Directus is an Open-Source Headless CMS & API for Managing Custom Databases
Failed to load latest commit information.
.github update ISSUE_TEMPLATE Feb 16, 2018
api fix spelling mistake (#2181) Jul 17, 2018
app Merge branch 'develop' Apr 3, 2018
assets Obliterate border radius from header buttons Nov 9, 2017
bin add shell to sh files Dec 19, 2017
customs Updated example extension so that #content always gets updated with eโ€ฆ Feb 22, 2018
installation directus requires php 5.6 or higher (#2112) Mar 27, 2018
storage/uploads add default file as example (Ref #1626) Jul 19, 2017
templates change .html to .twig and .handlebars Sep 4, 2017
tests add auth example to configuration stub Mar 29, 2018
thumbnail Update .htaccess (#1873) Oct 31, 2017
.editorconfig Add handlebars to the tab-prefered extensions Sep 5, 2017
.gitignore add thumbnail to build Sep 26, 2017
.gitmodules update templates submodule Jul 19, 2017
.htaccess fix env request uri Oct 31, 2017
.scrutinizer.yml add scrutinizer config Jul 18, 2016
.travis.yml remove php 5.5 from travis Mar 4, 2017 Update year in (#1333) Jan 21, 2017
composer.json Response cache (#1811) Oct 31, 2017
gulpfile.js add thumbnail to build Sep 26, 2017
index.php execute postMessage after item saved Dec 8, 2017
karma.conf.js update karma testing configuration files Apr 24, 2016
login.php change .html to .twig and .handlebars Sep 4, 2017
package.json โœจ ๐Ÿฐโ™ฆ๏ธ bump version: 6.4.9 โ™ฆ๏ธ๐Ÿฐ โœจ Apr 3, 2018
phpunit.php fix tests Oct 31, 2017
phpunit.xml phpunit filter Jul 4, 2016 directus requires php 5.6 or higher (#2112) Mar 27, 2018

Directus Logo

Open-Source Headless CMS & API



Directus is free and open-source and we like to keep it that way.
Please help us out by supporting the project on Patreon!


Directus is a free and open-source database API and 'headless' CMS. Unlike traditional CMS that encompass your entire project codebase, the decoupled approach of Directus offers an API and SDKs to connect your content to: websites, native apps, kiosks, IoT devices, or any other data-driven projects.

Directus makes no assumptions about how you should architect your database โ€“ giving you complete freedom to optimize structure and performance for projects of any size or complexity. Built on top of the API is our feature-rich admin webapp (CMS) which dynamically maps to your database's schema, instantly providing your users/clients with an intuitive interface for managing content.

Learn more at, chat with us on Slack, and follow us on Twitter: @directus


Download the latest pre-built version from our releases page or clone this repo and install the composer dependencies by running composer install from the root folder.


NGINX or Apache Server, MySQL 5.2+, PHP 5.6+ (curl, gd, finfo, pdo_mysql)

Database types

While Directus has been abstracted to allow for different database adapters in the future, currently only MySQL is supported. PostgreSQL, SQLite, and MongoDB support are under development โ€“ and we hope to expand support for additional database types as we gain contributors.


Directus ADMIN

The full documentation about using the admin Directus can be found over at

You can find the source of this documentation in our docs repo.

Directus API & SDKs

Our full API reference can be found over at Together with the endpoints and supported params, you can also find code examples for our supported SDKs.

You can find the source of this documentation in our API docs repo.

Help and Support

Reporting Bugs

Think you've discovered a bug? First, read through our docs to be sure โ€“ then submit a ticket to our GitHub Issues. And if you already know a good solution, we love Pull Requests! For all security related issues, please chat with us directly through

Requesting Features or Enhancements

Use our Feature Request Tool to request new features or vote on existing community suggestions.

Technical Support

For support using Directus, please post questions with the directus tag on Stack Overflow.

Team and Community Chat

If you're interested in discussing things with our core team or the Directus community, feel free to join us on Slack. This is not a place for free/faster tech support.

Contributing to Directus

First of all, thank you for taking the time to work on Directus!

The following is a set of guidelines for contributing to Directus and its components. These are just guidelines, not strict rules. Feel free to propose changes to this and other documents in a pull request.

Financial Support


Pull Requests

Pull requests are always welcome for every part of Directus. Please make sure to adhere to our .editorconfig rules and to lint your code with XO.

Your First Code Contribution

Unsure where to begin contributing to Directus? You can start by looking through the Beginner, good first issue and Help Wanted issues. Beginner and good first issue issues are issues that often only require a few lines of code. Help wanted issues are a bit more involved than beginner issues.

Want to help but have some trouble understanding the issue, ask us and we will help you to get you started.


Directus has multilingual support โ€“ and we're looking for anyone interested in helping translate our English default language file into other languages. It's as easy as copying that en.json file and changing the values!

PR any translations into this Directory.

Huge thanks to the following contributors!

Public Roadmap

This is what we want to get done next:

Q1 2018

Q2 2018


Key developers: coolov, freen, jel-massih, Lasha

Sponsors: Bas Jansen

Copyright, License, and Trademarks

  • Directus Core codebase released under the GPLv3 license.
  • Example Code, Design Previews, Demonstration Apps, Custom Extensions, Custom interfaces, and Documentation copyright 2018 RANGER Studio LLC.
  • RANGER Studio owns all Directus trademarks, service marks, and graphic logos on behalf of our project's community. The names of all Directus projects are trademarks of RANGER Studio LLC.