Public | Automated Build

Last pushed: 8 months ago
Short Description
Allows you to easily configure and run clusterio with docker.
Full Description


Branch Coverage Build

If you want to connect to a clusterio cluster, please reffer to the client


  • Entities to send/recieve items

  • Cross dimensional storage

  • Sending of liquids

  • Sending of circuit network signals

Connection diagram:

There can be any number of clients connected to each slave, and any sumber of slaves connected to a master but there can only be one master server.

Ubuntu setup

NodeJS does not support EOL ubuntu releases. Make sure you are on the most recent LTS release or newer.

Master and all slaves:

sudo curl -sL | sudo -E bash - && sudo apt install -y git nodejs && git clone && cd factorioClusterio && npm install && sudo npm install pm2 -g && curl -o factorio.tar.gz -L && tar -xvf factorio.tar.gz

downloads and installs nodejs, pm2, git and clusterio. To specify a version, change "latest" in the link to a version number like 0.14.21.


pm2 start master.js --name master

Server Host

To download the mod for all its non vanilla features and items, (optional)

node client.js download

To create a new instance (its own save, set of mods and config files)

node client.js start [instancename]

To launch an instance with pm2

pm2 start --name slave client.js -- start [instancename]

use nano config.json to change settings.

Ubuntu with Docker

Clusterio has limited support for using docker.

sudo docker build -t clusterio --no-cache --force-rm factorioClusterio

sudo docker run --name master -e MODE=master -p 1234:8080 -d -it --restart=unless-stopped danielvestol/clusterio

sudo docker run --name slave -e MODE=client -e INSTANCE=world1 -v /srv/clusterio/instances:/factorioClusterio/instances -p 1235:34167 -it --restart=unless-stopped danielvestol/clusterio

The -v flag is used to specify the instance directory. Your instances (save files etc) will be stored there.

Windows setup

Clusterio is built up of multiple parts. Here is a quick guide:

Master = master.js

Server host (Slave) = client.js + factorio server

Game Client = The people connecting to the server

All Server Hosts (Slaves) AND Game Clients need to be running the clusterio mod located at github Install it by dropping it into either the sharedMods folder or instances/[instanceName]/instanceMods folder.

There are no requirements for other mods, they can be ran in any configuration allowed by the base game.


download and install nodeJS 6+ from

download and install git from

reboot when you are done, then proceed to the next steps. reboots matter


  1. download and run

  2. You do not need to follow the given instructions, but you should

  3. type node master.js

Server Host

  1. download and run

  2. Follow the instructions given

  3. Type node client.js start [instancename] to create a new instance.

To connect to a master server running on a remote machine, open config.json with your favourite text editor (notepad++). You can also set it up to use the official server browser.

Change masterIP to something like (provided by master server owner)

Change masterPort to something like 8080 (provided by master server owner)

Repeat step 3 for more servers on one machine. You should be able to find its port by looking at the slave section on master:8080 (the web interface)


Fancy game client that does the following steps automatically: clusterioClient

  1. Download the same version of the mod as the slave is running from the mod portal or [github](

  2. Drop it into ./factorio/mods

  3. Run factorio and connect to slave as a normal MP game. You will find the port number to connect to at http://[masterAddress]:8080

Docker Pull Command
Source Repository