Skip to content

Options Reference

perSystem.n2c

Build archive-less docker images with nix2container!

Exposes low/high-level nix2container functionality as options.

Type: submodule

Default: { }

Declared by:

perSystem.n2c.check

Whether to image builds, … to the checks of this flake.

Type: submodule

Default: { }

Declared by:

perSystem.n2c.check.imageActions

Whether to add image actions (from do) to the checks of this flake.

Type: boolean

Default: false

Declared by:

perSystem.n2c.check.images

Whether to add image builds to the checks of this flake.

Type: boolean

Default: true

Declared by:

perSystem.n2c.images

Exposes options for invoking nix2container.buildImage and make composing/copying/running these images easy.

Type: lazy attribute set of (submodule)

Default: { }

Declared by:

perSystem.n2c.images.<name>.copyToRoot

A list of derivations copied in the image root directory.

Store path prefixes /nix/store/hash-path are removed, in order to relocate them at the image /.

Type: list of package

Default: [ ]

Declared by:

perSystem.n2c.images.<name>.do.copy

Copy your image to various targets with skopeo.

Type: submodule

Declared by:

perSystem.n2c.images.<name>.do.copy.to

Invoke scopeo copy without specifying the target yet – provide your own!

Type: package

Declared by:

perSystem.n2c.images.<name>.do.copy.toDockerDaemon

Copy the image to your default docker daemon.

Type: package

Declared by:

perSystem.n2c.images.<name>.do.copy.toPodman

Copy the image to podman store.

Type: package

Declared by:

perSystem.n2c.images.<name>.do.copy.toRegistry

Copy the image to its canonical registry with matching imageName/imageTag.

Type: package

Declared by:

perSystem.n2c.images.<name>.do.run

Binaries to run your image.

Type: submodule

Declared by:

perSystem.n2c.images.<name>.do.run.interactivelyInDocker

Load the image and run it interactively (run -it) in the locally installed docker.

Type: package

Declared by:

perSystem.n2c.images.<name>.do.run.interactivelyWithPodman

Load the image and run it interactively (run -it) in the locally installed podman.

Type: package

Declared by:

perSystem.n2c.images.<name>.imageConfig

The OCI image config.

Type: submodule

Declared by:

perSystem.n2c.images.<name>.imageConfig.cmd

This option has no description.

Type: null or (list of string)

Default: null

Declared by:

perSystem.n2c.images.<name>.imageConfig.entrypoint

This option has no description.

Type: null or (list of string)

Default: null

Declared by:

perSystem.n2c.images.<name>.imageConfig.raw

The attrs as passed to nix2container.buildImage as config arguement.

Everything in the OCI ImageConfig should be allowed:

https://github\.com/opencontainers/image-spec/blob/8b9d41f48198a7d6d0a5c1a12dc2d1f7f47fc97f/specs-go/v1/config\.go\#L23

Type: lazy attribute set of unspecified value

Declared by:

perSystem.n2c.images.<name>.name

The name of the container – reexported for convenience.

Type: string

Default: "‹name›"

Declared by:

perSystem.n2c.images.<name>.result

The JSON descriptor for the resulting image - the return value of the nix2container.buildImage.

Type: package

Declared by: