Directus is a real-time API and App dashboard for managing SQL database content.


This guide seems to be broken for the current versions of Directus, we would be happy if you want to work on a solution and create a Pull Request. See also the related issue:


For this guide you should be familiar with the basic concepts of


All relevant legal information can be found here in the GitHub repository of the project:


Node and npm

We’re using Node.js, its package manager npm:

[isabell@stardust ~]$ uberspace tools version show node
Using 'Node.js' version: '16'
[isabell@stardust ~]$ npm --version
[isabell@stardust ~]$


Update npm to the latest stable version. This includes npx (to execute npm package binaries).

[isabell@stardust ~]$ npm install --global npm@latest
[isabell@stardust ~]$

Create directory directus and sub directory logs.

[isabell@stardust ~]$ mkdir -p ~/directus/logs
[isabell@stardust ~]$


As CentOS 7 (uberspace) only provides glibc 2.17, the argon2 module on needs to be manually recompiled. This will avoid Error: /lib64/ version GLIBC_2.25

After installing directus need to delete ./node_modules/directus/node_modules/argon2 to force directus to use the locally compiled version.

[isabell@stardust ~]$ cd ~/directus
[isabell@stardust directus]$ npm install @mapbox/node-pre-gyp argon2
[isabell@stardust directus]$ npx node-pre-gyp rebuild -C ./node_modules/argon2
[isabell@stardust directus]$ rm -rf ~/directus/node_modules/argon2/
[isabell@stardust directus]$

Installation and initialize a new instance of Directus

[isabell@stardust ~]$ cd ~/directus
[isabell@stardust directus]$ npm install directus
[isabell@stardust directus]$ npx directus init
? Choose your database client
  PostgreSQL / Redshift
  MySQL / MariaDB / Aurora
❯ SQLite
  Microsoft SQL Server
  Oracle Database (Alpha)
⠹ Installing Database Driver...
? Choose your database client SQLite
? Database File Path: (/home/isabell/directus/data.db)
Create your first admin user:
? Email
? Password **********
Your project has been created at /home/isabell/directus.
The configuration can be found in /home/isabell/directus/.env
[isabell@stardust directus]$


Setup daemon

Create ~/etc/services.d/directus.ini with the following content:

command=%(ENV_HOME)s/bin/npx directus start

After creating the configuration, tell supervisord to refresh its configuration and start the service:

[isabell@stardust ~]$ supervisorctl reread
SERVICE: available
[isabell@stardust ~]$ supervisorctl update
SERVICE: added process group
[isabell@stardust ~]$ supervisorctl status
SERVICE                            RUNNING   pid 26020, uptime 0:03:14
[isabell@stardust ~]$

If it’s not in state RUNNING, check your configuration.

Change listening URL

In ~/directus/.env change the PUBLIC_URL to


Configure web server


Directus is running on port 8055.

To make the application accessible from the outside, configure a web backend:

[isabell@stardust ~]$ uberspace web backend set / --http --port <port>
Set backend for / to port <port>; please make sure something is listening!
You can always check the status of your backend using "uberspace web backend list".
[isabell@stardust ~]$

You can now reach Directus on your public domain, e.g.

To set up a specific domain or subdomain you can follow this guide:


Check GitHub repository of the project regularly to stay informed about the newest version. To update an existing installation use the following commands:

[isabell@stardust ~]$ cd ~/directus
[isabell@stardust directus]$ supervisorctl stop directus
[isabell@stardust directus]$ npx --yes npm-check-updates --upgrade
[isabell@stardust directus]$ npm install
[isabell@stardust directus]$ npx node-pre-gyp rebuild -C ./node_modules/argon2
[isabell@stardust directus]$ rm -rf ./node_modules/direcus/node_modules/argon2
[isabell@stardust directus]$ npx directus database migrate:latest
[isabell@stardust directus]$ supervisorctl start directus
[isabell@stardust directus]$

Tested with directus v9.4.1, Uberspace 7.12.0

Written by: j3n57h0m45 <>, André Lehner <>