stremio/docs/deployment.md
Jos Vooges | STH a5c6fd5fe4 Initial commit: Distributed Stremio Media Cluster V1
Master API, Admin UI, Go media-node, Docker/Dokploy deploy configs.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-25 00:17:04 +02:00

1.5 KiB

Deployment guide

Master (Ubuntu + Docker)

sudo mkdir -p /opt/media-master
# Kopieer de repo naar /opt/media-master

cd /opt/media-master
cp deploy/master/.env.example deploy/master/.env
nano deploy/master/.env   # SESSION_SECRET, ADMIN_*, PUBLIC_URL, TMDB_API_KEY

cd deploy/docker
docker compose up -d --build

Services:

  • master-api → :3000
  • admin-ui → :3001
  • postgres, redis

Backup:

bash deploy/master/backup.sh /opt/media-master/backups

Media Node (Ubuntu, geen Docker)

# Build op CI/build host:
cd node/media-node
GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o media-node-linux-amd64 ./cmd/media-node

# Op de node:
sudo cp media-node-linux-amd64 /usr/local/bin/media-node
sudo chmod +x /usr/local/bin/media-node
sudo media-node install

Installer vraagt om:

  1. Master URL
  2. Node name
  3. Public stream URL
  4. Movies directory
  5. Series directory
  6. Enrollment token (uit Admin UI)

Daarna:

sudo systemctl status media-node
media-node diagnostics

Stremio

  1. Admin UI → Instellingen → Addon token genereren
  2. In Stremio: Community Addons → URL
    https://master.media.example.com/stremio/<token>/manifest.json

Checklist productie

  • Sterke SESSION_SECRET (≥ 32 chars)
  • Sterk admin-wachtwoord
  • HTTPS via NPM op Master + alle Nodes
  • Node firewall: alleen NPM → :8080
  • TMDB API key (optioneel, betere metadata)
  • Backups van PostgreSQL gepland