Jump to content

Harmonia: Difference between revisions

From Official NixOS Wiki
Onny (talk | contribs)
Switched to harmonia
Onny (talk | contribs)
m Onny moved page Nix-serve to Harmonia
(No difference)

Revision as of 12:05, 20 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.

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

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

Add following snippet to your system configuration and apply it.

services.harmonia = {
  enable = true;
  secretKeyFile = "/var/lib/harmonia/cache-priv-key.pem";
};

The cache will be served on http://127.0.0.1:5000.

services.caddy = {
  enable = true;
  openFirewall = true;
  virtualHosts."cache.example.org".extraConfig = ''
    reverse_proxy 127.0.0.1:5000
  '';
};