skills.rest
binarin
binarinCOMMUNITY
Explore all skills by this author →
GitHub

docker-compose-to-nixos

Convert Docker Compose configurations to Arion-based NixOS modules.

20|Updated Apr 14, 2016
Search Tags:#automation#infrastructure-as-code#docker-compose#tailscale#nixos#arion
One-click install
npx skills add https://github.com/binarin/nixos-config --skill docker-compose-to-nixos
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: docker-compose-to-nixos
Source: https://github.com/binarin/nixos-config/tree/main/files/claude-skills/docker-compose-to-nixos
Command: npx skills add https://github.com/binarin/nixos-config --skill docker-compose-to-nixos

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about docker-compose-to-nixos

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

FAQPage Schema
How do I convert a Docker Compose file to NixOS?▼

Convert Docker Compose to NixOS by using Arion, which translates docker-compose.yaml services into NixOS modules. Place your docker-compose.yaml in the project, trigger the conversion, and output NixOS modules under modules/services/ with Arion-based configuration ready for deployment.

Can I automate user and group creation when migrating to NixOS?▼

Yes. The conversion generates deterministic system users and groups with UID/GID sourced from repository inventory, automating user management during Docker Compose to NixOS migration and ensuring reproducible deployments across environments.

Does Docker Compose to NixOS conversion support secrets management?▼

Yes. The conversion generates sops-based secrets templates and environment placeholders rendered at runtime, providing secure secrets handling integrated into the NixOS module structure during the Docker Compose translation process.

How can I expose NixOS services securely for remote access?▼

Integrate Tailscale during Docker Compose to NixOS conversion to expose services via Tailscale for secure external access, eliminating manual network configuration and enabling safe remote connectivity for migrated services.

What's the fastest way to migrate a multi-service Docker Compose setup to NixOS?▼

Automated conversion reduces manual translation time and ensures consistency by mapping Docker Compose services, volumes, networks, and secrets directly into Arion-based NixOS modules, then validate with evaluation workflows like just eval-nixos.

Do I need to manually configure directory structures and temporary files in NixOS?▼

No. The conversion automatically sets up directory structures via tmpfiles configuration, eliminating manual tmpfiles setup and ensuring consistent filesystem state across NixOS deployments.

Related Skills

Explore More Software Engineering Skills→
rennerenne

compose-file-reference

Reference Docker Compose file format elements for compose.yaml configuration.

Community
Basic
olafkfreundolafkfreund
21

tailscale

Configure, test, and monitor Tailscale VPN on NixOS.

Community
Advanced
johnnymo87johnnymo87
4

Managing Secrets

Automate secret encryption, decryption, rotation, and deployment in NixOS workflows.

Community
Advanced
reverb256reverb256

container-native

Manage Docker and Podman containers and images on NixOS.

Community
Intermediate