This is a fork of the default BELABOX UI (belaUI), that ported the code to Typescript and ESM (ECMAScript Modules).
The current source includes the upstream catch-up through official belaUI 6659308: BCRPT relay probing and low-MTU handling, guarded autostart, slider locks and statistics layout updates. See upstream synchronization for the commit mapping, runtime requirements, preserved local-subnet behavior and device qualification checklist.
See branches and CI/CD for the main development branch, dedicated upstream mirror, validation artifacts and tag-based releases.
Warning
I will likely remove the integration of moblink in one of the next releases, since datagutt/moblink-rust implemented a service that makes the integration mostly obsolete. I would recommend disabling the moblink relay in this fork (setup.json) and installing the service instead: Install moblink serivce.
This fork integrates datagutt/moblink-rust in the relay mode, meaning it allows Moblin apps in the network of the encoder (BELABOX) to use the network interfaces of the BELABOX including modems as Moblink relays for SRTLA from Moblin. It does not yet support using Moblinks or Moblin apps to be used as SRTLA relays for the BELABOX!
The implementation defaults to the password 1234 and uses auto-discovery to connect to "Moblin Streamers" in the network. You can change the password in the setup.json via SSH. As of now (2025-03-30) there is no UI for Moblink in this belaUI fork.
The installer downloads the latest published release. To deploy the current checkout, build it and follow the local deployment steps below.
Note: Replacing the original UI directly may cause issues. When your BELABOX is updated, it can revert the UI. Ensure you monitor updates and reapply the override after updates.
- Enable SSH for the default user (
user) on your existing belaUI - Connect to the BELABOX via SSH (use Putty on Windows, JuiceSSH on Android)
- Then run:
wget -qO- https://raw.githubusercontent.com/pjeweb/belaUI/main/install.sh | bash - To get back to the default belaUI, you can then run
sudo bash /opt/belaUI/reset-to-default.shthrough SSH.
Development and CI use Bun 1.2.3, pinned in package.json and the workflows.
To install the dependencies, you can use the following command:
bun install --frozen-lockfileRun typechecks, device-free regression tests and formatting/lint checks with bun run check. This checks the UI application and Vite configuration directly rather than only the empty project-reference config.
Local development is not really supported. Ideally you have a BELABOX to test changes. Build for production (see below) and deploy with the deploy script (see above).
You can run the UI locally with the following command:
bun run dev:uiTo run the server locally, you can use the following command:
bun run dev:serverTo build the UI for production, you can use the following command:
bun run buildIt is recommended to create an SSH key pair and install public key on the BELABOX, since the deployment script uses multiple ssh calls that would require you to type the password each time.
You can follow this tutorial to generate the key pair: https://www.digitalocean.com/community/tutorials/how-to-set-up-ssh-keys-on-ubuntu-22-04
- Enable SSH for the default user (
user) and connect via SSH - Enable SSH on boot to make things easier (
sudo systemctl enable ssh) - Use
sudo suto get root privileges and add to the authorized keys for the root user. Add the generated public ssh key to/root/.ssh/authorized_keysor create the file if it does not exist yet:- Create the directory if it does not exist:
mkdir -p /root/.ssh - Append your ssh key to the
authorized_keysfile (replacessh-...with your generated public key):echo "ssh-..." >> /root/.ssh/authorized_keys).
- Create the directory if it does not exist:
- Install rsync (
sudo apt install rsync) - Install an editor (e.g.
sudo apt install nano) - Edit the
/opt/belaUI/setup.jsonand add the following line to your existing setup to enable the moblink relay:Make sure to add commas to the end of the lines before and after the new line, if necessary."moblink_relay_enabled": true
- Install the generated private ssh key on the host (e.g.
~/.ssh/id_rsaand~/.ssh/id_rsa.pub) - It might be necessary or recommended to install a newer version of rsync from brew or similar (not tested if necessary)
- Run the deployment script by specifying the SSH target as an argument. For example, to deploy as root to a host at 192.168.100.100, run:
./deploy-to-local.sh root@192.168.100.100To reset the BELABOX to the default belaUI, you can run the reset script from the host (./reset-local.sh).
This project is licensed under the GPL-3.0 License. See the LICENSE file for more details.