Difference between revisions of "Server Hosting"

Latest revision as of 09:27, 19 September 2025

	How to host a public or private Holdfast server on Windows or Linux (Steam client, SteamCMD, Docker)

Server Hosting

The following documentation details how to host a public or private game server for Holdfast: Nations At War. The game offers an anonymous dedicated server for both Linux and Windows.

Quick Start Guide

For rapid local testing before hosting publicly:

Acquire files: Install Holdfast: Nations At War - Dedicated Server from your Steam library (Tools section).
Configuration: Modify the default map rotation file, which is located in (serverconfig_default.txt).
Launch: Start the server using the provided launch script: LaunchServer.ps1 (Windows) or LaunchServer.sh (Linux).
Connect: In the Holdfast game, go to the server browser, click Join Custom Server, and then click the top Connect button (leaving the address as Localhost unless you changed the port).
⚠️ Important: To allow other players to connect, you must configure port forwarding on your router and open the necessary UDP ports in your local firewall.

Prevent Overwrites on Update

💾 Game updates often overwrite the default launch script and configuration file. To prevent this, always create copies of these files and use the copies for your custom server:

Duplicate serverconfig_default.txt to a custom name (e.g., serverconfig_myname.txt).
Duplicate the launch script (e.g., LaunchServer.ps1 to LaunchServer_myname.ps1).
Edit your custom launch script to point to your custom config file.

Windows Server Hosting

Obtaining the game files

Obtaining the Game Files

You can acquire the dedicated server files using one of two methods:

1. Steam Client (Recommended)

This is the easiest method if you have Steam installed:

Open your Steam Library.
Use the filter to select Tools (or search for Holdfast and tick the Tools box).
Install Holdfast: Nations At War - Dedicated Server.
Once installed, right-click the app → Manage → Browse local files to access the server folder.

Steam application to download

Browse local files in Steam

2. SteamCMD

SteamCMD is a command-line utility used to install and update dedicated servers.

Download and set up SteamCMD.
Run the following command, replacing [LOGINNAME] and [PASSWORD] with your Steam credentials:

steamcmd +login [LOGINNAME] [PASSWORD] +force_install_dir "C:\holdfastser

Note: The account used must own the game; anonymous login will fail.
If the server has issues, run the command again with validate to verify files: +app_update 589290 validate.

Basic Configuration & Starting

Holdfast merged server & game files folder structure

The server files include example configs. See Server Configuration for all options.

Basic Configuration & Starting

Duplicate Files: Following the warning above, make copies of the default files:

serverconfig_default.txt → serverconfig_newserver.txt
LaunchServer.ps1 → LaunchServer_newserver.ps1

Edit Configuration (serverconfig_newserver.txt): Set up your ports and server details. Both ports must be unique for each server instance.

|Server & Steam Ports|
server_port 20100
steam_query_port 27000

|Basic variables|
server_name My Custom Server
server_region europe
#server_admin_password defaultAdminPWReplace (Uncomment and replace)
#server_password mypassword (Uncomment for private server)

Action: Ensure the server_port and steam_query_port (UDP) are open in your Windows firewall and have corresponding port forwarding rules on your router. The steam_query_port is what allows the server browser to display information like player count and map. Update Launch Script: Edit your custom launch script (LaunchServer_newserver.ps1) to ensure the arguments point to your custom config file:

# LaunchServer_newserver.ps1 - Example arguments
$args = '-s -r --serverConfigFilePath "serverconfig_newserver.txt" --outputLog "logs_output\outputlog_newserver.txt" ...'
Start-Process -FilePath "vapuriloadtester.exe" -Verb RunAs -ArgumentList $args

Start Server: Run LaunchServer_newserver.ps1 to start the server process.

Linux Server Hosting

Docker Setup (Recommended)

🐳 Using the official Docker image simplifies installation, maintenance, and updates:

Basic Installation: This command runs the server and uses the host network to automatically map required ports.

docker run -d --net=host --name=holdfastnaw-dedicated cm2network/holdfastnaw

Custom Ports: To run multiple instances, you can specify custom ports using environment variables:):

docker run -d --net=host -e SERVER_PORT=20100 -e STEAM_QUERY_PORT=27000 --name=holdfastnaw-dedicated cm2network/holdfastnaw

Docker Hub: https://hub.docker.com/r/cm2network/holdfastnaw/

Note: The container automatically checks for updates on start. You must restart the container after a game update to apply it. The configuration files are located inside the container at /home/steam/holdfastnaw-dedicated/.

Manual Setup

If you are not using Docker, you can manually set up the server using SteamCMD.

Install SteamCMD, then run the following to download the dedicated server files (App ID 1424230):

steamcmd.sh +login anonymous +force_install_dir /opt/holdfastserver +app_update 1424230 +quit

Note: Use +app_update 1424230 validate later to verify the files if needed.

Basic Configuration & Starting the Server (Manual)

Duplicate Config: Navigate to the server directory and copy the default config:

cd /opt/holdfastserver
cp serverconfig_default.txt serverconfig_myserver.txt

Edit Config (serverconfig_myserver.txt): Configure your ports and server details as detailed in the Windows section (setting server_port and steam_query_port).

cd /opt/holdfastserver
./Holdfast\ NaW \
-startserver -batchmode -nographics \
-screen-width 640 -screen-height 480 -screen-quality "Fastest" \
-framerate "120" --serverheadless \
-serverConfigFilePath "serverconfig_myserver.txt" \
-logFile "logs_output/outputlog_server.txt" \
-logArchivesDirectory "logs_archive/" \
-p "20100"

Note: Replace "serverconfig_myserver.txt" with your actual config file name and verify the port -p "20100" matches your configuration file.

Start Server: Execute the main game file with required arguments. This uses the -startserver flag and runs in a headless, no-graphics mode for stability:

"./Holdfast NaW" -startserver \
  -batchmode \
  -nographics \
  -screen-width 640 \
  -screen-height 480 \
  -screen-quality "Fastest" \
  -framerate "120" \
  --serverheadless \
  -serverConfigFilePath "serverconfig_myserver.txt" \
  -logFile "logs_output/outputlog_server.txt" \
  -logArchivesDirectory "logs_archive/" \
  -p "20100"

server_name My Server server_region europe # server_admin_password defaultAdminPWReplace

server_password mypassword

Tools

Edit body (VE)
Edit body (source)
Body history
Last body edit: EXPRI3ST — 2025-10-12 00:45 \1760229902\UTC\C
—
Edit wrapper (VE)
Edit wrapper (source)
Wrapper history
What links here
Changes to linked pages
Purge cache

@@ Line 1: / Line 1: @@
-The following documentation details how to host a public or private gameserver for [[Holdfast: Nations At War]]. The game is currently in its Alpha stage and therefor doesn't have a dedicated server steamappID. The only officially supported game build is currently compiled for Windows x64, this means that hosting a server on Linux requires library-level virtualization (e.g. [https://www.winehq.org/ Wine]).
+{{DISPLAYTITLE:Server Hosting}}
+{{ContentTemplateModernInline
+ | welcome            = [[File:Forum Logo.png|link=|left|alt=Server Hosting]]
+ | blurb              = How to host a public or private Holdfast server on Windows or Linux (Steam client, SteamCMD, Docker)
+ | sections_title     = On this page
+ | sections_content   =
+* [[#Quick Start Guide|Quick Start Guide]]
+* [[#Windows|Windows]]
+** [[#Obtaining the game files|Obtaining the game files]]
+*** [[#Download using Steam Client|Download using Steam Client]]
+*** [[#Download using SteamCMD|Download using SteamCMD]]
+** [[#Basic Configuration & Starting the Server|Basic Configuration & Starting the Server]]
+* [[#Linux|Linux]]
+** [[#Docker|Docker]]
+** [[#Manual Setup|Manual Setup]]
+*** [[#Downloading using SteamCMD|Downloading using SteamCMD]]
+*** [[#Basic Configuration & Starting the Server (Linux)|Basic Configuration & Starting the Server (Linux)]]
-To host a gameserver, you will require a Steam account that owns a copy of the game.
+ | featured_title     = Server Hosting
+ | featured_content   = {{:{{FULLPAGENAME}}/Body}}  <!-- everything below lives on /Body -->
-==Windows==
+ | image_content      =
-===Obtaining the game files===
+ | layout             = auto
-====Downloading using Steam Client====
+ | left_width         = 320px
-[[File:FolderStructure2.jpg|thumb|Holdfast game files folder structure]]
+ | aside_width        = 320px
+ | gap                = 0.5rem
-Obtaining the game files can be done via the regular [https://store.steampowered.com/about/ Steam Client]. Download the game and copy the files to another folder. It's not recommended to use the SteamApps location as a base for the gameserver, as this might lead to file corruption if a game update overwrites files whilst the server is running.
+ | show_toc           = no
+ | show_section_edit  = yes
-This is the default directory where the [[Holdfast: Nations At War]] game files are located:
+}}
-<pre>
-C:\Steam\steamapps\common\Holdfast Nations At War
-</pre>
-====Downloading using SteamCMD====
-The '''Steam Console Client''' or [https://developer.valvesoftware.com/wiki/SteamCMD '''SteamCMD'''] is a command-line version of the Steam client. Its primary use is to install and update various dedicated servers available on Steam using a command-line interface. It works with games that use the SteamPipe content system. All games have been migrated from the deprecated HLDSUpdateTool to [https://developer.valvesoftware.com/wiki/SteamCMD '''SteamCMD''']. This is usually required if you are forced to use a terminal for your server setup. You can find instructions on how to download [https://developer.valvesoftware.com/wiki/SteamCMD '''SteamCMD'''] here: https://developer.valvesoftware.com/wiki/SteamCMD#Windows
-The files can then be obtain using the following batch command:
-<pre>
-$ steamcmd +login [LOGINNAME] [PASSWORD] +force_install_dir "C:\holdfastserver" +app_update 589290 +quit
-</pre>
-===Obtaining the server files===
-==Linux==
-===Obtaining the game files===
-===Download Requirements===
-Make sure no previous version of Wine has been installed, if it has, uninstall it completely and don't forget to run apt-get autoremove to clean up the remaining files.
-<pre>
-$ dpkg --add-architecture i386 && \
-        apt-get update && apt-get install -y \
-        gnupg \
-        gnupg1 \
-        gnupg2 \
-        curl \
-        xvfb && \
-        apt-get -y upgrade && \
-        curl -o Release.key https://dl.winehq.org/wine-builds/Release.key && \
-        apt-key add Release.key && \
-        echo "deb http://dl.winehq.org/wine-builds/debian stretch main" >> /etc/apt/sources.list && \
-        apt-get update && \
-        apt-get install -y --install-recommends winehq-stable && \
-        rm Release.key && \
-        apt-get clean autoclean && apt-get autoremove -y && \
-        rm -rf /var/lib/{apt,dpkg,cache,log}/ && \
-        curl http://dl.winehq.org/wine/wine-mono/4.7.1/wine-mono-4.7.1.msi | wine msiexec /i; exit 0
-</pre>
-====Downloading using SteamCMD====
-The '''Steam Console Client''' or [https://developer.valvesoftware.com/wiki/SteamCMD '''SteamCMD'''] is a command-line version of the Steam client. Its primary use is to install and update various dedicated servers available on Steam using a command-line interface. It works with games that use the SteamPipe content system. All games have been migrated from the deprecated HLDSUpdateTool to [https://developer.valvesoftware.com/wiki/SteamCMD '''SteamCMD''']. This is usually required if you are forced to use a terminal for your server setup. You can find instructions on how to download [https://developer.valvesoftware.com/wiki/SteamCMD '''SteamCMD'''] here: https://developer.valvesoftware.com/wiki/SteamCMD#Linux
-The files can then be obtain using the following bash command:
-<pre>
-$ steamcmd.sh \
-        +@sSteamCmdForcePlatformType windows \
-        +login [LOGINNAME] [PASSWORD] \
-        +force_install_dir /opt/holdfastserver \
-        +app_update 589290 +quit
-</pre>
-Notes:
-: This will download the Windows game files. Library-level virtualization is required to run them (e.g. [https://www.winehq.org/ Wine].
-: ''+anonymous'' will fail because the account requires to own a copy of the game to download the game files!
-===Obtaining the server files===

Difference between revisions of "Server Hosting"

Latest revision as of 09:27, 19 September 2025

On this page

Server Hosting

Quick Start Guide

Prevent Overwrites on Update

Windows Server Hosting

Obtaining the game files

Obtaining the Game Files

1. Steam Client (Recommended)

2. SteamCMD

Basic Configuration & Starting

Basic Configuration & Starting

Linux Server Hosting

Docker Setup (Recommended)

Manual Setup

Basic Configuration & Starting the Server (Manual)

Tools

Navigation menu

Search