Installatiehandleiding

Stapsgewijze instructies om de Xcellerate RMM-server te installeren met Docker Compose.

Overzicht

De snelste manier om Xcellerate RMM uit te rollen is met Docker Compose. Deze handleiding leidt je door het hele proces — van het voorbereiden van de host tot het controleren van de draaiende server. Installeer je liever rechtstreeks op hardware, raadpleeg dan de geavanceerde installatienotities aan het einde.

Controleer eerst of je host voldoet aan de System requirements.

Kernbegrippen

  • Docker Compose-stack — de server wordt geleverd als een set containers: web-UI, API, achtergrondworkers, PostgreSQL en Redis.
  • Omgevingsbestand (.env) — één bestand met alle configuratie: databasegegevens, TLS-instellingen, SMTP-relay en licentiesleutel.
  • Datavolumes — persistente Docker-volumes voor de database en geüploade bestanden, zodat je gegevens een herstart van de containers overleven.

Installatie stap voor stap

1

Bereid de host voor

Installeer Docker en Docker Compose op je server. Op Ubuntu: sudo apt update && sudo apt install -y docker.io docker-compose-v2. Voeg daarna je gebruiker toe aan de groep docker: sudo usermod -aG docker $USER en meld je af en opnieuw aan.

2

Download het Xcellerate-pakket

Kloon de deploymentrepository: git clone https://github.com/rmmlabs/xcellerate-rmm.git && cd xcellerate-rmm. Die bevat de docker-compose.yml en een voorbeeldbestand .env.example.

3

Stel de omgevingsvariabelen in

Kopieer het voorbeeldbestand: cp .env.example .env. Open .env in je editor en stel minstens SERVER_HOSTNAME, DB_PASSWORD en ADMIN_EMAIL in. Het bestand bevat duidelijke commentaar — bij elke variabele staat waarvoor ze dient.

4

Start de stack

Voer docker compose up -d uit. Docker haalt de images op (~1,2 GB bij de eerste keer), maakt de volumes aan en start alle services. Dat duurt meestal 2–4 minuten.

5

Controleer de installatie

Open https://help.comodo.com/uploads/Comodo%20One/6e175807820c03aca9839d66e42cbef4/5eac818f1e1c4adc19d335055b06586b/86591a8e70c8559c6cbe59827974324a/c1_rmm_install6.png in een browser. Je zou het aanmeldscherm van Xcellerate RMM moeten zien. Gebruik je een self-signed certificaat, dan toont je browser een beveiligingswaarschuwing — dat is normaal.

Het aanmeldscherm van Xcellerate RMM na een geslaagde installatie

TLS inschakelen met Let's Encrypt

Schakel voor productie automatische TLS in. Zet TLS_MODE=letsencrypt en [email protected] in je .env-bestand en herstart daarna de stack. De ingebouwde reverse proxy vraagt certificaten automatisch aan en vernieuwt ze.

.env
# .env-fragment
SERVER_HOSTNAME=rmm.yourcompany.com
TLS_MODE=letsencrypt
[email protected]

Tips en best practices

  • Gebruik altijd een volledig gekwalificeerde domeinnaam (FQDN) voor SERVER_HOSTNAME — agents hebben die nodig om verbinding te maken.
  • Kies een sterk, uniek DB_PASSWORD. Vermijd speciale tekens die in een shell misschien geëscapet moeten worden.
  • Maak een aparte back-up van het .env-bestand — het bevat je databasegegevens en licentiesleutel.
  • Plan automatische updates van de Docker-images met een cronjob of Watchtower, zodat je altijd de nieuwste patchreleases hebt.
Stel PostgreSQL (poort 5432) of Redis (poort 6379) nooit open voor het publieke internet. Houd ze op een privénetwerk of gebonden aan localhost.