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 (
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:
- Add signing keys
- Add repository
- Update repository list
- 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
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:
systemctl disable serverboards systemctl stop serverboards
The first line disables Serverboards for future reboots, and the second stops it right away.
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
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
make install. Then create the database manually, setup the initial
/etc/serverboards/*.ini, start the
server and then add the initial users.
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.