Homelab MapleStory Operations
Homelab MapleStory Operations
Operational guide for running MapleStory servers on the homelab.
Server Stack
All on CT125 (workhorse/gpu01):
| Server | Version | Docker | Domain |
|---|---|---|---|
| CosmicMS | v83 | ✅ | — |
| BunsMS 🍑 | v83 | ✅ | buns.asslorde.com |
| Valhalla | v28 | ❌ (/opt/valhalla) | — |
Service Ports (CT125)
| Port | Service |
|---|---|
| 7575-7577 | Game server range (Docker) |
| 9494 | BunsMS game server (Docker, mapped to internal 8484) |
| 3001 | Buns dashboard web UI (Docker) |
| 3309 | Buns MySQL (Docker) |
| 8080 | Buns web client proxy |
| 8081 | Buns web client proxy (dev) |
| 3306 | MariaDB (localhost only) |
Docker Containers
buns-server-1— Game serverbuns-dashboard-1— Dashboard web UIbuns-db-1— MySQL 8.4 database
Auto-Registration
All servers have auto-registration ON. No separate “register online” flow needed — entering any username/password at login creates the account transparently.
Docket Port Quirk
Docker internal ports MUST be mapped 1:1. If the game server listens on port 9494 internally, it must be mapped to 9494 on the host. Translations cause packet issues.
WebSocket Proxy
Browser clients (e.g., the WASM client) need a WebSocket proxy to bridge browser → TCP game connection.