logos-storage-nim/nix/README.md

# Usage

## Shell

A development shell can be started using:
```sh
nix develop '.?submodules=1#'
```

## Building

To build a Logos Storage you can use:
```sh
nix build '.?submodules=1#default'
```
The `?submodules=1` part should eventually not be necessary.
For more details see:
https://github.com/NixOS/nix/issues/4423

It can be also done without even cloning the repo:
```sh
nix build 'git+https://github.com/logos-storage/logos-storage-nim?submodules=1#'
```

## Running

```sh
nix run 'git+https://github.com/logos-storage/logos-storage-nim?submodules=1#''
```

## Testing

```sh
nix flake check ".?submodules=1#"
```

## Running Logos Storage as a service on NixOS

Include logos-storage-nim flake in your flake inputs:
```nix
inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-24.11";
    logos-storage-nim-flake.url = "git+https://github.com/logos-storage/logos-storage-nim?submodules=1#";
};
```

To configure the service, you can use the following example:
```nix
services.logos-storage-nim = {
   enable = true;
   settings = {
       data-dir = "/var/lib/storage-test";
   };
};
```
The settings attribute set corresponds directly to the layout of the TOML configuration file 
used by logos-storage-nim. Each option follows the same naming convention as the CLI flags, but 
with the -- prefix removed. For more details on the TOML file structure and options, 
refer to the official documentation: [logos-storage-nim configuration file](https://docs.codex.storage/learn/run#configuration-file).