Experimental SSH Store with filesystem mounted - Nix 2.34.9 Reference Manual
Source: /pages/nix-manual/store/types/experimental-ssh-store-with-filesystem-mounted
Experimental SSH Store with filesystem mounted
Warning
This store is part of an experimental feature.
To use this store, make sure the
mounted-ssh-storeexperimental feature is enabled. For example, include the following innix.conf:extra-experimental-features = mounted-ssh-store
Store URL format: mounted-ssh-ng://[username@]hostname
Experimental store type that allows full access to a Nix store on a remote machine, and additionally requires that store be mounted in the local file system.
The mounting of that store is not managed by Nix, and must by managed manually. It could be accomplished with SSHFS or NFS, for example.
The local file system is used to optimize certain operations. For example, rather than serializing Nix archives and sending over the Nix channel, we can directly access the file system data via the mount-point.
The local file system is also used to make certain operations possible that wouldn't otherwise be. For example, persistent GC roots can be created if they reside on the same file system as the remote store: the remote side will create the symlinks necessary to avoid race conditions.
Settings
base64-ssh-public-host-keyThe public host key of the remote machine. Default: emptycompressWhether to enable SSH compression. Default:falselogdirectory where Nix stores log files. Default:/nix/var/log/nixmax-connection-ageMaximum age of a connection before it is closed. Default:4294967295max-connectionsMaximum number of concurrent connections to the Nix daemon. Default:1path-info-cache-sizeSize of the in-memory store path metadata cache. Default:65536priorityPriority of this store when used as a substituter. A lower value means a higher priority. Default:0realPhysical path of the Nix store. Default:/nix/storeremote-programPath to thenix-daemonexecutable on the remote machine. Default:nix-daemonremote-storeStore URL to be used on the remote machine. The default isauto(i.e. use the Nix daemon or/nix/storedirectly). Default: emptyrootDirectory prefixed to all other paths. Default: ``ssh-keyPath to the SSH private key used to authenticate to the remote machine. Default: emptystateDirectory where Nix stores state. Default:/dummystoreLogical location of the Nix store, usually/nix/store. Note that you can only copy store paths between stores if they have the samestoresetting. Default:/nix/storesystem-featuresOptional system features available on the system this store uses to build derivations. Example:"kvm"Default: machine-specifictrustedWhether paths from this store can be used as substitutes even if they are not signed by a key listed in thetrusted-public-keyssetting. Default:falsewant-mass-queryWhether this store can be queried efficiently for path validity when used as a substituter. Default:false
nix.dev/manual/nix/stable/store/types/experimental-ssh-store-with-filesystem-mounted.html