Ga naar hoofdinhoud

Installatie

Vereisten

  • Ubuntu 22.04+ server (min. 4 vCPU, 8 GB RAM, 80 GB SSD)
  • Docker + Docker Compose v2
  • Domeinnaam met DNS-beheer
  • GitHub repository toegang

Stap 1 — Server voorbereiden

# Docker installeren
curl -fsSL https://get.docker.com | sh
usermod -aG docker $USER

# Firewall
ufw allow 80/tcp
ufw allow 443/tcp
ufw allow 22/tcp
ufw enable

Stap 2 — GitHub Secrets instellen

Voeg volgende secrets toe onder Settings → Secrets → Actions:

SecretBeschrijving
DEPLOY_SSH_HOSTServer IP-adres
DEPLOY_SSH_USERSSH gebruiker (bijv. deploy)
DEPLOY_SSH_PRIVATE_KEYPrivate SSH sleutel
DEPLOY_PATHPad op server (bijv. /opt/nexon)
DEPLOY_ENV_PUBLICVolledige productie .env inhoud
ADMIN_DB_PASSWORDWachtwoord admin database
KEYCLOAK_DB_PASSWORDWachtwoord Keycloak database
INTERNAL_API_SECRETIntern API geheim
UPTIME_WEBHOOK_SECRETWebhook geheim voor uptime monitoring

Stap 3 — Eerste deploy (fresh install)

Ga naar GitHub Actions → Deploy Public stack en trigger met fresh_install=true.

waarschuwing

Fresh install wist alle data op de server. Gebruik dit alleen bij eerste installatie of volledig herstel.

Stap 4 — Super admin aanmaken

Na de deploy: GitHub Actions → Bootstrap Super Admin triggeren met je gegevens.

Stap 5 — DNS instellen

RecordTypeWaarde
nexonsolutions.beASERVER_IP
*.nexonsolutions.beASERVER_IP

Volgende stap

Eerste login