Harmonia: Difference between revisions
Initial page |
Update harmonia module usage |
||
| (6 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
[https://github.com | [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 === | ||
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/ | mkdir -p /var/lib/harmonia | ||
nix-store --generate-binary-cache-key cache. | nix-store --generate-binary-cache-key cache.example.org-1 \ | ||
/var/lib/ | /var/lib/harmonia/cache-priv-key.pem \ | ||
/var/lib/nix | /var/lib/harmonia/cache-pub-key.pem | ||
</syntaxhighlight>Add following snippet to your system configuration and apply it.<syntaxhighlight lang="nix"> | |||
services.harmonia = { | |||
cache.enable = true; | |||
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 lang="nix"> | |||
services.caddy = { | |||
services. | |||
enable = true; | enable = true; | ||
openFirewall = true; | |||
virtualHosts."cache.example.org".extraConfig = '' | |||
reverse_proxy 127.0.0.1:5000 | |||
''; | |||
}; | }; | ||
</syntaxhighlight> | </syntaxhighlight>Visit https://cache.example.org where you'll also find instructions on how to setup the cache on a client. | ||
Latest revision as of 09:51, 23 October 2026
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
First generate required public and private store keys, in this example for the domain cache.example.org.
mkdir -p /var/lib/harmonia
nix-store --generate-binary-cache-key cache.example.org-1 \
/var/lib/harmonia/cache-priv-key.pem \
/var/lib/harmonia/cache-pub-key.pem
Add following snippet to your system configuration and apply it.
services.harmonia = {
cache.enable = true;
signKeyPaths = [ "/var/lib/harmonia/cache-priv-key.pem" ];
};
The cache will be served on http://127.0.0.1:5000. It should be served with a web server such as Caddy.
services.caddy = {
enable = true;
openFirewall = true;
virtualHosts."cache.example.org".extraConfig = ''
reverse_proxy 127.0.0.1:5000
'';
};
Visit https://cache.example.org where you'll also find instructions on how to setup the cache on a client.