Get Started in 5 Minutes with a Free Account

Getting started with macchina.io Remote Manager is done in a few easy steps and takes less than five minutes.

A free account allows you to connect up to five devices. Perfect for testing or personal use. Some restrictions apply.

Sign Up

Sign Up

Navigate to our Sign Up page and register with your first and last names and your email address. Enter your chosen password twice to confirm and click the Sign up button.

You will receive an email containing a link to confirm your email address and activate your new account.

Activate Your Account and Sign In

Check your email for the "Activate your new macchina.io Remote Manager account at my-devices.net" message.
Open the activation link in the email to confirm your email address.

This will confirm your email address and activate your account. Note that your account will remain locked until you have confirmed your email address.

Then sign in with your registered email address (username) and password.

Activate
Device List

Welcome to the Devices Page

The Remote Manager Devices page is the main point of interaction with the Remote Manager. It will show a list of devices available to you.

Right now the list is empty as you haven't connected any devices yet.

Get Your Domain UUID

After activating your account and logging in, click the User icon or your email address in the top right to open the Account page. Find your Domain UUID in the User Properties section.

You will need the Domain UUID to configure the Remote Manager Agent for your device. The Domain UUID will associate your device with your user account.

You can also generate a configuration file for the Remote Manager Device Agent (WebTunnelAgent) right on that page.

Account
Dashboard

Install Device Agent

In order to connect a device to macchina.io Remote Manager, a program (Remote Manager Device Agent) needs to be installed on your device. For initial testing, the agent can also be installed on a Windows, Linux or macOS machine in the same network as the device.

Download one of the pre-built agent executables for your platform, or get the Remote Manager SDK source code. As a first step, we recommend running a pre-built Agent (WebTunnelAgent) on your desktop system or a Raspberry Pi.

Note: The macchina.io IoT Edge Device SDK already includes the agent, so if you're using it, you can skip this step and enable the agent in the IoT Edge Device SDK.

Configure Device Agent

The Device Agent (WebTunnelAgent) needs a configuration file named WebTunnelAgent.properties to work. The easiest way to obtain the configuration file is to generate and download it from the Remote Manager Account page.

Go to the Account page by clicking the User icon or email address in the Devices page, then find the Generate Configuration File section. Enter the IP address of your target device (use 127.0.0.1 if the agent is running on your target device), as well as the ports you want to forward. The port number of your web server should be entered in the Device HTTP Server Port field. You can add additional ports (such as 22 for SSH) in the Forwarded TCP Ports field.

When ready, click Download Configuration File to download your file.

Generate Configuration File
WebTunnelAgent

Start Device Agent

Copy the agent configuration file downloaded in the previous step to the same directory as the agent executable. Make sure that the configuration file is named WebTunnelAgent.properties. The start the agent, either by double-clicking the WebTunnelAgent executable on Windows, or by running it from a shell.

WebTunnelAgent will connect to the Remote Manager server, and you should see the device appear on the Devices page after refreshing the Devices page as "Unnamed Device". Click the device name to display the web user interface of your device. Or click on the Settings button to see and edit device properties.

Done!

Congratulations! You have just connected your first device to the macchina.io Remote Manager. You can now securely access your device from everywhere with an internet connection via web browser, SSH or VNC.

You can now connect additional devices, explore the Remote Manager SDK or the REST API.

Or read the FAQ to learn more, including how to connect via SSH or remote desktop (VNC).

Device is connected

Enabling Remote Manager in the IoT Edge Device SDK

The macchina.io IoT Edge Device SDK already contains the Remote Manager agent, so it only must be enabled in the global configuration file.

Open the macchina.properties in a text editor of your choice. Find the webtunnel.enable property and change its value to true. Then find the webtunnel.domain property and set it to your Domain UUID from the Remote Manager Account page. Restart macchina and the macchina.io IoT Edge SDK web interface will be accessible through Remote Manager.

#
# WebTunnel
#
webtunnel.enable = true
webtunnel.reflectorURI = https://reflector.my-devices.net
webtunnel.deviceName = ${system.nodeName}
webtunnel.domain = c60a3001-05ae-4dd6-a4fa-2ab692a1123f
webtunnel.deviceId = 3100ef24-e395-4726-9951-${system.nodeId}
webtunnel.username = ${webtunnel.deviceId}@${webtunnel.domain}
webtunnel.password =