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.What server.cfg needs
The panel keeps these lines inserver.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:- Place a player unit as usual.
- Place a Headless Client unit: side Game Logic, class Virtual Entities.
- Make it Playable and give it a Variable Name, for example
HC1. The name is required. - Add one slot for each HC you start.
- Export the mission and upload it to
mpmissions. See add missions.
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.Related guides
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:- Live Chat: Quick assistance via our website.
- Support Ticket: Open a Ticket
- Discord: Join our Community
- Email: support@freakhosting.com
Last Updated: October 2026