Server Hosting - Revision history

Xarkanoth at 17:48, 11 July 2026

2026-07-11T17:48:11Z

@@ Line 1: / Line 1: @@
-<div class="hf-relpage">
+<div class="hf-relpage hf-reference-page hf-server-hosting-page">
 {{Release_page_header|title=Server Hosting}}
 <div class="hf-relpage-body">
@@ Line 13: / Line 13: @@
 }}
 <div class="hf-relpage-content">
 {{Release_section

Xarkanoth at 14:54, 3 July 2026

2026-07-03T14:54:00Z

← Older revision		Revision as of 16:54, 3 July 2026
Line 66:		Line 66:
	<div class="hf-admin-file-card hf-admin-file-card-important">		<div class="hf-admin-file-card hf-admin-file-card-important">
	<div class="hf-admin-file-name">serverAdmins.txt</div>		<div class="hf-admin-file-name">serverAdmins.txt</div>
	<div class="hf-admin-file-desc">~~Stores~~ server administrators.</div>		<div class="hf-admin-file-desc">Auto-authorizes server administrators.</div>
	</div>		</div>
	</div>		</div>
Line 73:		Line 73:
	* '''Automatic updates:''' The game writes to <code>bannedplayers.txt</code>, <code>mutedplayerschat.txt</code>, and <code>mutedplayersvoip.txt</code> when server admins ban, chat mute, or VoIP mute players in-game.		* '''Automatic updates:''' The game writes to <code>bannedplayers.txt</code>, <code>mutedplayerschat.txt</code>, and <code>mutedplayersvoip.txt</code> when server admins ban, chat mute, or VoIP mute players in-game.
	* '''Manual edits:''' You can manually add players to these lists. Restart the server for manual changes to take effect, or use [[Remote Console Commands\|Remote Console Commands]] if you are reloading supported ban and mute files with <code>rc fileReloader</code>.		* '''Manual edits:''' You can manually add players to these lists. Restart the server for manual changes to take effect, or use [[Remote Console Commands\|Remote Console Commands]] if you are reloading supported ban and mute files with <code>rc fileReloader</code>.
	* '''Server admins:''' <code>serverAdmins.txt</code> ~~must~~ be ~~placed~~ in the base <code>/holdfastnaw-dedicated/</code> directory~~. Restart~~ the server after editing it.		* '''Server admins:''' <code>serverAdmins.txt</code> is only needed if you want listed players to automatically be logged into the admin console without using [[Remote Console Commands\|Remote Console Commands]]. Place it in the base <code>/holdfastnaw-dedicated/</code> directory and restart the server after editing it.

	<h3>Player ID Format</h3>		<h3>Player ID Format</h3>

Xarkanoth at 14:47, 3 July 2026

2026-07-03T14:47:35Z

@@ Line 6: / Line 6: @@
 <div>[[#quick-start|Quick Start Guide]]</div>
 <div>[[#prevent-overwrites|Prevent Overwrites on Update]]</div>
 <div>[[#windows|Windows Server Hosting]]</div>
 <div>[[#windows-config|Basic Configuration & Starting]]</div>
@@ Line 42: / Line 43: @@
 # Duplicate the launch script (e.g., <code>LaunchServer.ps1</code> to <code>LaunchServer_myname.ps1</code>).
 # Edit your custom launch script to point to your custom config file.
 }}

Maintenance script at 03:12, 9 February 2026

2026-02-09T03:12:32Z

New page

<div class="hf-relpage">
{{Release_page_header|title=Server Hosting}}
<div class="hf-relpage-body">
{{Release_TOC|content=
<div class="hf-toc-category">On this page</div>
<div>[[#quick-start|Quick Start Guide]]</div>
<div>[[#prevent-overwrites|Prevent Overwrites on Update]]</div>
<div>[[#windows|Windows Server Hosting]]</div>
<div>[[#windows-config|Basic Configuration & Starting]]</div>
<div>[[#linux|Linux Server Hosting]]</div>
<div>[[#linux-config|Linux Configuration & Starting]]</div>
}}
<div class="hf-relpage-content">

{{Release_section
|id=overview
|title=Overview
|content=
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.
}}

{{Release_section
|id=quick-start
|title=Quick Start Guide
|content=
For rapid local testing before hosting publicly:

# '''Acquire files:''' Install <code>Holdfast: Nations At War - Dedicated Server</code> from your Steam library ('''Tools''' section).
# '''Configuration:''' Modify the default map rotation file, which is located in (<code>serverconfig_default.txt</code>).
# '''Launch:''' Start the server using the provided launch script: <code>LaunchServer.ps1</code> (Windows) or <code>LaunchServer.sh</code> (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 <code>Localhost</code> 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.
}}

{{Release_section
|id=prevent-overwrites
|title=Prevent Overwrites on Update
|content=
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 <code>serverconfig_default.txt</code> to a custom name (e.g., <code>serverconfig_myname.txt</code>).
# Duplicate the launch script (e.g., <code>LaunchServer.ps1</code> to <code>LaunchServer_myname.ps1</code>).
# Edit your custom launch script to point to your custom config file.
}}

{{Release_section
|id=windows
|title=Windows Server Hosting
|content=
=== 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.

{{{!}}style="margin:0 auto;"
{{!}} [[File:ServerSteamLocation.png|thumb|Steam application to download]]
{{!}}{{!}} [[File:ServerBrowseLocalFiles.png|thumb|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 <code>[LOGINNAME]</code> and <code>[PASSWORD]</code> with your Steam credentials:

<pre class="hf-code">steamcmd +login [LOGINNAME] [PASSWORD] +force_install_dir "C:\holdfastserver" +app_update 589290 +quit</pre>

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

{{Release_section
|id=windows-config
|title=Basic Configuration & Starting (Windows)
|content=
[[File:FolderStructure.jpg|thumb|Holdfast merged server & game files folder structure|alt=|none]]

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

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

<pre class="hf-code">serverconfig_default.txt → serverconfig_newserver.txt
LaunchServer.ps1 → LaunchServer_newserver.ps1</pre>

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

<pre class="hf-code"># 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)</pre>

'''Action:''' Ensure the <code>server_port</code> and <code>steam_query_port</code> (UDP) are open in your Windows firewall and have corresponding port forwarding rules on your router. The <code>steam_query_port</code> is what allows the server browser to display information like player count and map.

'''Update Launch Script:''' Edit your custom launch script (<code>LaunchServer_newserver.ps1</code>) to ensure the arguments point to your custom config file:

<pre class="hf-code"># 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</pre>

'''Start Server:''' Run <code>LaunchServer_newserver.ps1</code> to start the server process.
}}

{{Release_section
|id=linux
|title=Linux Server Hosting
|content=
=== 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:

<pre class="hf-code">docker run -d --net=host --name=holdfastnaw-dedicated cm2network/holdfastnaw</pre>

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

<pre class="hf-code">docker run -d --net=host -e SERVER_PORT=20100 -e STEAM_QUERY_PORT=27000 --name=holdfastnaw-dedicated cm2network/holdfastnaw</pre>

Docker Hub: [https://hub.docker.com/r/cm2network/holdfastnaw/ 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 <code>/home/steam/holdfastnaw-dedicated/</code>.

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

Install [https://developer.valvesoftware.com/wiki/SteamCMD SteamCMD], then run the following to download the dedicated server files (App ID <code>1424230</code>):

<pre class="hf-code">steamcmd.sh +login anonymous +force_install_dir /opt/holdfastserver +app_update 1424230 +quit</pre>

'''Note:''' Use <code>+app_update 1424230 validate</code> later to verify the files if needed.
}}

{{Release_section
|id=linux-config
|title=Basic Configuration & Starting (Linux Manual)
|content=
'''Duplicate Config:''' Navigate to the server directory and copy the default config:

<pre class="hf-code">cd /opt/holdfastserver
cp serverconfig_default.txt serverconfig_myserver.txt</pre>

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

<pre class="hf-code">server_name My Server
server_region europe
server_admin_password defaultAdminPWReplace
#server_password mypassword</pre>

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

<pre class="hf-code">"./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"</pre>

'''Note:''' Replace <code>"serverconfig_myserver.txt"</code> with your actual config file name and verify the port <code>-p "20100"</code> matches your configuration file.
}}

</div>
</div>
</div>