What the server program actually does
It hosts one game at a time and then starts over. OpenRA's own wiki describes the dedicated server as a console application with no interface: players join its lobby, play a match, and when the match ends the program opens a fresh lobby by itself. If everybody leaves a match in progress, it shuts that game down and starts a new instance, so a forgotten game never blocks the slot.
Three mods come with the engine: ra (Red Alert), cnc (Tiberian Dawn) and d2k (Dune 2000). A server runs one mod. For two mods, or two lobbies of the same mod, you start two copies on two different ports.
The project publishes no hardware figures for the server. Plan the machine around how many lobbies you want open at once and what else will share the box.
The settings worth knowing before you launch
Every setting is passed as Server.Setting=value after the program name. Most of these are set by the official launch scripts; the defaults are from the release-20250330 source:
| Setting | Default | What it controls |
|---|---|---|
Server.Name | Dedicated Server (in the script) | The name shown in the server browser |
Server.ListenPort | 1234 | The TCP port players connect to |
Server.AdvertiseOnline | True | Whether the game is reported to the public server list |
Server.Password | empty | A password players must enter to join |
Server.RequireAuthentication | False | Only players signed in with an OpenRA forum account may join |
Server.ProfileIDWhitelist | empty | If set, only these forum profile IDs may join |
Server.ProfileIDBlacklist | empty | Profile IDs that are always turned away |
Server.EnableSingleplayer | False | Lets one person start a game against bots |
Server.RecordReplays | False | Saves a replay of every game played |
Server.MapPool | empty | A comma-separated list of map uids the lobby may use |
Server.FloodLimitJoinCooldown | 5000 | Milliseconds before a new arrival can chat |
Server.Ban takes a comma-separated list of IP addresses that may not join, and Server.EnableVoteKick (on by default) lets players vote someone out. To fix a starting map, Server.Map takes the map's hash, which the utility mode prints with --map-hash followed by the .oramap file.
Up and running in one sitting
The quickest route on Linux is the official AppImage for your mod. Its launcher has a --server switch that starts the dedicated server instead of the game, with the mod already chosen. These steps assume Ubuntu 24.04 and the Red Alert AppImage from the release-20250330 assets; swap in the Tiberian Dawn or Dune 2000 file for those mods.
- Create an ordinary user for the server and work as that user. Nothing here needs root except the package install and the firewall.
- AppImages need FUSE 2. On Ubuntu 24.04 the package is
libfuse2t64:sudo apt install libfuse2t64. If you would rather not install it, the AppImage project documents--appimage-extract-and-runas a fallback. - Download
OpenRA-Red-Alert-x86_64.AppImagefrom the OpenRA releases page on GitHub, then make it executable withchmod +x OpenRA-Red-Alert-x86_64.AppImage. - Allow SSH, then the game port, and only then enable ufw (commands below). ufw applies the same rules to IPv6 as long as
IPV6=yesis left in/etc/default/ufw. - Create the support directory with
mkdir -p ~/.config/openra, then put the password in~/.config/openra/settings.yamlunder aServer:line, with a tab-indentedPassword: your-long-passwordline beneath it. Runchmod 600 ~/.config/openra/settings.yamland start the server as in the second block below. Watch for the line that says it is starting a dedicated server for your mod. - Join from your own OpenRA client before you share the address, so that the admin seat is yours.
sudo ufw allow 22/tcp
sudo ufw allow 1234/tcp
sudo ufw enable
sudo ufw status verbose
./OpenRA-Red-Alert-x86_64.AppImage --server Server.Name="Friday Night Red Alert" Server.ListenPort=1234 Server.RecordReplays=True
Settings in settings.yaml are read at start-up, and anything also given on the command line overrides them. Keep the password out of the command line, where other users can see it in the process list, and never reuse a password that guards anything else.
On Windows, the wiki points to the launch-dedicated.cmd script: for an installed build you remove the bin\ prefix from the server path and change Engine.EngineDir from .. to . before running it.
Getting your lobby onto the public list
With Server.AdvertiseOnline=True, the server reports itself to OpenRA's master server and refreshes the listing every three minutes, and sooner when the lobby changes. On the first report it writes the master server's answer to dedicated-server.log in the Logs folder of its support directory, and passes the result to the players in the lobby as a chat notice.
- Server port is not accessible from the internet means the master server could not reach your port. Check the firewall rule and that
Server.ListenPortmatches it. - Server name contains a blacklisted word means the listing was refused because of the name. Pick another.
- Game has not been advertised online follows a refusal like the two above: the game still runs, and players can join by typing your address directly. If the master server cannot be reached at all, the notice reads Master server communication failed instead.
The program listens on both IPv4 and IPv6 for the same port, which is why the firewall rule has to cover both. Each time a game ends and a fresh lobby opens, the server asks the master server to drop the old listing. Stopping the program sends nothing, so its last listing stays public until the master server expires it a few minutes later.
Keeping the admin seat and the lobby yours
The wiki is plain about it: the first client to connect becomes the lobby admin, and if the admin leaves, the role passes to whoever has been there longest. An open server with no password hands control to the first stranger who finds it.
- For a private group, set
Server.Password, or setServer.RequireAuthentication=TruewithServer.ProfileIDWhitelistlisting your players' forum profile IDs. - For a public server, accept that the admin seat rotates, and use
Server.MapPool,Server.Banand vote kicks to shape what people can do. - To fix lobby options such as starting cash or the tech level for everyone, the wiki's lock-settings guide adds a
server-overrides.yamlrules file to the mod. - A message of the day goes in
motd.txtin the support directory, which is~/.config/openraon Linux.
Running it well week after week
Run the release your players run: when a new stable release lands, replace the AppImage, restart, and tell your group to update.
- Logs: the server writes
dedicated-server.login theLogsfolder of its support directory (~/.config/openra/Logson Linux). - Staying up: the program opens a new lobby after each match on its own, but nothing restarts it if the process itself stops. Run it in a tmux session, or as a systemd service with
Restart=on-failure, enabled withsystemctl enable --nowso it starts today and after every reboot. - Backups: copy the support directory, with its settings, message of the day and any recorded replays, to somewhere other than the server.
- Updates: apply your system's security updates; the game port is the only thing the server needs open besides SSH.
The machine that fits, and when it does not
One OpenRA lobby is a small job. A whole server earns its place when you want several lobbies, several mods, or OpenRA beside other game servers your community plays, all on one box that nobody else shares. Our game server line ranks processors by single-thread score, because a game's main loop leans on one core, and every machine on it comes with root access, one IPv4 address and IPv6, and an unmetered port not shared with any other customer at the access switch.
For a handful of OpenRA lobbies, the four-core Intel Xeon E3-1585L v5, our suggested start for a group of friends and sold in all five of our cities, is plenty. Choose the city closest to most of your players on the locations page, which times each one from your own browser. A machine already in the rack is handed over about 30 minutes after the order is approved; the payment check comes first and is the part that varies. Billing is monthly with no contract, and the full range is on the dedicated servers page.
If a single lobby for a few friends is all you need, a whole machine is more than the job asks for, and there is no game panel here: you install and update OpenRA yourself. The same applies to our guides for an OpenTTD dedicated server and a Mindustry server.
Questions people ask
- Which port does an OpenRA server need open?
- TCP 1234 by default, set with
Server.ListenPort. The server listens on that port over both IPv4 and IPv6, so open it for both. - Do my players need the same OpenRA version as the server?
- Plan on it. Run the same release and mod your players run, and update the server when they update. The project recommends the stable release for online multiplayer and offers playtests as previews of upcoming changes.
- Why can't I see my game in the server browser?
- Most often the master server cannot reach your port, and the lobby then reports that the server port is not accessible from the internet. Check the firewall rule, check that
Server.AdvertiseOnlineis True, and readdedicated-server.login theLogsfolder of the support directory. Players can still join by typing your address while you fix it. - How do I stop strangers from taking over the lobby?
- Whoever connects first becomes admin, so set
Server.Password, or require forum accounts withServer.RequireAuthentication=Trueand list your players inServer.ProfileIDWhitelist. Join yourself before sharing the address. - Can one machine host Red Alert and Dune 2000 lobbies at once?
- Yes. Start one server per mod, each from its own AppImage and on its own port, and open each port in the firewall.
- Do you install or update OpenRA for me?
- No. You get the whole machine with root access and install the game yourself. If you get stuck, our chat assistant answers in seconds and can check your server, and a person takes over whenever you ask.