내 서버에 설치해 여러 서비스 링크와 상태·날씨 정보를 한 화면에 모아 보는 대시보드 앱
중간맛 분석
여러 서비스 링크와 컨테이너 상태, 정보 위젯을 한 대시보드에 모아 내 서버에서 띄우는 앱입니다. 는 Next.js 애플리케이션이라고 설명하며, 페이지가 빌드 시점에 정적으로 생성된다고 밝힙니다. 설치 경로는 Compose, run, 소스 빌드 세 가지이고, Compose 경로에서는 HOMEPAGE_ALLOWED_HOSTS 지정이 필요합니다. 소스 빌드는 Git으로 저장소를 복제하고 pnpm으로 설치·빌드해야 합니다. 신뢰할 수 없는 네트워크에 노출하면 역방향 프록시 또는 VPN이 필요하며, 에는 데모 링크가 없습니다.
이런 레포예요
이럴 때 쓰면 좋아요
- 여러 웹 서비스 링크와 Docker 컨테이너 상태·통계를 한 화면에서 확인하려는 사용자
- Docker 라벨을 달아 컨테이너를 자동으로 대시보드에 등록하려는 운영자
- Radarr·Sonarr·Plex 등 README에 예시로 언급된 서비스의 정보를 위젯으로 보려는 사용자
핵심 기능
대안 대비 차별점
빌드 시점 정적 생성과 백엔드 API 요청의 전면 프록시 처리를 함께 내세워 API 키를 숨기는 구조를 README가 강조합니다.
먹어본 사람들
실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.
이 레포, 해먹는 법
처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.
준비물
- Docker Compose로 설치할 때(필수): Compose 설정에 HOMEPAGE_ALLOWED_HOSTS 허용 호스트를 지정하고, 로컬 config 디렉터리가 미리 있어야 합니다. PUID/PGID와 Docker 소켓 연결은 선택 사항입니다.
- docker run으로 설치할 때(필수): Docker로 README의 run 명령을 사용하며, Compose 경로와는 별개의 설치 방법입니다.
- 소스에서 직접 빌드할 때(필수): Git으로 저장소를 복제하고 pnpm으로 의존성 설치·빌드·실행을 진행하며, 처음 시작할 때는 src/skeleton을 config/로 복사합니다.
- 신뢰할 수 없는 네트워크에 노출할 때(필수): 인증·TLS·Host 헤더 검증을 적용하는 역방향 프록시 또는 VPN 뒤에 두어야 합니다. 내장 OIDC·비밀번호 로그인은 선택(opt-in) 기능입니다.
바로 차려먹기Node.js (pnpm)
깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.
git clone --depth 1 https://github.com/gethomepage/homepage.git && cd homepage && pnpm install && pnpm run dev
코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.
README가 안내하는 자세한 단계 보기
방법 A: docker run (Docker로 설치)
- README의 docker run 명령을 그대로 실행합니다.
HOMEPAGE_ALLOWED_HOSTS의 주소와/path/to/config경로는 자신의 환경 값으로 바꿔 씁니다.
docker run --name homepage \
-e HOMEPAGE_ALLOWED_HOSTS=gethomepage.dev \
-e PUID=1000 \
-e PGID=1000 \
-p 3000:3000 \
-v /path/to/config:/app/config \
-v /var/run/docker.sock:/var/run/docker.sock:ro \
--restart unless-stopped \
ghcr.io/gethomepage/homepage:latest
방법 B: 소스에서 빌드 (대안, 방법 A와 별개)
- 저장소를 복제합니다.
git clone https://github.com/gethomepage/homepage.git
- 의존성을 설치하고 production 번들을 빌드합니다.
pnpm install
pnpm build
-
처음 시작하는 경우
src/skeleton디렉터리를config/로 복사해 예시 설정 파일을 채웁니다. (README는 복사 명령을 따로 제시하지 않습니다.) -
자신의 허용 호스트 주소(포트 포함)를 넣어 production 모드로 서버를 실행합니다.
HOMEPAGE_ALLOWED_HOSTS=gethomepage.dev:1234 pnpm start
깃밥트라이로 맛보기
받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.
터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.
npx gitbap-try gethomepage/homepage
Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →
별 추이 · 7일
확인 시각
활용성 · 따라 만들기 좋은가
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2022년 생성
「셀프호스팅·홈서버」 이런 레포, 매주 받아보실래요?
매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.
내 레포인가요? README에 깃밥 배지 달기
[](https://www.gitbap.com/r/gethomepage/homepage)🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기