Resources

Documentation, Source Code and Binaries/Images

macchina.io REMOTE

macchina.io REMOTE

Secure remote access via web (HTTP), shell (SSH), remote desktop (RDP, VNC) and other protocols to IoT and edge devices behind routers or firewalls.

Source Code and Binaries/Images

Remote Manager Server

The Remote Manager 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.

macchina.io EDGE

macchina.io EDGE

A powerful, flexible, modular and scaleable C++ and JavaScript SDK for edge devices, IoT gateways and connected embedded systems.

Source Code and Images

macchina.io EDGE Open Source (GPL)

GPLv3-licensed source code for macchina.io EDGE Open Source release.

macchina.io EDGE Docker Images

Docker images for macchina.io EDGE (Open Source)

macchina.io EDGE Docker Sources

Sources for building a macchina.io EDGE (Open Source) Docker image.

Documentation

macchina.io EDGE Documentation

User guides, tutorials and reference documentation.

Building an IoT Edge Application with macchina.io and Docker

An article showing how to build an edge computing application for a Raspberry Pi with macchina.io EDGE, InfluxDB, Portainer and Docker.