> ## Documentation Index
> Fetch the complete documentation index at: https://help.freakhosting.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Arma 3 Server Mods Not Loading? How to Fix modlist.html Errors

> Arma 3 server mods not loading? Fix the modlist.html warning, check the file name and Launcher export, use lowercase folder names, semicolons and Workshop IDs.

If Arma 3 server mods are not loading, read the **Console** after a restart. The warning `Arma 3 Modlist file "modlist.html" could not be found, or is invalid!` means the uploaded file's name doesn't match the **Modlist File** variable or wasn't exported from the Arma 3 Launcher. For uploaded mods, use lowercase folder names in **Additional Mods** and try **\[Repair] Make Mod Files Lowercase** once.

| Fact | Value |
| - | - |
| Where to look | **Console**, the line after `Starting server with the following startup parameters:` |
| Modlist file | `modlist.html` in `/home/container/` (name set on **Startup**) |
| Folder rule | No capital letters, no spaces, not starting with a number |
| Repair options | **\[Repair] Make Mod Files Lowercase**, **\[Repair] Validate Server Files** |

## Check the startup line first

After a restart, the console prints the full parameter line. Look at `-mod=` and `-serverMod=`. If a mod is missing there, the panel didn't add it: check the variables below. If the mod is listed but doesn't work in game, check the folder and its keys.

## Fixes for Arma 3 mods not loading

| Symptom | Cause | Fix |
| - | - | - |
| `modlist.html" could not be found, or is invalid!` | No file with that name in the root | Upload the file to `/home/container/` and name it exactly as in **Modlist File (Exported from A3 Launcher)**. |
| Same warning, file is there | The file wasn't exported from the Arma 3 Launcher | Export the preset from the Launcher again. Hand-made lists and files from other tools are rejected. |
| You use no modlist and want the warning gone | **Modlist File** is still `modlist.html` | Clear **Modlist File** on **Startup**. The server then starts without a modlist and doesn't warn. |
| Uploaded mod missing from `-mod=` | Not in **Additional Mods**, or names not separated | Add it as `@mymod;`. Separate several folders with semicolons: `@mymod;@othermod;`. |
| Mod listed but not working | Capital letters in folder or file names (Linux is case-sensitive) | Turn on **\[Repair] Make Mod Files Lowercase**, restart once, then turn it off. |
| Folder name rejected or ignored | Spaces, capitals or a leading number | Rename it, for example `@my_mod` instead of `@My Mod` or `@1stmod`. |
| Workshop mod not downloading | **Automatic Updates** off, or the item isn't available on the Workshop | Turn **Automatic Updates** on, or upload the mod yourself. |
| Players kicked after joining | Missing `.bikey` in `keys/`, or different mod versions | See [signature errors](https://help.freakhosting.com/games/arma-3/enforcing-v2-signatures.md). |
| Mission says an addon is missing | A mod the mission needs isn't loaded | Add the mod, or remove the mission's dependency. |
| Server files damaged after a failed update | Broken game files | Turn on **\[Repair] Validate Server Files** for one start. It makes the start much slower. |

## How to check a Workshop mod by ID

Workshop mods from `modlist.html` are stored in folders named `@` plus the Workshop ID, for example `@450814997` for CBA\_A3. To add a single Workshop mod without the modlist, put that form in **Additional Mods**, for example `@450814997;`. With **Automatic Updates** on, the server downloads and updates it.

## When to restore or reinstall

If nothing helps, restore a [backup](https://help.freakhosting.com/portals/game-panel/how-to-create-and-restore-backups.md) from before you added the mods. [Share the console log](https://help.freakhosting.com/portals/game-panel/how-to-use-the-server-console.md) with our team in a [ticket](https://freakhosting.com/clientarea/submitticket.php) if you need help.

## Frequently asked questions

### Can I ignore the modlist.html warning on a vanilla server?

Yes. Without a modlist the server starts with no Workshop mods. Clear **Modlist File** if you don't want the warning.

### Why do mods from my Windows PC not load?

Windows ignores capital letters in file names, Linux doesn't. Use **\[Repair] Make Mod Files Lowercase** for one start after uploading.

### Do I need to restart after changing mods?

Yes. Mods are only loaded when the server starts.

## Related guides

> [card] [Arma 3 server guide](https://help.freakhosting.com/games/arma-3/arma-3-server-hosting-guide.md)
>
> Every Arma 3 page in one place.

> [card] [Install mods](https://help.freakhosting.com/games/arma-3/installing-mods-and-mission-files-in-arma-3.md)
>
> modlist.html and Additional Mods.

> [card] [Signature errors](https://help.freakhosting.com/games/arma-3/enforcing-v2-signatures.md)
>
> Keys and verifySignatures.

> [card] [Startup parameters](https://help.freakhosting.com/games/arma-3/understanding-startup-parameters.md)
>
> Every Startup variable explained.

> [card] [Server console](https://help.freakhosting.com/portals/game-panel/how-to-use-the-server-console.md)
>
> Read and share the console.

***

> [!NOTE]
>
> **Tested by the FREAKHOSTING team** on our Game Panel on 31 October 2026 (Arma 3 dedicated server 2.22). Steps may differ slightly if the game changes.

> [!NOTE]
>
> ### 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](https://freakhosting.com/clientarea/submitticket.php)
> * **Discord:** [Join our Community](https://discord.gg/freakhosting)
> * **Email:** [support@freakhosting.com](mailto:support@freakhosting.com)

> [!TIP]
>
> ### Save on Your Hosting
>
> Ready to upgrade your hosting? Use code **KB20** at checkout for **20% off** your first order!

***

**Last Updated:** October 2026


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.