3.2 KiB
3.2 KiB
title, updated, tags, source, upstream-version
| title | updated | tags | source | upstream-version | ||||
|---|---|---|---|---|---|---|---|---|
| NixOS Manual (25.11 Xantusia) | 2026-04-08 |
|
https://github.com/NixOS/nixpkgs/tree/nixos-25.11/nixos/doc/manual | 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 후 덮어쓰기:
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 전환 기록과 운영 가이드