feat(pxe-boot): mount pxe-images NFS share and symlink to /srv/pxe/http/images

Adds modules/pxe-boot/mount-pxe-images.nix, which mounts
server.sweet.home:/tank/proxmox/pxe-images at /mnt/pxe-images via NFSv4.2
(x-systemd.automount on Proxmox VMs, nofail on LXC containers — same pattern
as docker/mount-data.nix). The pxe-boot build-type now imports this module and
replaces the previous local /srv/pxe/http/images directory rule with an L+
symlink pointing to /mnt/pxe-images, so large images (ISOs, disk images) live
on the NFS share rather than the host's own root disk.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-07-27 03:54:37 +10:00
co-authored by Claude Sonnet 4.6
parent 16d6baea5f
commit 321048626e
3 changed files with 37 additions and 5 deletions
+11 -4
View File
@@ -29,7 +29,7 @@ The host creates these directories with systemd tmpfiles:
```text ```text
/srv/pxe /srv/pxe
/srv/pxe/http /srv/pxe/http
/srv/pxe/http/images /srv/pxe/http/images -> /mnt/pxe-images (symlink to NFS share)
/srv/pxe/http/auto-installer /srv/pxe/http/auto-installer
/srv/pxe/http/nixos-minimal /srv/pxe/http/nixos-minimal
/srv/pxe/http/debian /srv/pxe/http/debian
@@ -39,9 +39,13 @@ The host creates these directories with systemd tmpfiles:
/srv/pxe/tftp /srv/pxe/tftp
``` ```
Mount shared image storage under `/srv/pxe/http`, preferably `/srv/pxe/http/images` is a symlink to `/mnt/pxe-images`, which is an NFSv4.2
`/srv/pxe/http/images` unless a menu entry expects files in a specific mount of `server.sweet.home:/tank/proxmox/pxe-images`
directory such as `/srv/pxe/http/auto-installer`. (`modules/pxe-boot/mount-pxe-images.nix`). Place large images there (ISOs,
disk images) rather than on the pxe-boot host's own root disk. For an LXC
pxe-boot container the mount uses `nofail` (eager, non-blocking on server
unavailability); for a Proxmox VM it uses `x-systemd.automount` (lazy,
triggered on first access).
The HTTP iPXE chain is: The HTTP iPXE chain is:
@@ -116,6 +120,9 @@ The SystemRescue entry expects the source ISO at:
/srv/pxe/http/images/systemrescue.iso /srv/pxe/http/images/systemrescue.iso
``` ```
Since `/srv/pxe/http/images` is the NFS-backed symlink, place the ISO on the
NFS share at `server.sweet.home:/tank/proxmox/pxe-images/systemrescue.iso`.
The `stage-systemrescue.service` oneshot extracts that ISO into: The `stage-systemrescue.service` oneshot extracts that ISO into:
```text ```text
+2 -1
View File
@@ -132,6 +132,7 @@ in
{ {
imports = [ imports = [
../pxe-boot/stage-installer-artifacts.nix ../pxe-boot/stage-installer-artifacts.nix
../pxe-boot/mount-pxe-images.nix
]; ];
environment.systemPackages = with pkgs; [ environment.systemPackages = with pkgs; [
@@ -170,7 +171,7 @@ in
tmpfiles.rules = [ tmpfiles.rules = [
"d ${pxeRoot} 0755 root root -" "d ${pxeRoot} 0755 root root -"
"d ${httpRoot} 0755 root root -" "d ${httpRoot} 0755 root root -"
"d ${httpRoot}/images 0755 root root -" "L+ ${httpRoot}/images - - - - ${vars.nfsShares.proxmoxPxeImages.mountpoint}"
"d ${httpRoot}/auto-installer 0755 root root -" "d ${httpRoot}/auto-installer 0755 root root -"
"d ${httpRoot}/nixos-minimal 0755 root root -" "d ${httpRoot}/nixos-minimal 0755 root root -"
"d ${httpRoot}/systemrescue 0755 root root -" "d ${httpRoot}/systemrescue 0755 root root -"
+24
View File
@@ -0,0 +1,24 @@
{ config, vars, ... }:
let
# Use the same FQDN approach as docker/mount-data.nix — a bare hostname is
# unreliable: systemd-resolved only tries LLMNR for single-label names, and
# a global search domain causes it to skip the interface-scoped LAN DNS.
nfsServer = "${vars.nfsServerHost}.${vars.homeDomain}";
# x-systemd.automount is unsupported inside LXC containers (systemd logs
# "Starting of <unit>.automount unsupported" and never mounts). Use nofail
# there so a boot with the NFS server unreachable doesn't hang instead.
automountOpts = if config.boot.isContainer then [ "nofail" ] else [ "x-systemd.automount" ];
in
{
fileSystems.${vars.nfsShares.proxmoxPxeImages.mountpoint} = {
device = "${nfsServer}:${vars.storageRoot}/${vars.nfsShares.proxmoxPxeImages.subpath}";
fsType = "nfs";
options = [
"nfsvers=4.2"
"_netdev"
"noatime"
] ++ automountOpts;
};
}