Requirements

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
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.
Normal