Forge Home


Module for setting up a Factorio headless server

Nathan Spiegel



5,137 latest version

1.9 quality score

Version information

  • 0.1.2 (latest)
  • 0.1.1
  • 0.1.0
released Jun 28th 2017

Start using this module


beneficialcucumber/factorio — version 0.1.2 Jun 28th 2017


Table of Contents

  1. Overview
  2. Setup - The basics of getting started with factorio
  3. Limitations - OS compatibility, etc.


This module will install a Factorio headless server.


What factorio affects

  • Factorio user created
  • Headless tarball downloaded and extracted
  • New world created
  • Systemd unit created, started, and enabled

Beginning with factorio

Simply include factorio on the nodes and/or hierarchies you wish to have a server setup

The default world name will be generic. If you'd like to give your world a specific name, you can do so via hiera: factorio::world_name: 'yourcustomworldname'

Generating a new world / Changing worlds

Follow the steps below to change to a different save game:

  • Stop factorio (systemctl stop factorio)
  • Update factorio::world_name with the changed/new name you wish to use
  • Server will change maps and restart on next puppet run


To create a new world, you must stop the running server, then manually delete the existing save file. The next puppet run will then setup a fresh world.