Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

docker-nixpkgs: docker images from nixpkgs

This project is a collection of docker images automatically produced with Nix and the latest nixpkgs package set. All the images are refreshed daily with the latest versions of nixpkgs.

It's also a good demonstration on how to build and publish Docker images with Nix.

Always keep your docker images fresh!

Why use Nix to build docker images?

Nix has a number of advantages over Dockerfile when producing docker images:

  • builds are more likely to be repeatable and binary reproducible
  • Nix will only rebuild the minimum set of changes with no manual intervention
  • Nix produces optimised layers with no manual intervention
  • nixpkgs provides automatic security updates

Example usage

Here is an example of using one of the docker images. Usage will change from image to image.

# run the curl image which has curl as an entry-point
$ docker run -ti --rm nixpkgs/curl curl


Each image is built with the following nixpkgs channels and map to the following image tag.

The version of the packages included in each image depends on what version the nixpkgs channel describes.

Channel Image Tag Description
nixos-23.05 nixos-23.05 only minor versions that include security updates
nixos-23.11 nixos-23.11 only minor versions that include security updates
nixos-unstable latest latest and greatest, major versions might change

List of images

Here is the current list of images that are provided. Missing one? Send an image request.

All images are automatically built and published to Docker Hub, and served on our custom domain, courtesy of Scarf.

> ./readme-image-matrix

Image / Tag Pull
nixpkgs/bash docker pull
nixpkgs/busybox docker pull
nixpkgs/cachix docker pull
nixpkgs/cachix-flakes docker pull
nixpkgs/caddy docker pull
nixpkgs/curl docker pull
nixpkgs/devcontainer docker pull
nixpkgs/docker-compose docker pull
nixpkgs/hugo docker pull
nixpkgs/kubectl docker pull
nixpkgs/kubernetes-helm docker pull
nixpkgs/nginx docker pull
nixpkgs/nix docker pull
nixpkgs/nix-flakes docker pull
nixpkgs/nix-unstable docker pull
nixpkgs/nix-unstable-static docker pull

Adding new images

To add a new image to the project, create a new folder under ./images/<image-name> with a default.nix that returns the docker image.

Then run nix-build -A <image-name> to test that it builds, and then use docker load -i /nix/store/...<image-name>.tar.gz to load and test the image.

User Feedback


If you have any problems with or questions about this project, please contact us through a GitHub issue

Image request

Submit a request with an accompanying use-case for an image that you would like to see.


You are invited to contribute new features, fixes or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.

Related projects

  • The docker-library is an image set maintained by the Docker Inc. team and contain officially-supported images.

  • Nixery is a pretty cool service that builds docker images from nixpkgs attributes on the fly.


Copyright (c) 2021 @zimbatm and contributors.

Licensed under the MIT.