UT2004 Server

Docker image for a dedicated Unreal Tournament 2004 server that downloads all game files on first launch and runs as a non-root user.

  • Game Servers
  • Other
  • Tools & Utilities
Docker image for a dedicated Unreal Tournament 2004 server that downloads all game files on first launch and runs as a non-root user.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • 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.

64/100 Good

Maintained
73last commit 74 days ago
Popular
3448 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
100128 MB minimum RAM
Security check
85no serious findings, CI

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

GitHub stars
48
Open issues
4
Last commit
2026-09-07
License
GPL-3.0
Activity
stale

Checked 18 days ago - source: GitHub (PhasecoreX/docker-ut2004-server)

Resources & Compatibility

Minimum requirements: 128 MB RAM, 5.5 GB disk. ARM (e.g. Raspberry Pi) is not supported.

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

First-install notes

  • First launch The container downloads the UT2004 server files, ECE Bonus Pack, Official Megapack, and CSS/UWeb UTF-8 fixes on first launch; an updater system handles subsequent updates without redownloading unchanged files. source

Fetched 38 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Does the container need the game files before first launch?

No. It downloads the UT2004 server v3369_2, ECE Bonus Pack, Official Megapack, CSS fixes, and UWeb UTF-8 fixes on first launch. All of it is placed in the mounted /data directory.

What volume and port configuration is required to run it?

Mount a persistent volume at /data or the container will not start. Also publish port 7777/udp so game clients can reach the server.

How do I provide the UT2004 server CD key?

Set CD_KEY to your server key for the first run, or put a cdkey file in /data/config. Once the cdkey file exists, you can omit the CD_KEY environment variable.

Where do I add custom maps and mutators?

Extract them into /data/addons while preserving the same layout as the server folder. Then restart the server to load them.

Will updating the image overwrite my server .ini files?

No. The updater does not overwrite .ini files because they are stored in /data/config.

Answers sourced from github.com

Community

Collected 53 days ago - public community threads