Get Started in 5 Minutes with a Free Account

Set up secure remote access to your connected devices via web, apps, shell (SSH) or remote desktop (VNC or RDP). Don't worry about insecure port forwarding, scarce public IPv4 addresses, or complex and inflexible VPNs.

Getting started with macchina.io Remote Manager is done in just a few easy steps.

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. Chose your password and enter it 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.

Need support getting started or connecting your device? We're ready to help!

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 (and you won't be able to sign in) 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.
You will connect your first device next.

Connect a Device

In order to connect a device to macchina.io Remote Manager, a program (the Remote Manager Device Agent, also known as WebTunnelAgent) 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, get the Docker image, or get the Remote Manager SDK source code. As a first step, we recommend running a pre-built WebTunnelAgent or the container on your desktop system or a Raspberry Pi.

The Docker image comes with a generic configuration file that allows the essential settings to be configured via environment variables. The steps for configuring and running the container are different than the ones shown here for the standalone executable. See the README for more information.

The macchina.io EDGE already includes the agent, so if you're using it, you can skip the this and the following steps and enable the agent in your macchina.io EDGE configuration file.

Dashboard
Generate Configuration File

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.

In Remote Manager, go to the Account page by clicking the User icon or email address in the Devices page, then click the Generate configuration file link at the top. 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 Enable HTTP Server Port field. You can enable additional ports (such as 22 for SSH) as well.

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

Start Device Agent

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

If you cannot copy the configuration file to the same directory the executable is in, you can use the --config option to pass the location of the configuration file to WebTunnelAgent: WebTunnelAgent --config=/path/to/WebTunnelAgent.properties

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.

See the documentation for details on installing, configuring and running WebTunnelAgent.

WebTunnelAgent
Device is connected

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 macchina.io EDGE

macchina.io EDGE 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 ID from the Remote Manager Account page. Restart macchina and macchina.io EDGE 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 =

Questions? We're ready to help!

Please complete the form below to send us a message.