Clusterio

Game

Clusterio is a clustered Factorio server manager that provides the tooling for implementing cross server interactions in Factorio. It was previously best known for implementing cross server transfer and cloud storage of items via teleporter chests. But this functionality has been pulled out of Clusterio into its own plugin for Clusterio named Subspace Storage. By itself Clusterio doesn't change the gameplay in any way, you could even use Clusterio to manage completely vanilla Factorio servers. Plugins do the work of modding in the visible changes into the game, see the Plugins section for ready-made plugins you can install into a Clusterio cluster.

Author: psychoalex@thevcbc.comSource: pterodactyl/game-eggsUpdated: 5/24/2026

Startup Command

exec ./node_modules/.bin/clusterio{{SERVER_MODE}} run

Docker Images

Label	Image
NodeJS 21	ghcr.io/ptero-eggs/yolks:nodejs_21
NodeJS 20	ghcr.io/ptero-eggs/yolks:nodejs_20
NodeJS 19	ghcr.io/ptero-eggs/yolks:nodejs_19
NodeJS 18	ghcr.io/ptero-eggs/yolks:nodejs_18

Environment Variables

Name	Variable	Default	Rules
Server Mode Set's the cluster operation mode of the server, can be either "controller" or "host". This is better thought of as Management or Gameserver nodes. Required on: All	SERVER_MODE	controller	required\|string\|in:controller,host
Log Level Options: "none", "fatal", "error", "warn", "audit", "info", "verbose" Required on: All	LOG_LEVEL	info	required\|string\|in:none,fatal,error,warn,audit,info,verbose
Server Admin Superadmin account name Required on: Controller	ADMIN_STRING	none	required\|string\|max:64
Host Name Host name in the Controller Web UI Required on: Host	HOST_NAME	Your Sub-Server	nullable\|string\|max:20
Controller URL Connection URL to the Controller server, can be an internal address if you have allocated an additional internal port to the Controller Server. Example: http://yourip:yourport Required on: Host	CONTROLLER_URL	none	nullable\|string\|max:64
Controller Token Authentication token used to connect to the Controller server, generated through the Controller Web UI. Required on: Host	CONTROLLER_TOKEN	none	nullable\|string\|max:256
Plugins Clusterio Plugins to install, space separate list. Example: @clusterio/plugin-subspace_storage @clusterio/plugin-global_chat @clusterio/plugin-research_sync @clusterio/plugin-inventory_sync Required on: All	PLUGINS	none	nullable\|string\|max:512
Cluster Name The Name of your Controller server cluster. Required: Controller	CLUSTER_NAME	Your Cluster	nullable\|string\|max:20