⚙️ Installation

The easiest way to get up-and-running is with the Directus Suite, which includes the Directus API, the Directus App, and all dependencies.


Directus is developed and tested on the LAMP stack, and therefore this is the only officially supported environment. Alternate stacks (NGINX, Caddy, MariaDB, Percona, etc) may also work but you should proceed at your own risk. Please ensure your server meets the following requirements:

  • Apache
  • MySQL 5.7+
    • A Database (empty or existing)
    • A Database User (with access to database)
  • PHP 7.1+
    • Extensions: pdo, mysql, curl, gd, fileinfo, libapache2-mod-php and mbstring

Detailed Requirements

View our detailed requirements page to learn more about these requirements, neccesary permissions, and other server-specific prerequisites.


Running the following git command from your server's command line is the preferred method of installing the codebase.

git clone https://github.com/directus/directus.git

Other Install Methods

Alternatively, you can choose from one of these other installation methods.


If you are using Apache, make sure mod_rewrite and AllowOverride are enabled. Read more


If after installation you are experiencing missing functions or packages errors, follow these steps to recreate composer.json and update the composer autoloader. If there's already a composer.json, either run composer dump-autoload.


  1. Set your document root to the /public directory
  2. Navigate your browser to the App at /admin
  3. Follow the prompts to complete configuration (see below)
Field Description
Project Name The name of your project
Project Key For now, only the _ default is available through the installer
Admin Email The email address of your first administrator
Admin Password The password for your first administrator
Host The server/host of your database
Port The port for the database (default is 3306)
Database User The database user
Database Password The database user's password
Database Name The name of the database
Database Type As of now, Directus only supports MySQL

Manual Configuration

Alternatively, you can manually configure Directus.

Logging In

Once you've completed the installer you will automatically be taken to the login page of the Directus App (again, at /admin). You can then login with the credentials you provided during configuration, or the default credentials (admin@example.com and password) if configured manually.

👍 You've successfully installed Directus! Now you're ready to add your first collection.