Harmonia - Revision history

Onny: Update harmonia module usage

2026-10-23T09:51:27Z

Update harmonia module usage

← Older revision		Revision as of 09:51, 23 October 2026
Line 9:		Line 9:
	</syntaxhighlight>Add following snippet to your system configuration and apply it.<syntaxhighlight lang="nix">		</syntaxhighlight>Add following snippet to your system configuration and apply it.<syntaxhighlight lang="nix">
	services.harmonia = {		services.harmonia = {
	enable = true;		cache.enable = true;
	signKeyPaths = [ "/var/lib/harmonia/cache-priv-key.pem" ];		signKeyPaths = [ "/var/lib/harmonia/cache-priv-key.pem" ];
	};		};

Onny at 12:15, 20 October 2026

2026-10-20T12:15:12Z

← Older revision		Revision as of 12:15, 20 October 2026
Line 10:		Line 10:
	services.harmonia = {		services.harmonia = {
	enable = true;		enable = true;
	~~secretKeyFile~~ = "/var/lib/harmonia/cache-priv-key.pem";		signKeyPaths = [ "/var/lib/harmonia/cache-priv-key.pem" ];
	};		};
	</syntaxhighlight>The cache will be served on http://127.0.0.1:5000. It should be served with a web server such as [[Caddy]].		</syntaxhighlight>The cache will be served on http://127.0.0.1:5000. It should be served with a web server such as [[Caddy]].

Onny at 12:14, 20 October 2026

2026-10-20T12:14:36Z

← Older revision		Revision as of 12:14, 20 October 2026
Line 1:		Line 1:
	[https://github.com/nix-community/harmonia harmonia] is a small utility to serve a Nix store as a [[binary cache]], allowing it to be used as a substituter by other Nix installations.		[https://github.com/nix-community/harmonia harmonia] is a small utility to serve a Nix store as a [[Binary Cache\|binary cache]], allowing it to be used as a substituter by other Nix installations.

	=== Setup ===		=== Setup ===

Onny at 12:13, 20 October 2026

2026-10-20T12:13:45Z

← Older revision		Revision as of 12:13, 20 October 2026
Line 1:		Line 1:
	[https://github.com/nix-community/harmonia harmonia] is a small utility to serve a Nix store as a binary cache, allowing it to be used as a substituter by other Nix installations.		[https://github.com/nix-community/harmonia harmonia] is a small utility to serve a Nix store as a [[binary cache]], allowing it to be used as a substituter by other Nix installations.

	=== Setup ===		=== Setup ===

Onny: Add notes on client setup

2026-10-20T12:08:46Z

Add notes on client setup

← Older revision		Revision as of 12:08, 20 October 2026
Line 2:		Line 2:

	=== Setup ===		=== Setup ===
	First generate required public and private store keys.<syntaxhighlight lang="bash">		First generate required public and private store keys, in this example for the domain <code>cache.example.org</code>.<syntaxhighlight lang="bash">
	mkdir -p /var/lib/harmonia		mkdir -p /var/lib/harmonia
	nix-store --generate-binary-cache-key cache.example.org-1 \		nix-store --generate-binary-cache-key cache.example.org-1 \
	/var/lib/harmonia/cache-priv-key.pem \		/var/lib/harmonia/cache-priv-key.pem \
	/var/lib/harmonia/cache-pub-key.pem		/var/lib/harmonia/cache-pub-key.pem

	~~chown harmonia:harmonia /var/lib/harmonia/cache-priv-key.pem~~
	~~chmod 600 /var/lib/harmonia/cache-priv-key.pem~~
	~~chmod 644 /var/lib/harmonia/cache-pub-key.pem~~
	</syntaxhighlight>Add following snippet to your system configuration and apply it.<syntaxhighlight lang="nix">		</syntaxhighlight>Add following snippet to your system configuration and apply it.<syntaxhighlight lang="nix">
	services.harmonia = {		services.harmonia = {
Line 16:		Line 12:
	secretKeyFile = "/var/lib/harmonia/cache-priv-key.pem";		secretKeyFile = "/var/lib/harmonia/cache-priv-key.pem";
	};		};
	</syntaxhighlight>The cache will be served on http://127.0.0.1:5000.		</syntaxhighlight>The cache will be served on http://127.0.0.1:5000. It should be served with a web server such as [[Caddy]].

	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
Line 26:		Line 22:
	'';		'';
	};		};
	</syntaxhighlight>		</syntaxhighlight>Visit https://cache.example.org where you'll also find instructions on how to setup the cache on a client.

Onny: Onny moved page Nix-serve to Harmonia

2026-10-20T12:05:58Z

Onny moved page Nix-serve to Harmonia

← Older revision		Revision as of 12:05, 20 October 2026
(No difference)

Onny: Switched to harmonia

2026-10-20T12:05:43Z

Switched to harmonia

← Older revision		Revision as of 12:05, 20 October 2026
Line 1:		Line 1:
	[https://github.com~~/edolstra~~/nix-~~serve nix-serve~~] is a small utility to serve a Nix store as a binary cache, allowing it to be used as a substituter by other Nix installations.		[https://github.com/nix-community/harmonia harmonia] is a small utility to serve a Nix store as a binary cache, allowing it to be used as a substituter by other Nix installations.

	=== Setup ===		=== Setup ===
	First generate required public and private store keys.<syntaxhighlight lang="bash">		First generate required public and private store keys.<syntaxhighlight lang="bash">
	mkdir -p /var/lib/~~nix-serve~~		mkdir -p /var/lib/harmonia
	nix-store --generate-binary-cache-key cache.~~project-insanity~~.org-1 \		nix-store --generate-binary-cache-key cache.example.org-1 \
	/var/lib/~~nix-serve~~/cache-priv-key.pem \		/var/lib/harmonia/cache-priv-key.pem \
	/var/lib/~~nix-serve~~/cache-pub-key.pem		/var/lib/harmonia/cache-pub-key.pem

	chown ~~nix-serve~~:~~nix-serve~~ /var/lib/~~nix-serve~~/cache-priv-key.pem		chown harmonia:harmonia /var/lib/harmonia/cache-priv-key.pem
	chmod 600 /var/lib/~~nix-serve~~/cache-priv-key.pem		chmod 600 /var/lib/harmonia/cache-priv-key.pem
	chmod 644 /var/lib/~~nix-serve~~/cache-pub-key.pem		chmod 644 /var/lib/harmonia/cache-pub-key.pem
	</syntaxhighlight>Add following snippet to your system configuration and apply it.<syntaxhighlight lang="nix">		</syntaxhighlight>Add following snippet to your system configuration and apply it.<syntaxhighlight lang="nix">
	services.~~nix-serve~~ = {		services.harmonia = {
	enable = true;		enable = true;
	secretKeyFile = "/var/lib/~~nix-serve~~/cache-priv-key.pem";		secretKeyFile = "/var/lib/harmonia/cache-priv-key.pem";
	};		};
	</syntaxhighlight>The cache will be served on http://127.0.0.1:5000.		</syntaxhighlight>The cache will be served on http://127.0.0.1:5000.

			<syntaxhighlight lang="nix">
			services.caddy = {
			enable = true;
			openFirewall = true;
			virtualHosts."cache.example.org".extraConfig = ''
			reverse_proxy 127.0.0.1:5000
			'';
			};
			</syntaxhighlight>

Onny: Initial page

2026-10-20T11:36:28Z

Initial page

New page

[https://github.com/edolstra/nix-serve nix-serve] is a small utility to serve a Nix store as a binary cache, allowing it to be used as a substituter by other Nix installations.

=== Setup ===
First generate required public and private store keys.<syntaxhighlight lang="bash">
mkdir -p /var/lib/nix-serve
nix-store --generate-binary-cache-key cache.project-insanity.org-1 \
/var/lib/nix-serve/cache-priv-key.pem \
/var/lib/nix-serve/cache-pub-key.pem

chown nix-serve:nix-serve /var/lib/nix-serve/cache-priv-key.pem
chmod 600 /var/lib/nix-serve/cache-priv-key.pem
chmod 644 /var/lib/nix-serve/cache-pub-key.pem
</syntaxhighlight>Add following snippet to your system configuration and apply it.<syntaxhighlight lang="nix">
services.nix-serve = {
enable = true;
secretKeyFile = "/var/lib/nix-serve/cache-priv-key.pem";
};
</syntaxhighlight>The cache will be served on http://127.0.0.1:5000.