Dokumentation

Install, agent og produktion — Malaska Game Panel

Krav

  • Docker og Docker Compose
  • Linux VPS eller dedikeret server (anbefalet til produktion)
  • PostgreSQL 16 og Redis 7 (via Docker i dev/prod)
  • Node.js 20+ og pnpm (kun til udvikling fra kildekode)
  • Go 1.22+ (kun hvis du bygger agenten manuelt fra kildekode)

Hurtig start (udvikling)

  1. Klon game-panel repo og kør pnpm install
  2. Kopiér .env.example til .env
  3. Start PostgreSQL + Redis: docker compose -f docker/docker-compose.dev.yml up -d
  4. Kør migrationer: cd apps/api && pnpm exec prisma migrate deploy
  5. Start API + web fra roden: pnpm dev
  6. Åbn http://localhost:3000/setup og opret ROOT-bruger + første node
  7. Start agenten på node-maskinen (se nedenfor) med token fra setup
Tip: Valgfri demo-data med pnpm db:seed — kun til udvikling, ikke produktion.

Agent (game node)

Agenten kører på den maskine, der hoster Docker-spilservere (samme idé som Pterodactyl Wings). Panelet kommunikerer med agenten via Agent URL og token fra setup.

  • I Docker på samme host: http://agent:8080
  • På separat maskine: http://din-server-ip:8080
  • Manuel dev: cd apps/agent og go run . med AGENT_TOKEN sat

Produktion (Docker)

  1. Sæt stærke secrets i .env: POSTGRES_PASSWORD, JWT_SECRET, JWT_REFRESH_SECRET, AGENT_TOKEN
  2. Sæt offentlige URL'er: WEB_URL, NEXT_PUBLIC_API_URL, NEXT_PUBLIC_WS_URL
  3. Sæt ALLOW_REGISTRATION=false medmindre du vil have offentlig tilmelding
  4. Byg og start: docker compose -f docker/docker-compose.prod.yml up -d --build
  5. API kører prisma migrate deploy automatisk ved opstart
  6. Opsæt HTTPS med Caddy eller nginx (reverse proxy til port 3000 og 4000)
  7. Gennemfør /setup ved første besøg på et nyt miljø
WebSocket: Live konsol bruger Socket.IO mod API-hosten. Reverse proxy skal understøtte Upgrade-headers (Caddy gør det som standard).

Priser — hvad koster det?

Malaska Game Panel er gratis. Vi tager ikke betaling for selve panelet. Du betaler kun for din egen VPS/server, domæne og strøm.

Første spilserver

  1. Log ind som ROOT (eller opret bruger hvis registrering er slået til)
  2. Gå til dashboard → Opret server
  3. Vælg game template (Minecraft, CS2 m.fl.)

Sikkerhed (produktion)

  • Skift JWT_SECRET og JWT_REFRESH_SECRET (mindst 32 tegn)
  • Brug stærkt POSTGRES_PASSWORD
  • Kør kun over HTTPS på internettet
  • Rotér agent-token hvis det lækkes
  • Del aldrig .env eller agent-tokens offentligt
  • Tag backup af PostgreSQL-volumen regelmæssigt

Fuld install-guide

Se docs/install.md i game-panel repo for komplet guide inkl. HTTPS med Caddy, miljøvariabler og agent i produktion.

Brug for hjælp? Gå til support eller opret en ticket.