Awesome
services-flake
services-flake provides declarative, composable and reproducible services for Nix development environment, as a process-compose-flake module (based on flake-parts). It enables users to have NixOS-like services on macOS and Linux.
Motivation
services-flake is designed to solve the following problems:
- Run external services like databases, Redis, etc. natively across platforms.
- Enable users to configure multiple instances of these external services.
- Provide project-specific service configuration and data isolation.
Consider a scenario where we are juggling two projects, located at ~/code/foo and ~/code/bar. The foo project integrates postgres and nginx, while bar encompasses postgres, pgAdmin, and kafka. It's crucial that the postgres data remains segregated across these projects. Additionally, the bar project is designed to facilitate multiple instances of postgres. Both projects are equipped with a flake app, streamlining the launch of their respective service stacks. Consequently, anyone using a Linux or macOS system can effortlessly clone either project and execute nix run .#services to activate the full suite of services without the need for manual configuration.
Getting Started
See https://community.flake.parts/services-flake/start
Services available
List of supported services is available at https://community.flake.parts/services-flake/services
Comparison with other tools
| services-flake | devenv services | |
|---|---|---|
| macOS support | ✔️ | ✔️ |
| Pure Flakes | ✔️ | ✖️1 |
| Services as flake apps | ✔️ | ✖️2 |
| Multiple instances of a service | ✔️ | ✖️3 |
| Share services | ✔️ | ✖️4 |
| No coupling | ✔️ | ✖️5 |
Want to compare with other tools? Let us know.
Service data directory
See https://community.flake.parts/services-flake/datadir
Discussions
To discuss the project, please join our Zulip or post in Github Discussions.
Contributing & Development
See https://community.flake.parts/services-flake/contributing
Credits
Thanks to the devenv project, which originally inspired this project to provide the same for Nix flake users.
Thanks to all the contributors!
<a href="https://github.com/juspay/services-flake/graphs/contributors"> <img src="https://contributors-img.web.app/image?repo=juspay/services-flake" alt="Contributors"/> </a>Footnotes
-
Devenv's flakes integration requires you use run the nix shell in impure mode by passing
--impure. ↩ -
services-flakeproduces a flake app that you can run using the Nix command (nix run) outside of the devShell, whereas with devenv you must use devenv's CLI,devenv up, inside of devShell. See here. ↩ -
services-flakeallows you to configure multiple instances of the same service, whereas devenv does not. ↩ -
services-flakeis built on top of flake-parts, thus you may share your service and process modules for re-use across flakes (see example), whilst making them general enough for customization based on the module system. With devenv, as far as we can ascertain, you can only share whole devenv configuration as modules. See here. ↩ -
service-flakeexposesprocess-compose-flakemodules for each service, which can be reused as long as your project is usingflake-parts. With devenv, decoupling is not possible (nor prioritized in future) unless you buy into the whole devenv ecosystem. ↩