macchina.io REMOTE Downloads

Device Agent and Client Tools

macchina.io REMOTE Device Agent (WebTunnelAgent)

The WebTunnelAgent program is used to connect a device to the macchina.io REMOTE.
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.

Please scroll down for Linux and other options, including Docker, command-line tools, etc.

macOS Big Sur/Monterey/Ventura and Gatekeeper

On macOS Big Sur, Monterey and Ventura, the WebTunnelAgent.gz 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 commands will download and extract the WebTunnelAgent executable:

curl https://macchina.io/downloads/RemoteManager/SDK/macos/bigsur/x86_64/WebTunnelAgent.gz | gunzip >WebTunnelAgent && chmod +x WebTunnelAgent 

If you have downloaded the file via a browser, you can use the following command to unquarantine it:

xattr -d com.apple.quarantine WebTunnelAgent 

Linux

The WebTunnelAgent executable must be extracted from the gzip-compressed file with:

gunzip WebTunnelAgent.gz 

Windows

The executable for Windows (WebTunnelAgent.exe) has been cryptographically signed by Applied Informatics Software Engineering GmbH.

Docker

A Docker image containing WebTunnelAgent is available on Docker Hub.

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 SDK from GitHub.

Downloads

Platform Toolchain Hash (SHA-256) Download
Microsoft Windows
Windows 7/8/10/11 (x64) Visual C++ 2019 873601448131c3c9648f9b09276f252052567e4ade7ae77a259f756349f1955c
Apple macOS
macOS Big Sur/Monterey/Ventura (x86_64) Clang/Apple LLVM 13.0 2c9fc7adb2c74a368d9f73f66698c0e48049aaee7501ffb80566d2d16b3d5492
GNU/Linux
Ubuntu 18.04 (x86_64) GCC 7.4.0, glibc 2.27 73bdec785f5a73dd8d3b68ab4f42d17d3a3886f154c2d21bca7797bd030a6a47
Ubuntu 20.04 (x86_64) GCC 9.3.0, glibc 2.31 cb1535ddacf0d09aa4cff01a92d9d4b9d501474a4740ea4c67a8f77080031fea
Debian 9.x/Stretch (x86_64) GCC 6.3.0, glibc 2.24 2561cf738e9466cd412ac2df51d064e23ab43760d4d0aef1a73ccc630c110f06
Debian 9.x/Stretch (i386) GCC 6.3.0, glibc 2.24 b90cf1354155d10ba37f05d4d510f68ac499ca6237d126e0b449539aca70f69d
Raspberry Pi OS/Debian 11.x/Bullseye (armv7l) GCC 10.2.1, glibc 2.31 d78c50862ea2b9e0484231a25a3062e9092dfa5048296ab3070bd5b6e405f7bd
Other Downloads
All macchina.io REMOTE device agent and command-line client tools for various platforms
(WebTunnelAgent, remote-client, remote-ssh, remote-scp, remote-sftp, remote-vnc, remote-rdp)

macchina.io REMOTE Helper

macchina.io REMOTE Helper is a native Windows desktop application that integrates with the macchina.io REMOTE web user interface in the browser and allows you to launch an external secure shell (SSH), secure file transfer (SFTP), or remote desktop (RDP or VNC) client directly from the macchina.io REMOTE web user interface.

macchina.io REMOTE Helper Status Window

macchina.io REMOTE Command-Line Client Tools

The macchina.io REMOTE SDK includes a number of command-line clients for starting SSH (Secure Shell), SCP (Secure Copy), SFTP (Secure File-Transfer Protocol), RDP (Remote Desktop Protocol) or VNC (Virtual Network Computing) sessions, or for tunneling arbitrary TCP ports between a client machine and the remote device.

  • remote-client : This executable can run on a client machine (Windows, macOS or Linux) to create a secure tunnel from the client machine to the remote device, via macchina.io REMOTE. It is required for tunneling TCP-based protocols not directly supported by macchina.io REMOTE, such Modbus/TCP, OPC-UA, or application-specific protocols.
  • remote-ssh : This is a variant of remote-client that first creates a tunnel connection from your local machine (Windows, macOS or Linux) to the remote device, then launches a SSH client using that tunnel connection.
  • remote-scp : This is a variant of remote-client that first creates a tunnel connection from your local machine (Windows, macOS or Linux) to the remote device, then launches a SCP (Secure/SSH File Copy) client using that tunnel connection.
  • remote-sftp : This is a variant of remote-client that first creates a tunnel connection from your local machine (Windows, macOS or Linux) to the remote device, then launches a SFTP (Secure/SSH File Transfer Protocol) client using that tunnel connection.
  • remote-vnc : This is a variant of remote-client that first creates a tunnel connection from your local machine (Windows, macOS or Linux) to a remote device running a VNC (Virtual Network Computing) server, then launches a VNC remote desktop client using that tunnel connection.
  • remote-rdp : This is a variant of remote-client that first creates a tunnel connection from your local machine (Windows, macOS) to a remote Windows device (which must have the remote desktop feature enabled), then launches a Microsoft Remote Desktop (RDP) client using that tunnel connection.

Client Executables

macchina.io REMOTE command-line client executables for Windows, Linux and macOS are available for download.

macchina.io REMOTE SDK Sources

The macchina.io REMOTE SDK (formerly my-devices.net SDK) is available from GitHub.

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, remote-client, remote-ssh, remote-scp, remote-sftp, remote-vnc and remote-rdp. 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

The macchina.io REMOTE SDK is open source, based on the POCO C++ Libraries and licensed under the Boost Software License 1.0.