master server used for Aurora clients based on the DP Master Server (ID Tech) protocol. originally built by XLabsProject and maintained by AlterWare until archived
default port is 20810/udp. pass a different port as the first argument (example: alterware-master 20811)
set AW_STATS_LOCATION to a file or folder and the master writes stats.json there every 5 minutes. leave unset to skip stats
download windows-x64-release-msvc from the build artifacts and run it:
set AW_STATS_LOCATION=C:\stats\stats.json
alterware-master.exe
allow 20810/udp through windows firewall and forward it on your router
download linux-static-amd64-release (or linux-static-arm64-release). it runs on any distro:
chmod +x alterware-master
./alterware-master
open the port:
- ubuntu/debian:
sudo ufw allow 20810/udp - arch/fedora:
sudo firewall-cmd --permanent --add-port=20810/udp && sudo firewall-cmd --reload
put the binary in /opt/master-server and create /etc/systemd/system/master-server.service:
[Unit]
Description=Aurora Master Server
After=network.target
[Service]
Type=simple
ExecStart=/opt/master-server/alterware-master
WorkingDirectory=/opt/master-server
Environment="AW_STATS_LOCATION=/var/www/<domain name>/html/stats.json"
StandardOutput=null
Restart=on-failure
RestartSec=10
KillMode=process
User=<username>
Group=<group name>
[Install]
WantedBy=multi-user.target
then start it:
sudo systemctl daemon-reload
sudo systemctl enable --now master-server
the working directory must be writable (the master saves its keys there)
docker run -p 20810:20810/udp -e AW_STATS_LOCATION=<path> alterware/master-server:latest
to keep stats on the host, mount a writable host folder into the container
you need Git and Premake5 5.0.0-beta8 or newer (download)
git clone --recursive https://github.com/auroramod/master-server.git
cd master-server
needs Visual Studio 2022 with "Desktop development with C++"
premake5 vs2022
msbuild /m /p:Configuration=release /p:Platform=x64 build/alterware-master.sln
output: build/bin/x64/release
needs docker
premake5 --linux-static gmake
docker run --rm -v "$PWD:/src" -w /src alpine:3.20 sh -c "apk add --no-cache build-base linux-headers && make -C build config=release_amd64 -j$(nproc)"
output is in build/bin/amd64/release (use release_arm64 on arm64)
install clang:
- ubuntu/debian:
sudo apt install build-essential clang lld - arch:
sudo pacman -S --needed base-devel clang lld - fedora:
sudo dnf install gcc-c++ clang lld make
premake5 --cc=clang gmake
make -C build config=release_amd64 -j$(nproc)
output is in build/bin/amd64/release