# HomeboxLabel

HomeboxLabel is a self-hosted tools & utilities app. External label service for Homebox that generates 4 x 6 inch location labels while preserving compact item labels and QR-code links back to Homebox. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/2896/homeboxlabel

## Description

External label service for Homebox that generates 4 x 6 inch location labels while preserving compact item labels and QR-code links back to Homebox.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

45/100 (Fair), based on 3 of 4 factors.
- Maintained: 69 (last commit 91 days ago)
- Popular: 16 (5 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/homeboxlabel-0v3jsb61h646qm?q=HomeboxLabel

## Common questions

### Which Docker port does HomeboxLabel listen on?

The container listens on port 8787. You can map that to any unused host port, such as 9797.

### What does the PUBLIC_BASE_URL setting do?

It supplies the public base URL for your Homebox instance so relative QR targets are converted to complete URLs. This makes the generated QR codes point to the correct item or location page.

### What size are location labels and item labels?

Location labels are rendered as 4 by 6 inch landscape PNGs at 1800 by 1200 pixels and 300 DPI. Item labels use the width and height supplied by Homebox to stay compact.

---
Source: Our Local Host (https://ourlocalhost.com/app/2896/homeboxlabel), the self-hosted and open-source app directory.
