Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rasmus-kirk/nix-config
My nix config for all my machines
https://github.com/rasmus-kirk/nix-config
home-manager home-manager-config home-manager-module nix nix-flake nixos nixos-config nixos-configuration nixos-dotfiles nixos-module nixos-modules
Last synced: 19 days ago
JSON representation
My nix config for all my machines
- Host: GitHub
- URL: https://github.com/rasmus-kirk/nix-config
- Owner: rasmus-kirk
- License: mit
- Created: 2024-09-20T13:56:01.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2024-10-20T15:02:56.000Z (26 days ago)
- Last Synced: 2024-10-20T16:27:50.962Z (26 days ago)
- Topics: home-manager, home-manager-config, home-manager-module, nix, nix-flake, nixos, nixos-config, nixos-configuration, nixos-dotfiles, nixos-module, nixos-modules
- Language: Nix
- Homepage: https://nix.rasmuskirk.com/
- Size: 175 KB
- Stars: 25
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# My Nix Config
This repository contains my Nix configurations. Feel free to explore and
use any part that inspires you.
**Features:**
- Single flake setup
- [Agenix](https://github.com/ryantm/agenix) for secrets management
- Home-Manager integration
- Modularization
- Automatic module options documentation generation at [https://nix.rasmuskirk.com/](https://nix.rasmuskirk.com/)
- Pi-based NAS setup
**Directions:**
- `configurations/home-manager`:
- Home-Manager configurations for my devices (deck, Pi, and work).
- `configurations/nixos`:
- NixOS configurations for my devices (Pi).
- `modules/home-manager`:
- Home-Manager modules generalizing configuration for various tools.
- `modules/nixos`:
- NixOS modules generalizing configuration for various tools.
- `pubkeys`:
- Public keys for my devices.
- `docs`:
- Files required for building the documentation hosted at [https://nix.rasmuskirk.com/](https://nix.rasmuskirk.com/).
## The Configurations
The Home-Manager configurations are fairly straightforward since they mostly
reuse modules, but the NixOS configuration has some notable features:
- [Agenix](https://github.com/ryantm/agenix) for secrets management
- [Nixarr](https://nixarr.com/) integration
- Syncthing
- SSH tunneling
- Sudo insults
## The Modules
The modules allow configuration to be reused efficiently and without
duplication between machines. For example, I want to share configuration
between my Pi-based NAS and my work laptop for programs such as my editor,
file manager, git, shell and more.
An example follows below:
### Snippet from Work Laptop's Configuration
```nix
kirk = {
helix.enable = true;
yazi = {
enable = true;
configDir = configDir;
};
git = {
enable = true;
userEmail = "[email protected]";
userName = "rasmus-kirk";
};
zsh.enable = true;
fonts.enable = true;
terminalTools.enable = true;
};
```
### Snippet from NAS/Pi Configuration
```nix
kirk = {
helix = {
enable = true;
installMostLsps = false;
extraPackages = with pkgs; [ nil marksman nodePackages_latest.bash-language-server ];
};
yazi = {
enable = true;
configDir = configDir;
};
git = {
enable = true;
userEmail = "[email protected]";
userName = "rasmus-kirk";
};
zsh.enable = true;
fonts.enable = true;
terminalTools.enable = true;
};
```
### Importing Modules
The options I’ve created allow for different behaviors across devices, while
avoiding redundant configuration snippets. Although these modules are designed
for personal use, it's possible for others to reuse them:
```nix
{
description = "My NixOS configuration";
inputs = {
nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";
kirk-modules.url = "github:rasmus-kirk/nix-config";
kirk-modules.inputs.nixpkgs.follows = "nixpkgs";
home-manager.url = "github:nix-community/home-manager/release-23.11";
home-manager.inputs.nixpkgs.follows = "nixpkgs";
};
outputs = inputs @ {
self,
nixpkgs,
kirk-modules,
flake-parts,
...
}: let
inherit (self) outputs;
in {
homeConfigurations = {
myMachine = home-manager.lib.homeManagerConfiguration {
pkgs = nixpkgs.legacyPackages.x86_64-linux;
extraSpecialArgs = { inherit inputs outputs; };
modules = [
./configurations/home-manager/my-machine/home.nix
kirk-modules.homeManagerModules.default
];
};
};
};
}
```
### Automatically Generated Module Documentation
The Nix modules include built-in compilation of module options to
Markdown. I further convert this Markdown into HTML using Pandoc, which
is then deployed via GitHub Pages. You can find the module documentation
[here](https://nix.rasmuskirk.com/). For more details, see the `./docs`
directory.