Shren207 Nixos Config Managing Minipc

NixOS MiniPC 관리

NixOS MiniPC 설치, 설정, 유지보수, 설정 배치 가이드입니다. (NixOS 전용)

설정 배치 규칙

새 NixOS 설정을 추가할 때 반드시 아래 기준에 따라 배치 위치를 결정할 것.

판단 기준: "다른 NixOS 호스트에서도 동일하게 적용할 수 있는가?"

하드웨어 종속 설정 판별 체크리스트

다음 중 하나라도 해당하면 hosts/<hostname>/에 배치:

• 네트워크 인터페이스명 포함 (enp2s0, wlp1s0, eno1 등)
• 디스크 장치 경로 또는 UUID 포함 (/dev/nvme0n1, by-uuid/...)
• PCI 버스/슬롯 주소 참조 (0000:02:00.0)
• 특정 하드웨어 모델/드라이버에 의존
• fileSystems.* 마운트 포인트 (disko가 관리하지 않는 추가 디스크)

현재 hosts/greenhead-minipc/default.nix 구성

# 하드웨어 종속 설정만 포함
users.users.${username}.openssh.authorizedKeys.keys = [ ... ];  # 이 호스트의 SSH 접근 허용키
networking.interfaces.enp2s0.wakeOnLan.enable = true;           # NIC 종속 (Intel igc, PCI 02:00.0)
fileSystems."/mnt/data" = { device = "by-uuid/..."; };          # HDD UUID 종속

빠른 참조

NixOS 전용 nrs 옵션

nrs --force               # 소스 빌드 경고 무시하고 진행
nrs --force --cores 2     # 코어 제한으로 진행 (과열 방지)

소스 빌드 Pre-flight 체크: nrs/nrp가 nix build --dry-run으로 non-trivial 소스 빌드를 사전 감지하여 nrs는 abort, nrp는 경고 출력.

nrs/nrp 소스: modules/shared/scripts/rebuild-common.sh, modules/nixos/scripts/{nrs,nrp}.sh

MiniPC 접속 (Mac에서만 필요)

Platform이 darwin(Mac)일 때만 SSH 접속 필요:

ssh minipc      # ~/.ssh/config에 정의됨 (macOS 전용)

Platform이 linux이면 이미 MiniPC — SSH 금지. 명령어를 직접 실행할 것.

주요 파일 위치

시스템 복구

nixos-rebuild switch --rollback 또는 systemd-boot 메뉴에서 이전 세대 선택. 상세 내용: references/installation.md

원격 복원력

커널 패닉 자동 재부팅(10초), systemd watchdog(30초 hang 감지 → 10분 후 강제 재부팅), WoL(같은 LAN 전용). 상세 내용: references/features.md

하드웨어 모니터링

S.M.A.R.T. 디스크 건강 모니터링 (smartd)

modules/nixos/programs/smartd.nix에서 NixOS services.smartd 모듈 활용. NVMe + HDD 자동 감지, 디스크 장애 사전 감지 시 Pushover 알림 전송.

• 온도 임계값: 5도 변화 로그 / 50도 경고 / 60도 위험 (-W 5,50,60)
• 알림 우선순위: PreFailure/CurrentPendingSector/OfflineUncorrectable → 긴급(1), 기타 → 일반(0)
• 시크릿: pushover-system-monitor.age (smartd + temp-monitor 공유, NixOS 모듈 시스템이 merge)

systemctl status smartd            # 서비스 상태
sudo smartctl -a /dev/nvme0n1      # NVMe SMART 데이터
sudo smartctl -a /dev/sda          # HDD SMART 데이터

온도 모니터링 (temp-monitor)

modules/nixos/programs/temp-monitor/에서 systemd timer로 5분마다 CPU/NVMe 온도를 체크. 임계값 초과 시 단계별(경고/위험) Pushover 알림 발송. 임계값은 libraries/constants.nix의 tempMonitor에서 관리.

• 쿨다운: 경고 15분, 위험 5분 (단계별 차등)
• 시크릿: pushover-system-monitor.age (smartd와 공유)
• 센서 식별: 칩 타입 접두사(coretemp-/nvme-)로 동적 탐색

sensors                                        # 수동 온도 확인
sensors -j                                     # JSON 출력 (스크립트가 사용하는 형식)
systemctl status temp-monitor.service          # 서비스 상태
systemctl list-timers | grep temp-monitor      # 타이머 확인
journalctl -u temp-monitor.service -n 20       # 최근 로그
ls -la /var/lib/temp-monitor/                  # 상태 파일 (쿨다운 기록)

자주 발생하는 문제

1. nixos-install 시 flake 캐시 문제: --refresh 옵션 사용
2. hardware-configuration.nix 충돌: disko와 fileSystems 중복 확인
3. 부팅 불가: systemd-boot에서 이전 세대 선택 후 롤백

런타임 환경 전제

이 스킬은 NixOS MiniPC 호스트 환경 전제다. AI 에이전트 세션(Claude Code · Codex CLI · headless)이 어디서 실행되든 다음 의존을 충족하지 못하면 명령은 실행 불가하다.

• nixos-rebuild, nrs, nrp 등 NixOS 전용 명령은 NixOS 호스트에서만 동작 (macOS 호스트는 nrs 입력 시 nix-darwin 경로로 분기됨 — managing-macos 사용)
• sudo 권한으로 systemd/smartd/temp-monitor 명령 실행
• BIOS/UEFI WoL 설정, 하드웨어 인터페이스명(enp2s0), 디스크 UUID는 hosts/greenhead-minipc/에 호스트 종속으로 박혀 있음 — 다른 NixOS 호스트로 이식 시 직접 수정 필요
• ~/.local/lib/의 rebuild-common.sh 등 user-scope helper는 home-manager activation에 의해 설치되며 host 외부에선 부재

본 스킬을 macOS Codex 세션이나 다른 NixOS 호스트에서 호출하면 호스트 종속 부분(인터페이스명/UUID/하드웨어 모니터링)이 실패할 수 있다.

레퍼런스

• 트러블슈팅: references/troubleshooting.md
• 설치 가이드: references/installation.md
• 기능 목록: references/features.md
• 호스트 환경 전제 (hosting-copyparty/karakeep 공유): references/host-prerequisites.md

Source: shren207/nixos-config — distributed by TomeVault.