1. Homarr와 Docker 기반 개인 대시보드의 장점
Homarr는 자주 사용하는 웹 서비스, 서버 관리 도구, 홈 네트워크 장비, 스트리밍 서비스 등을 한 화면에 모아 관리할 수 있는 개인 대시보드입니다. 브라우저 북마크만으로도 서비스를 정리할 수 있지만, Homarr를 사용하면 아이콘, 카테고리, 상태 정보, 위젯 등을 활용해 훨씬 보기 좋은 시작 화면을 만들 수 있습니다. 특히 홈 서버나 NAS를 운영하는 사용자에게 유용합니다.
Docker를 이용하면 Homarr 설치 과정이 단순해집니다. 운영체제에 직접 패키지를 설치하지 않아도 되며, 컨테이너 이미지와 설정 파일만 관리하면 되므로 백업과 이전도 편리합니다. 서버를 교체하거나 NAS 환경을 변경할 때도 Docker Compose 파일과 데이터 볼륨을 옮기는 방식으로 비교적 쉽게 복구할 수 있습니다.
Homarr는 단순한 바로가기 페이지를 넘어 여러 서비스의 정보를 한곳에 표시하는 용도로 활용할 수 있습니다. 예를 들어 Pi-hole 또는 AdGuard Home의 DNS 차단 현황, Plex나 Jellyfin의 미디어 서버 상태, Sonarr·Radarr의 다운로드 관리 현황, Portainer의 컨테이너 관리 화면 등을 하나의 대시보드에 연결할 수 있습니다. 자주 확인하는 관리 페이지가 많을수록 편의성이 커집니다.
구축 전에는 Homarr를 실행할 서버의 Docker 환경을 먼저 준비해야 합니다. 일반적인 Linux 서버, Raspberry Pi, Synology NAS, QNAP NAS, 미니 PC 등에서 실행할 수 있으며, 외부에서 접속할 계획이라면 도메인과 리버스 프록시 구성도 고려해야 합니다. 처음에는 내부 네트워크에서만 사용할 수 있도록 구성한 뒤, 필요할 때 보안 설정을 추가하는 방식이 안전합니다.
2. Docker Compose로 Homarr 설치하기
Homarr 설치를 위해 먼저 서버에 작업용 디렉터리를 만듭니다. 예를 들어 Linux 환경에서는 /opt/homarr 또는 홈 디렉터리 아래에 homarr 폴더를 생성하면 됩니다. 이 폴더에는 Docker Compose 설정 파일과 Homarr가 생성하는 데이터 파일이 함께 저장되므로, 추후 백업할 때도 해당 디렉터리를 기준으로 관리하면 편리합니다.
아래 예시는 가장 기본적인 Docker Compose 구성입니다. compose.yml 또는 docker-compose.yml 파일을 만들고 내용을 저장합니다. 포트 7575는 외부 접속 포트이므로, 이미 다른 서비스가 사용 중이라면 원하는 값으로 변경할 수 있습니다.
services:
homarr:
image: ghcr.io/homarr-labs/homarr:latest
container_name: homarr
restart: unless-stopped
ports:
- "7575:7575"
volumes:
- ./appdata:/appdata
environment:
- TZ=Asia/Seoul설정 파일을 저장한 뒤 해당 디렉터리에서 다음 명령을 실행합니다. Docker Compose가 이미 설치되어 있다면 컨테이너 이미지를 자동으로 내려받고 Homarr를 백그라운드에서 실행합니다. 실행 상태는 docker compose ps 명령으로 확인할 수 있으며, 문제가 생겼을 때는 docker compose logs -f homarr 명령으로 로그를 살펴볼 수 있습니다.
docker compose up -d컨테이너가 정상적으로 시작되면 브라우저에서 http://서버IP:7575로 접속합니다. 예를 들어 서버 IP가 192.168.0.20이라면 http://192.168.0.20:7575 주소를 사용하면 됩니다. 첫 접속 시 관리자 계정 생성이나 초기 설정 과정이 표시될 수 있으며, 완료 후에는 대시보드 이름과 기본 레이아웃을 원하는 방식으로 설정할 수 있습니다.
3. 서비스 바로가기와 위젯 연동하기
Homarr에서 가장 기본적으로 사용하는 기능은 애플리케이션 바로가기 추가입니다. 대시보드 편집 모드로 들어간 뒤 새 항목을 추가하고, 서비스 이름과 URL을 입력하면 됩니다. 예를 들어 Portainer는 http://192.168.0.20:9000, Home Assistant는 http://192.168.0.30:8123, NAS 관리 페이지는 https://192.168.0.10:5001과 같은 형태로 등록할 수 있습니다.
바로가기에는 서비스별 아이콘을 적용하는 것이 좋습니다. Homarr는 다양한 아이콘을 제공하며, 서비스 로고가 없을 경우 직접 이미지 URL을 사용하거나 일반적인 웹 아이콘을 선택할 수도 있습니다. 아이콘과 이름을 통일된 규칙으로 정리하면 대시보드가 훨씬 깔끔해집니다. 예를 들어 관리 도구는 파란색, 미디어 서비스는 보라색, 네트워크 도구는 초록색 계열로 분류하는 식의 구성이 가능합니다.
서비스가 여러 개라면 카테고리 또는 그룹 기능을 활용해 정리하는 것이 좋습니다. 예를 들어 서버 관리, 미디어, 다운로드, 네트워크, 스마트홈, 개인 생산성 등의 영역으로 나눌 수 있습니다. 서버 관리 그룹에는 Portainer, Proxmox, Grafana를 배치하고, 미디어 그룹에는 Plex, Jellyfin, qBittorrent, Sonarr, Radarr를 배치하는 방식이 일반적입니다.
일부 서비스는 단순 링크 외에도 API 기반 위젯 연동을 지원합니다. 예를 들어 Pi-hole, AdGuard Home, Plex, Sonarr, Radarr, SABnzbd 등은 API 키나 인증 정보를 입력하면 차단 통계, 다운로드 상태, 미디어 현황 등의 정보를 대시보드에 표시할 수 있습니다. API 키를 입력할 때는 읽기 전용 권한을 제공할 수 있는지 확인하고, 외부에 공개된 대시보드에서는 민감한 토큰이나 내부 정보가 노출되지 않도록 주의해야 합니다.
4. 보안, 업데이트, 백업 관리 방법
Homarr를 내부 네트워크에서만 사용할 경우에는 서버의 사설 IP 주소로 접속하는 방식이 가장 간단합니다. 하지만 외부에서도 접속하려면 포트를 인터넷에 직접 노출하기보다 Nginx Proxy Manager, Traefik, Caddy 같은 리버스 프록시를 사용하는 것이 좋습니다. 리버스 프록시를 이용하면 도메인 연결과 HTTPS 인증서 적용, 접근 제어를 한 번에 관리할 수 있습니다.
외부 접속 환경에서는 Homarr 자체 로그인 기능뿐 아니라 추가 인증 계층을 두는 것도 좋습니다. 예를 들어 Cloudflare Access, Authelia, Authentik, Tailscale VPN 또는 WireGuard VPN을 이용하면 인터넷에 관리 페이지를 직접 공개하지 않고도 안전하게 접근할 수 있습니다. 특히 Portainer, NAS 관리자 페이지, 라우터 관리 페이지 같은 민감한 링크를 Homarr에 등록했다면 VPN 기반 접근을 우선 고려하는 편이 좋습니다.
업데이트는 Docker 이미지를 새로 받은 뒤 컨테이너를 재생성하는 방식으로 진행할 수 있습니다. 업데이트 전에는 appdata 디렉터리를 먼저 백업하고, 이후 docker compose pull과 docker compose up -d 명령을 순서대로 실행하면 됩니다. 최신 이미지에는 기능 개선과 보안 패치가 포함될 수 있지만, 메이저 버전 변경 시 설정 형식이나 데이터 구조가 달라질 수 있으므로 릴리스 노트를 확인하는 습관이 필요합니다.
docker compose pull
docker compose up -d마지막으로 대시보드의 완성도는 지속적인 정리에 달려 있습니다. 더 이상 사용하지 않는 서비스는 바로가기를 제거하고, 자주 사용하는 서비스는 상단이나 중앙에 배치하는 것이 좋습니다. 서버 장애나 인증서 만료, DNS 문제처럼 자주 확인해야 하는 항목은 상태 위젯과 함께 구성하면 Homarr가 단순한 즐겨찾기 페이지가 아니라 개인 서버 운영의 중심 화면으로 활용될 수 있습니다.