all repos — searchix @ 53a00f3ac15f1d32693a4db1b32c5af583b68f6b

Search engine for NixOS, nix-darwin, home-manager and NUR users

docs: document how to run an instance
Alan Pearce alan@alanpearce.eu
Wed, 22 May 2024 13:29:26 +0200
commit

53a00f3ac15f1d32693a4db1b32c5af583b68f6b

parent

4197ece130242467189b39619f9e9c6b272b8474

1 files changed, 44 insertions(+), 0 deletions(-)

jump to
A docs/running.md
@@ -0,0 +1,44 @@+# Running an instance
+
+## Requirements:
+
+-   400MiB disk space
+-   <100MiB RAM
+
+This [repository](https://git.alanpearce.eu/searchix) (or its [sourcehut mirror](https://git.sr.ht/~alanpearce/searchix)) is importable as a flake containing a NixOS module.
+
+```nix
+{
+  inputs.searchix.url = "git+https://git.alanpearce.eu/searchix";
+  # or
+  inputs.searchix.url = "sourcehut:~alanpearce/searchix";
+
+  outputs = { self, nixpkgs, searchix }: {
+    nixosConfigurations.<hostname> = nixpkgs.lib.nixosSystem {
+      modules = [
+        searchix.modules.web
+      ];
+    };
+  };
+}
+```
+
+This will then expose the following schema:
+
+```nix
+services.searchix = {
+  enable = true;
+# user = "searchix";
+# group = "searchix";
+# homeDir = "/var/lib/searchix";
+# settings = {
+#   web = {
+#     port = 51313;
+#     listenAddress = "localhost";
+#     baseURL = "http://localhost:51313";
+#   };
+# };
+};
+```
+
+Where `settings` complies with [NixOS RFC 42 (settings options)](https://github.com/NixOS/rfcs/pull/42); see the [default values](../defaults.toml) for reference.