Einrichtung · Kurzguide

1. Paket herunterladen

Das vollständige Setup-Bundle (Docker Compose, Agent, Beispiel-Konfigurationen) wird nach dem Kauf automatisch per E-Mail zugesandt und steht zusätzlich auf der Bestätigungsseite bereit.

Bewahre den Download-Link sicher auf – er ist 7 Tage gültig.

2. Agent entpacken

Das Archiv enthält das Verzeichnis ts-connect-agent. Entpacke es nach /etc/ts/ (Standardpfad für Konfiguration & Secrets).

• Sorge dafür, dass der Ordner dem System-User gehört, der den Agent betreibt.
• Setze Dateirechte für Secrets auf 600 (oder strenger).

3. Voraussetzungen prüfen

Der Agent benötigt eine aktuelle Docker-Umgebung.

• Linux (Ubuntu 22.04 LTS empfohlen) mit Root-Zugang
• docker & docker-compose (oder docker compose) installiert
• Firewall-Zugriff zum Vereinsnetz & zum Internet (HTTPS)

4. Datenbankzugang eintragen

Öffne /etc/ts/connect.env und pflege die Verbindungsdaten zur Vereins-Datenbank (MariaDB / MySQL).

• DB_HOST, DB_PORT, DB_USER, DB_PASSWORD
• Optional: separate Read-Only-User für Connect

5. Lizenzkey hinterlegen

Trage den Lizenzschlüssel in /etc/ts/license.key ein oder setze die Variable TSC_LICENSE_KEY in der Compose-Umgebung.

• Der Schlüssel ist pro Verein gültig.
• Änderungen werden beim nächsten Agent-Neustart übernommen.

6. Dienste starten

Im Entpack-Verzeichnis befindet sich ein docker-compose.yml. Starte den Agent mit:

cd /etc/ts
docker compose pull
docker compose up -d

Status & Logs: docker compose ps · docker compose logs -f