Skip to content

About

NixOS Homelab modules for external & internal network setup

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

103 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

nixos-homelab-networking

The networking base that ties the rest of the homelab together. Every workload across every nixos-homelab-* repo declares allowIngress/ allowEgress on its kubenix workload -- this repo's cilium module is what actually enforces them as network policy; without it they're just labels. It also provides the CNI itself, inbound and outbound VPNs, routable IP pools, and DNS management.

See the Cilium network policies docs for the policies this repo's cilium module gives kubenix pods and lib.toPorts, and the documentation, under Options, for the full list of module options.

Setup

{
  inputs = {
    ...
    homelab-networking = {
      url = "github:nixos-homelab/networking";
      inputs.nixpkgs.follows = "nixpkgs";
    };
    ...
  };
}
{ inputs, ... }:
{
  imports = [ inputs.homelab-networking.nixosModules.cilium ];
  config.homelab.cilium.enable = true;
}

Modules

  • cilium: the Cilium CNI, plus the LoadBalancer IP pool it hands out from -- see the Cilium network policies docs for the policies it gives the pods of kubenix submodules.
  • routed-ippool: a routable IPv4 pool for LoadBalancer services, routed to the cluster from the LAN.
  • client-vpn: the inbound WireGuard gateway -- named access groups, each scoped to specific services or full cluster access, for remote kubectl/service access.
  • privacy-vpn: an outbound WireGuard tunnel to an external VPN provider, for routing a workload's egress traffic through it (e.g. homelab-media's rtorrent).
  • external-dns: external-dns, managing DNS records for cluster services automatically.
  • unifi: Unifi Network Controller, for managing Ubiquiti networking gear.
  • netutils: a debugging container with common networking tools, for troubleshooting from inside the cluster.

About

NixOS Homelab modules for external & internal network setup

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages