Focalboard is an open source, self-hosted alternative to Trello, Notion, and Asana.


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


Your website domain needs to be set up:

[isabell@stardust ~]$ uberspace web domain list
[isabell@stardust ~]$

It’s recommended to use a PostgreSQL database. Install and configure PostgreSQL server as described in the PostgreSQL guide.


Download the latest release to your home directory and extract the application.

[isabell@stardust ~]$ wget
[isabell@stardust ~]$ tar --extract --gzip --file focalboard-linux.tar.gz
[isabell@stardust ~]$ rm focalboard-linux.tar.gz
[isabell@stardust ~]$


You need to modify ~/focalboard-app/config.json:

  • Change "localOnly": true, to "localOnly": false,

  • Add "session_expire_time": 2592000,

  • Add "session_refresh_time": 18000,

If PostgreSQL is used, the database configuration also needs to be adjusted. Edit the database config in the file ~/focalboard-app/config.json. These two values must be changed: .. warning:: Replace <db_user>, <db_password> and <db_name> with your values.

"dbtype": "postgres",
"dbconfig": "postgres://<db_user>:<db_password>@localhost/<db_name>?sslmode=disable&connect_timeout=10",

For example: .. code-block:: json

“dbtype”: “postgres”, “dbconfig”: “postgres://isabell_focalboard:sup3r-s3cr3t@localhost/focalboard?sslmode=disable&connect_timeout=10”,

Setup daemon

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


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 ~]$

Configure web server


Focalboard is running on port 8088.

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 ~]$

Configure application

Open a browser and point it to the domain and you should be redirected to the login screen. Click the link to register a new user instead, and complete the registration.

The first user registration will always be permitted, but subsequent registrations will require an invite link which includes a code. You can invite additional users by clicking on your username in the top left, then selecting “Invite users”.

More information can be found in the official documentation



Check the git repository regularly to stay informed about changes.

To update the application, stop the daemon and repeat the installation step.

Tested with Focalboard 0.6.1 and Uberspace 7.10.0

Written by: Thomas Kammerer <>