nix-darwin/README-ko.md

nix-darwin

nix-darwin, home-manager, nix-homebrew, sops-nix를 사용해 호스트 fenrir를 선언적으로 관리하는 macOS 설정 저장소입니다.

이 저장소가 관리하는 것

• 시스템 레벨 macOS 설정(modules/)
• 사용자 레벨 도구 및 셸/에디터 설정(home/)
• 선언적 Homebrew tap/app/cask
• SOPS 기반 암호화 시크릿(secrets/ + .sops.yaml)

사전 요구사항

• Apple Silicon macOS (aarch64-darwin)
• flakes가 활성화된 Nix (nix-command + flakes)
• just (명령 실행기)
• 아래 경로의 SOPS age 키:

~/.config/sops/age/keys.txt

저장소 구조

• flake.nix: flake input/output 및 darwinConfigurations
• Justfile: 일상 명령(darwin, darwin-debug, fmt, up, gc 등)
• modules/: 시스템 모듈(nix-core.nix, system.nix, apps.nix, host-users.nix)
• home/: Home Manager 모듈(셸, git, nvf, 터미널, 도구)
• secrets/: 암호화된 시크릿 파일(poby.yaml)

자주 쓰는 명령

# 사용 가능한 작업 보기
just

# 호스트용 빌드 및 스위치
just darwin $(hostname)

# 전체 trace와 함께 빌드 및 스위치
just darwin-debug $(hostname)

# Nix 파일 포맷팅(예: 저장소 전체)
just fmt .

# flake input 전체 업데이트
just up

# 특정 input 하나만 업데이트
just upp nixpkgs-darwin

# 시스템 프로필 히스토리 확인
just history

# 오래된 generation 정리 / 가비지 컬렉션
just clean
just gc

시크릿

• 시크릿은 secrets/*.yaml에 암호화되어 저장됩니다.
• .sops.yaml이 age 기반 암호화 규칙을 강제합니다.
• Home Manager는 secrets/poby.yaml에서 아래 항목을 읽어 사용합니다:
  • github_ssh_key
  • github_cli_token

커스터마이징 노트

• flake.nix의 hostname, username, useremail을 환경에 맞게 수정하세요.
• 새 시스템 동작은 modules/*.nix에 추가하세요.
• 사용자 도구는 home/*.nix에 추가하고 home/default.nix에서 import 하세요.

트러블슈팅

• 자세한 평가/빌드 출력이 필요하면 just darwin-debug <hostname>을 사용하세요.
• 빌드는 성공했는데 동작이 반영되지 않으면 switch를 다시 실행하고 활성 host/config 값을 확인하세요.