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. The APPARMOR_PROFILE environment variable is located in the .env file within the RemoteAccess_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:
    1. Username: remoteaccess_runtime
    2. UID: 9879
    3. 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