Case Study
View Case StudyTray.ai
Migrating hundreds of thousands of pages, re-platforming and extending for the leading composable AI integration platform
From KeystoneJS to Directus
We are the KeystoneJS to Directus migration experts
Last verified:
Challenges with KeystoneJS
Key pain points
The biggest challenge with KeystoneJS is that it hands you all the responsibility that a managed CMS would normally handle. Deployment is entirely on you, and the documentation around production hosting, Docker configuration, and scaling is thin. We've seen teams struggle to go from a smooth local development experience to a reliable production setup, especially if they don't have dedicated DevOps support. The admin UI Docker image alone can balloon to over a gigabyte, which is a headache for containerised deployments.
The community around Keystone is significantly smaller than competitors like Strapi or Payload. That means fewer tutorials, fewer plugins, and slower answers when you hit an edge case. The ecosystem of ready-made integrations is almost non-existent, so you'll be building most things from scratch. For an agency working on client projects with deadlines, that time cost adds up quickly.
Content editors also tend to have a harder time with Keystone compared to more polished alternatives. The admin UI is functional but feels utilitarian, and non-technical users often need more onboarding than you'd expect. There's no visual editing, no preview infrastructure, and no real content workflow features like drafts, publishing schedules, or approval chains without building them yourself. If your client's content team needs a CMS they can pick up and run with, Keystone usually isn't the answer.
Deployment complexity
Self-hosting is the only option, and the docs don't hold your hand. Getting Keystone into production requires real infrastructure knowledge, and the large Docker image sizes make it worse.
Small community and ecosystem
Compared to Strapi or even Payload, the community is much smaller. Fewer plugins, fewer tutorials, and slower support when things go wrong.
No built-in content workflows
There are no turnkey drafts, scheduled publishing, or approval chains. Keystone provides field primitives that can be assembled into publishing workflows, but you need to wire them up yourself.
Admin UI feels dated
The admin panel is functional but lacks the polish and UX of modern CMS interfaces. Non-technical editors often find it confusing and need more training.
No visual editing or live preview
There's no way for editors to see content in context before publishing. You'd need to build your own preview infrastructure, which is a significant engineering effort.
Scaling requires significant effort
Running Keystone under high traffic means managing session stores, reverse proxies, and server resources yourself. It doesn't scale as smoothly as cloud-native CMS alternatives.
Benefits of Directus
Key advantages
Directus instantly wins points with us because, well… it has a rabbit for a logo. But beyond that, it's genuinely a solid database-first CMS. If you like the idea of a CMS that sits directly on top of your SQL database without any abstractions, Directus feels incredibly natural.
You can self-host it, tweak it endlessly, and treat your schema exactly the way you want. Editors get a no-code admin UI that feels polished, developers get REST and GraphQL out of the box, and teams get workflows, versioning, automations, and proper permission controls. It's flexible, fast, and a great fit if your content is really just structured data waiting for a smarter interface. If your project revolves around relational data and you want total control from database to API, Directus is one of the cleanest ways to build it.
Intuitive non-technical interface
Editors get a clean, no-code admin panel that feels more like a productivity tool than a CMS. Non-technical teams can handle content updates without pinging developers every five minutes.
Database-agnostic SQL integration
Directus plugs straight into your SQL database and turns it into an API instantly. If your data lives in Postgres, MySQL, MariaDB, or SQLite, it just works.
Field-level permission controls
You can lock down every field, table, and action with granular role-based permissions. Perfect for teams that care about security and don't want interns accidentally deleting production data.
Built-in REST/GraphQL support
Your entire database is instantly exposed as both REST and GraphQL endpoints. Just plug into your frontend and start shipping.
Extensive UI customization
Directus lets you tweak the interface, add custom views, tailor layouts, and build the exact editing experience your team needs. It feels like a CMS you can actually shape instead of fight.
Real-time collaborative editing
Multiple contributors can work in the Studio at the same time without stepping on each other's toes. Collaborative editing shipped in February 2026, so drafts stay clean and the whole workflow feels built for modern teams, not 2010 intranets.
AI Assistant with image and PDF support
The built-in AI Assistant can process images and PDFs as well as text, and it works across OpenAI, Anthropic, and Google Gemini. It's a genuinely useful addition rather than a feature-list checkbox.
Common questions
KeystoneJS to Directus migration FAQs
Answers to the most common questions about KeystoneJS to Directus migration
What makes migrating from KeystoneJS difficult?
KeystoneJS stores data through Prisma, so the database layer is well-structured and easy to export. The harder part is replacing everything Keystone doesn't give you. Most Keystone projects have custom-built preview systems, publishing workflows, and access control logic that are tightly coupled to the Node.js backend. Rebuilding those features in a new CMS takes planning. We typically budget 4 to 8 weeks for a Keystone migration depending on how much custom infrastructure the team has built around it.
Why do teams move away from KeystoneJS?
Deployment complexity is the number one reason. Teams love Keystone during local development, then hit a wall getting it reliably into production. The Docker images can balloon past a gigabyte, the docs don't cover production hosting well, and there's no managed hosting option. The small community compounds this problem. When you hit an edge case, there are fewer people who've solved it before. Content editors also struggle with the admin UI, which lacks visual editing, live preview, and built-in publishing workflows that competing platforms ship by default.
How do we extract our content from KeystoneJS?
Since Keystone uses Prisma ORM, your content lives in standard PostgreSQL, MySQL, or SQLite tables with clean schemas. You can export directly from the database using SQL dumps or Prisma's query API. The content model is defined in your TypeScript codebase, so mapping fields to a new CMS is straightforward. We write automated scripts that handle the data transformation, including resolving relationships between lists and migrating file references. For a project with 20 to 50 Keystone lists, extraction and transformation usually takes 1 to 2 weeks.
How do we migrate content out of Directus?
Directus sits directly on your SQL database, which is both a blessing and a curse during migration. The blessing is that your content is in standard PostgreSQL, MySQL, or SQLite tables, so extraction is as simple as SQL queries. The curse is that Directus stores relational data and file references in its own conventions, so you need to untangle junction tables and re-map asset URLs. We write custom migration scripts for each project. A typical Directus migration with 50 to 100 content types takes 3 to 5 weeks.
Why do teams move away from Directus?
The two biggest triggers we see right now are licensing uncertainty and pricing sticker shock. Directus moved to the Monospace Sustainable Core License (MSCL) with v12 in May 2026, replacing the old BSL. Organisations under $5M revenue and 50 employees get a free Innovation Grant, but even above those thresholds the MSCL still permits free use of the Core tier — so larger orgs aren't categorically forced onto paid plans, though many opt into the cloud or a commercial self-hosted license for the production features sitting outside Core, and the community is noticeably split, with some teams forking old versions or migrating off entirely. On the cloud side, the old unlimited tier is gone; the Professional plan is $99/month and caps you at 5 users, 75K database entries, and 250K API requests. Growth past those limits means a jump straight to custom Enterprise pricing. On the development side, any custom interface work still requires Vue.js, which creates friction for React-focused teams. Breaking changes between updates also erode trust over time. Teams that started with Directus for its open-source appeal often outgrow it when they need predictable pricing and cleaner editorial workflows.
Can we keep our existing database when migrating from Directus?
You can keep your database infrastructure, but you'll likely restructure the schema. Directus creates its own system tables (directus_users, directus_permissions, directus_files, etc.) alongside your content tables. During migration, we extract the content tables, transform the data to fit your new CMS's content model, and leave the Directus system tables behind. If you're moving to a headless CMS like Sanity, the data moves from SQL rows to structured JSON documents, which typically results in a cleaner content model.
Get in touch
Fill out the form below and we'll get back to you
