mirror of
https://github.com/logos-storage/logos-storage-nim.git
synced 2026-01-02 13:33:10 +00:00
59 lines
1.5 KiB
Markdown
59 lines
1.5 KiB
Markdown
# 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). |