Remote Manager Device Agent (WebTunnelAgent)
The WebTunnelAgent program is used to connect a device to the macchina.io Remote Manager.
WebTunnelAgent can run on directly the device, or on a separate computer or network device (Windows, macOS, Raspberry Pi, OpenWRT router, etc) in the same network.
Executables for various platforms are available for download below.
macOS Catalina and Gatekeeper
On macOS Catalina, the WebTunnelAgent.tgz file should be downloaded via the Terminal (shell) using the
curl command. If the file is downloaded with a web browser, the executable won't run due to security
restrictions (Gatekeeper). The following command will download and extract the WebTunnelAgent executable:
curl https://macchina.io/downloads/RemoteManager/SDK/macos/10.14/x86_64/WebTunnelAgent.tgz | tar xz
The WebTunnelAgent executable must be extracted from the gzip-compressed tar archive with:
tar xfz WebTunnelAgent.tgz
The executable for Windows (WebTunnelAgent.exe) has been cryptographically signed by Applied Informatics Software Engineering GmbH.
Build from Source
If there is no executable for your platform, or if you want to build it yourself, please get the macchina.io Remote Manager SDK from GitHub.
Remote Manager Helper
Remote Manager Helper is a native Windows desktop application that integrates with the Remote Manager web user interface in the browser and allows you to launch an external secure shell (SSH) or remote desktop (RDP or VNC) client directly from the Remote Manager web user interface. Remote Manager Helper will work with the following clients:
- The OpenSSH client integrated in Windows 10 and Windows Server 2019.
- PuTTY, as an alternative SSH client.
- The Microsoft Remote Desktop client integrated in Windows (mstsc.exe).
- The RealVNC® VNC Viewer.
To install, download the RemoteManagerHelper.exe executable and run it. You will be prompted to install the application, which includes registering a special URI scheme (macchina-rm+wss), which will be handled by Remote Manager Helper. Remote Manager Helper will also look for the above mentioned SSH, RDP and VNC client applications. Once installed, you can click the SSH, VNC and RDP links in the Remote Manager web user interface. This will launch the helper, which will set up a secure tunnel between your PC and the remote device, then launch the configured helper application.
Remote Manager Helper is currently available for Windows Desktop (Win32, Intel 64-bit) only. A macOS version will be available in the future.
macchina.io Remote Manager SDK Sources
The SDK can be built for various platforms, including Linux (desktop/server or embedded), Windows, and macOS. CMake is required to build the SDK and the included programs WebTunnelAgent, WebTunnelClient, WebTunnelSSH, WebTunnelVNC and WebTunnelRDP. Please see the included README.md for instructions how to build.
Easy Install (Linux and macOS)
The easiest way to install the above mentioned executables on a Linux or macOS system from source is to download and run the installer script with the following command:
curl https://raw.githubusercontent.com/my-devices/agent-installer/master/install.sh | bash
The script should work on most Debian and RedHat-based Linux distributions including Ubuntu and Raspbian. On macOS, Homebrew must be installed.
The script will install all required dependencies, then get the sources from GitHub and run the steps necessary
to build and install the binaries in /usr/local/bin/.
If you do not want to or cannot run the installer script, please see the instructions in README.md