Przewodnik instalacji
Instrukcje krok po kroku dotyczące instalacji serwera Xcellerate RMM za pomocą Docker Compose.
Przegląd
Najszybszym sposobem na wdrożenie Xcellerate RMM jest Docker Compose. Ten przewodnik przeprowadzi Cię przez cały proces — od przygotowania hosta po weryfikację działającego serwera. Jeśli wolisz instalację bare-metal, zapoznaj się z zaawansowanymi uwagami na końcu.
Kluczowe pojęcia
- Stos Docker Compose — serwer dostarczany jest jako zestaw kontenerów: interfejs webowy, API, pracownicy w tle, PostgreSQL i Redis.
- Plik środowiskowy (.env) — pojedynczy plik zawierający całą konfigurację: dane dostępowe do bazy, ustawienia TLS, relay SMTP i klucz licencji.
- Woluminy danych — trwałe woluminy Docker dla bazy danych i przesłanych plików, zapewniające przetrwanie danych po restartach kontenerów.
Instalacja krok po kroku
Przygotuj hosta
Zainstaluj Docker i Docker Compose na swoim serwerze. Na Ubuntu: sudo apt update && sudo apt install -y docker.io docker-compose-v2. Następnie dodaj użytkownika do grupy docker: sudo usermod -aG docker $USER i wyloguj się/zaloguj ponownie.
Pobierz pakiet Xcellerate
Sklonuj repozytorium wdrożeniowe: git clone https://github.com/rmmlabs/xcellerate-rmm.git && cd xcellerate-rmm. Zawiera ono plik docker-compose.yml i przykładowy plik .env.example.
Skonfiguruj zmienne środowiskowe
Skopiuj przykładowy plik: cp .env.example .env. Otwórz .env w edytorze i ustaw co najmniej: SERVER_HOSTNAME, DB_PASSWORD i ADMIN_EMAIL. Plik jest dobrze skomentowany — każda zmienna wyjaśnia swoje przeznaczenie.
Uruchom stos
Wykonaj docker compose up -d. Docker pobierze obrazy (~1,2 GB przy pierwszym uruchomieniu), utworzy woluminy i uruchomi wszystkie usługi. Proces trwa zwykle 2–4 minuty.
Zweryfikuj instalację
Otwórz https://nazwa-twojego-serwera w przeglądarce. Powinieneś zobaczyć ekran logowania Xcellerate RMM. Jeśli używasz certyfikatu samopodpisanego, przeglądarka pokaże ostrzeżenie bezpieczeństwa — to normalne.
Włączanie TLS z Let's Encrypt
Dla środowiska produkcyjnego włącz automatyczny TLS. Ustaw TLS_MODE=letsencrypt i [email protected] w pliku .env, a następnie zrestartuj stos. Wbudowany reverse proxy automatycznie uzyska i odnowi certyfikaty.
# Fragment .env
SERVER_HOSTNAME=rmm.twojafirma.com
TLS_MODE=letsencrypt
[email protected]Wskazówki i najlepsze praktyki
- Zawsze używaj pełnej nazwy domeny (FQDN) dla
SERVER_HOSTNAME— agenci polegają na niej przy łączeniu. - Ustaw silne, unikalne
DB_PASSWORD. Unikaj znaków specjalnych wymagających escapowania w kontekstach powłoki. - Wykonaj kopię zapasową pliku
.envosobno — zawiera dane dostępowe do bazy i klucz licencji. - Zaplanuj automatyczne aktualizacje obrazów Docker za pomocą zadania cron lub Watchtower, aby być na bieżąco z poprawkami.