Host
Installing the Host
This guide is for the person who installs the Remotle host on a workstation. You need administrator access to the workstation.
Computle supplies two installers for the same build:
| File | Use |
|---|---|
ComputleRemotleHost-<version>-Setup.exe | Installing by hand, or silently with /quiet |
ComputleRemotleHost-<version>.msi | Intune, Configuration Manager or a script |
-
Check the requirements.
See Host Requirements.
-
Run the setup program as an administrator.
Read the agreement and click Install.
-
Click Finish.
If setup says “Restart this computer to finish.”, restart the workstation.
-
Enrol the host.
Silent install
Section titled “Silent install”ComputleRemotleHost-<version>-Setup.exe /quietmsiexec /i ComputleRemotleHost-<version>.msi /qn| Switch | Action |
|---|---|
/quiet | Install without a window. Running it again on the same version repairs the install. |
/uninstall | Remove the host. |
The setup log is written to %TEMP%\ComputleRemotleHost-<version>-setup.log.
Install details
Section titled “Install details”| Item | Value |
|---|---|
| Scope | Per machine |
| Install folder | C:\Program Files\Computle\Remotle\ |
| Data folder | C:\ProgramData\Computle\ |
| Services | See The Remotle Host |
| Drivers | Computle Virtual Display Adapter, Computle Virtual HID Mouse, Computle Virtual Audio, Computle USB VHCI |
| Upgrades | A newer installer upgrades an older one. Installing an older version over a newer one is refused. |
Uninstall
Section titled “Uninstall”Remove Computle (Remotle) Host from Settings, Apps, or run the setup program with /uninstall. Uninstalling removes the services, drivers, host settings and host logs.
Computle supplies two packages for each build. Install both together.
| Package | Contents |
|---|---|
computle-enrolment | The host’s identity with Computle |
computle-host | The host |
-
Check the requirements.
See Host Requirements.
-
Add the kernel module packages the host needs.
Distribution USB devices ( vhci-hcd)Camera ( v4l2loopback)Ubuntu linux-modules-extra-$(uname -r). Cloud and minimal images do not include it.v4l2loopback-dkms(universe)Debian In the standard kernel v4l2loopback-dkmsRocky, RHEL, Alma 8 and 9 kmod-usbipfrom ELRepokmod-v4l2loopbackfrom ELRepoRocky, RHEL, Alma 10 kmod-usbipfrom ELRepokmod-v4l2loopbackfrom RPM Fusion (free)SUSE Linux Enterprise kernel-default-extrav4l2loopback-kmp-defaultThe package install reports any module it cannot load and names the package that provides it.
-
Install the packages.
Ubuntu and Debian:
sudo apt-get install -y ./computle-enrolment_*.deb ./computle-host_*.debRocky Linux, RHEL and AlmaLinux:
sudo dnf -y install ./computle-enrolment-*.el8.*.rpm ./computle-host-*.el8.*.rpmSUSE Linux Enterprise:
sudo zypper -n install --allow-unsigned-rpm ./computle-enrolment-*.suse15.*.rpm ./computle-host-*.suse15.*.rpmFor a silent install on Ubuntu and Debian, set
DEBIAN_FRONTEND=noninteractive. -
Sign out and sign in again.
The session agent starts with the next GNOME session, the login screen included.
-
Enrol the host.
Install details
Section titled “Install details”| Item | Value |
|---|---|
| Program folder | /usr/lib/computle-host/, and /usr/bin/computle-session |
| Configuration | /etc/computle/ |
| Data | /var/lib/computle/ |
| Service account | computle-host, group computle |
| Version | /usr/lib/computle-host/VERSION |
Uninstall
Section titled “Uninstall”Remove computle-host with your package manager. On Ubuntu and Debian, purging the package also removes /var/lib/computle, /var/log/computle and the update settings.