forked from lix-project/lix
79 lines
2.5 KiB
Markdown
79 lines
2.5 KiB
Markdown
|
Title: nix-copy-closure
|
|||
|
|
|
|||
|
|
# Name
|
|||
|
|
|
|||
|
|
`nix-copy-closure` - copy a closure to or from a remote machine via SSH
|
|||
|
|
|
|||
|
|
# Synopsis
|
|||
|
|
|
|||
|
|
`nix-copy-closure` [`--to` | `--from`] [`--gzip`] [`--include-outputs`] [`--use-substitutes` | `-s`] [`-v`] _user@machine_ _paths_
|
|||
|
|
|
|||
|
|
# Description
|
|||
|
|
|
|||
|
|
`nix-copy-closure` gives you an easy and efficient way to exchange
|
|||
|
|
software between machines. Given one or more Nix store _paths_ on the
|
|||
|
|
local machine, `nix-copy-closure` computes the closure of those paths
|
|||
|
|
(i.e. all their dependencies in the Nix store), and copies all paths
|
|||
|
|
in the closure to the remote machine via the `ssh` (Secure Shell)
|
|||
|
|
command. With the `--from` option, the direction is reversed: the
|
|||
|
|
closure of _paths_ on a remote machine is copied to the Nix store on
|
|||
|
|
the local machine.
|
|||
|
|
|
|||
|
|
This command is efficient because it only sends the store paths
|
|||
|
|
that are missing on the target machine.
|
|||
|
|
|
|||
|
|
Since `nix-copy-closure` calls `ssh`, you may be asked to type in the
|
|||
|
|
appropriate password or passphrase. In fact, you may be asked _twice_
|
|||
|
|
because `nix-copy-closure` currently connects twice to the remote
|
|||
|
|
machine, first to get the set of paths missing on the target machine,
|
|||
|
|
and second to send the dump of those paths. If this bothers you, use
|
|||
|
|
`ssh-agent`.
|
|||
|
|
|
|||
|
|
# Options
|
|||
|
|
|
|||
|
|
*`--to`*
|
|||
|
|
: Copy the closure of _paths_ from the local Nix store to the Nix
|
|||
|
|
store on _machine_. This is the default.
|
|||
|
|
|
|||
|
|
*`--from`*
|
|||
|
|
: Copy the closure of _paths_ from the Nix store on _machine_ to the
|
|||
|
|
local Nix store.
|
|||
|
|
|
|||
|
|
*`--gzip`*
|
|||
|
|
: Enable compression of the SSH connection.
|
|||
|
|
|
|||
|
|
*`--include-outputs`*
|
|||
|
|
: Also copy the outputs of store derivations included in the closure.
|
|||
|
|
|
|||
|
|
*`--use-substitutes` / `-s`*
|
|||
|
|
: Attempt to download missing paths on the target machine using Nix’s
|
|||
|
|
substitute mechanism. Any paths that cannot be substituted on the
|
|||
|
|
target are still copied normally from the source. This is useful,
|
|||
|
|
for instance, if the connection between the source and target
|
|||
|
|
machine is slow, but the connection between the target machine and
|
|||
|
|
`nixos.org` (the default binary cache server) is
|
|||
|
|
fast.
|
|||
|
|
|
|||
|
|
*`-v`*
|
|||
|
|
: Show verbose output.
|
|||
|
|
|
|||
|
|
# Environment variables
|
|||
|
|
|
|||
|
|
*`NIX_SSHOPTS`*
|
|||
|
|
: Additional options to be passed to `ssh` on the command
|
|||
|
|
line.
|
|||
|
|
|
|||
|
|
# Examples
|
|||
|
|
|
|||
|
|
Copy Firefox with all its dependencies to a remote machine:
|
|||
|
|
|
|||
|
|
$ nix-copy-closure --to alice@itchy.labs $(type -tP firefox)
|
|||
|
|
|
|||
|
|
Copy Subversion from a remote machine and then install it into a user
|
|||
|
|
environment:
|
|||
|
|
|
|||
|
|
$ nix-copy-closure --from alice@itchy.labs \
|
|||
|
|
/nix/store/0dj0503hjxy5mbwlafv1rsbdiyx1gkdy-subversion-1.4.4
|
|||
|
|
$ nix-env -i /nix/store/0dj0503hjxy5mbwlafv1rsbdiyx1gkdy-subversion-1.4.4
|
|||
|
|
|