Skip to main content
To set up a headless client on a FREAKHOSTING Arma 3 server, open Startup, set [Advanced] Headless Clients (HC) to a number from 1 to 5 and restart. The panel starts that many headless clients next to the server, with the same mods and password. server.cfg already allows them from 127.0.0.1. Your mission also needs a Headless Client slot and scripts that move AI to it.

What is a headless client?

A headless client (HC) is an extra copy of Arma 3 without graphics that joins your server and runs AI calculations, so the server itself has more time for everything else. It only helps when the mission is written for it. A normal mission runs all AI on the server and ignores the HC.

Before you start

  • Use a mission with at least one Headless Client slot (see below).
  • Each HC is another copy of the game and uses extra memory (plan for around 2 GB each), counted in your server’s resources. Check Statistics after you turn it on.

How to start headless clients

1

Set the number of headless clients

Open Startup and set [Advanced] Headless Clients (HC) to 1 (up to 5). Use one HC per Headless Client slot in your mission.
2

Choose the console output

[Advanced] HC Hide Console Output is on by default and hides HC output except critical errors. Turn it off for a start if you need to troubleshoot.
3

Restart the server

Restart. The console shows a line such as Headless Client 1 launched. for each HC. They connect to 127.0.0.1 and take a free HC slot.
The HCs use the server’s Server Password and the same mods as players, so you don’t need to set those twice.

What server.cfg needs

The panel keeps these lines in server.cfg for you:
If you want HCs to load unpacked files, allowedFilePatching = 1; allows file patching for headless clients only.

How to add a Headless Client slot to your mission

In the Eden editor:
  1. Place a player unit as usual.
  2. Place a Headless Client unit: side Game Logic, class Virtual Entities.
  3. Make it Playable and give it a Variable Name, for example HC1. The name is required.
  4. Add one slot for each HC you start.
  5. Export the mission and upload it to mpmissions. See add missions.
The mission’s scripts must then create AI on the HC or hand AI groups to it. Bohemia Interactive’s example runs a script only on the HC with:

Frequently asked questions

How many headless clients should I use?

Start with one. More only help if the mission spreads AI over several HCs, and each one uses more memory.

Does a headless client take a player slot?

It takes a Headless Client slot in the mission, not one of the playable soldier slots.

Why is my headless client not used?

The mission has no Headless Client slot, or its scripts don’t move AI to the HC. Check the mission first, then the console with HC Hide Console Output off.

Arma 3 server guide

Every Arma 3 page in one place.

Server FPS

Measure the effect of an HC.

Startup parameters

Every Startup variable explained.

Add missions

Upload an HC-ready mission.

Server statistics

Watch memory and CPU use.

Tested by the FREAKHOSTING team on our Game Panel on 31 October 2026 (Arma 3 dedicated server 2.22). Mission setup checked against the Bohemia Interactive headless client page. Steps may differ slightly if the game changes.

Need Extra Help?

If you encounter any issues, our support team is ready to assist:

Save on Your Hosting

Ready to upgrade your hosting? Use code KB20 at checkout for 20% off your first order!

Last Updated: October 2026