Files
BetterDesk/docs/docker/GHCR_PACKAGE_README.md
UNITRONIX 3411994d60 feat(docker): introduce official single container layout and update installation scripts
- Added support for an official all-in-one Docker image (`ghcr.io/unitronix/betterdesk`) as the default installation method.
- Updated installation scripts and documentation to reflect the new single container layout.
- Retained legacy two-container layout option for backward compatibility.
- Adjusted API port from `21114` to `21121` for the new layout.
- Enhanced Docker-related scripts and configuration files to support the new structure.
- Updated various language files to ensure consistency in messaging regarding Docker deployment.
2026-07-06 19:31:22 +02:00

1.2 KiB
Raw Permalink Blame History

BetterDesk — Official All-in-One Container Image

Image: ghcr.io/unitronix/betterdesk

This is the recommended BetterDesk Docker deployment. It bundles the Go server (signal, relay, HTTP API) and the Node.js web console in a single container, managed by supervisord.

Quick start

curl -fsSL https://raw.githubusercontent.com/UNITRONIX/BetterDesk/main/docker-compose.quick.single.yml -o docker-compose.yml
docker compose pull && docker compose up -d

Or use the one-line installer (defaults to this image):

curl -fsSL https://raw.githubusercontent.com/UNITRONIX/BetterDesk/main/install.sh | sudo bash

Update

docker compose pull && docker compose up -d

Pin a release tag with BETTERDESK_IMAGE_TAG (see DOCKER_QUICKSTART.md).

Ports

Port Service
5000 Web console
21115 NAT test
21116 Signal (TCP/UDP)
21117 Relay
2111821119 WebSocket signal/relay
21121 HTTP API (RustDesk client + REST)

Legacy split images

For two-container deployments, use betterdesk-server and betterdesk-console with docker-compose.quick.yml or install.sh --split.