A Belabox bonds your modems into one SRTLA stream. This guide connects it to an IRLServer relay. Then it sets up remote control, so you can reach the Belabox while it is in your backpack.
Step 1: create your SRTLA endpoint
In the IRLServer dashboard, create an SRTLA endpoint. Open it, go to the Connect tab, and pick Belabox. The tab shows three values:
- Server URL, such as
srt.sfj.irl.ac - Stream Port:
5000 - Stream ID
The server name holds a region. Use the region nearest to where you stream.
New to the protocol? Start with SRTLA bonding explained, then come back.
Step 2: enter the relay in belaUI
belaUI is the Belabox's web interface. On a phone or laptop on the same network as the Belabox, open http://belabox.local. Then:
- Open Relay server settings.
- Set Relay server to Manual configuration.
- Enter the server URL in SRTLA receiver address.
- Enter
5000in SRTLA receiver port. - Enter the stream id in SRT streamid.
The Belabox now knows where to send your bonded stream.
Step 3: add your modems and go live
Insert your modems and check that each one connects. Start the stream. SRTLA spreads the stream across every connection, and the relay joins it back together on the other end.
Give it more than two connections if you can
Two SIMs is the minimum that earns the word bonded. A third connection gives SRTLA somewhere to go when you switch towers, which is exactly when two SIM rigs stutter.
Control the Belabox from your phone
belaUI only works on the same network as the Belabox. In the field your connections are cellular modems that nothing outside can reach. So once the Belabox is in your backpack, belaUI is out of reach.
IRLControl fixes that. It shows the Belabox in your browser and lets you control it from anywhere. You can start and stop the stream, change the maximum bitrate, turn single connections on or off, and change modem and WiFi settings. You can also share the rig with your team.
IRLControl reaches the Belabox in one of two ways:
- Belabox's own remote. This is free for everyone. IRLControl connects with the Belabox's remote key.
- The IRLControl remote. This is included with an IRLServer relay subscription. The Belabox connects straight to IRLControl, and belaUI lists your IRLServer endpoints for you to pick from. Setup takes one command over SSH.
You pick one in step 4 and can switch later.
Step 4: create a Belabox rig in IRLControl
- Sign in at irlcontrol.com.
- Under Create a new rig, enter a name and set App Type to BELABOX.
- Select Create Rig.
A name is enough. The BELABOX remote key field is optional, so you can create the rig before you have the key.
Then open the rig's Settings page. Under Connect your BELABOX, pick how IRLControl reaches the Belabox:
- Paste the remote key. This is free and uses Belabox's own remote. Copy the key as shown below, paste it, and select Save.
- The IRLControl remote. With a relay subscription, select Set up the IRLControl remote and follow step 5. Without one, the card links to the relay plans.
To copy the remote key:
- Open
http://belabox.localon the same network as the Belabox. - Open System and find BELABOX cloud remote key.
- Tap Show and copy the key.
If the field is empty, set up Belabox's own remote for the Belabox first. Then copy the key it saved. If you have the key at hand when you create the rig, you can paste it in BELABOX remote key right away.
IRLControl stores the key encrypted and never shows it again. Once a key is saved, the Remote key card on the Settings page shows whether the key works and whether the Belabox is online. If the key is not accepted, copy it again from belaUI and save it.
That is all you need for Belabox's own remote.
Step 5 (optional): set up the IRLControl remote
With a relay subscription, the rig's Settings page offers Set up the IRLControl remote. Select it to open the setup wizard. Read the notice at the top before you start.
Before you install
The IRLControl remote is our own service. Help with it comes from us, not
from the Belabox project, which does not run or approve it. The install
changes the Belabox's system. It adds our agent and a service override that
sends belaUI's remote connection to IRLControl instead of Belabox's own
remote, and it gives belaUI a new remote key. belaUI's own files stay as they
are, but the Belabox project does not support modified systems. You install
it at your own risk. To undo it, use Switch back to the official remote
or Uninstall on the rig's Settings page while the Belabox is online. Both
give belaUI its previous remote key back. Without internet, run
sudo bb-agent uninstall on the Belabox over SSH.
The wizard has three steps:
- Turn on SSH on the Belabox. Open
http://belabox.local. In Advanced / Developer, tap Start SSH server and note the password it shows. - Connect to it from your computer. Open a terminal (Terminal on Mac or Linux, PowerShell on Windows). Run
ssh user@belabox.localand enter that password. - Paste the install command. In the wizard, select Show the install command. Copy the command and paste it into the SSH session.
The install command pairs this Belabox with your rig. It works once and for 15 minutes. If it expires, select Make a new command.
You do not need to refresh the wizard. It updates by itself and shows Connected when the Belabox signs in. Select Done.
Now pick your endpoint in belaUI. Open Relay server settings. Relay server lists the IRLServer servers. Pick the one nearest to where you stream. Relay server account lists your own SRTLA endpoints. Pick the one you want to stream to. You no longer type the address and stream id by hand.
Switch back or uninstall
On the rig's Settings page, the IRLControl remote card has two ways back. Both need the Belabox to be online.
- Switch back to the official remote moves the Belabox to Belabox's own remote right away. A running stream keeps going. Our agent stays installed but idle, so you can come back later with a new install command. You can paste an official remote key. If you leave the field empty, IRLControl uses the key it has saved, or else the key the Belabox had before.
- Uninstall removes our agent and moves the Belabox back to the official remote. belaUI restarts once no stream is running.
If the Belabox is offline or cannot reach IRLControl, connect to it over SSH with ssh user@belabox.local and run:
sudo bb-agent uninstall
The command needs no internet. It gives the Belabox its previous remote key back. Then open BELABOX offline or cannot reach us? on the Settings page and select Remove the pairing.
Comparing remote options? See Belabox Cloud vs IRLServer.
Once the Belabox is bonded and you can reach it from your phone, pair it with drop protection. Your own OBS pulls the relay as a source, and NOALBS switches scenes so a rough feed never ends the broadcast.
Not affiliated with or endorsed by Belabox. Belabox is a trademark of its respective owner.
FAQ
- Can I change settings on the Belabox while I am live?
- Yes. From IRLControl you can start and stop the stream, change the maximum bitrate, turn single connections on or off, and change modem and WiFi settings. You do not have to stop and open the backpack.
- Do I need remote control if the Belabox already has a local web interface?
- belaUI works when you are on the same network as the Belabox. In the field your connections are cellular modems that nothing outside can reach, so remote control is what lets you (and your team) reach the Belabox from anywhere.
- Do I need an IRLServer relay to use IRLControl with a Belabox?
- No. IRLControl works with Belabox's own remote for everyone. The IRLControl remote is the part that comes with a relay subscription.
- What happens to the IRLControl remote if my relay subscription ends?
- It keeps working for a grace period, and the rig's page shows the end date. After that the Belabox still connects and shows its status, but you can no longer control it from IRLControl and belaUI gets no relay list. Switching back and uninstalling keep working.
- Which port do I use?
- 5000, the SRTLA port. The SRT port 4001 is for encoders that send plain SRT, which gives up the bonding a Belabox is for.