Conquer is a multiplayer strategy game from Usenet, 1987: a fantasy world, nations, armies, one turn at a time. Conquer Web runs it in a Docker container, shows its terminal in the browser (ttyd) behind Apache with HTTPS, and adds what a public server needs: a home page with the live game state, a practice game that runs in the visitor's browser, player accounts with requests approved by the administrator, turn updates on a schedule, seasons with a hall of fame, backups and notifications.
| Server | What is there |
|---|---|
| conquer.vejeta.com | The live game, run by the author of this project: a shared world with scheduled turns. Try it with no account (a practice world in your browser); to join, ask for your seat on the home page and the administrator approves it. In English, Spanish, German, Portuguese, Polish, Russian and Chinese. |
Running your own server? Open a pull request to add it here.
![]() |
![]() |
![]() |
| Trailer 40 seconds: what Conquer is |
Found your nation the game's own builder, step by step |
Your first turn the narrated tutorial |
The videos are narrated in all seven languages, with captions: the site
plays each visitor's own (web/tutorial/<video>.<language>.mp4, made by
tools/tutorial/video.py).
- Ask for a seat on the home page (I want to play,
/signup.html): an account name and a password (no email is asked, none is kept). With an invite code from the administrator the seat is approved at once. - Wait for the administrator, who approves the request at
/admin/. - Press Play now and sign in with that account: the terminal menu has the game's nation builder found your nation (at any turn).
- Play: option 1 of the menu, then your nation password. Your orders are resolved at the next turn update (the home page shows the schedule in your own time zone).
- Learn at any time: the practice world at
/try/(no account), the tutorial, the Coach button above the game and the player's guide (/guide.html).
For development, on your own machine (Docker and docker-compose; Apache runs in a container, with a self-signed certificate):
./setup-environment.sh # choose 1, Local development
./start-local.sh # https://conquer.local (accept the certificate warning)The administrator's web account is made from TTYD_USERNAME/TTYD_PASSWORD
in config/local.env on the first start. Then ./logs.sh, ./health-check.sh,
./rebuild.sh --quick (after changing config/local.env) and ./stop.sh
manage it, and ./manage-players.sh, ./run-turn.sh and ./add-nation.sh
work as on a server.
Running a public server (Debian VPS with Apache and Docker):
- DEPLOYMENT.md is the runbook: first install, updates, every setting, the Apache virtual host, email notifications, players and requests, seasons, backups, the god password and troubleshooting.
- QUICK-REFERENCE.md is one screen of the commands an administrator types every day.
- Who is an administrator: only an account marked
*indata/lib/.players, set on the server withsudo ./manage-players.sh assign NAME --admin(oradd NAME --admin), or at/admin/by an existing administrator.sudo ./manage-players.sh listshows them. Visiting a page never makes anyone one. - SECURITY.md covers hardening (fail2ban, rate limits, headers).
Conquer is a hobby project and the game is free, with no ads. If you want to
help pay for the servers you can give through Liberapay:
liberapay.com/Conquer. The site shows
a small "Support the servers" link in the footers of the home page and the
Hall (never inside the Android app). The address lives in one place,
DONATE_URL in web/site.js; to change it edit that line (and this section).
Donations are voluntary and give nothing in return; Liberapay is a separate
controller for its own data and we receive no payment data.
Every page takes its colours, fonts and spacing from one stylesheet, web/theme.css: green phosphor over the mountains, with a phosphor per race (data-race on <html>: human, elf, dwarf, orc, chosen in the game's options or read from the nation's own screen by web/race.js) and parchment (data-theme="parchment") for the long reading pages. web/design.html is the living style guide (linked from every footer as "Design"): open it to see every component. The game screen's frames are raster artefacts baked by python3 tools/arch/bake.py from the shapes in tools/arch/src; the map texture at the page edges comes from python3 tools/hero/build-bg.py. Pages add layout only, never colours: a browser test fails on any colour literal in a page.
| Where | What |
|---|---|
| DEPLOYMENT.md, QUICK-REFERENCE.md, SECURITY.md | Running a server |
/guide.html on the site (web/guide.html) |
The player's guide: history, workflow, advice, tournament formats |
| tests/README.md | The tests and how CI runs them |
| web/i18n/README.md, conquer/i18n/README.md | Adding a language (pages, terminal menu) |
| tools/tutorial/README.md, tools/hero/README.md | The tutorial and videos; the home page map |
| wasm/README.md | The practice game in WebAssembly |
| conquer/patches/README.md | Fixes applied to the game engine at build time |
conquer/ game image: Dockerfile, engine patches, default world, menu and turn scripts, sign-up service (gate), translations
web/ the site: home page, guide, tutorial, sign-up, /admin/, game page, /try/ (WebAssembly)
vps/ Apache virtual host template and systemd unit for a VPS
apache/ Apache container of the local setup
config/ environment templates (production.env, local.env, backup.env)
tools/ wasm/ tutorial and video builders, check-i18n.py, WebAssembly build
tests/ pytest suites (see tests/README.md)
*.sh administration scripts (see QUICK-REFERENCE.md)
data/ live world, accounts, backups and practice worlds (created at run time, not in git)
Fork, make a branch, run the checks, open a pull request:
shellcheck -S warning -x -P conquer/scripts ./*.sh conquer/scripts/*.sh conquer/i18n/*.sh
python3 tools/check-i18n.py
python3 -m pytest -m "not browser and not game"GPL v3 or later; see LICENSE.md. The game is Conquer, with thanks to ttyd, Docker and Let's Encrypt.


