Runnable Sudoku Shift container (Game Off 2026) with configurable Centrifugo WebSocket URL
3.1K
Runnable Docker container for Sudoku Shift — a zero-backend 9×9 and 6×6 Sudoku SPA with real-time Co-op and Spectator mode, built with React 19, Vite 8, and Nginx (port 8000).
Created for GitHub Game Off 2026.
Solo mode works out of the box. For live Co-op and Watch/Spectator mode, a Centrifugo v6 WebSocket server is required and can be passed directly via Docker environment variables.
docker run -d \
--name sudoku-shift \
-p 8000:8000 \
-e WS_URL="wss://your-centrifugo-host/connection/websocket" \
hapheus/sudoku-shift:latest
Then open http://localhost:8000.
services:
app:
image: hapheus/sudoku-shift:latest
restart: unless-stopped
ports:
- "8000:8000"
environment:
WS_HOST: "localhost"
WS_PORT: "8081"
WS_SCHEME: "http"
# Or set the full WebSocket URL directly:
# WS_URL: "wss://sudoku-ws.example.com/connection/websocket"
centrifugo:
image: centrifugo/centrifugo:v6
restart: unless-stopped
ports:
- "8081:8080"
volumes:
- ./docker/centrifugo/config.json:/centrifugo/config.json:ro
environment:
CENTRIFUGO_CLIENT_ALLOWED_ORIGINS: "*"
See
docker/centrifugo/config.json in the repository for the required Centrifugo namespace configuration (sudokuandapp).
At container startup, entrypoint.sh writes /usr/share/nginx/html/env-config.js so one image works across environments without rebuilding:
| Variable | Description | Example |
|---|---|---|
WS_URL | Full Centrifugo WebSocket endpoint (overrides WS_HOST/WS_PORT/WS_SCHEME) | wss://sudoku-ws.example.com/connection/websocket |
WS_HOST | Centrifugo hostname | localhost |
WS_PORT | Centrifugo port | 8081 |
WS_SCHEME | http (ws://) or https (wss://) | https |
PUBLIC_APP_URL | Optional public base URL for share/invite links | https://sudoku.example.com |
Content type
Image
Digest
sha256:fbd3574fb…
Size
66.1 MB
Last updated
7 minutes ago
docker pull hapheus/sudoku-shift