{
  "schema_version": 1,
  "generated_at": "2026-10-23T00:00:00.000Z",
  "canonical_url": "https://openlogs.fyi/tools/homebox",
  "slug": "homebox",
  "name": "Homebox",
  "tagline": "Inventory manager for household items with labels, locations and attachments.",
  "replaces": {
    "summary": "Paid home inventory services, such as Sortly.",
    "products": [
      {
        "slug": "sortly",
        "name": "Sortly",
        "vendor": "Sortly",
        "url": "https://openlogs.fyi/alternatives/sortly"
      }
    ]
  },
  "stack": [
    {
      "kind": "language",
      "name": "Go"
    }
  ],
  "deployment_methods": [
    "docker_compose"
  ],
  "requirements": {
    "min_ram_mb": null,
    "min_cpu_cores": null,
    "source_url": null
  },
  "license": {
    "spdx": "AGPL-3.0",
    "class": "osi",
    "source_url": "https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/LICENSE"
  },
  "business_model": {
    "value": "unknown",
    "notes": "The README at the pinned commit does not state a business model, so it stays unknown.",
    "source_url": "https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/README.md",
    "checked_at": "2026-10-22"
  },
  "difficulty": {
    "value": "easy",
    "reason": "1 service, 1 volume mount, no env values to set, no elevated host access. Heuristic score 0 of 11: easy."
  },
  "repository": {
    "owner": "sysadminsmedia",
    "name": "homebox",
    "url": "https://github.com/sysadminsmedia/homebox"
  },
  "compose_check": {
    "status": "config_ok",
    "validated_at": "2026-10-22",
    "summary": "config_ok on 2026-10-22"
  },
  "recipe": {
    "version": 1,
    "source_path": "docs/src/content/docs/en/quick-start/install.mdx",
    "source_repo": "sysadminsmedia/homebox",
    "source_commit_sha": "1fd28822634a3d5935c002d569559ef46530d4a0",
    "source_kind": "app_repo",
    "source_url": "https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/docs/src/content/docs/en/quick-start/install.mdx"
  },
  "install_steps": [
    {
      "order": 1,
      "kind": "prerequisite",
      "language": "text",
      "label": "Docker with the Compose plugin",
      "body": "A host with Docker and the Docker Compose plugin. This entry runs from a compose file.",
      "source_url": "https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/docs/src/content/docs/en/quick-start/install.mdx#L82-L103",
      "validation_status": "unvalidated"
    },
    {
      "order": 2,
      "kind": "compose",
      "language": "yaml",
      "label": "Save the code block as compose.yml",
      "body": "services:\n    homebox:\n        image: ghcr.io/sysadminsmedia/homebox:latest\n        restart: always\n        environment:\n            - HBOX_LOG_LEVEL=info\n            - HBOX_LOG_FORMAT=text\n            - HBOX_WEB_MAX_UPLOAD_SIZE=10\n            # Please consider allowing analytics to help us improve Homebox (basic computer information, no personal data)\n            - HBOX_OPTIONS_ALLOW_ANALYTICS=false\n            # Use a strong random string for the pepper in production, it will be used to hash API keys and make them more secure\n            - HBOX_AUTH_API_KEY_PEPPER=some_random_string\n        volumes:\n            - homebox-data:/data/\n        ports:\n            - 3100:7745\n\nvolumes:\n    homebox-data:\n        driver: local\n",
      "source_url": "https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/docs/src/content/docs/en/quick-start/install.mdx",
      "validation_status": "config_ok"
    },
    {
      "order": 3,
      "kind": "note",
      "language": "text",
      "label": "What the compose file check ran with",
      "body": "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.",
      "source_url": "https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/docs/src/content/docs/en/quick-start/install.mdx#L82-L103",
      "validation_status": "unvalidated"
    },
    {
      "order": 4,
      "kind": "shell",
      "language": "bash",
      "label": "Start it",
      "body": "docker compose up -d",
      "source_url": "https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/docs/src/content/docs/en/quick-start/install.mdx",
      "validation_status": "unvalidated"
    },
    {
      "order": 5,
      "kind": "verify",
      "language": "text",
      "label": "Open the app",
      "body": "Open http://localhost:3100. The compose file publishes host port 3100 for the homebox service.",
      "source_url": "https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/docs/src/content/docs/en/quick-start/install.mdx",
      "validation_status": "unvalidated"
    }
  ],
  "notes": [
    {
      "kind": "gotcha",
      "title": "Some images use the latest tag or no tag",
      "body": "Images without a pinned version: homebox: ghcr.io/sysadminsmedia/homebox:latest. A later pull can get a different version.",
      "source_url": "https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/docs/src/content/docs/en/quick-start/install.mdx",
      "checked_at": "2026-10-22"
    },
    {
      "kind": "gotcha",
      "title": "The compose file publishes host ports",
      "body": "Host ports: 3100 (homebox). A port without a host address listens on all host network interfaces.",
      "source_url": "https://github.com/sysadminsmedia/homebox/blob/1fd28822634a3d5935c002d569559ef46530d4a0/docs/src/content/docs/en/quick-start/install.mdx",
      "checked_at": "2026-10-22"
    }
  ],
  "signals": {
    "captured_at": "2026-10-22",
    "stars": 7616,
    "forks": 599,
    "open_issues": 142,
    "last_push": "2026-10-17",
    "days_since_push": 5,
    "latest_release": "v0.27.0",
    "latest_release_date": "2026-10-17",
    "days_since_release": 5
  },
  "links": {
    "html": "https://openlogs.fyi/tools/homebox",
    "markdown": "https://openlogs.fyi/tools/homebox.md",
    "json": "https://openlogs.fyi/tools/homebox.json"
  },
  "updated_at": "2026-10-22"
}