{"repo":"neonwatty/kamal-quake","free":true,"listed":false,"github":"https://github.com/neonwatty/kamal-quake","clone":"git clone https://github.com/neonwatty/kamal-quake.git","description":"A simple recipe for self-hosting quakejs in an https-friendly manner using kamal.","language":"Ruby","stars":21,"topics":["docker","kamal","kamal2","quakejs"],"license":null,"category":"deployment-docker-iac","readme_excerpt":"kamal-quake A simple recipe for self-hosting quakejs with HTTPS and multiplayer support using Kamal 2. Kamal handles the reverse proxy, SSL certificates via Let's Encrypt, and Docker deployment automatically. Join us on Discord to discuss further improvements, new features, and game times! Read the backstory: Claude Code Helped Me Bring Quake to the Browser with HTTPS and Multiplayer — how AI pair programming helped finally ship this stalled project. Quick Start 1. Prerequisites - A VPS with at least 1GB RAM - A domain pointing to your VPS IP - Docker registry (GitHub Container Registry, Docker Hub, etc.) - Ruby installed ( gem install kamal ) 2. VPS Setup SSH into your VPS and configure Docker permissions: Open these firewall ports: - 443 - HTTPS traffic - 27961 - WebSocket multiplayer 3. Configure Clone this repo and edit config/deploy.yml : Set your registry token in .kamal/secrets : 4. Deploy Visit https://your-domain.xyz to play! Architecture Kamal-proxy handles SSL termination. The container runs a WSS proxy on port 27961 that terminates TLS using the same certificates and forwards to the internal game server. Multiplayer Starting a Game 1. Visit your URL - you'll see the asset download screen 2. Once loaded, press Escape to open the menu 3. Navigate to Multiplayer → Create a game Joining a Game New players are automatically connected to active games. If not, press Escape → Multiplayer → Select the game. Troubleshooting Stuck on loading screen? Check firewall ports 443 ","default_branch":null,"files":null,"tree":[],"storefront":"/r/neonwatty","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/neonwatty/kamal-quake/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}