Install Serverboards

Under 3 minutes, 4 commands and a lot of apt-waiting


Latest development version available at this page.


Recommended Install Method

Serverboards requires Ubuntu 18.04 or later.

It is possible to install the latest development version at this page.

Install Serverboards APT Repository

Run this in a terminal as root (sudo bash):

apt-key adv --keyserver keyserver.ubuntu.com --recv-keys FACCB714
echo "deb https://serverboards.io/ubuntu/ stable main" >> /etc/apt/sources.list.d/serverboards.list
apt update
apt install -y serverboards

Explained by line:

  1. Add signing keys
  2. Add repository
  3. Update repository list
  4. Install Serverboards. This asks several questions as initial user password.

It should ask the user several questions, as the Fully Qualified Domain Name, initial user email, email server settings and whether to configure NGINX automatically.

If there is any problem (for example typo in the URL) there might be an error on the postinstall. It can be forced again with dpkg-reconfigure serverboards --force

First access

Now you can access at http://localhost:8080, and if NGINX was configured, at https://s10s.yourdomain.com .

User and password is:

  • as in the installed system (uses PAM)
  • or using the generated user and the password set with s10s user passwd [email@example.com],
  • or recovering the password at the login dialog, for the initial generated user, if the email server is properly configured.

Fine tune Serverboards

Edit the files at /etc/serverboards/*.ini to fine tune if you need your configuration, or create your own adding configuration options.

Default configuration should be OK in most cases.

Enable and start Serverboards

Serverboards is enabled by default. User may disable and reenable it running this in a terminal as root:

To disable:

systemctl disable serverboards
systemctl stop serverboards

The first line disables Serverboards for future reboots, and the second stops it right away.

To enable:

systemctl enable serverboards
systemctl start serverboards

The first line enables it for future reboots of the machine, the second starts it right away.

Serverboards only allows unauthenticated access from localhost, so to access from another computer there is need for a HTTPS proxy, as the autoconfigured NGINX.

Keep it updated

You can update from the settings section or type this (normal apt update/upgrade):

apt update
apt install serverboards

Manual install

If you prefer to install manually and do not add the Serverboards’ APT repository, you can download the .deb file at

and install it and fix dependencies with:

dpkg -i serverboards.deb
apt -f install

Source code install

There is no official Source Code install method, but you can find the source code at Gihub and compile and install using the debian/* files as guide.

In resume it needs to have all the dependencies installed, do a make and then a make install. Then create the database manually, setup the initial configuration at /etc/serverboards.ini or /etc/serverboards/*.ini, start the server and then add the initial users.

Development workflow

The development workflow requires two terminals (or tabs):

First tab, backend:

cd backend
iex -S mix

Second tab, frontend:

cd frontend
npm start

On the browser go to http://localhost:3000 .

Finally must add a localStorage option, opening the inspector (F12) and then on the console tab, writing: localStorage.servername = 'http://localhost:8080'. This instructs Serverboards to connec tto another server, not to http://localhost:3000. May require a reload of the page (Crtl+R or F5).

Any problem, head to the Serverboards Forum.