<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>Immich on Kabelbruch</title><link>https://kabelbruch.de/tags/immich/</link><description>Recent content in Immich on Kabelbruch</description><image><title>Kabelbruch</title><url>https://kabelbruch.de/og-image.png</url><link>https://kabelbruch.de/og-image.png</link></image><generator>Hugo</generator><language>de-DE</language><lastBuildDate>Fri, 20 Nov 2026 10:00:00 +0100</lastBuildDate><atom:link href="https://kabelbruch.de/tags/immich/index.xml" rel="self" type="application/rss+xml"/><item><title>Mein NFS-Mount war schneller als das Netzwerk</title><link>https://kabelbruch.de/posts/nfs-mount-beim-booten-debian/</link><pubDate>Fri, 20 Nov 2026 10:00:00 +0100</pubDate><guid>https://kabelbruch.de/posts/nfs-mount-beim-booten-debian/</guid><description>Nach jedem Neustart fehlte der NFS-Mount, und Immich schrieb Fotos auf die lokale Platte. Ursache: ein Wort in /etc/network/interfaces.</description><content:encoded><![CDATA[<p>Ende September zeigte Immich plötzlich Fehler an. Immich ist meine selbst gehostete Fotoverwaltung, eine Art Google Fotos für zu Hause. Die Bilder sollen nicht auf der virtuellen Platte der VM liegen, sondern auf meinem NAS. Dafür ist ein Verzeichnis des NAS per NFS in die VM eingebunden.</p>
<p>Als ich nachgesehen habe, war genau dieses Verzeichnis nicht eingebunden. Und Immich hatte trotzdem fröhlich weitergeschrieben, und zwar in das leere Verzeichnis auf der lokalen Platte, in dem eigentlich das NAS hätte hängen sollen.</p>
<p>Von Hand ließ sich das NAS problemlos einbinden. Nach dem nächsten Neustart war es wieder weg.</p>
<h2 id="das-setup">Das Setup</h2>
<ul>
<li><strong>VM</strong> unter Proxmox mit <strong>Debian 13</strong> (trixie). Das Netzwerk verwaltet klassisch <code>ifupdown</code> über <code>/etc/network/interfaces</code>, die Adresse kommt per DHCP.</li>
<li>In der VM läuft <strong>Docker</strong>, unter anderem mit Immich.</li>
<li>Das <strong>NAS</strong> ist ein UniFi UNAS Pro. Es stellt eine Freigabe per <strong>NFSv3</strong> bereit, eingebunden über <code>/etc/fstab</code>.</li>
</ul>
<p>Kurz zu NFS, falls der Begriff neu ist: Mit NFS bindet ein Rechner ein Verzeichnis eines anderen Rechners so ein, als wäre es eine lokale Festplatte. Der Ort, an dem das passiert, heißt Mountpunkt. Bei mir ist das <code>/mnt/nas</code>.</p>
<p>Der Eintrag in der <code>fstab</code> sah zu Beginn so aus:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">10.0.99.1:/var/nfs/shared/docker  /mnt/nas  nfs  nofail,x-systemd.automount,x-systemd.device-timeout=10s  0 0
</span></span></code></pre></div><h2 id="spurensuche-im-journal">Spurensuche im Journal</h2>
<p>systemd macht aus jedem Eintrag in der <code>fstab</code> eine eigene Mount-Unit. Deren Name leitet sich vom Pfad ab: Aus <code>/mnt/nas</code> wird <code>mnt-nas.mount</code>. Sonderzeichen werden dabei umgeschrieben, ein Bindestrich im Pfad zum Beispiel zu <code>\x2d</code>. Den korrekten Namen liefert <code>systemd-escape</code>:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">systemd-escape -p --suffix<span class="o">=</span>mount /mnt/nas
</span></span></code></pre></div><p>Mit dem Namen kommt man an die Meldungen seit dem letzten Start:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">journalctl -b -u mnt-nas.mount
</span></span></code></pre></div><p>Dort standen zwei Dinge:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">mount.nfs: Network is unreachable
</span></span><span class="line"><span class="cl">...
</span></span><span class="line"><span class="cl">Start request repeated too quickly.
</span></span></code></pre></div><p>Der Mount wurde also versucht, aber zu einem Zeitpunkt, an dem die VM noch gar kein Netzwerk hatte. Er scheiterte mehrfach innerhalb derselben Sekunde. Daraufhin hat systemd aufgegeben und keine weiteren Versuche mehr zugelassen. Danach war nicht nur der Mount inaktiv, sondern auch die Automount-Unit, die ihn eigentlich beim ersten Zugriff hätte nachholen sollen.</p>
<h2 id="die-ursache-ein-wort-in-der-netzwerkkonfiguration">Die Ursache: ein Wort in der Netzwerkkonfiguration</h2>
<p>Damit Netzwerk-Mounts nicht zu früh starten, gibt es in systemd das Ziel <code>network-online.target</code>. Ein Ziel ist eine Art Wegmarke beim Booten. Alles, was das Netzwerk braucht, wartet auf diese Marke, und NFS-Mounts tun das automatisch.</p>
<p>Das Problem: Die Marke kann schon erreicht sein, obwohl noch gar keine IP-Adresse da ist. Bei mir trafen zwei Dinge zusammen.</p>
<p><strong>Erstens</strong> stand die Netzwerkkarte so in <code>/etc/network/interfaces</code>:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">allow-hotplug ens18
</span></span><span class="line"><span class="cl">iface ens18 inet dhcp
</span></span></code></pre></div><p><code>allow-hotplug</code> heißt: Die Karte wird hochgefahren, sobald der Kernel sie meldet, und zwar nebenbei, ohne dass der Bootvorgang darauf wartet. Das ist praktisch für USB-Netzwerkadapter, die mal da sind und mal nicht. Für die einzige Netzwerkkarte einer VM ist es die falsche Wahl. Debian setzt das bei der Installation trotzdem gern so.</p>
<p><strong>Zweitens</strong> war der Dienst <code>ifupdown-wait-online.service</code> deaktiviert. Genau der sorgt bei <code>ifupdown</code> dafür, dass <code>network-online.target</code> erst erreicht wird, wenn die Schnittstellen wirklich oben sind. Er wartet aber nur auf Schnittstellen, die mit <code>auto</code> eingetragen sind, nicht auf <code>allow-hotplug</code>.</p>
<p>Ergebnis: systemd meldete „Netzwerk online“, der DHCP-Client wartete noch auf seine Adresse, und der NFS-Mount lief ins Leere.</p>
<h2 id="die-lösung-in-vier-schritten">Die Lösung in vier Schritten</h2>
<p>Vorher habe ich beide Dateien gesichert:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">sudo cp -a /etc/network/interfaces /etc/network/interfaces.bak
</span></span><span class="line"><span class="cl">sudo cp -a /etc/fstab /etc/fstab.bak
</span></span></code></pre></div><p><strong>1. Die Netzwerkkarte beim Booten fest hochfahren.</strong> In <code>/etc/network/interfaces</code> habe ich <code>allow-hotplug</code> durch <code>auto</code> ersetzt:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">auto ens18
</span></span><span class="line"><span class="cl">iface ens18 inet dhcp
</span></span></code></pre></div><p><strong>2. Das Warten auf das Netzwerk einschalten:</strong></p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">sudo systemctl <span class="nb">enable</span> ifupdown-wait-online.service
</span></span></code></pre></div><p><strong>3. Den <code>fstab</code>-Eintrag aufräumen:</strong></p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">10.0.99.1:/var/nfs/shared/docker  /mnt/nas  nfs  defaults,_netdev,nofail,x-systemd.mount-timeout=30s  0 0
</span></span></code></pre></div><p>Was die Optionen bedeuten:</p>
<ul>
<li><code>nofail</code>: Wenn das NAS nicht erreichbar ist, bootet die VM trotzdem weiter, statt im Notfallmodus hängen zu bleiben.</li>
<li><code>x-systemd.mount-timeout=30s</code>: So lange darf der Mount dauern, dann gibt systemd auf.</li>
<li><code>_netdev</code>: Markiert den Eintrag als Netzwerk-Dateisystem. Bei NFS erkennt systemd das eigentlich schon am Typ, die Option schadet aber nicht.</li>
</ul>
<p>Die Automount-Option habe ich rausgenommen. Ehrlich gesagt weiß ich nicht mehr genau, warum. Ich meine, sie hat nicht sauber funktioniert. Mit der reparierten Reihenfolge brauche ich sie ohnehin nicht mehr: Das NAS wird beim Booten direkt eingebunden.</p>
<p><strong>4. Neu laden und neu starten:</strong></p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">sudo systemctl daemon-reload
</span></span><span class="line"><span class="cl">sudo reboot
</span></span></code></pre></div><p>Nach dem Neustart zeigt <code>findmnt</code>, ob das NAS wirklich eingebunden ist:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">findmnt /mnt/nas
</span></span></code></pre></div><p>Steht dort nichts, ist das Verzeichnis nur ein leerer Ordner auf der lokalen Platte.</p>
<h2 id="das-eigentliche-problem-docker-schreibt-einfach-weiter">Das eigentliche Problem: Docker schreibt einfach weiter</h2>
<p>Der fehlende Mount war ärgerlich. Gefährlich war etwas anderes: Docker hat das gar nicht interessiert.</p>
<p>Für einen Container ist <code>/mnt/nas</code> einfach ein Verzeichnis. Ob dort ein NAS hängt oder nicht, sieht er nicht. Ist der Mount nicht da, schreibt Immich seine Fotos eben auf die lokale Platte der VM. Das hat mehrere unschöne Folgen:</p>
<ul>
<li>Die Fotos liegen nicht dort, wo ich sie vermute, und nicht dort, wo ich sie sichere.</li>
<li>Die virtuelle Platte der VM läuft voll. Bei mir ist sie deutlich kleiner als das NAS.</li>
<li>Sobald das NAS wieder eingebunden ist, verschwinden die lokal geschriebenen Dateien aus dem Blick. Sie sind noch da, aber versteckt unter dem Mount. Sehen kann man sie erst wieder, wenn man das NAS aushängt.</li>
</ul>
<p>Deshalb darf Docker bei mir erst starten, wenn der Mount wirklich steht. Dafür gibt es in systemd die Option <code>RequiresMountsFor</code>. Am einfachsten legt man sie mit <code>systemctl edit</code> an:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">sudo systemctl edit docker.service
</span></span></code></pre></div><p>In den Editor kommt:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-ini" data-lang="ini"><span class="line"><span class="cl"><span class="k">[Unit]</span>
</span></span><span class="line"><span class="cl"><span class="na">RequiresMountsFor</span><span class="o">=</span><span class="s">/mnt/nas</span>
</span></span></code></pre></div><p>Das landet in <code>/etc/systemd/system/docker.service.d/override.conf</code> und überlebt damit auch Updates des Docker-Pakets. <code>RequiresMountsFor</code> sorgt für zwei Dinge: Docker startet erst <strong>nach</strong> dem Mount, und es startet <strong>gar nicht</strong>, wenn der Mount fehlschlägt.</p>
<p>Lieber gar kein Immich als ein Immich, das heimlich auf die falsche Platte schreibt. Wenn Docker nicht hochkommt, merke ich das sofort. Fotos am falschen Ort merke ich vielleicht erst nach Wochen.</p>
<h2 id="stolperfallen-und-learnings">Stolperfallen und Learnings</h2>
<p><strong><code>allow-hotplug</code> ist für Wechsel-Hardware gedacht.</strong> Für eine feste Netzwerkkarte, an der Mounts hängen, gehört <code>auto</code> hin.</p>
<p><strong>„Network online“ heißt nicht, dass eine Adresse da ist.</strong> Ob <code>network-online.target</code> wirklich wartet, hängt davon ab, welcher Dienst die Wartearbeit übernimmt. Bei <code>ifupdown</code> ist das <code>ifupdown-wait-online.service</code>, bei anderen Netzwerkverwaltungen heißt der Dienst anders.</p>
<p><strong><code>x-systemd.device-timeout</code> bringt bei NFS nichts.</strong> Die Option gilt für Blockgeräte wie Festplatten und USB-Sticks, auf deren Erscheinen systemd wartet. Bei NFS gibt es kein Gerät. Für Netzwerk-Mounts ist <code>x-systemd.mount-timeout</code> die richtige Option.</p>
<p><strong>Den Namen der Mount-Unit nicht raten.</strong> <code>systemd-escape</code> liefert ihn zuverlässig, auch bei Bindestrichen und Leerzeichen im Pfad.</p>
<p><strong>Die Abhängigkeit gehört an den Dienst, der Daten schreibt.</strong> Den Mount zu reparieren reicht nicht. Irgendwann ist das NAS mal kurz weg, beim Booten oder nach einem Update. Dann muss klar sein, dass niemand ins leere Verzeichnis schreibt.</p>
<h2 id="nachtrag-inzwischen-über-eine-eigene-netzwerkkarte">Nachtrag: inzwischen über eine eigene Netzwerkkarte</h2>
<p>Seit Oktober hängt die VM zusätzlich mit einer zweiten Netzwerkkarte direkt im Storage-VLAN des NAS. Der NFS-Verkehr läuft jetzt dort, mit fester Adresse und ohne Umweg über die Firewall. Wie das aussieht und was ich dabei gelernt habe, steht im Artikel <a href="/posts/drei-tage-ohne-backup-pbs-nfs/">Drei Tage ohne Backup</a>. Auch diese Karte steht in <code>/etc/network/interfaces</code> mit <code>auto</code>, aus genau dem Grund von oben.</p>
<h2 id="fazit">Fazit</h2>
<p>Ein einziges Wort in der Netzwerkkonfiguration hat dafür gesorgt, dass mein NAS nach jedem Neustart fehlte. Gefunden war das schnell, sobald ich ins Journal geschaut habe. Die wichtigere Lehre war aber die zweite: Ein Dienst, der auf ein Netzlaufwerk schreibt, muss wissen, dass er es tut. Sonst schreibt er im Zweifel einfach daneben.</p>
<h2 id="was-als-nächstes-kommt">Was als Nächstes kommt</h2>
<ul>
<li>Mein Medienserver läuft als Container und bindet das NAS ebenfalls über die <code>fstab</code> ein. Ob dort dasselbe Problem schlummert, will ich mir noch ansehen.</li>
<li>Eine zusätzliche Idee, die ich noch nicht umgesetzt habe: den leeren Mountpunkt bei ausgehängtem NAS mit <code>chattr +i</code> schreibgeschützt machen. Dann kann dort gar nichts mehr landen, auch nicht durch ein Programm außerhalb von Docker.</li>
</ul>
]]></content:encoded></item></channel></rss>