rocket_launch

Deploy a Gate

Manage the registration secret and generate the first-deploy command for a new host.

key Registration Secret

All Gates must present this secret when registering.

Loading...

build Deploy Command Builder

Fill in the Gate URL for the target host. The Core API URL is loaded from Settings.

warning Not configured — set CoreApiUrl in Settings.

Generate a registration secret above before building the deploy command.

checklist Pre-Deploy Checklist
Docker installed and running — run this to check, then follow the Docker Install Guide if needed. 
docker --version
 person Manual
Create Gate directory
mkdir -p /docker/gatenet-gate
 person Manual
Set directory permissions
sudo chmod 777 /docker/gatenet-gate
 person Manual
Place docker-compose.yaml in the Gate directory.
services:
  gatenet.gate:
    image: harbor.dasboothen.haus/homelab/gatenet-gate:latest
    container_name: gatenet-gate
    restart: unless-stopped
    group_add:
      - "${DOCKER_GID}"
    #pid: "host" # allows deeper host visibility for monitoring.
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /docker:/docker
      - /etc/fstab:/etc/fstab:ro
      - /proc:/host/proc:ro
      - /etc/hostname:/host/etc/hostname:ro
      - /etc/os-release:/host/etc/os-release:ro
      - /etc/systemd/system:/host/etc/systemd/system:ro
    environment:
      - ASPNETCORE_ENVIRONMENT=Production
      - ASPNETCORE_HTTP_PORTS=8080
      - GateConfig__BearerToken=${GATE_BEARER_TOKEN}
      - GateConfig__AllowedBasePath=/docker/
      - GateConfig__SentryUrl=http://host.docker.internal:5800
      - GateConfig__CoreUrl=${GATE_CORE_URL}
      - GateConfig__GateUrl=${GATE_URL}
      - GateConfig__RegistrationSecret=${GATE_REGISTRATION_SECRET}
      - GateConfig__EnvFilePath=/docker/gatenet-gate/.env
      # Host's LAN IP — supply on first deploy only; written to .env on registration
      # so future restarts pick it up automatically without this inline var.
      - GateConfig__HostLanIp=${HOST_LAN_IP}
      # Docker group GID — supply on first deploy only; written to .env on registration.
      - GateConfig__DockerGid=${DOCKER_GID}
    ports:
      - "8900:8080"
    extra_hosts:
      - "host.docker.internal:host-gateway"
person Manual
Log in to Harbor registry to allow image pulls

warning Harbor credentials not configured — set them in Settings.

person Manual
Traefik route configured for Gate URL → port 8900 person Manual
Registration secret generated cancel Not set