NixOS-like services for Nix flakes
Go to file
Shivaraj B H 9b806b53f3
postgres: always create socketDir during init if not already present (#88)
If the socketDir is in tmpfs, or if it is deleted by some other process, we would want the socketDir to be created, if not already present, on restarts.
2024-01-31 18:47:52 +05:30
.github/workflows ci: Don't upgrade Nix behind the scenes (#79) 2024-01-18 00:06:29 -05:00
dev docs: flakular rename 2023-11-17 15:08:15 -05:00
doc docs/clickhouse: Use heading anchors (#86) 2024-01-24 23:04:28 +05:30
example [Postgres]: Fix test process not starting (#78) 2024-01-18 11:28:15 +05:30
nix postgres: always create socketDir during init if not already present (#88) 2024-01-31 18:47:52 +05:30
test Add Clickhouse service (#85) 2024-01-24 20:54:26 +05:30
.envrc Revert "dev flake: check example and tests" 2023-07-10 19:36:14 -04:00
.gitignore Add dev flake 2023-06-21 16:07:19 -04:00
flake.nix [Docs] Home page and getting started (#83) 2024-01-21 17:59:30 +05:30
justfile Process as test (VM -> Native test) (#38) 2023-08-23 22:47:20 +05:30
LICENSE Initial commit 2023-06-19 17:44:27 -04:00
README.md [Docs] Home page and getting started (#83) 2024-01-21 17:59:30 +05:30

services-flake

NixOS-like services for Nix flakes, as a process-compose-flake module (based on flake-parts).

Getting Started

$ nix flake new --template github:juspay/services-flake ./my-project
$ cd my-project
$ nix run

Or see ./test/flake.nix

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

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