Homebox

Homebox

Docker app from ZappyZap's Repository

Overview

Homebox is the inventory and organization system built for the Home User! With a focus on simplicity and ease of use, Homebox is the perfect solution for your home inventory, organization, and management needs

HomeBox

Docs | Demo | Discord

Github Checks

What is HomeBox

HomeBox is the inventory and organization system built for the Home User! With a focus on simplicity and ease of use, Homebox is the perfect solution for your home inventory, organization, and management needs. While developing this project, We've tried to keep the following principles in mind:

  • 🧘 Simple but Expandable - Homebox is designed to be simple and easy to use. No complicated setup or configuration required. But expandable to whatever level of infrastructure you want to put into it.
  • 🚀 Blazingly Fast - Homebox is written in Go, which makes it extremely fast and requires minimal resources to deploy. In general, idle memory usage is less than 50MB for the whole container.
  • 📦 Portable - Homebox is designed to be portable and run on anywhere. We use SQLite and an embedded Web UI to make it easy to deploy, use, and backup.

Key Features

  • 📇 Rich Organization - Organize your items into categories, locations, and tags. You can also create custom fields to store additional information about your items.
  • 🔍 Powerful Search - Quickly find items in your inventory using the powerful search feature.
  • 📸 Image Upload - Upload images of your items to make it easy to identify them.
  • 📄 Document and Warranty Tracking - Keep track of important documents and warranties for your items.
  • 💰 Purchase & Maintenance Tracking - Track purchase dates, prices, and maintenance schedules for your items.
  • 📱 Responsive Design - Homebox is designed to work on any device, including desktops, tablets, and smartphones.

Screenshots

Login Screen Dashboard Item View Create Item Search

You can also try the demo instances of Homebox:

Quick Start

Configuration & Docker Compose

# If using the rootless or hardened image, ensure data 
# folder has correct permissions
mkdir -p /path/to/data/folder
chown 65532:65532 -R /path/to/data/folder
docker run -d \
  --name homebox \
  --restart unless-stopped \
  --publish 3100:7745 \
  --env TZ=Europe/Bucharest \
  --volume /path/to/data/folder/:/data \
  ghcr.io/sysadminsmedia/homebox:latest
# ghcr.io/sysadminsmedia/homebox:latest-rootless
# ghcr.io/sysadminsmedia/homebox:latest-hardened

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

To get started with code based contributions, please see our contributing guide.

If you are not a coder and can't help translate, you can still contribute financially. Financial contributions help us maintain the project and keep demos running.

Help us Translate

We want to make sure that Homebox is available in as many languages as possible. If you are interested in helping us translate Homebox, please help us via our Weblate instance.

Translation status

Credits

Contributors

Install Homebox on Unraid in a few clicks.

Find Homebox in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Homebox Review the template variables and paths Click Install

Download Statistics

228,989
Total Downloads
26,998
This Month
22,116
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Details

Repository
ghcr.io/sysadminsmedia/homebox:latest
Last Updated2026-06-29
First Seen2024-06-19

Runtime arguments

Web UI
http://[IP]:[PORT:7745]/
Network
bridge
Shell
sh
Privileged
false
Extra Params
--restart=unless-stopped

Template configuration

Data DirPathrw
Target
/data
Value
/mnt/user/appdata/homebox
Log LevelVariable

log level to use, can be one of: trace, debug, info, warn, error, critical

Target
HBOX_LOG_LEVEL
Default
info
Value
info
Log FormatVariable

log format to use, can be one of: text, json

Target
HBOX_LOG_FORMAT
Default
text
Value
text
Maximum fil upload sizeVariable

maximum file upload size supported in MB

Target
HBOX_WEB_MAX_UPLOAD_SIZE
Default
10
Value
10
Web UI portPorttcp
Target
7745
Default
3100
Value
3100
Allow RegistrationVariable

allow users to register themselves

Target
HBOX_OPTIONS_ALLOW_REGISTRATION
Default
true
Value
true
Check For Github ReleasesVariable

check for new github releases

Target
HBOX_OPTIONS_CHECK_GITHUB_RELEASE
Default
true
Value
true
Auth API Key PepperVariable

pepper for hashing API keys

Target
HBOX_AUTH_API_KEY_PEPPER
ModeVariable

application mode used for runtime behavior can be one of: development, production

Target
HBOX_MODE
Default
production
Value
production
Auto Increment Asset IDsVariable

auto increments the asset_id field for new items

Target
HBOX_OPTIONS_AUTO_INCREMENT_ASSET_ID
Default
true
Value
true
Web Read TimeoutVariable

Read timeout of HTTP sever

Target
HBOX_WEB_READ_TIMEOUT
Default
10s
Value
10s
Web Write TimeoutVariable

Write timeout of HTTP server

Target
HBOX_WEB_WRITE_TIMEOUT
Default
10s
Value
10s
Web Idle TimeoutVariable

Idle timeout of HTTP server

Target
HBOX_WEB_IDLE_TIMEOUT
Default
30s
Value
30s
Mail HostVariable

email host to use, if not set no email provider will be used

Target
HBOX_MAILER_HOST
Mailer PortVariable

email port to use

Target
HBOX_MAILER_PORT
Default
587
Value
587
Mailer UsernameVariable

email user to use

Target
HBOX_MAILER_USERNAME
Mailer PasswordVariable

email password to use

Target
HBOX_MAILER_PASSWORD
Mailer Sender AddressVariable

email from address to use

Target
HBOX_MAILER_FROM