CERMM/wiki>

Getting started

Quick start

Three steps: run the server, claim the first account with the setup code, paste one line on a machine.

1. Run the server

On a fresh Debian 13 (or 12) machine, LXC container or VM, as root:

apt-get update && apt-get install -y git
git clone https://git.klab.gg/xvoltzz/CERMM.git /opt/cermm && cd /opt/cermm
sh deploy/lxc.sh

It installs Node 26 and Go, builds the web app and the agents, and starts CERMM under systemd. At the end it prints the address, the certificate's fingerprint and the setup code. More in Install on Debian or an LXC.

Just trying it on your own computer? See Development setup: npm install && npm run agents && npm run build && npm run server.

2. Claim the first account

Open https://<server>:4800. Your browser warns the first time, because CERMM made its own certificate (see HTTPS). Enter the setup code, choose a username and password. Then turn on two-factor sign-in in Settings → Security. More in The first account.

3. Add a device

Press the + in the title bar (or n). CERMM makes an enroll token and shows one line to paste:

  • Linux and macOS: a curl … | sudo sh -s -- --token … line, in a terminal.
  • Windows: a PowerShell line, in Windows PowerShell run as Administrator.

The dialog waits for the machine to check in. Within a few seconds it's on the Devices list, and its inventory (hardware, software, network) follows. More in Adding a device.

Next

CERMM is in development. Something here wrong or out of date? Tell us or fix it.