All versions since v0.24.1
v0.24.1
What’s Changed
- fix: stop the items page crashing when attachments connected
- chore(deps): bump the npm_and_yarn group across 2 directories with 1 update by @dependabot[bot] in https://github.com/sysadminsmedia/homebox/pull/1355
- chore(deps): bump the npm_and_yarn group across 2 directories with 2 updates by @dependabot[bot] in https://github.com/sysadminsmedia/homebox/pull/1357
Full Changelog: https://github.com/sysadminsmedia/homebox/compare/v0.24.0...v0.24.1
v0.24.2
- Actually fixes the item page crash (multiple validated reports and tests)
Full Changelog: https://github.com/sysadminsmedia/homebox/compare/v0.24.1...v0.24.2
v0.25.0
[!NOTE] As always, we highly recommend making a backup of your databases and files before upgrading!
[!IMPORTANT] This release fixes CVE-2026-40196 which allowed a user removed from their default group to still access it via the API.
Big Changes
- Tag Relationships: Tags can now have parents/children, and icons.
- Fractional/Decimal Quantities: You can now have partial quantities like 1.2, 3.45, etc.
- User Settings Stored in DB: Your user preferences are now stored in the DB, settings persist across devices and browsers.
- OpenTelemetry Support: Homebox now has basic OpenTelemetry tracing, logging and error tracking. While not full and in-depth yet, it has already proven useful in finding issues and potential performance problems.
- More Barcode Providers: OpenFoodFacts, OpenBeautyFacts, and OpenProductsFact have been added as providers to broaden the support for scanning product barcodes for metadata.
- And plenty of other improvements and bug fixes.
What’s Changed
- chore(deps): bump the npm_and_yarn group across 2 directories with 1 update by @dependabot[bot] in https://github.com/sysadminsmedia/homebox/pull/1365
- chore(deps): bump the npm_and_yarn group across 2 directories with 1 update by @dependabot[bot] in https://github.com/sysadminsmedia/homebox/pull/1366
- Update to go 1.26, and other various backend updates by @tankerkiller125 in https://github.com/sysadminsmedia/homebox/pull/1364
- chore(deps): bump flatted from 3.3.3 to 3.4.1 in /frontend in the npm_and_yarn group across 1 directory by @dependabot[bot] in https://github.com/sysadminsmedia/homebox/pull/1370
- Add OpenTelemetry tracing to backend and frontend with full chain support in https://github.com/sysadminsmedia/homebox/pull/1256
- chore(deps): bump google.golang.org/grpc from 1.79.2 to 1.79.3 in /backend in the go_modules group across 1 directory by @dependabot[bot] in https://github.com/sysadminsmedia/homebox/pull/1383
- chore(deps): bump the npm_and_yarn group across 2 directories with 1 update by @dependabot[bot] in https://github.com/sysadminsmedia/homebox/pull/1382
- Improve tag handling by @tankerkiller125 and @tonyaellie in https://github.com/sysadminsmedia/homebox/pull/1327
- chore(deps): bump flatted from 3.4.1 to 3.4.2 in /frontend in the npm_and_yarn group across 1 directory by @dependabot[bot] in https://github.com/sysadminsmedia/homebox/pull/1385
- Add backend to store user settings in the DB by @tankerkiller125 and @tonyaellie in https://github.com/sysadminsmedia/homebox/pull/958
- Add a page for tags by @tonyaellie in https://github.com/sysadminsmedia/homebox/pull/1392
- feat: fractional/decimal quantity by @tankerkiller125 in https://github.com/sysadminsmedia/homebox/pull/1372
- Fix incorrectly generated Swagger docs for
/labelmaker/asset/{id}route by @adarshp in https://github.com/sysadminsmedia/homebox/pull/1084 - chore(deps): bump brace-expansion from 1.1.12 to 1.1.13 in /frontend in the npm_and_yarn group across 1 directory by @dependabot[bot] in https://github.com/sysadminsmedia/homebox/pull/1399
- chore(deps): bump node-forge from 1.3.3 to 1.4.0 in /frontend in the npm_and_yarn group across 1 directory by @dependabot[bot] in https://github.com/sysadminsmedia/homebox/pull/1400
- feat(frontend): Make group invitation link work when user is logged in by @mdrkrg in https://github.com/sysadminsmedia/homebox/pull/1412
- fix: apply collection currency changes immediately by @IceeAn in https://github.com/sysadminsmedia/homebox/pull/1409
- feat: add OpenFoodFacts as barcode lookup provider by @palini762 in https://github.com/sysadminsmedia/homebox/pull/1406
- Add Open Facts barcode sources by @RobinMJD in https://github.com/sysadminsmedia/homebox/pull/1426
New Contributors
- @adarshp made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1084
- @mdrkrg made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1412
- @palini762 made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1406
- @RobinMJD made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1426
Full Changelog: https://github.com/sysadminsmedia/homebox/compare/v0.24.2...v0.25.0
v0.26.0
[!CAUTION] We recommend skipping direct to v0.26.1, this release has an issue with attachments for docker containers.
[!NOTE] As always, we highly recommend making a backup of your databases and files before upgrading! But especially this one for it’s major architecture changes.
[!WARNING] This release requires an additional environment variable or CLI parameter to be set.
HBOX_AUTH_API_KEY_PEPPERor--auth-api-key-peppermust be set to at least 32 characters random secret.
Biggest Release Yet!
This is by far the biggest, most comprehensive release of Homebox since we took over. Below are the biggest, most important changes. Please read through the warnings and notes carefully, as they contain important upgrade information.
Entity Merge
This release officially implements the entity merge, one of the most comprehensive and complex changes to the Homebox backend ever. Items and locations now share a single underlying “entity” structure, allowing them to share custom fields, attachments, entity types, and templates — and preparing Homebox to take on the features and capabilities people have been asking for.
[!WARNING] The entity merge introduces significant database re-work. You should always make a backup before updating, but a backup is especially important in this case.
[!IMPORTANT] If you are an integration/software developer, the
/v1/items*and/v1/locations*endpoints have been entirely replaced by/v1/entities*. Please review our entity merge documentation for the API changes.
API Keys
Homebox can now generate static API Keys for developers/integrations. Each key takes on the access level of the user who created it. All Homebox keys are prefixed with hb_ to help prevent secrets from being accidentally committed to source code repositories.
Password Resets
Homebox now supports password resets. If the instance admin configures the SMTP environment variables, users can reset their password from the front-end quickly and easily. For those not wanting to set up SMTP, you can run homebox reset-password --email=<email>, which outputs a random new password for that user (which they can then change from the UI).
Better Export/Import (Experimental)
Thanks to the entity merge, you can now export an entire collection’s inventory (including attachments, tags, entities, etc.) into a single ZIP file. That ZIP can then be imported into a different Homebox instance (the receiving collection must be “empty”). A recurring background export task is included as well.
“AR” Scanner
Added more as a fun experiment, but we think some people will find it genuinely useful. Switch to “AR” mode and point your camera at a Homebox QR code — a hovering box appears with basic information about the entity, and if it has children, a list of those child entities.
Other Improvements
- External URL attachments — attach HTTP(S) links to entities via drag-and-drop; rendered as direct hyperlinks and stored as DB records (no blob storage used).
- Convert entity type — convert an item into a location (or vice versa) directly from the edit view.
- Entity types UI — new entity-types management page with improved UI and page titles.
- Remember selected camera in the scanner.
- Nix flake for reproducible dev/build environments.
- Config redaction & stronger security protections, stronger API-key pepper hashing, group/permission fixes, and extensive new tracing.
- Numerous bug fixes: CSV import/export (parent relationships, location export), dark-theme styling, legacy Windows attachment paths, WebSocket auth/retry, DNS64 support, password-manager support, Swagger BaseURL, and more.
Security Fixes:
The following security advisories have been fixed:
- GHSA-r9pf-rg22-655m (pending CVE assignment)
- CVE-2026-48826
- CVE-2026-48974
- CVE-2026-48975
- CVE-2026-48976
What’s Changed
- chore(deps): bump dompurify from 3.3.3 to 3.4.0 in /frontend in the npm_and_yarn group across 1 directory by @dependabot[bot] in https://github.com/sysadminsmedia/homebox/pull/1434
- feat(frontend): remember previously selected camera by @lpiepiora in https://github.com/sysadminsmedia/homebox/pull/1425
- feat: merge items and locations into “entities” by @tankerkiller125 in https://github.com/sysadminsmedia/homebox/pull/1414
- feat: “ar” scanner functionality by @tankerkiller125 in https://github.com/sysadminsmedia/homebox/pull/1421
- fix: correct apostrophe placement in default collection name on user registration by @Copilot in https://github.com/sysadminsmedia/homebox/pull/1462
- Fix #1398 by setting Swagger BaseURL to dynamic variable by @katosdev in https://github.com/sysadminsmedia/homebox/pull/1459
- Fix public docs to remove github URL by @katosdev in https://github.com/sysadminsmedia/homebox/pull/1464
- Update baseURL by @katosdev in https://github.com/sysadminsmedia/homebox/pull/1465
- fix: #437 hopefully by @tankerkiller125 in https://github.com/sysadminsmedia/homebox/pull/1455
- fix: improve password manager support for auth forms by @martinfrancois in https://github.com/sysadminsmedia/homebox/pull/1477
- feat: add support for external URL attachments by @szaiser in https://github.com/sysadminsmedia/homebox/pull/1481
- fix: location create modal shows ‘Item Photo’ instead of ‘Location Photo’ (closes #1456) by @bskthefirst in https://github.com/sysadminsmedia/homebox/pull/1490
- fix: handle numeric list_price in upcitemdb response by @aaaaaadrian in https://github.com/sysadminsmedia/homebox/pull/1432
- feat: password reset by @tankerkiller125 in https://github.com/sysadminsmedia/homebox/pull/1488
- feat: export/import capability by @tankerkiller125 in https://github.com/sysadminsmedia/homebox/pull/1472
- fix: preserve CSV item parent relationships by @saquibreja7-hash in https://github.com/sysadminsmedia/homebox/pull/1517
- i18n(ko-KR): translate sidebar, quick stats, collection menu by @wonieby in https://github.com/sysadminsmedia/homebox/pull/1519
- Fixes bug where location is exported incorrectly for csv export by @bmyoungquist in https://github.com/sysadminsmedia/homebox/pull/1393
- fix: dark theme styling issues by @IceeAn in https://github.com/sysadminsmedia/homebox/pull/1418
- fix: lack of page title for entity types page by @tonyaellie in https://github.com/sysadminsmedia/homebox/pull/1540
- Add nix flake by @6543 in https://github.com/sysadminsmedia/homebox/pull/1119
- fix: improve entity type UI by @tonyaellie in https://github.com/sysadminsmedia/homebox/pull/1544
- fix: expose ability to change type to ui by @tonyaellie in https://github.com/sysadminsmedia/homebox/pull/1546
New Contributors
- @lpiepiora made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1425
- @martinfrancois made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1477
- @szaiser made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1481
- @bskthefirst made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1490
- @aaaaaadrian made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1432
- @saquibreja7-hash made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1517
- @wonieby made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1519
- @6543 made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1119
Full Changelog: https://github.com/sysadminsmedia/homebox/compare/v0.25.0...v0.26.0
v0.26.1
Fixes
- Search page issue
- Storage library regression breaking attachments on docker deployments
Full Changelog: https://github.com/sysadminsmedia/homebox/compare/v0.26.0...v0.26.1
v0.26.2
What’s Changed
- fix: various new bugs by @tankerkiller125 in https://github.com/sysadminsmedia/homebox/pull/1553
Full Changelog: https://github.com/sysadminsmedia/homebox/compare/v0.26.1...v0.26.2
v0.27.0
[!CAUTION] Homebox now defaults to blocking notifiers to all internal IP addresses, if you have internal services with RFC1918 IPs that Homebox needs access to for webhooks or otherwise, please review our documentation on notifier security configuration: https://homebox.software/en/user-guide/notifiers/#network-security-for-notifiers
What’s New
- This release includes significant improvements to search, including tokenization for database-based searching, and the ability to use Meilisearch as a backend. See our documentation for configuration: https://homebox.software/en/quick-start/configure/search/
Security Issues Patched
This release fixes 15 security issues:
- https://github.com/sysadminsmedia/homebox/security/advisories/GHSA-mw9p-fhpj-jf82
- https://github.com/sysadminsmedia/homebox/security/advisories/GHSA-h7wm-wjr6-cfxh
- https://github.com/sysadminsmedia/homebox/security/advisories/GHSA-mgw9-qw3h-224m
- https://github.com/sysadminsmedia/homebox/security/advisories/GHSA-58m4-m8xj-v3j2
- https://github.com/sysadminsmedia/homebox/security/advisories/GHSA-754m-5j7m-8wfv
- https://github.com/sysadminsmedia/homebox/security/advisories/GHSA-59cq-p2m6-hh23
- https://github.com/sysadminsmedia/homebox/security/advisories/GHSA-j935-m3f2-frrj
- https://github.com/sysadminsmedia/homebox/security/advisories/GHSA-4gp5-59x3-vhhg
- https://github.com/sysadminsmedia/homebox/security/advisories/GHSA-4p8r-vm9v-c9pm
- https://github.com/sysadminsmedia/homebox/security/advisories/GHSA-wxcf-4p4j-vhvg
- https://github.com/sysadminsmedia/homebox/security/advisories/GHSA-g3p9-jfjj-pqgw
- https://github.com/sysadminsmedia/homebox/security/advisories/GHSA-xqg9-6xxv-3452
- https://github.com/sysadminsmedia/homebox/security/advisories/GHSA-h4x5-6587-jpwp
- https://github.com/sysadminsmedia/homebox/security/advisories/GHSA-jm28-2xm3-m6m5
- https://github.com/sysadminsmedia/homebox/security/advisories/GHSA-rhfm-x4x2-p3qr
As usual, we thank all security researchers who reported issues.
What’s Changed
- flake.lock: Update by @6543 in https://github.com/sysadminsmedia/homebox/pull/1558
- chore: more consistent css by @andrewhong04 in https://github.com/sysadminsmedia/homebox/pull/1559
- fix: various other issues with v0.26.x by @tankerkiller125 in https://github.com/sysadminsmedia/homebox/pull/1564
- linting improvements and apply formatting fixes by @harrisony in https://github.com/sysadminsmedia/homebox/pull/1567
- Fix update-currencies CI job: restcountries API
namefield returns string instead of object by @tankerkiller125 with @Copilot in https://github.com/sysadminsmedia/homebox/pull/1570 - chore(deps): bump the npm_and_yarn group across 1 directory with 2 updates by @dependabot[bot] in https://github.com/sysadminsmedia/homebox/pull/1568
- fix: backup memory usage by @lpiepiora in https://github.com/sysadminsmedia/homebox/pull/1582
- fix: various bugs by @tankerkiller125 in https://github.com/sysadminsmedia/homebox/pull/1596
- feat: replace the deprecated countries API with v5 by @ydkmlt84 in https://github.com/sysadminsmedia/homebox/pull/1622
- Update currencies.json by @github-actions[bot] in https://github.com/sysadminsmedia/homebox/pull/1638
- Fix/currency krone labels by @JacosVerksted in https://github.com/sysadminsmedia/homebox/pull/1640
- fix: a few random crash fixes by @harrisony in https://github.com/sysadminsmedia/homebox/pull/1628
- Fix item detail photo grid to load thumbnails instead of originals by @WangLeto in https://github.com/sysadminsmedia/homebox/pull/1607
- fix: clamp processedChars before slicing in wrapText by @SAY-5 in https://github.com/sysadminsmedia/homebox/pull/1658
- fix: preserve asset ID when re-importing items by import ref (#1100) by @TowyTowy in https://github.com/sysadminsmedia/homebox/pull/1610
- fix: resolve golangci-lint failures in Go CI by @harrisony in https://github.com/sysadminsmedia/homebox/pull/1629
- fix: use standard Cross-Origin header names in SecurityHeaders by @Ajithkumar003-dev in https://github.com/sysadminsmedia/homebox/pull/1682
- fix(ci): attest the published manifest list digest instead of a copied source manifest by @Datastream-x86 in https://github.com/sysadminsmedia/homebox/pull/1685
- fix broken internal links in contribute docs by @Gorghs in https://github.com/sysadminsmedia/homebox/pull/1689
- Fixed bug in Quickstart instructions by @stephenlf in https://github.com/sysadminsmedia/homebox/pull/1687
- feat: use full path in location search by @lpiepiora in https://github.com/sysadminsmedia/homebox/pull/1511
- fix: infinite preference sync feedback loop and default item page size by @IceeAn in https://github.com/sysadminsmedia/homebox/pull/1632
- Update currencies.json by @github-actions[bot] in https://github.com/sysadminsmedia/homebox/pull/1695
- docs: fix typo extenal -> external by @vaibhav8a in https://github.com/sysadminsmedia/homebox/pull/1705
- fix: dates (hopefully) by @tankerkiller125 in https://github.com/sysadminsmedia/homebox/pull/1708
- fix(devcontainer): bump Go feature to 1.26 to match go.mod by @lonerockz in https://github.com/sysadminsmedia/homebox/pull/1710
- fix: make repo docker-compose.yml startable by @lonerockz in https://github.com/sysadminsmedia/homebox/pull/1711
- fix(lint): extract repeated notifier URL fixture into a constant by @landscapejohn in https://github.com/sysadminsmedia/homebox/pull/1722
- Return barcode results when one provider fails by @justadityaraj in https://github.com/sysadminsmedia/homebox/pull/1727
- Fix Traditional Chinese label generator crash by @justadityaraj in https://github.com/sysadminsmedia/homebox/pull/1728
- your -> you are / you’re by @Some1withgithub in https://github.com/sysadminsmedia/homebox/pull/1724
- fix(scanner): guard AR overlay against locations with no children by @costajohnt in https://github.com/sysadminsmedia/homebox/pull/1741
- docs: explain how Ensure Asset IDs treats an ID of 0 versus an empty one by @costajohnt in https://github.com/sysadminsmedia/homebox/pull/1743
- fix: redirect back to tags list after deleting a tag by @costajohnt in https://github.com/sysadminsmedia/homebox/pull/1744
- docs: publish the Entity Types page the user guide already links to by @vaibhav8a in https://github.com/sysadminsmedia/homebox/pull/1748
- feat: better search by @tankerkiller125 in https://github.com/sysadminsmedia/homebox/pull/1550
- fix: child item seperate location by @tankerkiller125 in https://github.com/sysadminsmedia/homebox/pull/1696
- fix: roll back thumbnail transaction on all errors to prevent DB lockups by @marazmarci in https://github.com/sysadminsmedia/homebox/pull/1761
- Update currencies.json by @github-actions[bot] in https://github.com/sysadminsmedia/homebox/pull/1793
New Contributors
- @andrewhong04 made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1559
- @ydkmlt84 made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1622
- @JacosVerksted made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1640
- @WangLeto made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1607
- @SAY-5 made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1658
- @TowyTowy made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1610
- @Ajithkumar003-dev made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1682
- @Datastream-x86 made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1685
- @Gorghs made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1689
- @stephenlf made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1687
- @vaibhav8a made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1705
- @lonerockz made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1710
- @landscapejohn made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1722
- @justadityaraj made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1727
- @Some1withgithub made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1724
- @costajohnt made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1741
- @marazmarci made their first contribution in https://github.com/sysadminsmedia/homebox/pull/1761
Full Changelog: https://github.com/sysadminsmedia/homebox/compare/v0.26.2...v0.27.0
v0.27.1 Latest
Version 27.0.1
[!WARNING] This release is a security release to patch a NodeJS upstream vulnerability. We advise updating to this version of Homebox as soon as possible.
Security Issues Patched
This version patches NodeJS to remediate risks surrounding Node2Shell. Homebox does not leverage PHP and therefore was not affected by the PHP2Shell vulnerability that was disclosed.
Full Changelog: https://github.com/sysadminsmedia/homebox/compare/v0.27.0...v0.27.1