nix-config

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 459 Open GitHub ↗

My personal NixOS config

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# nix-config [![built with nix](https://builtwithnix.org/badge.svg)](https://builtwithnix.org) [![ci](https://github.com/lovesegfault/nix-config/actions/workflows/ci.yaml/badge.svg)](https://github.com/lovesegfault/nix-config/actions/workflows/ci.yaml)

This repository holds my Nix configurations. It uses the [nixos-unified]
framework for consistent configuration across NixOS, nix-darwin, and
home-manager.

For the configurations' entry points, see the individual [configurations], as
well as [flake.nix]. For adding overlays see [overlays](#adding-overlays).

Hostnames are picked from my [hostname list][hostnames].

## Structure

```
.
├── configurations/          # Host-specific configurations
│   ├── nixos/              # NixOS hosts
│   ├── darwin/             # nix-darwin hosts
│   └── home/               # Standalone home-manager hosts
├── modules/                 # Reusable modules
│   ├── nixos/              # NixOS-only modules
│   ├── darwin/             # Darwin-only modules
│   ├── home/               # Shared home-manager modules
│   ├── shared/             # Shared NixOS+Darwin modules
│   └── flake-parts/        # Flake-level configuration
├── overlays/               # Nixpkgs overlays
└── secrets/                # Encrypted secrets (agenix-rekey)
```

## Usage

### Deploying

The unified `activate` command works for all configuration types:

```console
$ nix run .#activate
```

This auto-detects your hostname and activates the appropriate configuration.

#### Alternative methods

**NixOS:**
```console
$ sudo nixos-rebuild --flake .#<hostname> switch
```

**Darwin:**
```console
$ darwin-rebuild --flake .#<hostname> switch
```

**Home Manager:**
```console
$ home-manager --flake .#<hostname> switch
```

### Updating inputs

To update the primary flake inputs (nixpkgs, home-manager, nix-darwin):

```console
$ nix run .#update
```

### Adding overlays

Overlays should be added as individual nix files to `./overlays/` with format:

```nix
final: prev: {
  hello = prev.hello.overrideAttrs (oldAttrs: { doCheck = false; });
}
```

For more examples see [overlays].

### Module conventions

- **nixosModules.\*** - NixOS-only modules from `modules/nixos/`
- **darwinModules.\*** - Darwin-only modules from `modules/darwin/`
- **homeModules.\*** - Shared home-manager modules from `modules/home/`

Modules are imported via flake outputs:

```nix
{ flake, ... }:
let
  inherit (flake) inputs self;
in
{
  imports = [
    self.nixosModules.default
    self.nixosModules.hardware-thinkpad-z13
  ];
}
```

[nixos-unified]: https://github.com/srid/nixos-unified
[configurations]: https://github.com/lovesegfault/nix-config/tree/master/configurations
[flake.nix]: https://github.com/lovesegfault/nix-config/blob/master/flake.nix
[hostnames]: https://gist.github.com/2a059213162c190f125c16a8d4463043
[overlays]: https://github.com/lovesegfault/nix-config/tree/master/overlays

nix-config

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README