mirror of https://github.com/UNITRONIX/BetterDesk.git synced 2026-09-10 17:45:42 +00:00

Files

T

UNITRONIX 0180f33228 docs: add GitHub wiki source and sync tooling

Maintain user-facing wiki pages in docs/wiki/ with updated BetterDesk URLs,
AGPL licensing, RBAC/org coverage, and eight new operator guides. Add sync
scripts and point docker helper TLS docs to the BetterDesk wiki.

2026-07-12 20:06:09 +02:00

2.2 KiB

Raw Permalink Blame History

Panel Updates

BetterDesk can update itself through Settings → Updates in the web panel, or via betterdesk.sh / betterdesk.ps1.

Native install (recommended flow)

Log in as super_admin or server_admin
Open Settings → Updates
Review available version and changelog preview
Run Preflight (checks disk space, build tools, server binary)
Click Install — panel downloads GitHub changes, merges .env keys, rebuilds Go server if needed, restarts services

What is preserved

Database files (auth.db, db_v2.sqlite3, PostgreSQL data)
User passwords and TOTP secrets
SSL certificates and API keys
Operator secrets in .env (only missing keys appended from .env.example)

Update channels

Channel	Branch	Use
Stable	`main`	Production (default)
Development	`dev`	Latest work-in-progress

Switch under Settings → Updates → Update channel, or via installer script.

Script-based update

# Linux
sudo ./betterdesk.sh   # option 2 — Update

# Windows
.\betterdesk.ps1       # option 2 — Update

Script updates also clear stale panel warning banners from failed in-panel attempts.

Docker (GHCR images)

When running pre-built images from GHCR (docker-compose.quick.yml):

In-panel Install is disabled — use image pull instead
Panel shows pull instructions:

docker compose pull && docker compose up -d

Each console image embeds its build commit; startup syncs data/.update_sha.

Troubleshooting updates

Symptom	Fix
Red banner after successful script update	Update to latest build — banner cleared on script/Docker success (#192)
Go server build failed	Check preflight; use Rebuild server binary in Updates
Permission errors on `/opt/`	Run panel update as root or fix ownership
Stale server binary	Updates force full server source sync before compile

2.2 KiB Raw Permalink Blame History