Introduction
This guide walks you through the steps to enable and use Remote Desktop on your edge device via the Allxon Hub feature.
System Requirements
Before you begin, make sure your device meets the following minimum requirements:
- Operating System: Ubuntu 22.04 (JetPack 6.0) or later
- Monitor: A physical display must be connected to the device.
Enable Remote Desktop on Your Device
Starting from Ubuntu 22.04, Remote Desktop Protocol (RDP) support is built in. You can enable it directly in your Ubuntu system settings:
Connect via the Allxon Portal
Once Remote Desktop has been enabled on your device, you can launch it directly from Allxon Portal using the Allxon Hub feature. This allows you to securely access and control your edge device’s desktop environment anytime, anywhere.
💡Remote Desktop with auto-login💡
By default, the remote desktop password will be randomly generated each time the device is rebooted when auto-login is enabled. This is because, during auto-login to the desktop, the session does not have the necessary authentication to access the permanent remote desktop password that is stored in the encrypted keyring.
Action Required: Please make sure to use the Send Command feature to unlock the keyring every time the device has rebooted.
Allxon provides a script below that allows you to unlock the keyring remotely by using the Allxon Send Command Feature:
LOGIN_USER="" # your edge device login user name
KEYRING_PASSWORD="" # your keyring password
set -Eeuo pipefail
log() { printf '%s %s\n' "$(date -Is)" "$*" >&2; }
die() { log "ERROR: $*"; exit 1; }
[ -n "$LOGIN_USER" ] || die "LOGIN_USER not provided. Use --user or set LOGIN_USER."
for cmd in sudo id gnome-keyring-daemon systemctl; do
command -v "$cmd" >/dev/null 2>&1 || die "Required command missing: $cmd"
done
USER_UID="$(id -u "$LOGIN_USER" 2>/dev/null || true)"
[ -n "$USER_UID" ] || die "User not found: $LOGIN_USER"
XDG_RUNTIME_DIR="/run/user/$USER_UID"
if [ ! -d "$XDG_RUNTIME_DIR" ]; then
log "WARN: $XDG_RUNTIME_DIR does not exist. User systemd session may not be active."
fi
[ -n "$KEYRING_PASSWORD" ] || die "Password is empty."
log "Unlocking GNOME Keyring for user '$LOGIN_USER'"
printf '%s' "$KEYRING_PASSWORD" | sudo -H -u "$LOGIN_USER" env XDG_RUNTIME_DIR="$XDG_RUNTIME_DIR" gnome-keyring-daemon --daemonize --replace --unlock
log "Restarting gnome-remote-desktop for user '$LOGIN_USER'"
sudo -H -u "$LOGIN_USER" env XDG_RUNTIME_DIR="$XDG_RUNTIME_DIR" systemctl --user restart gnome-remote-desktop
unset -v KEYRING_PASSWORD || true
log "Done"
Customized Service Options
We also offer a customized service to suit your use case for remote desktop access requirements.
Troubleshooting
If the remote desktop client unexpectedly closes immediately after you enter the user name and password: Please check you have the monitor connected to the device correctly and the monitor can show the desktop properly.