Skip to content

ResIOT X4

Supported models

As of April 2023, Merlin targets all the ResIOT -X4-ETH- and -X4-LTE- products family.

Notes

Access your gateway via SSH, by default the IP address is 192.168.2.1

Default credentials, when prompted, are:
username: root
password: resiot1234

OpenVPN

The OpenVPN service is preinstalled on the gateway.

If you want to update from the installed version 2.3.8 to version 2.4.12 to support tls-crypt, make sure your gateway is connected to the internet and run the following:

curl -s update.resiot.io/extra/openvpn/resiot_gw_x2_x4_x7_update_openvpn_to_2412.sh | bash

After doing that, certificates can be handled by ResIOT or manually installed in the /etc/openvpn folder.

Keep in mind openvpn expects certificates with a .conf extension and that the resiot.conf is a reserved name and should not be used for manual certificates.

Installation

All gateways come with ResIOT Merlin preinstalled.

Update

Via the Merlin web interface you can update your software to the latest version. If the gateway is connected to a ResIOT server, updates can be scheduled or triggered from the platform itself.

Running

ResIOT™ Merlin is installed by default. Refer to the official ResIOT website for instructions.

Merlin Reset

The newest Merlin versions (v33+) allows you to force reset all the Merlin settings to their defaults with an administrator, pre-registered user with password resiot1234.

In order to trigger the reset routine, create a reset file on a FAT32 formatted USB key and plug the key into your gateway. The reset procedure will then reset Merlin to its defaults settings. The operation could take up to two minutes.

In order to avoid reboot and reset loops, once complete, the reset procedure will rename your reset file to resiot.

The reset routine will:

  1. Remove previous ResIOT OpenVPN certificates
  2. Reset Cellular data if present
  3. Reset all existing user passwords and set the Administrator's password to resiot1234
  4. Reset the assigned gateway EUI
  5. Reset all grpc and secuity token settings
  6. Reset the network connection to static IP address: 192.168.2.1
  7. Restart the gateway

Other Software

Python

All ResIOT gateways come with Python 2.7.11 preinstalled.

If you wish to upgrade to Python 3.5.3 you can do so by running the following:

curl -s update.resiot.io/extra/python3/resiot_gw_x2_x4_x7_update_python_to_353.sh | bash

This will install the newer version!