---
title: NixOS Manual (25.11 Xantusia)
updated: 2026-04-08
tags: [nixos, manual, reference, dev]
source: https://github.com/NixOS/nixpkgs/tree/nixos-25.11/nixos/doc/manual
upstream-version: nixos-25.11
---

# NixOS Manual (로컬 사본)

NixOS 25.11 stable("Xantusia") 매뉴얼의 CommonMark 소스. nixpkgs `nixos-25.11` 브랜치의 `nixos/doc/manual/` 디렉토리를 그대로 복사한 것.

- **온라인 렌더링**: https://nixos.org/manual/nixos/stable/
- **상위**: https://github.com/NixOS/nixpkgs/tree/nixos-25.11/nixos/doc/manual
- **가져온 날짜**: 2026-04-08
- **로컬 위치**: `~/obsidian/reference/nixos-manual/`

## 구조

| 디렉토리 / 파일 | 내용 |
|---|---|
| `manual.md` | 매뉴얼 루트(목차) |
| `preface.md` | 머리말 |
| `installation/` | 설치(하드웨어, 부트로더, 프로비저닝) |
| `configuration/` | 시스템 설정(모듈, 옵션, 사용자, 네트워킹, 부트, X11, Wayland 등) |
| `administration/` | 운영(서비스 관리, 컨테이너, 업그레이드, 트러블슈팅) |
| `development/` | 개발(모듈 작성, 옵션 정의, 테스트, 패키지 추가, 빌드 시스템) |
| `release-notes/` | 릴리스 노트 (각 NixOS 버전별 변경) |
| `nixos-options.md` | 옵션 카탈로그 안내 |
| `contributing-to-this-manual.chapter.md` | 매뉴얼 자체 기여 가이드 |
| `redirects.json` | 매뉴얼 URL 리다이렉트 매핑 |
| `default.nix`, `common.nix`, `shell.nix`, `README.md` | 매뉴얼 빌드 인프라 (참고용, NixOS 사용에는 직접 필요 없음) |

## 빠른 진입

- 처음 NixOS를 보는 사람: `manual.md` → `installation/` → `configuration/`
- 운영 중인 노드 다루는 사람: `administration/` + `release-notes/rl-2511.section.md`
- 모듈 만들고 싶은 사람: `development/writing-nixos-modules.section.md`
- 옵션 검색은 온라인이 더 빠름: https://search.nixos.org/options?channel=25.11

## 갱신 방법

새 stable 출시 시 (예: 26.05) 같은 방식으로 sparse clone 후 덮어쓰기:

```bash
cd /tmp && rm -rf nixpkgs-manual-fetch
git clone --depth=1 --filter=blob:none --sparse \
  --branch nixos-26.05 https://github.com/NixOS/nixpkgs.git nixpkgs-manual-fetch
cd nixpkgs-manual-fetch && git sparse-checkout set nixos/doc/manual
rm -rf ~/obsidian/reference/nixos-manual/{administration,configuration,development,installation,release-notes,*.md,*.nix,*.json}
cp -R /tmp/nixpkgs-manual-fetch/nixos/doc/manual/. ~/obsidian/reference/nixos-manual/
# _index.md(이 파일)는 보존
```

## 주의

- 파일은 **CommonMark + MyST 확장**이라 일반 markdown 렌더러는 일부 directive(`{.note}`, `:::`, `{=include}`)를 제대로 보여주지 않을 수 있음. Obsidian 기본 뷰에서는 코드블럭처럼 보일 수 있음.
- 옵션 카탈로그(`nixos-options.md`)는 빌드 시 자동 생성되는 placeholder. 실제 옵션 검색은 https://search.nixos.org/options 사용.
- 빌드 인프라 파일(`default.nix`, `common.nix`, `shell.nix`)은 manual을 PDF/HTML로 빌드할 때만 필요.
- 향후 [[zlambda]] 같은 NixOS 노드 운영 시 빠른 참조용.

## 관련 문서

- [[infra-hosts]] — 인프라 호스트 (zlambda NixOS 노드 포함)
- [[zlambda]] — zlambda(구 sandbox-tokyo)의 NixOS 전환 기록과 운영 가이드