Homebox

GitHub stats

Stars

7,616

Forks

599

Open issues and pull requests

142

Last push

2026-10-17

Latest release

v0.27.0

Released

2026-10-17

From the GitHub API on 2026-10-22. These numbers are a snapshot, not live. GitHub detected the license as AGPL-3.0.

Compose file

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

From the app's own repository: github.com/sysadminsmedia/homebox/blob/1fd2882/docs/src/content/docs/en/quick-start/install.mdx.

Compose example from the project's own docs: sysadminsmedia/homebox:docs/src/content/docs/en/quick-start/install.mdx.

Install

1. Docker with the Compose plugin (github.com/sysadminsmedia/homebox/blob/1fd2882/docs/src/content/docs/en/quick-start/install.mdx#L82-L103)

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

2. Save the code block as compose.yml (github.com/sysadminsmedia/homebox/blob/1fd2882/docs/src/content/docs/en/quick-start/install.mdx)

   Use the compose file shown above.

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

   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 (github.com/sysadminsmedia/homebox/blob/1fd2882/docs/src/content/docs/en/quick-start/install.mdx)

   docker compose up -d

5. Open the app (github.com/sysadminsmedia/homebox/blob/1fd2882/docs/src/content/docs/en/quick-start/install.mdx)

   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. (github.com/sysadminsmedia/homebox/blob/1fd2882/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. (github.com/sysadminsmedia/homebox/blob/1fd2882/docs/src/content/docs/en/quick-start/install.mdx, checked 2026-10-22)

Signals

• Open issues and pull requests: 142
• Last push: 2026-10-17 (5 days before this page was built)
• Latest release: v0.27.0 on 2026-10-17 (5 days before this page was built)