Installation

Norgolith can be installed in multiple ways depending on your environment and preferences. Below are the recommended methods:

Important

The Norgolith binary is called lith and not norgolith, this is for ergonomic reasons.

Binary Installation

via Releases

For stable releases, statically compiled binaries with musl are provided in the releases section. There are binaries for Linux and macOS (x86_64 and arm64). Windows is currently unsupported by Norgolith.

The release tarballs contains the following files:

via Cargo

You can also install Norgolith using cargo, however this might add an additional step which is compiling the source code. Prefer this way if you want to use a development version.

Prerequisites:

# Install from the repository
cargo install --git https://github.com/NTBBloodbath/norgolith --locked

# Verify the installation
lith --version

Nix Flake

You can add Norgolith to your NixOS configuration with Nix flakes.

Prerequisites:

Add Norgolith to your system packages:

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";

    norgolith.url = "github:NTBBloodbath/norgolith";
  };

  outputs = { nixpkgs, norgolith, ... }: {
    nixosConfigurations.mysystem = nixpkgs.lib.nixosSystem {
      modules = [
        {
          # add norgolith as a package
          environment.systemPackages = [
            norgolith.packages.x86_64-linux.default
          ];
        }
      ];
    };
  };
}
Special thanks to @Ladas552 for providing this example flake!

Next: Create your first site →