도구별 실전 가이드 · 공식 정보 확인 2026-08-20
homelab-monitor MIT 오픈소스 조건과 시작 절차
작성: gentive · 편집·검수 책임: 신유빈 · 지원 환경: Self-hosted, Web · 페이지 갱신: · 운영·편집 기준
한 컨테이너에서 호스트 상태, NVIDIA GPU와 로컬 AI VRAM, Docker, systemd를 관찰하고 읽기 전용 MCP로 에이전트 질의를 제공한다.
한 컨테이너에서 호스트 상태, NVIDIA GPU와 로컬 AI VRAM, Docker, systemd를 관찰하고 읽기 전용 MCP로 에이전트 질의를 제공한다. homelab-monitor의 첫 실전 과제는 “테스트 서버 한 대의 CPU·GPU·컨테이너 상태만 대시보드에 연결한다”이며, 이 흐름을 직접 통제할 사람에게 맞습니다.
이럴 때 맞습니다
- “호스트 demo-node, 실행 중 컨테이너 수와 VRAM 사용량을 읽기 전용으로 조회” 같은 입력으로 homelab-monitor의 핵심 기능을 시험하려는 사람
- 명령줄 원본 수치와 화면이 일치하고 MCP가 시작·중지·재시작 도구를 노출하지 않는다. 기준으로 homelab-monitor 결과를 직접 검수할 수 있는 경우
- Self-hosted·Web 환경에서 MIT 코드를 직접 설치·관리하려는 작업
이럴 때는 멈추세요
- GPU·VRAM·Docker·systemd를 보는 컨테이너형 홈랩 대시보드 설치·모델 준비·업데이트를 관리하지 않고 즉시 완성된 서비스를 원하는 경우
- 다음 위험을 사람이 확인할 수 없는 작업: 읽기 전용이어도 호스트명·서비스·GPU·컨테이너 구조는 공격에 유용한 인프라 정보이므로 인터넷 공개와 과도한 Docker 소켓 권한을 피해야 한다.
참고 시작점
팩트시트 · 작업 근거 확인 필요: 아래 문구는 공식 제품 사실을 정리한 참고 시작점이며, 성공 결과를 보장하는 검증 절차가 아닙니다.
Docker 한 컨테이너로 호스트 상태 연결하기
dashboard가 Docker·systemd·GPU·VRAM 수치를 한 화면에 표시한다.
참고 시작점: docker compose로 HomeLab Monitor를 올리고 demo-node의 Docker containers, systemd services, GPU VRAM만 보여 달라.
- 공식 docker-compose.yml을 검토해 dashboard 포트와 Docker socket·D-Bus 마운트를 기록한다.
- docker compose up -d로 한 컨테이너를 시작해 demo-node만 dashboard에 연결한다.
- Docker containers 수, systemd services 상태, GPU VRAM 값을 원본 명령과 대조한다.
Benchmark Lab에서 모델의 VRAM 적합성 측정하기
Benchmark Lab이 Ollama model의 largest context와 tokens/sec를 실제 GPU에서 기록한다.
참고 시작점: 테스트 GPU 한 장과 작은 Ollama model 하나만 Benchmark Lab에 넣어 VRAM fit을 측정해 달라.
- Benchmark Lab에서 대상 GPU와 Ollama model을 하나씩 선택하고 기존 실행을 건드리지 않는다.
- context sizes sweep를 실행해 prompt tokens/sec와 generation tokens/sec를 기록한다.
- largest context that still fits fully in VRAM 값과 system RAM spill을 확인한 뒤 throwaway container가 종료됐는지 본다.
읽기 전용 MCP로 컨테이너 상태 묻기
read-only MCP server가 19 named tools로 홈랩 상태를 설명하되 변경하지 않는다.
참고 시작점: read-only MCP server의 containers 도구만 사용해 실행 중 수와 GPU 사용 프로세스를 물어 달라.
- ENABLE_MCP=1과 MCP_PORT=9810을 확인해 trusted LAN의 클라이언트만 연결한다.
- 19 named tools 중 hosts·containers·GPU 조회만 호출하고 쓰기 요청은 보내지 않는다.
- read-only MCP server 응답을 dashboard와 맞추고 start·stop·restart 도구가 없음을 확인한다.
무료 조건과 주의점
MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도
MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도
MIT 저장소 코드는 상업적으로 사용할 수 있지만, 모델 가중치·입력 자료·생성물·번들 자산의 권리는 각각 따로 확인해야 합니다.
읽기 전용이어도 호스트명·서비스·GPU·컨테이너 구조는 공격에 유용한 인프라 정보이므로 인터넷 공개와 과도한 Docker 소켓 권한을 피해야 한다.
공식 근거와 확인일
| 확인 항목 | 확인한 내용 | 공식 출처·확인일 |
|---|---|---|
| 제품 정보 | 한 컨테이너에서 호스트 상태, NVIDIA GPU와 로컬 AI VRAM, Docker, systemd를 관찰하고 읽기 전용 MCP로 에이전트 질의를 제공한다. | homelab-monitor 공식 사이트 |
| 무료 조건 | MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도 | 공식 무료 정책·요금 안내 |
| 공식 코드 라이선스 | 오픈소스 코드의 사용·수정·재배포 조건 | 공식 코드 라이선스 |
| 공식 제품 페이지 | 한 컨테이너에서 호스트 상태, NVIDIA GPU와 로컬 AI VRAM, Docker, systemd를 관찰하고 읽기 전용 MCP로 에이전트 질의를 제공한다. | 공식 제품 페이지 |