gethomepage/homepage

어떤 프로젝트인가요?

핵심 기능

• 01Docker 컨테이너 레이블을 통한 서비스 자동 탐색
• 02API 키를 서버 측에 보관하는 100개 이상 서비스용 프록시 API 연동
• 03날씨, 시간, 날짜, 검색, 시스템 상태 정보 위젯
• 04YAML 파일을 통한 설정
• 05사용자 지정 테마, CSS, JavaScript 및 레이아웃
• 06다국어 인터페이스와 AMD64 및 ARM64용 Docker 이미지

활용 사례

• 홈 서버의 모든 셀프 호스팅 서비스 링크를 모은 시작 페이지 만들기
• 하나의 대시보드에서 Docker 컨테이너 상태와 리소스 사용량 모니터링하기
• *arr, Plex 또는 Jellyfin의 다운로드 및 미디어 라이브러리 상태를 한곳에서 확인하기

빠른 시작

1. 1

   docker run으로 Docker 이미지를 실행하세요(HOMEPAGE_ALLOWED_HOSTS를 설정하고 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

사용 전 알아둘 점

• !GPL-3.0 라이선스가 적용되며, 카피레프트 라이선스 조건에 따라 파생물도 동일한 조건으로 오픈소스화해야 합니다.
• !신뢰할 수 없는 네트워크에서 접근할 수 있다면 인증과 TLS를 적용하는 reverse proxy 또는 VPN 뒤에 배치해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

homepage은(는) 무엇인가요?

Docker 서비스 탐색, 100개 이상의 서비스용 API 프록시 위젯, YAML 설정을 지원하는 셀프 호스팅 애플리케이션 대시보드입니다. Homepage는 직접 호스팅해 사용하는 맞춤형 시작 페이지이자 애플리케이션 대시보드입니다. 서비스 링크, Docker 컨테이너의 실시간 상태와 통계, *arr 제품군, Plex, Jellyfin, qBittorrent 등의 셀프 호스팅 앱에서 가져온 데이터 위젯을 표시하고, 날씨·시간·날짜·검색 같은 정보 위젯도 제공합니다.

homepage은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

homepage은(는) GPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

homepage은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. homepage의 마지막 커밋은 2026년 10월 23일입니다.

homepage은(는) 어디에 사용할 수 있나요?

홈 서버의 모든 셀프 호스팅 서비스 링크를 모은 시작 페이지 만들기 하나의 대시보드에서 Docker 컨테이너 상태와 리소스 사용량 모니터링하기 *arr, Plex 또는 Jellyfin의 다운로드 및 미디어 라이브러리 상태를 한곳에서 확인하기

homepage는 어떻게 설치하나요?

docker run으로 Docker 이미지를 실행하세요(HOMEPAGE_ALLOWED_HOSTS를 설정하고 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

homepage은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/gethomepage/homepage