# Homebox

Inventory manager for household items with labels, locations and attachments.

- Replaces: [Sortly](https://openlogs.fyi/alternatives/sortly)
- Summary: Paid home inventory services, such as Sortly.
- Stack: Go (language)
- Deployment: docker_compose
- License: AGPL-3.0 (osi) [source](https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/LICENSE)
- Business model: unknown. The README at the pinned commit does not state a business model, so it stays unknown. ([source](https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/README.md), read 2026-10-22)
- Difficulty: easy. 1 service, 1 volume mount, no env values to set, no elevated host access. Heuristic score 0 of 11: easy.
- Requirements: not stated
- Repository: [sysadminsmedia/homebox](https://github.com/sysadminsmedia/homebox)

## Install

1. Docker with the Compose plugin ([source](https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/docs/src/content/docs/en/quick-start/install.mdx#L82-L103))

   ```text
   A host with Docker and the Docker Compose plugin. This entry runs from a compose file.
   ```

2. Save the code block as compose.yml ([source](https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/docs/src/content/docs/en/quick-start/install.mdx))

   ```yaml
   services:
       homebox:
           image: ghcr.io/sysadminsmedia/homebox:latest
           restart: always
           environment:
               - HBOX_LOG_LEVEL=info
               - HBOX_LOG_FORMAT=text
               - HBOX_WEB_MAX_UPLOAD_SIZE=10
               # Please consider allowing analytics to help us improve Homebox (basic computer information, no personal data)
               - HBOX_OPTIONS_ALLOW_ANALYTICS=false
               # Use a strong random string for the pepper in production, it will be used to hash API keys and make them more secure
               - HBOX_AUTH_API_KEY_PEPPER=some_random_string
           volumes:
               - homebox-data:/data/
           ports:
               - 3100:7745
   
   volumes:
       homebox-data:
           driver: local
   ```

3. What the compose file check ran with ([source](https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/docs/src/content/docs/en/quick-start/install.mdx#L82-L103))

   ```text
   This compose file is copied unchanged from the code block in https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/docs/src/content/docs/en/quick-start/install.mdx#L82-L103. The block sits inside a list in the page, so the indent of its lines was removed, as the rendered page shows it. The check ran on that block alone. The quick start guide tells the reader to create a compose.yml with this content.
   ```

4. Start it ([source](https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/docs/src/content/docs/en/quick-start/install.mdx))

   ```bash
   docker compose up -d
   ```

5. Open the app ([source](https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/docs/src/content/docs/en/quick-start/install.mdx))

   ```text
   Open http://localhost:3100. The compose file publishes host port 3100 for the homebox service.
   ```

Compose file check: config_ok on 2026-10-22.

## Gotchas and maintenance

### Gotchas

- Some images use the latest tag or no tag: Images without a pinned version: homebox: ghcr.io/sysadminsmedia/homebox:latest. A later pull can get a different version. ([source](https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/docs/src/content/docs/en/quick-start/install.mdx), checked 2026-10-22)
- The compose file publishes host ports: Host ports: 3100 (homebox). A port without a host address listens on all host network interfaces. ([source](https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/docs/src/content/docs/en/quick-start/install.mdx), checked 2026-10-22)

### Signals

Computed from a GitHub snapshot taken 2026-10-22.

- Open issues and pull requests: 142
- Stars: 7616, forks: 599
- Last push: 2026-10-17 (5 days ago)
- Latest release: v0.27.0 on 2026-10-17 (5 days ago)

## Sources

- [Repository: https://github.com/sysadminsmedia/homebox](https://github.com/sysadminsmedia/homebox)
- [License: https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/LICENSE](https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/LICENSE)
- [Business model: https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/README.md](https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/README.md)
- [Compose file: https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/docs/src/content/docs/en/quick-start/install.mdx](https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/docs/src/content/docs/en/quick-start/install.mdx)
- [Install step: https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/docs/src/content/docs/en/quick-start/install.mdx#L82-L103](https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/docs/src/content/docs/en/quick-start/install.mdx#L82-L103)

---
Canonical: https://openlogs.fyi/tools/homebox  
Last updated: 2026-10-22