sysadminsmedia/homebox

어떤 프로젝트인가요?

핵심 기능

• 01카테고리, 위치, 태그별로 물품 정리
• 02물품에 추가 정보를 저장할 사용자 지정 필드 설정
• 03물품에 이미지, 문서, 보증 정보 첨부
• 04구매일, 가격, 유지보수 일정 기록
• 05재고 전체 검색
• 06SQLite 저장소와 Docker 배포를 지원하는 반응형 웹 UI

활용 사례

• 보험 가입이나 이사를 위해 집안 물품 목록 작성
• 가전제품의 보증 기간과 설명서 관리
• 가정용 장비의 유지보수 일정 기록
• 홈 서버에서 비공개 재고 관리 시스템 운영

빠른 시작

1. 1

   pepper를 로컬 파일에 저장합니다

   openssl rand -base64 48 > hbox.pepper
2. 2

   pepper 파일의 권한을 제한합니다

   chmod 400 hbox.pepper
3. 3

   data 폴더를 만들고 Docker로 컨테이너를 실행합니다

   docker run -d --name homebox --restart unless-stopped --publish 3100:7745 --env TZ=Europe/Bucharest --env HBOX_AUTH_API_KEY_PEPPER=$(cat hbox.pepper) --volume /path/to/data/folder/:/data ghcr.io/sysadminsmedia/homebox:latest

사용 전 알아둘 점

• !Docker를 사용하거나 수동으로 설정해야 하며, 첫 실행 전에 비밀 pepper 파일을 만들어야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

homebox은(는) 무엇인가요?

물품, 위치, 문서, 보증 및 유지보수를 기록하는 셀프 호스팅 가정용 재고 관리 시스템으로, 기존 HomeBox 프로젝트를 이어갑니다. HomeBox는 가정 사용자를 위한 셀프 호스팅 재고 및 정리 앱입니다. 보유한 물품을 기록하고, 물품을 카테고리·위치·태그별로 정리하며, 추가 정보를 위한 사용자 지정 필드를 설정할 수 있습니다.

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

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

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

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

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

보험 가입이나 이사를 위해 집안 물품 목록 작성 가전제품의 보증 기간과 설명서 관리 가정용 장비의 유지보수 일정 기록 홈 서버에서 비공개 재고 관리 시스템 운영

homebox는 어떻게 설치하나요?

pepper를 로컬 파일에 저장합니다: openssl rand -base64 48 > hbox.pepper pepper 파일의 권한을 제한합니다: chmod 400 hbox.pepper data 폴더를 만들고 Docker로 컨테이너를 실행합니다: docker run -d --name homebox --restart unless-stopped --publish 3100:7745 --env TZ=Europe/Bucharest --env HBOX_AUTH_API_KEY_PEPPER=$(cat hbox.pepper) --volume /path/to/data/folder/:/data ghcr.io/sysadminsmedia/homebox:latest

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

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