docker-compose-to-nixos

What problem does it solve?

This Skill automates the complex process of translating Docker Compose configurations into NixOS modules using the dendritic pattern with Arion. It reduces manual translation time, ensures consistency, and enables seamless Tailscale integration for secure external access.

Core Features & Use Cases

• Automated Docker Compose to Arion mapping: Converts services into Arion/NixOS module structures suitable for deployment.

• Deterministic user and group management: Creates system users and groups with UID/GID sourced from the repository inventory.

• Sops-based secrets templates: Generates secrets placeholders and environment templates rendered at runtime.

• Arion-based deployment model: Produces a docker-compose-like Arion configuration within NixOS modules.

• Tailscale integration: Exposes services via Tailscale for secure remote access.

• Use Case: When migrating from docker-compose to NixOS, this skill speeds up the conversion, reduces errors, and ensures reproducible deployments.

Quick Start

Place your docker-compose.yaml in the project and trigger the skill. It will output NixOS modules under modules/services/, plus Arion-based configuration and a Tailscale integration ready for deployment. Then run the validation workflow (e.g., just eval-nixos) to verify correctness.