Managed Server Modus

Der Managed Server Modus betreibt MaxiCore auf einem dedizierten Server. Ideal für Teams und persistente Verfügbarkeit.

Pairing mit einem Server

1. Server vorbereiten

Auf deinem Server (Linux/macOS):

curl -fsSL https://install.maxicore.ch/agent | bash
maxicore agent init

Dies generiert einen Service-Pairing-Key im Format MC-XXXXXX-YYYYYY-ZZZZZZ.

2. Im Portal pairing aktivieren

1. Gehe zu Settings → Managed Agents
2. Klick "Add Agent"
3. Gib den MC-XXXXXX-YYYYYY-ZZZZZZ Key ein
4. Gib dem Agent einen Namen (z.B. "Production Agent")
5. Klick "Pair"

Der Agent authentifiziert sich jetzt via HTTPS und wird in deinem Dashboard angezeigt.

3. Service-Installation

Nach erfolgreichem Pairing:

maxicore service install --name maxicore-agent
systemctl start maxicore-agent
systemctl enable maxicore-agent

Der Agent läuft jetzt als systemd-Service und startet automatisch nach Reboot.

Service-Management

# Status prüfen
systemctl status maxicore-agent

# Logs anschauen
journalctl -u maxicore-agent -f

# Neu starten
systemctl restart maxicore-agent

# Service stoppen
systemctl stop maxicore-agent

Netzwerk & Security

Der Managed Server benötigt ausgehende HTTPS-Verbindung zu:

• https://api.maxicore.ch — API Kommunikation
• https://events.maxicore.ch — Event Streaming

Firewall-Regel (Optional, für eingehende UI):

# Port 8090 ist der Standard-Port des Agents
sudo ufw allow 8090/tcp

Multi-User Access

Alle Benutzer mit Zugriff auf dein Workspace können den Agent nutzen:

# Admin: Zugriff auf Policies
# Editor: Normale Nutzung
# Viewer: Nur Logs lesen (read-only)

Permissions werden im Portal pro Agent verwaltet unter Settings → Agent Permissions.

Upgrade & Wartung

Der Agent prüft automatisch auf Updates (täglich). Für manuelles Update:

maxicore agent upgrade --force

Dies lädt die neueste Version herunter und startet den Service neu.