Dennis HilkLinux Fix LabEN

NixOS und Konfiguration

Eine Konfigurationsoption existiert nicht

Die Auswertung lehnt eine Option vor dem Systembau ab. Prüfe Schreibweise, Modulimporte und die genaue Nixpkgs-Revision statt geratener Ersatznamen.

Redaktionelle Quellenprüfung: Mit den Hinweisen beginnenAnleitung teilen
Auf dieser Seite
  1. Symptome und Geltungsbereich
  2. Mögliche Ursachen
  3. Sicher prüfen
  4. Nächste Schritte nach Befund
  5. Quellen und Prüfung
  6. Verwandte Probleme

Symptome und Geltungsbereich

  • Die Auswertung meldet eine nicht existierende Option.
  • Eine kopierte Konfiguration funktioniert mit anderer Version oder anderen Modulen.

Betroffene Umgebung

NixOS-Modulkonfigurationen mit Channels oder Flake-Lock; verfügbare Optionen folgen dem ausgewerteten Nixpkgs-Eingang.

Erkennbare Meldungen (synthetische Beispiele)
error: The option `services.example.enable' does not exist. Definition values:

Prüfe Deklarationsbereich und Eingangsrevision; dies ist Auswertung, kein Aktivierungsfehler.

Mögliche Ursachen

Das sind mögliche Erklärungen, keine bestätigte Diagnose. Mehrere unabhängige Fehler können gleichzeitig vorliegen.

  • Die Option kann falsch geschrieben, umbenannt oder durch ein nicht importiertes Modul bereitgestellt sein.
  • Dokumentation einer anderen Nixpkgs-Revision kann eine in der festgelegten Quelle fehlende Option beschreiben.

Sicher prüfen

Führe jeweils einen Befehl in der passenden Sitzung aus. Lies zuerst die Erklärung. Großgeschriebene Platzhalter brauchen deine Werte; Werkzeuge und Rechte unterscheiden sich je nach Distribution. Die Website zeigt Befehle an und führt sie niemals aus.

Prüfschritt 1

Ersetze services.example durch den abgelehnten Optionsbereich und /etc/nixos durch deinen Konfigurations-Checkout; rg liest nur Dateien.

rg -n 'services\.example' /etc/nixos

Ergebnis einordnen: Ermittle definierendes Modul und Importe. Die gemeldete Definitionsstelle ist hilfreicher als das Ändern aller ähnlichen Namen.

Prüfschritt 2

Führe dies im Flake-Checkout mit installiertem jq aus; passe den Eingangsname an, falls er nicht nixpkgs heißt.

jq '.nodes.nixpkgs.locked' flake.lock

Ergebnis einordnen: Die festgelegte Revision benennt die zu prüfende Optionsquelle. Bei Channels prüfe deren tatsächliche Quelle; ein Lock einer anderen Konfiguration ist irrelevant.

Nächste Schritte nach Befund

Die Option dieser Quelle verwenden

Wenn die festgelegte Version die Option umbenannt oder entfernt hat, migriere anhand ihrer Modulbeschreibung und Versionshinweise. Erhalte Typ und Bedeutung statt nur eines ähnlichen Namens.

Vorsicht: Baue den Kandidaten vor der Aktivierung. system.stateVersion wählt kein neueres Optionsschema.

Wiederherstellung / Rücknahme: Stelle bei Verschlechterung Konfiguration und Lock gemeinsam zurück; behalte eine funktionierende Generation.

Hat dir dieser Hinweis geholfen?

Hinweis teilen#

Das deklarierende Modul importieren

Wenn die Option zu einem externen oder eigenen Modul gehört, ergänze seinen vorgesehenen Import im passenden NixOS-Modulbereich. Prüfe die Version im Verhältnis zur übrigen Konfiguration.

Vorsicht: Schalte Prüfungen unbekannter Optionen nicht für einen Tippfehler ab. Importierte Module können weitere Standardwerte ergänzen.

Wiederherstellung / Rücknahme: Entferne den Import und stelle vorherige Eingänge und Einstellungen wieder her; baue dann die frühere Konfiguration.

Hat dir dieser Hinweis geholfen?

Hinweis teilen#

Quellen und Prüfung

Diese Anleitung basiert auf Originalquellen von Projekten oder Distributionen und wurde am genannten Datum redaktionell geprüft. Das ist eine Quellenprüfung, kein Nachweis einer auf deiner Hardware reproduzierten Lösung. Log-Beispiele sind synthetische Testdaten. Versionsabhängige Details müssen zur installierten Ausgabe passen.