v3.0.0
UNITRONIX/BetterDeskv3.0.0Jun 7, 2026by UNITRONIX
AI Summary
This release addresses a critical SQLite crash issue during database upgrades and updates Docker image version reporting. It also updates the default Docker image tag to the stable 3.0.0 version and ensures legacy access tokens are properly backfilled.
Key Highlights
- Resolves SQLite crash on existing auth.db volumes by adding missing `token_hash` column before running indexes.
- Legacy access tokens are automatically backfilled with SHA-256 hashes on first boot.
- Docker image labels and entrypoints now correctly report version 3.0.0 instead of an undefined version.
- Docker quick-start configuration now defaults to the stable `3.0.0` image tag instead of `3.0.0-alpha`.
Full Release Notes
## [3.0.0] — 2026-06-07
### Fixed
- **SQLite auth.db upgrade crash (issue #158)** — Console startup no longer fails with `SqliteError: no such column: token_hash` on existing `auth.db` volumes. The `token_hash` column and index are now added before any index DDL runs; legacy access tokens are backfilled with SHA-256 hashes on first boot.
- **Docker image version display** — Container entrypoints and image labels now report **3.0.0** (via `BETTERDESK_IMAGE_VERSION` at build time).
### Changed
- **Docker quick-start default image tag** — `docker-compose.quick.yml` pins `ghcr.io/unitronix/betterdesk-{server,console}:3.0.0` instead of `3.0.0-alpha`.
---