Teeworlds

Teeworlds is a free, open-source retro multiplayer arena shooter where up to 16 players battle in modes such as Team Deathmatch and Capture the Flag.

  • Game Servers
  • Other
  • Tools & Utilities
Teeworlds is a free, open-source retro multiplayer arena shooter where up to 16 players battle in modes such as Team Deathmatch and Capture the Flag. This Docker image provisions a dedicated Teeworlds server with the autoexec.cfg, dm.cfg, tdm.cfg, and ctf.cfg config files preconfigured, so you only need to set the server name and the RCON password. It is aimed at homelabbers who want a low-maintenance home server for a persistent game session with friends, and the container updates itself by simply restarting it when a new game version is released.

Platform availability

Available on 2 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

52/100 Fair

Maintained
23last commit 497 days ago
Popular
682,654 GitHub stars
Easy to install
452 install platforms, install notes, Docker image
Light to run
85512 MB minimum RAM
Security check
71no serious findings, CI, tests, OpenSSF Scorecard 3.6/10

Availability: platform listings confirmed today, links checked 37 days ago

GitHub stars
2,654
Open issues
361
Last commit
2025-07-12
Latest release
0.7.5
Activity
stale

Checked 20 days ago - source: GitHub (teeworlds/teeworlds)

Resources & Compatibility

Minimum requirements: 512 MB RAM. ARM (e.g. Raspberry Pi) is not supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Initial setup The config files autoexec.cfg, dm.cfg, tdm.cfg, and ctf.cfg ship preconfigured; you only need to set the server name and the RCON password in autoexec.cfg. source
  • Updating the server Do not delete the tar.gz file in the container's main directory, as the image relies on it. To update to a newer game version, restart the container and it will download and install the new version automatically. source

Fetched 45 days ago - each note links to its source

Alternatives (1)

  • Armajet - Armajet is an accessible, free-to-play multiplayer shooter designed for mobile that pits teams of players against each other in fast-paced…

Checked 52 days ago - source: AlternativeTo

Common questions

How can I troubleshoot common Teeworlds server issues like lag or crashes?

Make sure the server meets the recommended minimum configuration for typical use cases. This helps avoid common problems such as lag, crashes, and long loading times.

Where can I find rules for hosting a Teeworlds server?

The official documentation and FAQ area includes server hosting rules, support rules, and client settings guidance.

What should I check if the Teeworlds client fails to start on first launch?

Check that you have the latest graphics card drivers installed. Teeworlds uses OpenGL for acceleration.

How many players can Teeworlds support in a match?

Teeworlds supports up to 16 players in modes such as Team Deathmatch and Capture The Flag.

Can I use maps I create myself in Teeworlds?

Players can design their own maps for Teeworlds.

Answers sourced from github.com, teeworlds.com, www.reddit.com, www.reddit.com, www.teeworlds.com

Community

Collected 53 days ago - public community threads