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

Navigate to our Sign Up page and register with your name and 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. Please follow the link and enter your username and password to activate your account and log in.

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 and sign in with your username and password registered in the previous step.

This will confirm your email address, activate your account and sign you in. Note that your account will remain locked until you have signed in once using the activation link.

Welcome to the Dashboard

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

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 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 Dashboard, 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.

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 Dashboard after refreshing the Dashboard page as "Unnamed Device". Click the device name to display the web user interface of your device.

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).


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 =