This guide explains how to install and manage mods on your Factorio dedicated server hosted with Legion Hosting. For initial server setup, configuration, and connecting, see Factorio Server Setup.
Overview
Factorio has a rich modding ecosystem. All mods are managed through files in the mods/ directory on your server.
Downloading and Installing Mods
- Browse available mods at mods.factorio.com.
- Download the desired mod file. Mods are distributed as
.zipfiles (e.g.,ModName_1.2.3.zip). - Stop your server in GPanel.
- Upload the
.zipfile to themods/directory on your server via the File Manager or SFTP. - Start the server. The mod will be loaded automatically.
Automatic mod downloads: If your server has valid
SERVER_USERNAME and SERVER_TOKEN credentials configured, you can also manage mods through mod-list.json and the server will attempt to download them from the mod portal on startup.
mod-list.json
The mods/mod-list.json file controls which installed mods are enabled or disabled. It is automatically generated but can be edited manually.
{
"mods": [
{ "name": "base", "enabled": true },
{ "name": "ExampleMod", "enabled": true },
{ "name": "AnotherMod", "enabled": false }
]
}Set "enabled": false to disable a mod without deleting its files. This is useful for troubleshooting mod conflicts.
Mod Compatibility
- Always check that the mod version is compatible with your server's Factorio version.
- Some mods have dependencies on other mods -- check the mod page on mods.factorio.com for required dependencies.
- All connecting players must have the same mods installed at the same versions. Players will be prompted to download missing mods when connecting if the mods are available on the portal.
Modded saves and map generation: Adding or removing mods that affect world generation (such as resource overhaul mods) on an existing save can cause errors or corruption. Always back up your save before changing mods, and consider generating a new map when adding significant world-generation mods.
Related Articles
- Factorio Server Setup
- How to Find Your Server IP and Port
- How to Upload Files via SFTP
- Server Startup Guide
Need Help?
If you are experiencing issues with mods on your Factorio server, open a support ticket with your server details, the mod names/versions, and any error messages from the console.
