Keyboard shortcuts

Press ← or β†’ to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Introduction

Colmena is a simple, stateless NixOS deployment tool modeled after NixOps and morph, written in Rust. It’s a thin wrapper over Nix commands like nix-instantiate and nix-copy-closure, and supports parallel deployment.

Interested? Get started here!

$ colmena apply --on @tag-a [INFO ] Enumerating nodes... [INFO ] Selected 7 out of 45 hosts. (...) βœ… 0s Build successful sigma πŸ•— 7s copying path '/nix/store/h6qpk8rwm3dh3zsl1wlj1jharzf8aw9f-unit-haigha-agent.service' to 'ssh://root@sigma.redacted'... theta βœ… 7s Activation successful gamma πŸ•˜ 8s Starting... alpha βœ… 1s Activation successful epsilon πŸ•— 7s copying path '/nix/store/fhh4rfixny8b21l6jqzk7nqwxva5k20h-nixos-system-epsilon-20.09pre-git' to 'ssh://root@epsilon.redacted'... beta πŸ•— 7s removing obsolete file /boot/kernels/z28ayg10kpnlrz0s2qrb9pzv82lc20s2-initrd-linux-5.4.89-initrd kappa βœ… 2s Activation successful

You are currently reading version 0.5 of the Colmena Manual, built against version 0.5.0.