- Software components setup and installation
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 theRemote Desktopfeature. Instead, if Wayland is installed and enabled, disable it by editing the file:/etc/gdm3/custom.confor/etc/gdm3/daemon.confuncomment the following line by removing the #:#WaylandEnable=false
- Do not upload to the host any AppArmor profile named after the value of theAPPARMOR_PROFILEenvironment variable. If you do so, the Setuphost will load such a profile in enforcement mode. TheAPPARMOR_PROFILEenvironment variable is located in the .env file within theRemoteAccess_Composedirectory.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 enteringsystemctl status systemd-resolved.
- If not already existing, the Setuphost creates aremoteaccess_runtimeuser that has the following credentials. Ensure that this user is available on your host:
- Username:remoteaccess_runtime
- UID:9879
- GID:9879
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 |
Provide Feedback