Requirements
Host requirements
To set up your host correctly, keep the following requirements in mind:
- Confirm that your host device has Debian 11.9 or Ubuntu 22.04 as an operating system.
Note: This procedure is designed specifically for Debian 11.9 or Ubuntu 22.04 and might not work properly with other operating systems.
- Install the X11 Window System to enable the Remote
Desktop feature. Instead, if Wayland is installed and enabled, disable it by
editing the file:
/etc/gdm3/custom.conf
or
/etc/gdm3/daemon.conf
uncomment the following line by removing the #:
#WaylandEnable=false
- Do not upload to the host any AppArmor profile named after the value of the
APPARMOR_PROFILE
environment variable. If you do so, the Setuphost will load such a profile in enforcement mode. TheAPPARMOR_PROFILE
environment variable is located in the .env file within theRemoteAccess_Compose
directory.Note: To learn more about the .env file configuration, see Configure features supported in the container. - Make sure you use Systemd on the host.
- Confirm that the host uses an active systemd-resolved for DNS resolution. Check its
status by entering
systemctl status systemd-resolved
. - If not already existing, the Setuphost creates a
remoteaccess_runtime
user that has the following credentials. Ensure that this user is available on your host:- Username:
remoteaccess_runtime
- UID:
9879
- GID:
9879
- Username:
Packages for scripts running
Some scripts run by the Setuphost during the host initialization phase require specific commands to be available on the host system. If any of these commands are missing, the Setuphost container will return an error. Most of the commands are typically available by default on a clean installation of Debian or Ubuntu.
Note: Confirm that these commands are installed to avoid any interruptions while running the
scripts.
Command |
Type for installation |
---|---|
useradd
groupadd |
sudo apt-get install passwd |
xdpyinfo (used only when RDP is enabled) |
sudo apt-get install x11-utils |
xhost (used only when RDP is enabled) |
sudo apt-get install x11-xserver-utils |
mknod (used only when VPN is enabled)
readlink |
sudo apt-get install coreutils |
iptables (used only when VPN is enabled) |
sudo apt-get install iptables |
brctl (used only when VPN is enabled) |
sudo apt-get install bridge-utils |
dhclient (used only when VPN is enabled) |
sudo apt-get install isc-dhcp-client |
aa-status
apparmor_parser
aa-enforce (used only when an AppArmor profile is specified) |
sudo apt-get install apparmor-utils apparmor |
systemd-run
systemctl
resolvectl |
sudo apt-get install systemd |