2 releases

0.1.1 Apr 26, 2024
0.1.0 Mar 28, 2024

#6 in #nix-build

MIT license

66KB
2K SLoC

nix-remote

This is a re-implementation of Nix's remote build protocol. The main objectives are:

  • to express the protocol declaratively, as much as possible;
  • to document the protocol better than it has been so far;
  • to provide a library for tools making use of Nix remote builds.

So far, the library has been used to implement a nix remote proxy, which forwards commands to a real nix-daemon, while inspecting the commands and the responses. I believe that we have implemented all worker ops used in the current version of the nix protocol. (Nix itself supports more ops, but only for backwards-compatibility.)

Usage

To build the project and use nix to connect to it as remote, run:

cargo build
nix store ping --store 'ssh-ng://localhost?remote-program=/PATH/TO/nix-remote-rust/target/debug/nix-remote'

Dependencies

~5–11MB
~130K SLoC