# Überlegungen zum Node-Speicherplatz

### Wie der Node Speicher reserviert

Beim Einrichten deines Nodes wird eine einzelne Datei namens `storage.blob` erstellt. Diese Datei wird sofort in voller konfigurierter Grösse per `fallocate` auf der Festplatte reserviert.

Wenn du 500 GB Speicher konfigurierst, werden 500 GB Speicherplatz sofort belegt — auch wenn noch keine Daten gespeichert wurden. Der Platz ist auf der Festplatte reserviert, unabhängig von der tatsächlichen Nutzung.

Das ist gewollt. Die Vorab-Reservierung sorgt für schnelle, vorhersagbare Schreibgeschwindigkeit und vermeidet Dateisystem-Fragmentierung im Betrieb.

### Das Problem: Gemeinsam genutzte Volumes

Ein gemeinsam genutztes Volume bedeutet, dass `storage.blob` auf derselben Festplatte oder Partition liegt wie dein Betriebssystem, Datenbanken, Backup-Jobs oder andere Dienste.

Jedes dieser Systeme schreibt unabhängig Daten. Das Betriebssystem erzeugt Logs, temporäre Dateien, Paket-Caches und Swap-Daten. Backup-Tools, Datenbanken und Monitoring-Agents tun dasselbe. Keines dieser Systeme kennt den Platzbedarf der anderen.

Wenn dein Node 450 GB auf einer 500 GB Festplatte reserviert, bleiben nur 50 GB für alles andere. Dieser Puffer kann schnell und ohne Vorwarnung schrumpfen.

### Was passieren könnte, wenn die Festplatte voll wird

Wenn der verbleibende Speicherplatz auf einem gemeinsam genutzten Volume aufgebraucht ist, könnte Folgendes passieren:

* **Das Betriebssystem könnte aufhören, korrekt zu funktionieren.** Linux benötigt freien Speicherplatz für Logs, temporäre Dateien und Prozessverwaltung. Ohne diesen könnten Kerndienste abstürzen oder einfrieren.
* **Der Fernzugriff könnte verloren gehen.** SSH-Sitzungen benötigen temporäre Dateischreibvorgänge. Bei einer vollen Festplatte könnte der Login unmöglich werden — du wärst von deinem eigenen Server ausgesperrt.
* **Andere Dienste könnten ausfallen.** Datenbanken, Backup-Jobs oder Webserver auf derselben Festplatte könnten abstürzen, Daten beschädigen oder nicht mehr reagieren.
* **Der Node könnte deaktiviert werden.** Ein volles Volume löst die automatische Deaktivierung deines Nodes aus. Das Netzwerk behandelt deinen Node als nicht verfügbar, bis das Problem behoben ist.
* **Wiederherstellung könnte physischen Zugang erfordern.** Im schlimmsten Fall könnte das System komplett nicht mehr reagieren und einen Rescue-Boot oder physischen Konsolenzugang erfordern, um Speicherplatz freizugeben.

Keine dieser Situationen erzeugt vorher eine klare Warnung. Die Festplatte füllt sich einfach, und Dienste beginnen einer nach dem anderen auszufallen.

### Best Practices

#### Option A: Eigene Partition oder eigenes Volume verwenden (Empfohlen)

Mounte eine separate Partition oder ein eigenes Volume ausschliesslich für `storage.blob` deines Nodes. So bleibt das Betriebssystem unbeeinträchtigt, selbst wenn der Node 100% seines zugewiesenen Speichers nutzt.

Das ist das sicherste Setup und wird für Produktiv-Nodes dringend empfohlen.

#### Option B: Genügend freien Speicher auf gemeinsamen Festplatten lassen

Wenn ein eigenes Volume nicht möglich ist, konfiguriere den Node-Speicher nie auf mehr als **80–85%** der Gesamtfestplatte. Bei einer 1 TB Festplatte maximal 800–850 GB für den Node konfigurieren. Der Rest dient als Puffer für das Betriebssystem und andere Dienste.

#### Option C: Speicherplatz-Monitoring einrichten

Nutze ein Monitoring-Tool, das dich warnt, wenn die Festplattenauslastung einen Schwellenwert überschreitet. Eine Warnung bei **85%** und ein kritischer Alarm bei **90%** gibt dir genug Zeit, um zu reagieren.

Einfache Prüfung über die Kommandozeile:

```bash
df -h /
```

Das zeigt, wie viel Platz auf deiner Root-Partition verfügbar ist.

### So prüfst du dein aktuelles Setup

**1. Festplattenauslastung prüfen:**

```bash
df -h
```

Schau dir die Partition an, auf der sich `storage.blob` befindet. Wenn sie denselben Mount-Punkt wie `/` hat, nutzt du ein gemeinsames Volume.

**2. Partitionen anzeigen:**

```bash
lsblk
```

Das zeigt alle Festplatten und Partitionen. Idealerweise sollte `storage.blob` auf einem eigenen Mount-Punkt liegen (z.B. `/mnt/node-storage`), getrennt von `/`.

**3. Speicherort und Grösse von storage.blob prüfen:**

```bash
ls -lh /pfad/zu/storage.blob
```

Vergleiche die Dateigrösse mit der Gesamtkapazität der Partition, auf der sie liegt.

### Zusammenfassung

| Setup                                  | Risikostufe | Empfehlung                           |
| -------------------------------------- | ----------- | ------------------------------------ |
| Eigenes Volume für storage.blob        | Tief        | Empfohlen für alle Betreiber         |
| Gemeinsame Festplatte, 80–85% belegt   | Mittel      | Akzeptabel mit Monitoring            |
| Gemeinsame Festplatte, 90%+ belegt     | Hoch        | Sofort umkonfigurieren               |
| Gemeinsame Festplatte, ohne Monitoring | Kritisch    | Monitoring einrichten oder migrieren |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wesendit.io/de/wesendit-node-network/onboarding-fur-nodebetreiber-and-skalierung/uberlegungen-zum-node-speicherplatz.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.