Self-hosting

Node/PM2, Docker Compose, or k8s. Forks use the same files.

Node / PM2

pnpm install, .env.example → .env, set TOKEN + MONGO_URI. See repo README.

Dashboard split:

• bot: FLUXY_PROCESS=bot API_ENABLED=false → node build/index.js
• web: FLUXY_PROCESS=web API_ENABLED=true → node build/api/standalone.js

API_ADMIN_TOKEN on both. BOT_INTERNAL_URL defaults to http://127.0.0.1:4001.

Docker Compose

cp .env.docker.example .env
docker compose up -d --build

Port 4000. Dockerfile + docker-compose.yml in repo root.

Kubernetes

k8s/base/ — mongo, bot, web, ingress.

cp k8s/base/secret.example.yaml k8s/base/secret.yaml
kubectl apply -f k8s/base/secret.yaml
kubectl apply -k k8s/base/

Image: git.fluxy.gay/dog/fluxy:latest from CI. Forks change kustomization.yaml.

docs/K8S.md, docs/FLUXERHOST.md for detail.

k8s/docker env overrides:

Variable	Value
BOT_INTERNAL_BIND	0.0.0.0
GATEWAY_SESSION_PATH	/data/.gateway-session.json
MONGO_URI	mongodb://mongo:27017/fluxy

Bot: 1 replica only.