Przejdź do treści
Biblioteka skilli
DevOps i chmura · Analiza

nix-debug

/nix-debug

Znajduje przyczynę nieudanej ewaluacji, budowy, aktywacji lub usługi Nix i bezpiecznie aktualizuje wejścia oraz poprawki.

Repozytorium
skills ↗
Licencja
MPL-2.0
Ostatnia zmiana repozytorium
12.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 12.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MPL-2.0, otwarta.

Co robi i kiedy

Znajduje przyczynę nieudanej ewaluacji, budowy, aktywacji lub usługi Nix i bezpiecznie aktualizuje wejścia oraz poprawki.

Oryginalny opis (EN)

Find why a Nix evaluation, build, activation, service or boot fails. Update inputs, pins, hashes and carried patches safely. Use for a failed nix flake check, build or deploy, a flake.lock bump, or a rescue from a live USB.

Jak działa

  1. 1. Find the layer
  2. 2. Evaluation and build
  3. 3. Updates are supply-chain events
  4. 4. Rescue from a live USB
  5. Rules
Sekcje z nagłówków SKILL.md, w oryginale · 61 linii, 451 słów
Podgląd SKILL.md
---
name: nix-debug
description: "Find why a Nix evaluation, build, activation, service or boot fails. Update inputs, pins, hashes and carried patches safely. Use for a failed nix flake check, build or deploy, a flake.lock bump, or a rescue from a live USB."
---

# nix-debug

First find the layer where the failure occurs. Then fix it in that layer only.

## 1. Find the layer

| Layer | Symptom | First command |
|---|---|---|
| Evaluation | `error:` with a Nix trace, before any build | `nix flake check --no-build --show-trace` |
| Build | a derivation fails, `builder for ... failed` | `nix log <drv>` |
| Activation | the switch fails, or a unit fails right after it | `journalctl -b -u <unit>` |
| Runtime | the system runs, a service misbehaves | `systemctl status <unit>`, then the journal |
| Boot | the machine does not start | section 4 |

## 2. Evaluation and build

- Read the trace from the bottom. The last frame in your own files is usually the cause.
- Read one value: `nix eval .#<path>`. Inspect a set: `nix repl` then `:lf .`.
- An option name that you are not sure of: search the option. Do not guess.
- A hash mismatch: set `lib.fakeHash`, build, then copy the `got:` hash. Never copy a hash from
  a web page.
- A build that works on one machine only: check the `system`, the sandbox and an impure path.

## 3. Updates are supply-chain events

1. Update one input at a time: `nix flake update <input>`.
2. Read what moved: `git diff flake.lock`, and the upstream log between the two revisions.
3. Build before and after. Compare the closures: `nix run nixpkgs#dix -- <old> <new>`.
4. Run the full gate.
5. Open a PR with only the update, its closure difference and the inputs that moved.

For a package pin: change the version, set the hash to `lib.fakeHash`, build, copy the real
hash. For a carried patch: rebase it on the new source. If upstream merged it, delete it. Say
which in the PR.

Before you rely on an open nixpkgs PR, build its attribute and read its diff. Do not trust it
because it has approvals.

## 4. Rescue from a live USB

Use this only with the owner present. Each step changes a real disk.

```bash
lsblk -f                                        # find root, boot and any LUKS volume
sudo cryptsetup open /dev/<dev> root            # only for LUKS
sudo mount /dev/disk/by-label/nixos /mnt
sudo mount /dev/disk/by-label/boot /mnt/boot    # UEFI only
sudo nixos-enter --root /mnt                    # a shell in the installed system
```

Inside: list the generations (`nix-env -p /nix/var/nix/profiles/system --list-generations`).
Switch to the last good one, or rebuild from the flake. Reinstall the bootloader only when the
bootloader is the cause.

## Rules

- Read the error before you change code.
- Change one thing, then build again.
- Never make a check weaker to get a pass.

Wersje

W bazie nie ma innych skilli o nazwie nix-debug.

Migawka bazy z 13.11.2026 · wersja paczki ef48f7ae43c0 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100nix-flake-init
    Tworzy nowy flake Nix dla projektu, z przypiętymi wejściami, prawdziwym buildem, devShellem i testami.
  • 96nix-best-practices
    Podpowiada dobre praktyki przy pracy z Nix flakes, overlays oraz plikami shell.nix i flake.nix.
  • 100nix-for-dev
    Konfiguruje Nix dla projektu deweloperskiego z szybkim nix develop: flake.nix bez wejść, npins, default.nix i shell.nix, sub-flake'i i zalecenia dla języków.
  • 96nix
    Pisze i sprawdza kod Nix w plikach .nix, pilnując poprawności konfiguracji.
  • 100nix-scaffolding
    Zakłada nowy projekt od zera z konfiguracją flake Nix i devshell.
  • 100nix-config-debug
    Znajduje przyczynę awarii w konfiguracji Nix: błąd ewaluacji lub budowy, nieudaną aktywację, niedziałającą usługę, DNS lub CI.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.