Skip to main content
Nur Nix provides pre-built container images that can be pulled and used in your Nix configurations with content-addressed hashing for reproducibility.

​
Available Images

FFmpeg

FFmpeg 8.0.1 container image from LinuxServer.io

Nix

Official Nix 2.34.0 container image from NixOS

​
Why Pre-Built Images?

These container images are wrapped with Nix for several benefits:
Each image is pinned to a specific digest with a Nix content hash, ensuring the exact same image is pulled every time.
Images can be referenced directly in Nix flakes and expressions, making them first-class citizens in your Nix infrastructure.
Define your entire container setup in Nix, from the base image to the runtime configuration.
These images include fixes for known Nixpkgs issues (e.g., #445481).

​
Quick Start

​
Using in a Flake

Add Nur Nix to your flake inputs:
flake.nix
{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    nur-nix.url = "github:yourusername/nur-nix";
  };

  outputs = { self, nixpkgs, nur-nix }: {
    # Use the images in your configuration
    packages.x86_64-linux.default = nur-nix.images.x86_64-linux.ffmpeg;
  };
}

​
Building an Image

Build and load a container image: 
# Build the FFmpeg image
nix build github:yourusername/nur-nix#images.x86_64-linux.ffmpeg

# Load into Docker
docker load < result

​
Image Architecture

All images are built for linux/amd64 architecture and use dockerTools.pullImage from Nixpkgs to fetch upstream images with verification.

​
Structure

Each image definition includes:
  • Image Name: The upstream Docker image reference
  • Tag: Specific version tag (e.g., 8.0.1, 2.34.0)
  • Digest: SHA256 digest for the exact image manifest
  • Hash: Nix content hash for reproducibility
  • Attributes: Special attributes for structured attrs and reference handling
The unsafeDiscardReferences attribute is required due to Nixpkgs issue #445481 to properly handle image references.

​
Next Steps

FFmpeg Image

Learn about the FFmpeg container image

Nix Image

Explore the official Nix container image

Build docs developers (and LLMs) love

Get started for freeTalk to us