lix/src/nix/bundle.md

1.4 KiB

R""(

Examples

  • Bundle Hello:

    # nix bundle nixpkgs#hello
    # ./hello
    Hello, world!
    
  • Bundle a specific version of Nix:

    # nix bundle github:NixOS/nix/e3ddffb27e5fc37a209cfd843c6f7f6a9460a8ec
    # ./nix --version
    nix (Nix) 2.4pre20201215_e3ddffb
    
  • Bundle a Hello using a specific bundler:

    # nix bundle --bundler github:NixOS/bundlers#toDockerImage nixpkgs#hello
    # docker load < hello-2.10.tar.gz
    # docker run hello-2.10:latest hello
    Hello, world!
    

Description

nix bundle, by default, packs the closure of the installable into a single self-extracting executable. See the bundlers homepage for more details.

Note

This command only works on Linux.

Bundler definitions

If no flake output attribute is given, nix bundle tries the following flake output attributes:

  • defaultBundler.<system>

If an attribute name is given, nix run tries the following flake output attributes:

  • bundler.<system>.<name>

Bundlers

An bundlers is specified by a flake output attribute named bundlers.<system>.<name> or defaultBundler.<system>. It looks like this:

bundlers.x86_64-linux.identity = drv: drv;

bundlers.x86_64-linux.blender_2_79 = drv: self.packages.x86_64-linux.blender_2_79;

defaultBundler.x86_64-linux = drv: drv;

A bundler must be a function that accepts a derivation and returns a derivation.

)""