Nix/NixOS Installation #

NixOS Module #

This repo exposes a NixOS module at nixosModules.default.

Via flake input #

{
  inputs.arabica.url = "github:<you>/arabica";

  outputs = { self, nixpkgs, arabica, ... }: {
    nixosConfigurations.my-host = nixpkgs.lib.nixosSystem {
      system = "x86_64-linux";
      modules = [
        arabica.nixosModules.default
        ({ ... }: {
          services.arabica = {
            enable = true;
            dataDir = "/var/lib/arabica";

            settings = {
              port = 18910;
              logLevel = "info";
              secureCookies = true;
              # publicUrl = "https://arabica.example.com";
            };

            oauth = {
              clientId = "https://arabica.example.com/client-metadata.json";
              redirectUri = "https://arabica.example.com/oauth/callback";
            };
          };
        })
      ];
    };
  };
}

Via local checkout #

{
  imports = [ ./nix/module.nix ];

  services.arabica = {
    enable = true;
    dataDir = "/var/lib/arabica";

    settings = {
      port = 18910;
      logLevel = "info";
      secureCookies = false; # only for local/dev http
    };

    oauth = {
      clientId = "https://arabica.example.com/client-metadata.json";
      redirectUri = "https://arabica.example.com/oauth/callback";
    };
  };
}

Build/Run Manually (flake) #

# Build package
nix build .#arabica

# Run built binary
./result/bin/arabica

# Or run directly
nix run .#arabica

By default the wrapper stores data at ~/.local/share/arabica/arabica.db when ARABICA_DB_PATH is not set.