Documentation — GateControl - Server

Schnellstart

git clone https://github.com/CallMeTechie/gatecontrol.git
cd gatecontrol
cp .env.example .env
docker compose up -d

GateControl ist danach unter der konfigurierten GC_BASE_URL erreichbar.

Voraussetzungen

Docker und Docker Compose
Ein Server mit öffentlicher IP-Adresse oder Domain
Port 51820/UDP (WireGuard), 80/TCP und 443/TCP (Caddy) offen

Installationsoptionen

Option 1: Online (empfohlen)

mkdir gatecontrol && cd gatecontrol
curl -fsSLO https://github.com/CallMeTechie/gatecontrol/releases/latest/download/setup.sh
curl -fsSLO https://github.com/CallMeTechie/gatecontrol/releases/latest/download/docker-compose.yml
curl -fsSLO https://github.com/CallMeTechie/gatecontrol/releases/latest/download/.env.example
sudo bash setup.sh

Das Setup-Script erkennt automatisch dein Betriebssystem, installiert Docker falls nötig und führt dich durch die Konfiguration.

Option 2: Offline

curl -fsSLO https://github.com/CallMeTechie/gatecontrol/releases/download/v1.0.0/gatecontrol-image.tar.gz
curl -fsSLO https://github.com/CallMeTechie/gatecontrol/releases/download/v1.0.0/setup.sh
sudo bash setup.sh

Option 3: Docker Compose (manuell)

git clone https://github.com/CallMeTechie/gatecontrol.git
cd gatecontrol
cp .env.example .env
# .env bearbeiten
docker compose up -d

Erster Login

Nach dem Start ist GateControl unter der konfigurierten GC_BASE_URL erreichbar (Standard: http://localhost:3000).

Standard-Zugangsdaten

Feld	Wert
Benutzername	`admin`
Passwort	Das in `GC_ADMIN_PASSWORD` gesetzte Passwort

Achtung: Das Standard-Passwort in der .env.example ist changeme. Aendere es unbedingt vor dem ersten Start! Das Setup-Script fragt dich nach einem sicheren Passwort — wenn du manuell installierst, setze es in der .env:

GC_ADMIN_USER=admin
GC_ADMIN_PASSWORD=DeinSicheresPasswort123!

Der Benutzername kann ueber GC_ADMIN_USER geaendert werden (Standard: admin).

Nach dem Login

Passwort aendern: Navigiere zu Profil (oben rechts) und setze ein neues Passwort
SMTP konfigurieren: Unter Settings → Email fuer E-Mail-Benachrichtigungen und Route Auth OTP
Ersten Peer erstellen: Unter Peers → Add Peer

Erste Schritte