macchina.io REMOTE Resources

Documentation, Source Code and Binaries/Images

Source Code and Binaries/Images

macchina.io REMOTE Server

The macchina.io REMOTE Server is the core of macchina.io REMOTE. It's a server application that runs on a Linux system.

Server Binaries and Docker Images

Binaries and Docker images are available to set up your own server instance.
Please contact us for more information.

SDK and Device Agent

The macchina.io REMOTE SDK is used to build the device agent, client tools, and other applications wanting to integrate agent or client features.

Device Agent Binaries

Pre-compiled binaries of the macchina.io REMOTE device agent for different platforms.

Device Agent Docker Image

Docker image for macchina.io REMOTE Device Agent on Docker Hub.

Device Agent Docker Sources

Sources for building the macchina.io REMOTE Device Agent Docker image.

SDK Source Code

Source code and instructions for macchina.io REMOTE Device Agent and client tools such as remote-client, remote-ssh, etc.

Homebrew Tap

A Homebrew tap containing a formula for building the device agent and client tools for macOS.

OpenWRT Packages

Meta data and instructions for building OpenWRT packages of the device agent for various OpenWRT targets with Docker.

Yocto Layer

Meta data and instructions for building Yocto packages of the device agent.

Client Tools

Client applications for starting SSH, VNC or RDP sessions from the command-line, or directly from the macchina.io REMOTE web user interface.

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) or remote desktop (RDP or VNC) client directly from the macchina.io REMOTE web user interface.

macchina.io REMOTE Command-Line Clients

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 the macchina.io REMOTE server. 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.

Gateway

The macchina.io REMOTE Gateway allows you to connect multiple devices or services to a macchina.io REMOTE server, without having to run the Device Agent on every device. It typically runs on a gateway device such as a Raspberry Pi or a router.

Gateway Source Code

Source code and instructions for macchina.io REMOTE Gateway.

Gateway Docker Image

Docker image containing the macchina.io REMOTE Gateway.

Gateway Docker Sources

Sources for building the macchina.io REMOTE Gateway Docker image.

Documentation

Getting Started

Get Started in 5 Minutes with a Free Account

A step-by-step guide to sign up and connect your first device to our public test server.

How to Provide Secure Remote Access to IoT Edge Devices via Web, SSH and Remote Desktop

An introductory article explaining why macchina.io REMOTE is needed and which problems it solves.

Video Tutorials (Playlist)

Various video tutorials for getting started and setting up the macchina.io REMOTE Device Agent on YouTube.

Server Administration

macchina.io REMOTE Server - Set-Up and Administration Guide

The complete guide for setting up and managing a macchina.io REMOTE server.
Read this if you want to set-up or manage your own macchina.io REMOTE server.
Please contact us for this document.

macchina.io REMOTE Server - Docker

Instructions and example configuration files for running the macchina.io REMOTE server as a Docker container (with MySQL/MariaDB).
There is also a PostgreSQL version of the repository.

macchina.io REMOTE Server - AWS

Instructions and example configuration files for running the macchina.io REMOTE server as a Docker container on AWS infrastructure.

APIs

Device REST API Documentation

Documentation of the REST API for device management.
Read this if you want to integrate macchina.io REMOTE with another application and need to read and modify device meta-data.

User and Authentication REST API Documentation

Documentation of the REST API for users and permissions management.
Read this if you want to integrate macchina.io REMOTE with another application and need to manage user accounts and their permissions.
Please contact us for this document.