Vietcong Docker Container
This Docker container runs a Vietcong (2003) dedicated server. It is built on the WINE image and runs the retail v1.60 dedicated server launcher, vcded.exe -dedicated <file>.ded, under Wine and Xvfb. The container doesn't download the game, so you provide the files.
Quick Start
services:
vietcong:
image: lancommander/vietcong:latest
container_name: vietcong
ports:
- 5425:5425/udp
- 6073:6073/udp
volumes:
- "/data/Servers/Vietcong/Deathmatch:/config"
environment:
VC_SERVER_NAME: "My Vietcong Server"
VC_ADMIN_PASSWORD: "changeme"
user: root
cap_add:
- SYS_ADMIN
security_opt:
- apparmor:unconfined
restart: unless-stopped
Copy a Vietcong v1.60 install (the folder with vcded.exe, game.dll, logs.dll and the vietcong_*.cbf archives) into Server/ before the first start. You can instead set VC_ARCHIVE_URL to a zip of that folder.
How It Starts
PostInitialization/10-InitializeWinePrefix.ps1(from the WINE image) creates the Wine prefix in/config/wineprefix.PostInitializeWinePrefix/20-InstallDirectPlay.ps1runswinetricks directplayonce, using the DirectX redist cached in the image. This installs Microsoft'sdpnet.dlland related DLLs. Vietcong hosts with DirectPlay 8, and Wine's builtindpnetcan't host. A marker file,wineprefix/.lancommander-directplay, records that the install is done. Delete it to reinstall.PostInitialization/20-InstallVietcong.ps1checks forServer/vcded.exe. If it's missing andVC_ARCHIVE_URLis set, the hook downloads the archive.PostInitialization/30-ConfigureVietcong.ps1writesDedicated/<VC_DED_NAME>.dedfrom theVC_*variables (it lands inOverlay/Dedicated/).START_EXE(/usr/local/bin/vc-server) runswine-run vcded.exe [-addon <VC_ADDON>] -dedicated <VC_DED_NAME>.dedfrom the game root and followsdev/chatlog.txtto stdout.
vcded.exe is a GUI program. Without -dedicated it opens the setup dialog (map list, settings, Save/Start). With -dedicated it hosts at once and shows a small status window ("Server info", players, "Exit the game") on the Xvfb display. It writes nothing to stdout. A successful start looks like:
Starting: vcded.exe -dedicated lancommander.ded
2026-11-02 06:03:04.485 - === Loading map : WaterFallDM ===
Configuration Options
Ports
- 5425/udp: Game (DirectPlay host,
VC_PORT). It also answers DirectPlay enumeration. - 6073/udp: DirectPlay enumeration (
dpnsvr). The in-game LAN list uses it.
DirectPlay also opens a few dynamic UDP ports. Giving the container its own LAN address (macvlan/ipvlan) is the most reliable setup. The server binds per interface, so query it on the container's LAN IP rather than 127.0.0.1.
With VC_INTERNET_GAME=true the server also registers with the master server (the bundled logs.dll from VCStarter points at OpenSpy). The community lists UDP 15425 as the query port for that. LAN play doesn't need it.
Environment Variables
See the README for the table, the rotation format and the map/mode list.
Server definition file
The generated file looks like the one vcded's own Save button writes:
// Generated by the LANCommander image from the VC_* settings.
// Delete the line above to keep your own edits.
Server name = Vietcong Server
//Server settings
Friendly fire = 1
Auto balanced teams = 1
Maximum players = 32
Enemy camera = 0
Internet game = 0
Hide server IP = 0
Port number = 5425
Cooperative difficulty = 1
Player respawn method = 60
Weapon respawn limit = 30
Engineers = -1
Medics = -1
Snipers = -1
Radiomans = -1
MachineGunners = -1
ATG mission time = 5
TT mission time = 0
TT respawn time = 0
CTF respawn time = 0
Immortality after respawn = 3
Vietnam mode = 0
Vietnam chat mode = 0
Ammo boxes = 1
Team kill = 3
Team kill ban = 6
Ping kick = 0
Idle player kick = 10
Team booby trap = 1
Hradba enable = 0
Hradba auto update = 0
Hradba upload limit = 5
User-map enable = 1
User-map upload limit = 10
Voice chat = 0
Change map voting = 1
Restart map voting = 1
Password =
Admin password =
Server join message =
//List of missions
Mission = WaterFall, DM, time, 20:00
Any of these keys can be set with VC_SETTINGS (Key = value; Key = value). Times are in minutes, respawn times in seconds, and class limits of -1 mean unlimited. Player respawn method and Weapon respawn limit are in seconds.
The file is regenerated on every start while its first line is the marker comment. Delete that line, or point VC_DED_NAME at a .ded of your own in Overlay/Dedicated/, to manage it by hand.
Hooks
| Hook | When |
|---|---|
PreInstallVietcong / PostInstallVietcong | Around the game file check/download |
PreInitializeWinePrefix / PostInitializeWinePrefix | Around Wine prefix creation (WINE image) |
Put .ps1 scripts in config/Scripts/Hooks/<HookName>/.
Troubleshooting
- The server runs but UDP 5425 is never bound. vcded found a problem in the
.dedfile. It shows a message box ("Can't find map "X" at line N", "Error loading definition file") and waits forever, which you can't see in a container. The configure hook checks base-game maps and modes before starting. A map from an add-on or user map is only warned about, so check its exact name and modes in vcded's setup dialog. If the hook rejectsVC_MISSIONS, it logs the reason and the previous.dedstays in place. - Edits to
Overlay/from the host while the container runs don't show up. OverlayFS caches the upper directory. Restart the container, or edit throughMerged/inside it (docker exec). - Clients can't join. They need v1.60 (
gamever 198). A HradBa server rejects VCStarter clients, so keepVC_HRADBA=falseunless every client runs HradBa. - ALSA "cannot find card" messages in the log are harmless; the server needs no sound device.
- Idle CPU is about 20% of a core (vcded's window loop under Xvfb).