Skip to content

Kerlink IBTS Guide

Supported models

As of August 2019, this version targets the Kerlink IBTS listed at the official Kerlink website.

Download

Frequency plan Download Link
EU 863-870 Download
US 902-928 Download
AU 915-928 Download

Installation

Access your gateway via SSH using port 22 and the gateway's IP address obtained from the DHCP server. Default credentials, when prompted, are:
Username: root password: pdmk-XXXXXX where XXXXXX are hexadecimal units of your iBTS hostname. More information here.

Remove any existing packet forwarder installed over your gateway. If you wish, you can simply remove the scripts launching them on startup time. Simply move the files away from your /etc/rcU.d/ folder.

Configure your gateway in order for it to gain internet access and finally run the following (using the correct region file):

mkdir /user/resiot
cd /user/resiot
wget https://update.resiot.io/bsclient/resiot-basestation-client-kibts-EU_863_870.zip
unzip resiot-basestation-client-kibts-EU_863_870.zip
chmod +x install.sh
./install.sh

That's it!

Customizing the firewall

The IBTS comes with a built-in firewall. The Merlin script will install some premade firewall rules to make sure everything works correctly between Merlin and ResIOT. If you have a custom ResIOT build running over non-default ports, you might need to edit the default rules that came with the script. To do so, edit the file /etc/firewall.d/resiot.rules and change the default ports with the ones your setup is using instead. Here are the default ports in your file and what they refer to:

[OUT] 7677 udp: LoRa communication
[OUT] 8095 tcp: default ResIOT gRPC connection
[OUT] 1883 tcp: default MQTT broker connection
[IN] 50056 tpc: default Merlin webserver
[IN] 50076 tpc: default Merlin Update webserver

Removal

Shall you want to uninstall Merlin, just run the following commands:

rm /etc/rcU.d/*resiot*
rm -r /user/resiot
rm /etc/firewall.d/resiot.rules
reboot

Running

Your ResIOT™ BaseStation Gateway Client is now installed. Refer to the official ResIOT website for instructions.