Factorio - Revision history

DoggoBit at 20:07, 5 June 2025

2025-06-05T20:07:55Z

← Older revision		Revision as of 20:07, 5 June 2025
Line 1:		Line 1:
			{{tip/unfree}}

	<strong>[https://www.factorio.com Factorio]</strong> is a video game created by [https://www.factorio.com/game/about Wube Software]. Factorio has a multiplayer mode that requires a dedicated server, which is available on Nixpkgs and can be installed on NixOS.		<strong>[https://www.factorio.com Factorio]</strong> is a video game created by [https://www.factorio.com/game/about Wube Software]. Factorio has a multiplayer mode that requires a dedicated server, which is available on Nixpkgs and can be installed on NixOS.

	== Installation ==		== Installation ==

	~~{{Unfree}}~~

	To install the Factorio server, add the following to your [[Overview_of_the_NixOS_Linux_distribution#Declarative_Configuration\|NixOS configuration]]:		To install the Factorio server, add the following to your [[Overview_of_the_NixOS_Linux_distribution#Declarative_Configuration\|NixOS configuration]]:

SigmaSquadron: /* Mods */: Update upstream link.

2024-11-02T03:45:08Z

Mods: : Update upstream link.

← Older revision		Revision as of 03:45, 2 November 2024
Line 74:		Line 74:
	</nowiki>		</nowiki>
	}}		}}
	This code was developed by [https://github.com/nicball/nuc-nixos-configuration/blob/~~f70f2c4d8da1f2648b5e595d9058e0f105409fd7~~/factorio.nix#L16 nicball].		This code was developed by [https://github.com/nicball/nuc-nixos-configuration/blob/fccfa8441cba60c835aa2eb4238ae6f53bb781bb/factorio.nix#L16-L37 nicball].

	== See also ==		== See also ==

SigmaSquadron: /* Mods */: As the wiki is also MIT-licensed, this disclaimer is a bit redundant.

2024-11-02T03:44:28Z

Mods: : As the wiki is also MIT-licensed, this disclaimer is a bit redundant.

← Older revision		Revision as of 03:44, 2 November 2024
Line 74:		Line 74:
	</nowiki>		</nowiki>
	}}		}}
	This code was developed by [https://github.com/nicball/nuc-nixos-configuration/blob/f70f2c4d8da1f2648b5e595d9058e0f105409fd7/factorio.nix#L16 nicball]~~, and is licensed under the MIT License~~.		This code was developed by [https://github.com/nicball/nuc-nixos-configuration/blob/f70f2c4d8da1f2648b5e595d9058e0f105409fd7/factorio.nix#L16 nicball].

	== See also ==		== See also ==

SigmaSquadron: /* Mods */: Update snippet, now MIT-licensed!

2024-11-02T03:43:21Z

Mods: : Update snippet, now MIT-licensed!

← Older revision		Revision as of 03:43, 2 November 2024
Line 40:		Line 40:
	=== Mods ===		=== Mods ===

	The NixOS module for Factorio supports [https://wiki.factorio.com/Modding third-party modifications], or <i>mods</i>, which are just ~~zip files~~ with extra game content. While technically you can create a full derivation for mods, in practice this can get complicated, especially since authentication is required to download mods from the official mod site.		The NixOS module for Factorio supports [https://wiki.factorio.com/Modding third-party modifications], or <i>mods</i>, which are just compressed archives with extra game content. While technically you can create a full derivation for mods, in practice this can get complicated, especially since authentication is required to download mods from the official mod site.

	Instead, you can download the mods you need ~~separately~~ from https://mods.factorio.com/, place them in a folder such as <code>/~~home~~/~~username~~/factorio-mods</code>, and put this code in your [[Overview_of_the_NixOS_Linux_distribution#Declarative_Configuration\|NixOS configuration]]~~. (credit to [https://github.com/nicball/nuc-nixos-configuration/blob/f70f2c4d8da1f2648b5e595d9058e0f105409fd7/factorio.nix#L16 nicball])~~:		Instead, you can download the mods you need imperatively from https://mods.factorio.com/, place them in a folder such as <code>/etc/nixos/factorio-mods</code>, and put this code in your [[Overview_of_the_NixOS_Linux_distribution#Declarative_Configuration\|NixOS configuration]]:

	{{file\|configuration.nix\|nix\|		{{file\|configuration.nix\|nix\|
	<nowiki>		<nowiki>
	{		{
	services.factorio~~.mods~~ =		services.factorio = {
	~~let~~		mods =
	~~inherit (pkgs) lib;~~		let
	modDir = ~~/home/username~~/factorio-mods;		modDir = ./factorio-mods;
	modList = lib.pipe modDir [		modList = lib.pipe modDir [
	builtins.readDir		builtins.readDir
	(lib.filterAttrs (k: v: v == "regular"))		(lib.filterAttrs (k: v: v == "regular"))
	(lib.mapAttrsToList (k: v: k))		(lib.mapAttrsToList (k: v: k))
	(builtins.filter (lib.hasSuffix ".zip"))		(builtins.filter (lib.hasSuffix ".zip"))
	];		];
	modToDrv = modFileName:		validPath = modFileName:
	pkgs.runCommand "copy-factorio-mods" {} ''		builtins.path {
	mkdir $out		path = modDir + "/${modFileName}";
	~~cp ${modDir + "/~~${modFileName}"} $out/${modFileName}		name = lib.strings.sanitizeDerivationName modFileName;
	''		};
	// { deps = []; };		modToDrv = modFileName:
	in		pkgs.runCommand "copy-factorio-mods" {} ''
	builtins.map modToDrv modList;		mkdir $out
			ln -s '${validPath modFileName}' $out/'${modFileName}'
			''
			// { deps = []; };
			in
			builtins.map modToDrv modList;
			};
	}		}
	</nowiki>		</nowiki>
	}}		}}
			This code was developed by [https://github.com/nicball/nuc-nixos-configuration/blob/f70f2c4d8da1f2648b5e595d9058e0f105409fd7/factorio.nix#L16 nicball], and is licensed under the MIT License.

	== See also ==		== See also ==

SigmaSquadron: typo

2024-10-30T15:14:09Z

typo

← Older revision		Revision as of 15:14, 30 October 2024
Line 40:		Line 40:
	=== Mods ===		=== Mods ===

	The NixOS module for Factorio supports [https://wiki.factorio.com/Modding ~~Factorio~~ third-party modifications], or <i>mods</i>, which are just zip files with extra game content. While technically you can create a full derivation for mods, in practice this can get complicated, especially since authentication is required to download mods from the official mod site.		The NixOS module for Factorio supports [https://wiki.factorio.com/Modding third-party modifications], or <i>mods</i>, which are just zip files with extra game content. While technically you can create a full derivation for mods, in practice this can get complicated, especially since authentication is required to download mods from the official mod site.

	Instead, you can download the mods you need separately from https://mods.factorio.com/, place them in a folder such as <code>/home/username/factorio-mods</code>, and put this code in your [[Overview_of_the_NixOS_Linux_distribution#Declarative_Configuration\|NixOS configuration]]. (credit to [https://github.com/nicball/nuc-nixos-configuration/blob/f70f2c4d8da1f2648b5e595d9058e0f105409fd7/factorio.nix#L16 nicball]):		Instead, you can download the mods you need separately from https://mods.factorio.com/, place them in a folder such as <code>/home/username/factorio-mods</code>, and put this code in your [[Overview_of_the_NixOS_Linux_distribution#Declarative_Configuration\|NixOS configuration]]. (credit to [https://github.com/nicball/nuc-nixos-configuration/blob/f70f2c4d8da1f2648b5e595d9058e0f105409fd7/factorio.nix#L16 nicball]):

SigmaSquadron: Overhaul page per the MoS.

2024-10-30T14:32:26Z

Overhaul page per the MoS.

← Older revision		Revision as of 14:32, 30 October 2024
Line 1:		Line 1:
	[https://en.~~wikipedia~~.~~org/wiki/Factorio~~ Factorio] is a video game created by Wube Software. Factorio has a multiplayer mode that requires a dedicated server, which is ~~what this guide is about. If you have tips for installing the Factorio client, please feel free to expand this wiki page~~.		<strong>[https://www.factorio.com Factorio]</strong> is a video game created by [https://www.factorio.com/game/about Wube Software]. Factorio has a multiplayer mode that requires a dedicated server, which is available on Nixpkgs and can be installed on NixOS.

	~~For more specific information about Factorio multiplayer, see: https://wiki.factorio.com/Multiplayer~~		== Installation ==

	~~== Default Server Installation ==~~		{{Unfree}}

	To install the Factorio server, add ~~"factorio-headless"~~ to your ~~"systemPackages" in your~~ NixOS configuration:		To install the Factorio server, add the following to your [[Overview_of_the_NixOS_Linux_distribution#Declarative_Configuration\|NixOS configuration]]:

	<~~syntaxhighlight lang=nix~~>		{{file\|configuration.nix\|nix\|
	environment.systemPackages = ~~with~~ pkgs~~; [~~		<nowiki>
	factorio-headless		{
	];		environment.systemPackages = [ pkgs.factorio-headless ];
	~~# Also enable non-free packages or else the factorio download will fail:~~		nixpkgs.config.allowUnfreePredicate = pkg: builtins.elem (lib.getName pkg) [
	nixpkgs.config.~~allowUnfree~~ = ~~true~~;		"factorio-headless"
	</~~syntaxhighlight~~>		];
			}
			</nowiki>
			}}
			{{Evaluate}}

	It's important to only install "factorio-headless" instead of "factorio" because the headless version is a ~~free~~ download that does not require login credentials.		It is important to only install <code>factorio-headless</code> instead of <code>factorio</code> because the headless version is a redistributable download that does not require login credentials.

	== Configuration ==		== Configuration ==

	Here is a minimum viable configuration for the Factorio server ~~(add this to your NixOS configuration)~~:		Here is a minimum viable configuration for the Factorio server:

	<~~syntaxhighlight lang=nix~~>		{{file\|configuration.nix\|nix\|
	services.factorio = {		<nowiki>
	enable = true;		{
	openFirewall = true;		services.factorio = {
	};		enable = true;
	</~~syntaxhighlight~~>		openFirewall = true;
			};
			}
			</nowiki>
			}}

	This will run a ~~non-password-protected~~ server that binds to "0.0.0.0" and uses the default UDP port of 34197, with an auto-generated save file. Factorio servers support IPv6 by setting <code>bind = "[::]";</code>. All default settings can be seen here: ~~https~~:~~//search~~.~~nixos~~.~~org/options?&query=factorio~~		This will run a unprotected server that binds to the <code>0.0.0.0</code> local IP address and uses the default UDP port of <code>34197</code>, with an auto-generated save file. Factorio servers support IPv6 by setting <code>bind = "[::]";</code>. All default settings can be seen here: {{nixos:option\|services.factorio.*}}

	== Mods ==		=== Mods ===

	The NixOS module for Factorio supports [https://wiki.factorio.com/Modding Factorio mods], which are just zip files. While technically you can create a full derivation for mods, in practice this can get complicated, especially since authentication is required to download mods from the official mod site.		The NixOS module for Factorio supports [https://wiki.factorio.com/Modding Factorio third-party modifications], or <i>mods</i>, which are just zip files with extra game content. While technically you can create a full derivation for mods, in practice this can get complicated, especially since authentication is required to download mods from the official mod site.

	Instead, you can download the mods you need separately from https://mods.factorio.com/, place them in a folder such as <code>/home/username/factorio-mods</code>, and put this code in your configuration.~~nix~~ (credit to [https://github.com/nicball/nuc-nixos-configuration/blob/f70f2c4d8da1f2648b5e595d9058e0f105409fd7/factorio.nix#L16 nicball]):		Instead, you can download the mods you need separately from https://mods.factorio.com/, place them in a folder such as <code>/home/username/factorio-mods</code>, and put this code in your [[Overview_of_the_NixOS_Linux_distribution#Declarative_Configuration\|NixOS configuration]]. (credit to [https://github.com/nicball/nuc-nixos-configuration/blob/f70f2c4d8da1f2648b5e595d9058e0f105409fd7/factorio.nix#L16 nicball]):

	<~~syntaxhighlight lang=nix~~>		{{file\|configuration.nix\|nix\|
	services.factorio ~~= {~~		<nowiki>
	~~# --omitted--~~		{
	mods =		services.factorio.mods =
	let		let
	inherit (pkgs) lib;		inherit (pkgs) lib;
Line 54:		Line 62:
	cp ${modDir + "/${modFileName}"} $out/${modFileName}		cp ${modDir + "/${modFileName}"} $out/${modFileName}
	''		''
	// { deps = []; };		// { deps = []; };
	in		in
	builtins.map modToDrv modList;		builtins.map modToDrv modList;
	};		}
	</~~syntaxhighlight~~>		</nowiki>
			}}

	~~Note that any changes to the list of mods in the "~~factorio~~-mods" folder require running <code>nixos-rebuild switch<~~/~~code>.~~		== See also ==

			* [https://wiki.factorio.com/Multiplayer The Factorio wiki page on Multiplayer]

	[[Category:Gaming]]		[[Category:Gaming]]
	[[Category:Server]]		[[Category:Server]]

Klinger: Category:Gaming Category:Server

2024-04-19T19:06:19Z

Category:Gaming Category:Server

← Older revision		Revision as of 19:06, 19 April 2024
Line 62:		Line 62:
	Note that any changes to the list of mods in the "factorio-mods" folder require running <code>nixos-rebuild switch</code>.		Note that any changes to the list of mods in the "factorio-mods" folder require running <code>nixos-rebuild switch</code>.

	[[Category:~~Cookbook~~]]		[[Category:Gaming]]
	[[Category:~~NixOS]]~~		[[Category:Server]]
	~~[[Category:Applications~~]]

imported>Mac-chaffee: mention IPv6 support

2023-06-26T00:47:59Z

mention IPv6 support

← Older revision		Revision as of 00:47, 26 June 2023
Line 28:		Line 28:
	</syntaxhighlight>		</syntaxhighlight>

	This will run a non-password-protected server that binds to "0.0.0.0" and uses the default UDP port of 34197, with an auto-generated save file. All default settings can be seen here: https://search.nixos.org/options?&query=factorio		This will run a non-password-protected server that binds to "0.0.0.0" and uses the default UDP port of 34197, with an auto-generated save file. Factorio servers support IPv6 by setting <code>bind = "[::]";</code>. All default settings can be seen here: https://search.nixos.org/options?&query=factorio

	== Mods ==		== Mods ==

imported>Mac-chaffee: fix nixos-rebuild syntax

2023-06-23T02:08:23Z

fix nixos-rebuild syntax

← Older revision		Revision as of 02:08, 23 June 2023
Line 60:		Line 60:
	</syntaxhighlight>		</syntaxhighlight>

	Note that any changes to the list of mods in the "factorio-mods" folder require running <code>nixos-rebuild --switch</code>.		Note that any changes to the list of mods in the "factorio-mods" folder require running <code>nixos-rebuild switch</code>.

	[[Category:Cookbook]]		[[Category:Cookbook]]
	[[Category:NixOS]]		[[Category:NixOS]]
	[[Category:Applications]]		[[Category:Applications]]

imported>Mac-chaffee: Created page with "[https://en.wikipedia.org/wiki/Factorio Factorio] is a video game created by Wube Software. Factorio has a multiplayer mode that requires a dedicated server, which is what thi..."

2023-06-23T02:05:48Z

Created page with "[https://en.wikipedia.org/wiki/Factorio Factorio] is a video game created by Wube Software. Factorio has a multiplayer mode that requires a dedicated server, which is what thi..."

New page

[https://en.wikipedia.org/wiki/Factorio Factorio] is a video game created by Wube Software. Factorio has a multiplayer mode that requires a dedicated server, which is what this guide is about. If you have tips for installing the Factorio client, please feel free to expand this wiki page.

For more specific information about Factorio multiplayer, see: https://wiki.factorio.com/Multiplayer

== Default Server Installation ==

To install the Factorio server, add "factorio-headless" to your "systemPackages" in your NixOS configuration:

<syntaxhighlight lang=nix>
environment.systemPackages = with pkgs; [
factorio-headless
];
# Also enable non-free packages or else the factorio download will fail:
nixpkgs.config.allowUnfree = true;
</syntaxhighlight>

It's important to only install "factorio-headless" instead of "factorio" because the headless version is a free download that does not require login credentials.

== Configuration ==

Here is a minimum viable configuration for the Factorio server (add this to your NixOS configuration):

<syntaxhighlight lang=nix>
services.factorio = {
enable = true;
openFirewall = true;
};
</syntaxhighlight>

This will run a non-password-protected server that binds to "0.0.0.0" and uses the default UDP port of 34197, with an auto-generated save file. All default settings can be seen here: https://search.nixos.org/options?&query=factorio

== Mods ==

The NixOS module for Factorio supports [https://wiki.factorio.com/Modding Factorio mods], which are just zip files. While technically you can create a full derivation for mods, in practice this can get complicated, especially since authentication is required to download mods from the official mod site.

Instead, you can download the mods you need separately from https://mods.factorio.com/, place them in a folder such as <code>/home/username/factorio-mods</code>, and put this code in your configuration.nix (credit to [https://github.com/nicball/nuc-nixos-configuration/blob/f70f2c4d8da1f2648b5e595d9058e0f105409fd7/factorio.nix#L16 nicball]):

<syntaxhighlight lang=nix>
services.factorio = {
# --omitted--
mods =
let
inherit (pkgs) lib;
modDir = /home/username/factorio-mods;
modList = lib.pipe modDir [
builtins.readDir
(lib.filterAttrs (k: v: v == "regular"))
(lib.mapAttrsToList (k: v: k))
(builtins.filter (lib.hasSuffix ".zip"))
];
modToDrv = modFileName:
pkgs.runCommand "copy-factorio-mods" {} ''
mkdir $out
cp ${modDir + "/${modFileName}"} $out/${modFileName}
''
// { deps = []; };
in
builtins.map modToDrv modList;
};
</syntaxhighlight>

Note that any changes to the list of mods in the "factorio-mods" folder require running <code>nixos-rebuild --switch</code>.

[[Category:Cookbook]]
[[Category:NixOS]]
[[Category:Applications]]