# nix

NixOS dotfiles and configuration for various hosts and users.

## Structure

- [`flake.lock`](./flake.lock) and [`flake.nix`](./flake.nix): Core Nix flake files defining the repository's dependencies and entry points.

- [`hosts/`](./hosts): All host-specific configurations.
  - [`common/`](./hosts/common): Shared configuration definitions.
    - [`shells/`](./hosts/common/shells): Nix dev shells.
    - [`configs/`](./hosts/common/configs): System configurations applicable to all hosts.
      - [`system/`](./hosts/common/configs/system): System-level configurations and scripts.
      - [`user/`](./hosts/common/configs/user): Per-user options.
        - [`console/`](./hosts/common/configs/user/console): Console-related settings.
        - [`gui/`](./hosts/common/configs/user/gui): GUI-related settings.
  - `<name>/`: Individual host configurations.

- [`overlays/`](./overlays/): Custom patches.

- [`packages/`](./packages/): Custom packages.

- [`scripts/`](./scripts): Utility scripts for managing the repository.
  - [`add-host.sh`](./scripts/add-host.sh): Instantiate the keys for a new host configuration.
  - [`remove-host.sh`](./scripts/remove-host.sh): Remove references to a host.
  - [`update-keys.sh`](./scripts/update-keys.sh): Update the encryption keys in all relevant files using `sops.yaml` configurations.
  - [`update.sh`](./scripts/update.sh): Update flake and all packages.
  - [`cache.sh`](./scripts/cache.sh): Build all `nixosConfiguration`s and push them to `attic`.

Any `options.nix` files create custom option definitions when present.

## Hosts

Below is a table of all hosts, with links to their respective README files, which may provide further details and/or post-installation checklists.

| Host          | README                                                       |
| ------------- | ------------------------------------------------------------ |
| `installer`   | [hosts/installer/README.md](./hosts/installer/README.md)     |
| `himalia`     | [hosts/himalia/README.md](./hosts/himalia/README.md)         |
| `elara`       | [hosts/elara/README.md](./hosts/elara/README.md)             |
| `jupiter`     | [hosts/jupiter/README.md](./hosts/jupiter/README.md)         |
| `jupiter-vps` | [hosts/jupiter-vps/README.md](./hosts/jupiter-vps/README.md) |