https://github.com/mirkolenz/quadlet-nix

NixOS module for Quadlet / podman-systemd
https://github.com/mirkolenz/quadlet-nix

containers home-manager nix nixos podman quadlet systemd

Last synced: 11 months ago
JSON representation

NixOS module for Quadlet / podman-systemd

• Host: GitHub
• URL: https://github.com/mirkolenz/quadlet-nix
• Owner: mirkolenz
• License: mit
• Created: 2025-01-10T10:21:37.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-07-21T06:06:50.000Z (11 months ago)
• Last Synced: 2025-07-21T08:13:35.315Z (11 months ago)
• Topics: containers, home-manager, nix, nixos, podman, quadlet, systemd
• Language: Nix
• Homepage: https://mirkolenz.github.io/quadlet-nix/
• Size: 83 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# quadlet-nix

NixOS module for [Quadlet / podman-systemd](https://docs.podman.io/en/latest/markdown/podman-systemd.unit.5.html).

Inspired by the excellent work of [SEIAROTg](https://github.com/SEIAROTg/quadlet-nix), but rewritten from scratch.

You can get started with the following minimal configuration:

```nix

{

  inputs = {

    nixpkgs.url = "github:nixos/nixpkgs/nixpkgs-unstable";

    quadlet-nix = {

      url = "github:mirkolenz/quadlet-nix/v1";

      inputs.nixpkgs.follows = "nixpkgs";

    };

  };

  outputs = {nixpkgs, flocken, ...}:  {

    nixosConfigurations.default = nixpkgs.lib.nixosSystem {

      system = "x86_64-linux";

      modules = [

        ({pkgs, ...}: {

          virtualisation.quadlet.enable = true;

          virtualisation.quadlet.containers = {

            hello-world = {

              containerConfig.Image = "docker.io/library/hello-world:latest";

            };

            nginx = {

              imageStream = pkgs.dockerTools.examples.nginxStream;

            };

          };

        })

      ];

    };

  };

}

```

All available options are described in the [documentation](https://mirkolenz.github.io/quadlet-nix/nixos-options.html).

You may also want to take a look at the [tests](https://github.com/mirkolenz/quadlet-nix/blob/main/tests/nixos.nix) for more examples.