running-containers

Orchestrate Podman containers and NixOS homeserver services with Caddy HTTPS reverse proxy.

4|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/greenheadHQ/nixos-config --skill running-containers
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: running-containers
Source: https://github.com/greenheadHQ/nixos-config/tree/main/.claude/skills/running-containers
Command: npx skills add https://github.com/greenheadHQ/nixos-config --skill running-containers

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The Skill provides a centralized, declarative approach to manage Podman containers and NixOS homeserver services, reducing manual setup and drift.

Core Features & Use Cases

  • Orchestrates Podman containers and related services using common runtime and NixOS options.
  • Configures a Caddy HTTPS reverse proxy to expose services under a domain and manage TLS.
  • Supports service updates, backups, and port mappings for a suite of home services (Immich, Uptime Kuma, Copyparty, Vaultwarden, Karakeep).
  • Enables deterministic deployment via mkOption-based modules and shared service libraries.

Quick Start

Enable the relevant homeserver options in your NixOS configuration and rebuild the system to apply Podman-based services and the reverse proxy.

Frequently Asked Questions about running-containers

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I orchestrate Podman containers on NixOS declaratively?

You can orchestrate Podman containers on NixOS declaratively by using mkOption-based modules and shared service libraries to define home infrastructure, ensuring deterministic deployments and reducing manual setup drift. This approach centralizes container configuration across multiple services.

How do I configure a Caddy reverse proxy for Podman containers in NixOS?

Configuring a Caddy reverse proxy for Podman containers in NixOS involves enabling specific homeserver options that automatically route traffic and manage TLS certificates. This exposes your containerized services securely under a domain without manual certificate provisioning.

Can I manage backups and updates for homeserver services like Immich and Vaultwarden using NixOS?

Yes, you can manage backups and updates for homeserver services like Immich and Vaultwarden using NixOS. The declarative configuration supports service updates, backups, and port mappings across a suite of home applications through centralized mkOption modules.

Do I need Podman installed before applying NixOS homeserver modules?

Yes, you need the Podman runtime installed and active before applying NixOS homeserver modules. The orchestration Skill configures and deploys containers using the Podman runtime, alongside Caddy for HTTPS reverse proxying and shared service library support.

What is the best way to maintain multiple home services without configuration drift?

The best way to maintain multiple home services without configuration drift is through a centralized, declarative approach using NixOS mkOption-based modules. This method ensures deterministic deployment and centralized maintenance for services like Uptime Kuma and Copyparty.

Does this NixOS container orchestration approach support automatic HTTPS setup?

Yes, this NixOS container orchestration approach supports automatic HTTPS setup by integrating a Caddy reverse proxy. Caddy automatically manages TLS certificates to securely expose your Podman-based home services under your configured domain.