# UT2004 Server

UT2004 Server is a self-hosted game servers app. Docker image for a dedicated Unreal Tournament 2004 server that downloads all game files on first launch and runs as a non-root user. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1578/ut2004-server

## Description

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.

## Health score

64/100 (Good), based on 5 of 5 factors.
- Maintained: 73 (last commit 74 days ago)
- Popular: 34 (48 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 100 (128 MB minimum RAM)
- Security check: 85 (no serious findings, CI)

## Links

- Docker Hub: https://hub.docker.com/r/phasecorex/ut2004-server
- GitHub: https://github.com/PhasecoreX/docker-ut2004-server
- Unraid: https://ca.unraid.net/apps/ut2004-server-0p4bma11aukze5?q=ut2004-server

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/1578/ut2004-server), the self-hosted and open-source app directory.
