home/nixos-servers
home/nixos-servers
2
0
Fork 0
Code Issues 8 Pull requests Projects Releases Packages Wiki Activity Actions
Infrastructure as Code for our home servers
266 commits 3 branches 0 tags 2.4 MiB
Nix 98.2%
Shell 1.8%
Find a file
Pim Kunis 6e608e6ca8 use dns.nix for kun.is zone again 
parameterize k8s' service IPs
2024-04-13 23:25:48 +02:00
flake-parts use dns.nix for kun.is zone again 2024-04-13 23:25:48 +02:00
kubenix-modules use dns.nix for kun.is zone again 2024-04-13 23:25:48 +02:00
machines cleanup more nix code 2024-04-13 16:06:35 +02:00
my-lib use dns.nix for kun.is zone again 2024-04-13 23:25:48 +02:00
nixos-modules add persistent storage to minecraft 2024-04-13 22:21:26 +02:00
secrets cleanup more nix code 2024-04-13 16:06:35 +02:00
.gitignore add persistent storage to minecraft 2024-04-13 22:21:26 +02:00
configuration.nix create own library for globals and net.nix 2024-04-13 17:28:31 +02:00
flake.lock remove hypervisor vlan 2024-04-12 23:13:06 +02:00
flake.nix create own library for globals and net.nix 2024-04-13 17:28:31 +02:00
README.md create own library for globals and net.nix 2024-04-13 17:28:31 +02:00

README.md

nixos-servers

Nix definitions to configure our servers at home.

Acknowledgements

  • deploy-rs: NixOS deploy tool with rollback functionality
  • disko: declarative disk partitioning
  • agenix: deployment of encrypted secrets to NixOS machines
  • dns.nix: A Nix DSL for defining DNS zones
  • flake-utils: Handy utilities to develop Nix flakes
  • nixos-hardware: Hardware-specific NixOS modules. Doing the heavy lifting for our Raspberry Pi.

Installation

Prerequisites

  1. Install the Nix package manager or NixOS (link)
  2. Enable flake and nix commands (link)

Bootstrapping

We bootstrap our servers using nixos-anywhere. This reformats the hard disk of the server and installs a fresh NixOS. Additionally, it deploys an age identity, which is later used for decrypting secrets.

⚠️ This will wipe your server completely ⚠️

  1. Make sure your have a Secret service running (such as Keepassxc) that provides the age identity.
  2. Ensure you have root SSH access to the server.
  3. Run nixos-anywhere: nix run .#bootstrap <servername> <hostname>

Deployment

To deploy all servers at once: nix run nixpkgs#deploy-rs -- .# -k To deploy only one server: nix run nixpkgs#deploy-rs -- -k --targets .#<host>

Deploying to Kubernetes

To deploy to the Kubernetes cluster, first make sure you have an admin account on the cluster. You can generate this using nix run .#gen-k3s-cert <username> <servername> ~/.kube, assuming you have SSH access to the master node. This puts a private key, signed certificate and a kubeconfig in the kubeconfig directory

If the cluster has not been initialized yet, next run nix run .#kubenix-bootstrap.x86_64-linux.

⚠️ Do not do this if the cluster has been initialized already, as it will prune any deployed resources! ⚠️

Lastly, deploy everything to the cluster using nix run .#kubenix.x86_64-linux.

Known bugs

Rsync not available during bootstrap

The rsync command was removed from recent NixOS ISO which causes nixos-anywhere to fail when copying extra files. See this issue. Solution is to execute nix-env -iA nixos.rsync on the host.