Starlink Failover Configuration
The information in this page is updated in accordance with firmware version 07.04.5.
Introduction
This article provides a guide on how to use starlink connection and setup failover configuration using RUTX11. These configurations can be implemented on RUT, RUTX and TRB series devices.
- First you want to make sure that you have ADVANCED mode enabled. This will allow you to choose from a larger variety of settings.
Starlink is a satellite internet service provided by SpaceX. It aims to provide high-speed, low-latency internet access to users around the world, including in remote and underserved areas.
The Failover function allows you to backup your primary WAN connection in case it goes down. Cellular failover for satellite connections, is simply a process of adding a backup internet source, when the satellite connection fails. When a failure is detected, the cellular gateway or router automatically establishes a network connection and begins routing traffic through it. This ensures that there is no interruption in the Internet connection, and users can continue to access the Internet and transfer data without disruption.
This article provides an extensive configuration example with details on how to create a starlink connection with Teltonika router and how to configure Starlink failover.
Configuration Overview and Prerequisites
Before we begin, let's overview the configuration that we are attempting to achieve and the prerequisites that will make it possible. Prerequisites:
- One RUTxxx router of any type with sim
- Atleast one end device to configure the router
- Putty in your end device Putty Download
- Starlink dish, Starlink Ethernet adapter
- Starlink mobile phone application Starlink app
Here is the topology of the Starlink connection with the Teltonika router :In this configuration, your initial step should involve connecting the Starlink dish to the Starlink router, followed by linking it to an Ethernet adapter, and ultimately connecting it to the WAN port of RUTX11.Once that's done, use an Ethernet cable to establish a connection between the RUTX11 router and your PC via its LAN port. Alternatively, you can opt for a wireless connection if preferred.Before moving forward, double-check that both devices are securely connected and powered on.
Note: Additionally, before setting up the topology, make sure to adjust the LAN IP to a separate subnet to prevent any IP conflicts. Change LAN IP
Starlink Configuration
The Starlink antenna was positioned on the rooftop to ensure an unobstructed line of sight, and it was allowed to automatically orient itself. The Starlink app on the Android phone was utilized to configure the Starlink settings following the instructions provided in its initial setup guide. The WAN port of the RUTX11 router was connected to the Starlink modem using the Starlink Ethernet adapter. Additionally, both the laptops were directly connected to the router's LAN ports.
- Starlink application using the setup guide:
Router Configuration
- WebUI Login:
Access RUTOS through your laptop or computer that is connected to the router. Launch a web browser on your connected device, and in the address bar, type in the router's default IP address, which is typically 192.168.1.1. Upon doing so, you will receive a prompt to provide a username and password. Unless you've previously modified them, the default credentials are:
Username: admin
Password: (located on the device)
After logging in, proceed to update the LAN IP by navigating to Network → interfaces. Click on the edit icon for the LAN interface. Modify the IP address and lease time as needed. After making these changes, save and apply. The WebUI will refresh with the new IP address, allowing you to process with the configuration steps.
- Failover setup:
Firstly, In the WebUI, navigate to Network → Firewall. In this section, you should observe two entries: " WAN," which represents your starlink connection, and "mob1s1a1", which corresponds to your Teltonika Networks router. Both of these entries should be indicated as online. Next arrange the connection order by simply dragging and dropping "WAN" into position 1 and "mob1s1a1" into position 2. This sequence determines the order of priority for the connections.
- Failover rules:
In the same section, configure the failover rules for both connections as follows:
To begin, click on the pencil icon associated with your WAN connection and establish the rule that will activate the failover mechanism. You have the flexibility to define this rule according to your preferences. If you're uncertain about how to proceed, you can opt to set up the default rule displayed in the provided screenshot.
Note: Depending on the reliability of your Starlink connection, you have the flexibility to adjust your interval setting for your WAN connection to a value between 3 and 10. We recommend conducting tests to determine the optimal interval that offers the highest stability for your specific location.
Finally, replicate the same process for your mob1s1a1 connection.
Testing Results
The below screenshots provide speed test when the device was connected to starlink.
- Starlink Speed test:
- Testing on CLI:
The below screenshots shows that Starlink route is the most preferred while the 4g is the backup route to internet. Try some of the below commands on CLI and verify.
Command: ip route
Command: traceroute google.com
- Failover logs:
The below screenshots are the testing results when the primary WAN stopped and failover to 4G took place, and then failback to the primary WAN after the interface was enabled.
WAN interface stopped:
Ping loss:
Failover to 4G:
Failback when the WAN interface was enabled:
Troubleshooting
Slow speed:
Navigate to Network → Firewall → General settings and enable/disable Software flow offloading option, depending on its default setting;
MTU settings:
Navigate to Network → Interfaces → General. Edit WAN interface settings, switch to Advanced settings tab. In the Override MTU field try the following values: 1420 1460 1472
opkg instaqll iperf3 for a proper speed/bandwidth test
iperf3 command: iperf < -s|-c host> <options> It is a tool to measure the bandwidth and the quality of a network link. It is additional package. First it should be installed on device: opkg install iperf3 Syntax examples for server: iperf3 -s -p 5000; for client: iperf3 -c IPADDRESS -p 5000 -t 10
For failover stability:
Change (increase / decrease) ping check packets, failover check intervals
Compatability checks:
Ensure that the correct branded "SpaceX" ethernet adapter is used to connect between the router's ethernet port and the starlink modem
Subnet issues:
As starlink modem is on the same management ip 192.168.1.0/24:
Under "Protocol" you need select "DHCP" and leave all other config settings for WAN at the defaults. The IP address is assigned by Starlink and will appear on the main "Interfaces" page when you connect.
Please check the IP address assigned to your WAN interface after connecting it to Starlink. Then, ensure that your LAN is on a different network than your WAN interface. For example, if your WAN is on the 192.168.1.0/24 network, and your LAN is also on the 192.168.1.0/24 network, then change the LAN network to something else, like 192.168.10.0/24. To do so, edit your LAN interface and change the IPv4 address to 192.168.10.1 (scroll down and change the DHCP IP start and end settings to 192.168.10.100 and 192.168.10.249 too).
If you want Starlink to be your primary connection, make sure the WAN interface is at the top of the list in Network → Interfaces → General.
If you are using failover, move your WAN interface to the top in Network → Failover as well. In your case, the order from top to bottom should be WAN → mob1s1a1 → mob1s2a1.
Capture output of the below commands from the teltonika router
- Traceroute 8.8.8.8,
- mwan3 status,
- ifconfig,
- ip route,
- arp,
- logread | grep mwan3
In case you still cannot access the internet via Starlink, please replicate the issue and generate a troubleshoot file. To do this, connect to Starlink, wait a few minutes, and try accessing the internet. Next, download a troubleshoot file from System → Administration → Troubleshoot and raise VIP query.
Low signal:
The signal strength can be gauged from the starlink app itself at that particular location,
