← Docs

You deployed the server

The dotMage server is running. A few things to set up so your team can use it.

Save the bootstrap secret

It is printed once at first start. You need it to create the account and to add new devices.

Make it reachable

dotMage is client↔server — each machine connects directly to the server. If your team isn't all on one network, put the server behind HTTPS (a TLS reverse proxy) or a VPN. See TLS / Production.

Team mode

Start the server with team endpoints, then invite members from an owner device:

$ curl -fsSL https://raw.githubusercontent.com/dotMage/server/main/install.sh | DOTMAGE_MODE=team bash
$ dmage user invite alice --role editor

See Team mode.

Back up the database

With end-to-end encryption the server cannot recover a lost database — schedule backups. See Backup & restore.

Upgrades

Re-run the installer (it is idempotent) or use the update banner in the admin panel:

$ curl -fsSL https://raw.githubusercontent.com/dotMage/server/main/install.sh | bash

See Upgrading the server.

Full reference: Documentation.