Deployment Overview

Important Distinction

This document covers the deployment of the JoyFlick Knowledge Base — the Docusaurus documentation site you are reading now, hosted at knowledge.joyflick.com. This is NOT documentation of JoyFlick's production gaming platform infrastructure.

JoyFlick (joyflick.com) runs on Elympics cloud infrastructure with game servers in Warsaw, Dallas, Tokyo, Mumbai, and Belgium (*-gs.elympics.ai). The production platform uses Next.js, Privy for auth, and Unity WebGL for games — none of which are deployed via this KB's Docker Swarm stack.

For production platform architecture, see System Architecture.

Knowledge Base Stack

This documentation site is a Docusaurus static site deployed via:

Component	Role
Docusaurus	Static site generator (MDX content)
Docker Swarm	Container orchestration
Portainer	Docker management UI
Traefik	Reverse proxy and TLS termination
GitLab CI	Build and deploy pipeline

Deployment Flow

  GitLab repo (joyflick-kb)
         │
         ▼
  GitLab CI pipeline
    ├── Build Docusaurus static site
    ├── Build Docker image
    └── Push to container registry
         │
         ▼
  Docker Swarm cluster
    ├── Traefik (reverse proxy, TLS)
    └── KB service (Docusaurus container)
         │
         ▼
  knowledge.joyflick.com

Pipeline Triggers

The CI pipeline runs on pushes to main. The pipeline builds the Docusaurus site, packages it into a Docker image, and deploys it to the Swarm cluster.

Portainer

Portainer provides a web UI for managing the Docker Swarm services. It is used for:

• Monitoring container health
• Viewing logs
• Manual service updates if needed
• Stack management

Traefik

Traefik handles:

• HTTPS termination (Let's Encrypt or managed certificates)
• Routing requests to the KB container
• Health checks

What This Infrastructure Is NOT

To be explicit about what this deployment stack does not cover:

• joyflick.com — the production gaming platform (Next.js on Elympics infrastructure)
• Game servers — *-gs.elympics.ai regions (Elympics cloud)
• Game hosting — *.elympics.host and hosting-bucket.elympics.ai (Elympics CDN)
• Authentication — privy.joyflick.com (Privy SaaS)
• Blockchain settlement — USDC on Base
• Analytics — Google Analytics, Sentry, Firebase, Hotjar (third-party SaaS)

None of the above run on Docker Swarm or are managed via Portainer/Traefik.