Installing the Directus Suite
The easiest way to get up-and-running with Directus is with our combined release, which includes the Directus API, the Directus Application, and all required dependencies. Check that your server meets the requirements, install Directus, and then configure it with the installer.
Directus 7 is a major release with significant breaking changes from previous versions. Therefore there is no automated way to migrate your settings and configuration from v6 to v7. However, because Directus stores your content as pure SQL, that data is always portable between versions. Learn More About Legacy Upgrades
Learn more about these system requirements, neccesary permissions, and other server-specific prerequisites on our dedicated requirements page.
- HTTP/Web Server
- MySQL 5.2+
- Database (empty or existing)
- Database User (with access to database)
- PHP 7.1+
The preferred method of installing is through Git by running the following command from your server's command line. If your server doesn't allow for this method then you can install manually too.
git clone https://github.com/directus/directus.git
- Set your document root to the
- Navigate your browser to the App at
- Follow the prompts to complete configuration (see steps below)
|Project Name||The name of your project|
|Project Key||For now, only the |
|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|
If you would rather setup your project manually you can follow these instructions. This method creates the default config file (
/config/api.php) from our sample (
/config/api_sample.php) and installs the boilerplate database using the included schema file (
Once you've finished with 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 the configuration process, or the default credentials if configured manually:
Other Install Options
# Get the zip file from GitHub wget https://github.com/directus/directus/archive/master.zip # Decompress the file unzip master.zip
# Get the zip file from GitHub wget https://github.com/directus/directus/archive/master.tar.gz # Decompress the file tar -xzf master.tar.gz
If you don't have access to the command line then you'll need to decompress the files on your local computer before uploading to the remote server, though this will take much longer.
If you prefer, you can choose to only install the Directus API, or only install the Directus App. This is useful for multitenancy, such as when you need many instances of the API but only one App to manage them all.
Install from Source
If you would like to extend or make contributions to the core codebase then you can install the Directus API Source, or install the Directus App Source. This process involves more steps, so we recommend using the combined build for normal usage.