v3.3.2

UNITRONIX/BetterDeskv3.3.2Jun 17, 2026by UNITRONIX

AI Summary

A patch release fixing bare-metal console startup failures caused by permission errors on the data directory.

Key Highlights

Fixed bare-metal console startup failure due to `SQLITE_READONLY_DIRECTORY`.
Applied setgid group-write permissions to the data directory.
Improved installer permission handling for unprivileged `betterdesk` user.

Full Release Notes

Patch release on `main`. Ships via **Settings → Updates** (Stable), `betterdesk.sh` option 2 (Update / Repair permissions), or panel update on the stable channel.

### Fixed

- **Bare-metal console startup (#206)** — `betterdesk-console` failed with `SQLITE_READONLY_DIRECTORY` on `db_v2.sqlite3` because the unprivileged `betterdesk` user could not write to the Go server data directory. Installer and `linux-ensure-console-user.js` now apply setgid group-write on `$RUSTDESK_PATH`, re-sync permissions after the Go server starts, and verify both console `data/` and Go data dirs before marking permissions OK.

### Upgrade notes

| Topic | Action |
|-------|--------|
| **Broken console on bare metal** | Update to 3.3.2+ via Settings → Updates (Stable) or `betterdesk.sh` → Update. Or once as root: `chown root:betterdesk /opt/betterdesk && chmod 2775 /opt/betterdesk`, then `systemctl restart betterdesk-console`. |
| **Verify** | `systemctl is-active betterdesk-console`; panel loads on port 5000 or 5443; `journalctl -u betterdesk-console -n 20` shows no `SQLITE_READONLY_DIRECTORY`. |


## What's Changed
* Hotfix 3.3.1: betterdesk.sh update (#198, #199) by @UNITRONIX in https://github.com/UNITRONIX/BetterDesk/pull/200
* Hotfix 3.3.2: bare-metal console permissions (#206) by @UNITRONIX in https://github.com/UNITRONIX/BetterDesk/pull/207


**Full Changelog**: https://github.com/UNITRONIX/BetterDesk/compare/v3.3.0...v3.3.2