services-flake/README.md

38 lines
1.8 KiB
Markdown
Raw Normal View History

2024-02-22 16:19:37 +03:00
[![project chat](https://img.shields.io/badge/zulip-join_chat-brightgreen.svg)](https://nixos.zulipchat.com/#narrow/stream/414011-services-flake)
2023-06-20 00:44:27 +03:00
# services-flake
Declarative, composable, and reproducible services for Nix development environment, as a [process-compose-flake](https://github.com/Platonic-Systems/process-compose-flake) module (based on [flake-parts](https://flake.parts)). Enabling users to have NixOS-like service on MacOS and Linux.
![Demo](./doc/demo.gif)
2023-07-10 20:18:46 +03:00
## Getting Started
See <https://community.flake.parts/services-flake/start>
2023-06-20 01:01:04 +03:00
## Services available
See the list [here](nix/default.nix).
## A note on process working directory
2023-12-19 17:03:09 +03:00
The `dataDir` of these services tend to take *relative* paths, which are usually relative to the project root. As such, when you run these services using `nix run`, their data files are created relative to whichever directory you are in. If you want these data files to always reside relative to the project directory, instead of using `nix run` consider wrapping the process-compose packages in script, via either [mission-control](https://community.flake.parts/mission-control) module or a [justfile](https://just.systems/). The example uses the latter.
2023-11-22 22:20:14 +03:00
## Discussions
To discuss the project, please [join our Zulip](https://nixos.zulipchat.com/#narrow/stream/414011-services-flake).
## Contributing & Development
See <https://community.flake.parts/services-flake/contributing>
## Credits
2023-06-21 17:00:29 +03:00
Thanks to [the devenv project](https://github.com/cachix/devenv/tree/main/src/modules/services) on which much of our services implementation is based on.
2023-06-27 03:56:27 +03:00
## FAQ
### Why not re-use devenv service modules?
This is currently not possible (nor prioritized by the devenv project), which is why we must create our own services. See <https://github.com/cachix/devenv/issues/75>