loganhan123/dcss-webtiles repository overview

⁠DCSS webtiles

Dungeon Crawl Stone Soup⁠ 0.34.1 webtiles server in a single container. Play the roguelike in a browser, with 2x (xBR) tile sheets served automatically to high-DPI screens.

• Live server: https://crawl.han.life⁠
• Source: https://github.com/logan-han/dcss-webtiles⁠

⁠Tags

• latest, 0.34.1: the current build of DCSS 0.34.1
• sha-<commit>: the build of a specific commit

Images are multi-arch: linux/amd64 and linux/arm64.

⁠Quick start

mkdir -p data
docker run -d --name dcss -p 8080:8080 --user "$(id -u):$(id -g)" -v "$PWD/data:/data" loganhan123/dcss-webtiles

Open http://localhost:8080⁠ and register an account.

⁠Configuration

• Port 8080 serves the lobby and the game WebSocket. Put a TLS reverse proxy in front of it for public use.
• HTTP_XHEADERS=true makes webtiles log the client IP from X-Real-IP. Only set it behind a proxy that overwrites that header, otherwise clients can fake their address.
• /data holds everything that persists: accounts, settings, rc files, saves and morgues. It must be writable by the container user (uid 1000 unless you pass --user).
• Games in the lobby: normal, seeded, sprint and tutorial.

⁠Compose with automatic HTTPS

compose.yaml:

services:
  dcss:
    image: loganhan123/dcss-webtiles:latest
    restart: unless-stopped
    user: "1000:1000"  # owner of ./data
    environment:
      HTTP_XHEADERS: "true"
    volumes:
      - ./data:/data
  caddy:
    image: caddy:2
    restart: unless-stopped
    ports: ["80:80", "443:443", "443:443/udp"]
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      - caddy_data:/data
volumes:
  caddy_data:

Caddyfile:

crawl.example.com {
    reverse_proxy dcss:8080 {
        header_up X-Real-IP {remote_host}
    }
}

⁠Licence

Dungeon Crawl Stone Soup is GPL-2.0-or-later. The build files and patches are in the GitHub repo.