nixos-config/README.md

3.5 KiB

Felixalbs nixos config

Contains configurations for some nixos servers, some nixos desktops and a nix-darwin host. Secrets are managed with sops-nix.

Build:

  • Build locally on another machine:
nix --extra-experimental-features "nix-command flakes" build ".#nixosConfigurations.sarek.config.system.build.toplevel"

(replace "sarek" with the hostname)

  • Build, install and switch on the actual target
nixos-rebuild switch --update-input nixpkgs --update-input unstable --no-write-lock-file --refresh --flake github+felixalbrigtsen/nixos-server-conf.git --upgrade

Services and tools

Below is a list of most of the services configured in this repo, at least the ones that are accessible to the public. It might be incomplete or out of date, but should generally describe the state of my homelab. Other installed packages and tools are described in the config files (like ./hosts/HOSTNAME/configuration.nix), but not listed here.

Public / important services

  • Matrix (source) - Decentralized, encrypted chat - Contact me at @felixalb:feal.no
  • Nextcloud (source) - Personal cloud services and "google replacements", including file hosting, notes, calendar and webmail
  • Gitea (source) - Software forge / git server
  • Hedgedoc (source) - Collaborative markdown notes editor
  • HomeAssistant (source)- Home automation / IOT controller
  • VaultWarden (source) - BitWarden Password Manager backend
  • Kanidm (source) - Authentication provider with support for OAuth2/OIDC, LDAPS, SSH, etc.
  • Jellyfin (source) - Local media streaming

Networking

  • I use nginx as a web server and reverse proxy. The configuration is mostly distributed throughout the services that use it (example).
  • I recently switched from Tailscale(actually headscale) to WireGuard, configured here and here.
  • PiHole (source) run my internal DNS (*.home.feal.no) and ad blocking.

Monitoring

  • Prometheus (source) - Pull-based metrics system that fetches metrics over HTTP from a range of exporters and stores them in a time-series database
  • Loki (source) - Central logging for all my hosts
  • Grafana (source) - Visualization and alerting for all my metrics and logs
  • Uptime-Kuma (source) - Uptime / health check with alerting

Dotfiles and user tools

  • (Neo)vim (source) - Text editor with my configuration for IDE-like support for autocompletion, syntax highlighting and efficient editing.
  • Zsh (source) - My shell of choice