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.
On Linux and macOS, don't forget to uncompress (gunzip) the
the downloaded file and make it executable with the command:
gunzip WebTunnelAgent.gz && chmod +x WebTunnelAgent
The executable for Windows (WebTunnelAgent.exe) has been cryptographically signed by Applied Informatics Software Engineering GmbH.
If there is no executable for your platform, please use the macchina.io Remote Manager SDK available from GitHub build it yourself.
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