Files
BetterDesk/docs/wiki/MeshAgent.md
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

1.9 KiB

MeshAgent

BetterDesk includes an optional MeshCentral compatibility layer for managing MeshAgent endpoints alongside RustDesk peers.


Overview

Component Role
MeshAgent Lightweight agent on managed endpoints
BetterCore Agent-side JS pushed after handshake (consent, WebRTC, terminals)
BetterViewer Panel web remote viewer for MNG_KVM sessions (transport=mesh)

Mesh is enabled by default on full installs (MESH_ENABLED=Y). Disable with MESH_ENABLED=N on betterdesk-server.service if not needed.


Operator actions (panel)

For online mesh_agent devices, the device menu includes:

Action Description
Web Remote KVM desktop over mesh transport
Terminal Interactive shell
File browser Remote files
Run command One-shot command on agent channel
Guest desktop link Time-limited view-only URL
TCP port relay Browser tunnel to LAN host:port
Sleep / Reset Power commands via MeshAgent API

Session recording: open web remote with ?record=1 for server-side .mcrec capture.


Web remote integration

Mesh KVM sessions use the same Web Remote Desktop UI with transport=mesh. HTTPS panel proxy must forward .ashx paths to the Go API (automatic with Node.js console).


Enable / disable

# Check service environment
systemctl cat betterdesk-server | grep MESH

# Disable
sudo systemctl edit betterdesk-server
# Add: Environment=MESH_ENABLED=N
sudo systemctl restart betterdesk-server

Panel HTTPS (:5443 or reverse proxy) should proxy MeshCentral-style paths to Go API port 21114.


See also