Installing the server

Installation and first start

Answers the question What happens once the package is installed?

Installation

The server ships as a Debian package. Without a license it serves up to two devices.

The archive is on the downloads page.

tar -xzf wyrd-latest-debian-amd64.tar.gz
cd wyrd-*-debian-amd64
gpg --show-keys --with-fingerprint wyrd-release.asc

Integrity checks are described on the "Verifying the package" page.

The installation is a single command:

sudo apt install ./*.deb

This installs the server and the log store; Tor comes from the Debian repository. Over Tor the server obtains the application update and map areas without revealing your address; without the log store the logging switches in the console refuse.

An update is installed the same way, over the old version. The device database, settings, certificate, server key and the logs already collected stay where they are. A new version appears on the downloads page.

apt remove leaves the database, the settings and the server key on disk. Only apt purge deletes them, and that is irreversible: without the server key every phone has to be enrolled again.

First sign-in

There is no default password. On first start the server creates the admin account and takes its password one of two ways:

• If WYRD_ADMIN_PASSWORD is set, it uses that.
• If it is not, the server creates a random 24-character password and writes it to the log once.

Generated initial admin credentials (WYRD_ADMIN_PASSWORD was not set):
  username: admin
  password: ...
Save this NOW - it will not be shown again.

Take the password out of the log right after the first start. It is never shown again. Then open the dashboard at your domain and change it.

The certificate

The connection is always encrypted. The certificate and key are read from files. Replacements are loaded without a restart, and established sessions are not cut.