deploy-rs
A simple multi-profile Nix-flake deployment tool for managing NixOS and non-NixOS systems.
What is deploy-rs?
deploy-rs is a deployment tool built for the Nix ecosystem that uses Nix flakes to manage and deploy system configurations across multiple servers. It solves the problem of safely and flexibly deploying NixOS and non-NixOS profiles to various users and nodes, with built-in rollback protection to prevent breaking changes.
System administrators and DevOps engineers using Nix and NixOS who need granular, multi-user deployment capabilities across server clusters.
Developers choose deploy-rs for its multi-profile design that enables independent deployments per user, its safety-focused magic rollback feature, and its deep integration with Nix flakes for declarative infrastructure management.
Overview
A simple multi-profile Nix-flake deploy tool.
Use Cases
Best For
- Deploying NixOS configurations across server clusters
- Managing multi-user environments with different profile deployments
- Implementing safe deployment practices with automatic rollback
- Replacing traditional Nix deployment tools like NixOps or morph
- Deploying home-manager configurations to non-privileged users
- Building infrastructure-as-code workflows with Nix flakes
Not Ideal For
- Teams deploying applications without Nix or in environments where Nix is not adopted
- Projects requiring real-time monitoring and GUI dashboards for deployment status
- Organizations using container orchestration platforms like Kubernetes without Nix integration
Pros & Cons
Pros
Allows deploying independent profiles to any user, enabling non-root deployments and home-manager integration, as detailed in the Multi-profile section of the README.
Automatically detects and rolls back deployments that break connectivity, preventing unreachable systems, described in the Magic Rollback feature overview.
Built for Nix flakes with a fallback mode, providing a declarative configuration approach with working examples in the API section.
Includes deployChecks for nix flake check to validate deployment configurations, reducing errors early, as mentioned in the API usage.
Cons
Heavily dependent on Nix and flakes, making it unsuitable for teams not already using Nix, with limited support for other deployment paradigms.
Requires writing Nix code for deployment definitions, which can be more complex and error-prone than simpler configuration formats like YAML used in tools like Ansible.
Compared to mainstream tools, deploy-rs has a smaller ecosystem and fewer plugins for external services, relying primarily on SSH and Nix-based workflows.
Open Source Alternative To
deploy-rs is an open-source alternative to the following products:
NixOps is a tool for deploying NixOS configurations to multiple machines, both physical and virtual, providing infrastructure as code capabilities for NixOS environments.
morph is a tool for managing database schema migrations, allowing developers to apply version-controlled changes to database structures across different environments.
Frequently Asked Questions
Related Projects
ColmenaA simple, stateless NixOS deployment tool [maintainer=@zhaofengli, @stepbrobd, @NickCao]
nixopsNixOps is a tool for deploying to NixOS machines in a network or cloud.
NixeryContainer registry which transparently builds images using the Nix package manager. Canonical repository is https://cs.tvl.fyi/depot/-/tree/tools/nixery
morphNixOS deployment tool
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.