Dokumentacja Techniczna i Wdrożeniowa

Praktyczny przewodnik instalacji serwera SmartRMM oraz masowej dystrybucji natywnego agenta Windows na stacjach roboczych w domenie Active Directory lub chmurze Microsoft Intune.

Szukasz kompletnego opisu wszystkich funkcji platformy?

Zobacz nasz Oficjalny Podręcznik Użytkownika SmartRMM v2.4.2, opisujący w szczegółach wszystkie moduły systemu (Flota, Karta stacji roboczej, Helpdesk i pulpit RustDesk, Audyt NIS2, CVE, SAM, Monitoring Web & SSL, Sonda LAN i Skrypty RSA).

Otwórz Podręcznik →

1. Uruchomienie Serwera SmartRMM (Docker)

Serwer SmartRMM wdrażany jest jako odizolowany kontener Docker. Do 5 stacji roboczych pakiet Community otrzymujesz bezpłatnie na zawsze.

BASH / LINUX TERMINAL (CLI)
docker run -d \
  --name smartrmm \
  -p 8000:8000 \
  -v smartrmm_data:/app/data \
  --restart unless-stopped \
  ghcr.io/akap-it-krzysztof/smartrmm:latest

Alternatywnie: Docker Compose (QNAP Container Station, Synology, Portainer):

docker-compose.yml
version: '3.8'

services:
  smartrmm:
    image: ghcr.io/akap-it-krzysztof/smartrmm:latest
    pull_policy: always
    container_name: smartrmm
    restart: always
    ports:
      - "8000:8000"
    environment:
      - TZ=Europe/Warsaw
    volumes:
      - smartrmm_data:/app/data

volumes:
  smartrmm_data:
    name: smartrmm_data

Gotowe w 60 sekund: Po uruchomieniu kontenera otwórz przeglądarkę pod adresem http://twoj-serwer:8000 i zaloguj się domyślnym kontem administratora. W zakładce Lokalizacje kliknij zielony przycisk Wdrażanie przy wybranej lokalizacji lub oddziale, aby wygenerować skrypt PowerShell, parametry MSI lub pobrać gotowy pakiet ZIP.

2. Parametry Instalatora MSI

Agent dostarczany jest jako 64-bitowy instalator Windows Installer (SmartRMM.msi) zbudowany w standardzie WiX Toolset v5.

Właściwość MSI Typ Wymagany? Opis
SERVER String (URL) Tak Adres WebSocket serwera SmartRMM, np. wss://rmm.twojadomena.pl/api/ws/agent
TOKEN String (GUID) Tak Unikalny token lokalizacji wygenerowany w panelu w zakładce Lokalizacje (okno Wdrażanie)

Ochrona Poufności (NIS2): Właściwości SERVER i TOKEN są zadeklarowane jako MsiHiddenProperties. Poufny token lokalizacji nigdy nie trafia do logów instalatora w formacie jawnym.

Polecenie instalacji cichej (Silent Install):

CMD (ADMINISTRATOR)
msiexec.exe /i "SmartRMM.msi" SERVER="wss://rmm.twojadomena.pl/api/ws/agent" TOKEN="twoj_token_lokalizacji" /qn /norestart /l*v "%TEMP%\SmartRMM_install.log"

Alternatywnie: Pakiet instalacyjny na pendrive / SMB (Zero-Touch ZIP)

Dla stacji instalowanych ręcznie lub poza domeną w oknie Wdrażanie (zakładka Lokalizacje) dostępna jest opcja Pobierz pakiet instalacyjny (.zip). Zawiera on plik SmartRMM.msi oraz skrypt Instaluj.cmd – wystarczy rozpakować archiwum na pendrive lub zasób sieciowy i uruchomić Instaluj.cmd jako Administrator (skrypt automatycznie cicho instaluje agenta bez konieczności ręcznego wpisywania tokenów).

3. Wdrożenie przez Active Directory (GPO Startup Script)

Najbardziej niezawodną metodą wdrożenia w domenie Windows Server jest skrypt startowy komputera (Computer Startup Script), który weryfikuje obecność usługi przed instalacją.

Install-SmartRMM.bat (SKRYPT STARTOWY GPO)
@echo off
set SHARE=\SERWER-PLIKOW\Deploy$\SmartRMM
set SERVER_URL=wss://rmm.twojadomena.pl/api/ws/agent
set TOKEN=TUTAJ_WKLEJ_TOKEN_LOKALIZACJI

:: 1. Sprawdzenie czy usługa SmartRMM_Service już istnieje
sc query "SmartRMM_Service" >nul 2>&1
if %ERRORLEVEL% EQU 0 (
    exit /b 0
)

:: 2. Cicha instalacja pakietu MSI
msiexec.exe /i "%SHARE%\SmartRMM.msi" SERVER="%SERVER_URL%" TOKEN="%TOKEN%" /qn /norestart /l*v "%TEMP%\SmartRMM_GPO_Install.log"

4. Wdrożenie przez Microsoft Intune (Endpoint Manager)

W środowiskach hybrydowych lub chmurowych (Microsoft Entra ID) spakuj SmartRMM.msi narzędziem Microsoft Win32 Content Prep Tool (IntuneWinAppUtil.exe).

  1. Polecenie instalacji (Install command):
    msiexec.exe /i "SmartRMM.msi" SERVER="wss://rmm.twojadomena.pl/api/ws/agent" TOKEN="twoj_token" /qn /norestart
  2. Polecenie odinstalowania (Uninstall command):
    msiexec.exe /x {KOD-PRODUKTU-MSI} /qn /norestart
  3. Reguła wykrywania (Detection Rule - PowerShell):
POWERSHELL (DETECTION RULE)
if (Get-Service -Name "SmartRMM_Service" -ErrorAction SilentlyContinue) {
    Write-Output "SmartRMM Zainstalowany"
    exit 0
} else {
    exit 1
}

5. Zgłaszanie Awarii przez Użytkownika Końcowego

Po zainstalowaniu agenta w zasobniku systemowym (obok zegara Windows) pojawia się ikona SmartRMM.

  • 1 kliknięcie: Użytkownik klika prawym przyciskiem myszy na ikonę i wybiera „Zgłoś problem IT”.
  • Opis usterki: Pojawia się proste okno dialogowe z polem na krótki opis problemu.
  • Automatyczny zrzut ekranu: W momencie wysyłki agent wykonuje zrzut pulpitu i dołącza go do zgłoszenia w panelu serwisowym.