Homebox: 집 안 물건 인벤토리 셀프호스팅

이사 준비물, 계절 옷, 공구, 여분의 전자제품 케이블까지 — 집에 물건이 쌓이다 보면 “그거 어디 뒀더라”를 반복하게 돼요. Homebox는 이런 문제를 해결하기 위해 만들어진 셀프호스팅 인벤토리 관리 도구로, 물건을 사진과 함께 등록하고 위치별로 정리해서 나중에 검색으로 바로 찾을 수 있게 해줘요. 그렇다면 집 안 물건 인벤토리를 셀프호스팅으로 관리한다는 게 실제로 어떻게 이뤄질까요?

기본 개념: 위치(Location)와 라벨(Label)

Homebox의 핵심 구조는 계층적인 “위치”예요. 예를 들어 “집 > 창고 > 파란 박스 3번”처럼 물건이 보관된 위치를 트리 구조로 등록해두고, 각 물건을 해당 위치에 배정해요. 여기에 “전자제품”, “계절용품”, “공구” 같은 라벨을 추가로 붙이면, 위치와 카테고리 두 축으로 자유롭게 물건을 찾을 수 있어요.

각 물건 항목에는 다음과 같은 정보를 기록할 수 있어요.

이름, 설명, 사진: 여러 장의 사진을 첨부할 수 있어요.
구매 정보: 구매처, 구매일, 구매 가격을 기록해요.
제품 정보: 제조사, 모델명, 시리얼 번호를 기록해요.
보증 만료일: 만료 전에 알림을 받을 수 있어요.
수량: 같은 물건을 여러 개 보유한 경우도 관리할 수 있어요.

실제로 유용한 시나리오

Homebox는 “물건을 못 찾는” 일상적인 문제뿐 아니라, 이사나 보험 청구처럼 물건 목록 자체가 중요해지는 상황에서도 진가를 발휘해요.

이사할 때: 어느 박스에 뭐가 들었는지 미리 등록해두면, 이사 후 특정 물건을 찾기 위해 모든 박스를 열어볼 필요가 없어요.
보증 기간 관리: 가전제품의 보증 만료일을 등록해두고, 만료 전에 알림을 받아 하자 발생 시 놓치지 않고 AS를 받을 수 있어요.
보험 청구 대비: 화재나 도난 같은 사고 발생 시, 등록해둔 사진과 구매 가격 정보가 보험 청구 과정에서 물건 목록과 가치를 증빙하는 자료가 돼요.
중복 구매 방지: “그 케이블 집에 있었나?”를 검색 한 번으로 확인할 수 있어, 이미 있는 물건을 또 사는 낭비를 줄여요.

QR 코드/라벨 프린팅 연동

Homebox는 각 위치나 물건에 대해 QR 코드 라벨을 생성하는 기능을 제공해요. 이 QR 코드를 실제 박스나 서랍에 붙여두면, 스마트폰으로 스캔했을 때 바로 그 위치에 등록된 물건 목록이 떠요. 라벨 프린터가 있다면 이 워크플로우가 특히 편리한데, 물리적인 라벨과 디지털 데이터베이스를 QR 코드로 연결하는 셈이에요.

설치

다른 서비스들과 마찬가지로 Docker Compose 한 파일로 간단히 띄울 수 있어요.

services:
  homebox:
    image: ghcr.io/sysadminsmedia/homebox:latest
    ports:
      - "7745:7745"
    volumes:
      - homebox_data:/data
volumes:
  homebox_data:

단일 Go 바이너리 기반이라 리소스 사용량이 매우 낮고, 라즈베리파이 같은 저전력 기기에서도 충분히 돌릴 수 있어요.

데이터 입력의 현실적인 장벽

인벤토리 관리 도구의 공통적인 약점은 “초기 데이터 입력이 번거롭다”는 거예요. 집에 있는 물건을 하나하나 사진 찍고 등록하는 작업은 상당한 시간이 들어요. 현실적인 접근은 처음부터 모든 물건을 완벽하게 등록하려 하지 말고, 이사나 대청소처럼 어차피 물건을 하나씩 살펴봐야 하는 시점에 맞춰 점진적으로 등록해나가는 거예요. 혹은 자주 찾게 되는 물건(공구, 케이블, 서류)부터 우선순위를 두고 등록하는 것도 좋은 전략이에요.

다중 사용자와 가족 공유

가족 구성원이 각자 계정으로 접속해 같은 인벤토리를 함께 조회하고 갱신할 수 있어요. “그 드라이버 어디 있어?”라는 질문에 직접 찾아보는 대신 Homebox를 검색해서 답해줄 수 있는 셈이라, 물건을 정리하는 사람과 찾는 사람이 다른 가족 단위에서 특히 효용이 커요.

결론

Homebox는 화려한 기능보다 “정확히 이 문제(물건을 못 찾겠다)“를 해결하는 데 집중한 실용적인 도구예요. 초기 등록에 품이 들긴 하지만, 한 번 정리해두면 이후로 물건을 찾는 시간을 꾸준히 절약해주는, 투자 대비 효용이 확실한 셀프호스팅 프로젝트예요. 보증서나 영수증처럼 종이 서류까지 함께 디지털화하고 싶다면 Paperless-ngx를 같이 구성하는 것도 좋고, 외출 중에 물건 위치를 확인하고 싶다면 Tailscale로 원격 접속하면 돼요.