NixOS-like services for Nix flakes
Go to file
shivaraj-bh 87ad31ec21 add contribuiting to index; set order of contributing to -9
contributing will appear after Getting started in the sidebar
2024-02-27 06:26:10 -05:00
.github/workflows Revert "ci: Don't upgrade Nix behind the scenes" (#94) 2024-02-11 04:52:32 -05:00
dev explicitly define project root in treefmt (#103) 2024-02-20 11:06:02 +05:30
doc add contribuiting to index; set order of contributing to -9 2024-02-27 06:26:10 -05:00
example Update process-compose-flake (#111) 2024-02-24 06:59:35 -05:00
nix clickhouse: use lib.recursiveUpdate to deep merge extraConfig (#110) 2024-02-22 22:32:52 +05:30
test Update process-compose-flake (#111) 2024-02-24 06:59:35 -05:00
.envrc Revert "dev flake: check example and tests" 2023-07-10 19:36:14 -04:00
.gitignore Development and contribution guidelines (#112) 2024-02-24 17:54:57 +05:30
flake.nix explicitly define project root in treefmt (#103) 2024-02-20 11:06:02 +05:30
justfile Development and contribution guidelines (#112) 2024-02-24 17:54:57 +05:30
LICENSE Initial commit 2023-06-19 17:44:27 -04:00
README.md Development and contribution guidelines (#112) 2024-02-24 17:54:57 +05:30

project chat

services-flake

Declarative, composable, and reproducible services for Nix development environment, as a process-compose-flake module (based on flake-parts). Enabling users to have NixOS-like service on MacOS and Linux.

Demo

Getting Started

See https://community.flake.parts/services-flake/start

Services available

See the list here.

A note on process working directory

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 module or a justfile. The example uses the latter.

Discussions

To discuss the project, please join our Zulip.

Contributing & Development

See https://community.flake.parts/services-flake/contributing

Credits

Thanks to the devenv project on which much of our services implementation is based on.

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