This guide is text-only. The screenshots were removed because the pairing screen has changed since they were taken. The steps below were rewritten against the current source, including the Pair stage the earlier version omitted, but have not been walked through on a device.
Mobile Server Documentation
Background
This is documentation on how to use the Febris Mobile Server. You get it from the downloads section of this site, or from the Software Repository page of the node you connect to, which links to the same place. It is published, at v0.2.0, as an .apk you sideload and a .zip a node ingests.
Not every aspect of the Febris mobile server is currently online. This will change in future releases.
If you violate your hardware's EULA by installing the Febris Mobile Suite, Febris takes no responsibility.
Requirements
Needed Items:
- Android based Tablet (Android 10 [API 29] is optimal and minimum required OS, a phone can work but its size can make operation a challenge.)
- Android based headset
- OTG cable and second USB cable (optional but sometimes required for headsets that have removed the normal installer)
If your Android device does not support the installation of software outside of their tightly controlled marketplace, you may not be able to install the Febris software and we apologize for the inconvenience but there is nothing we can do about that situation.
Registering a device
Registration is what lets your node send modules to this device and collect training data back from it. It runs in one direction: your node creates the credential, and you carry it to the device. Nothing is read off the device first.
- On your node's portal, open Hardware and create the device.
- The node generates a credential and displays it once. Copy it before leaving the page. It is stored only as a fingerprint, so nobody can look it up later, not even an administrator. If it is lost, use Regenerate on the Hardware list to issue a new one; the old credential stops working immediately and the device will not connect again until the new value is entered on it.
- On the mobile server, open the configuration page and enter the credential in Hardware License. It is long, so pasting beats typing.
- Press Update Settings. The credential is kept in the device's secure storage and used from then on.
The order matters. The mobile server cannot reach your node until it has been given a credential, so create the device on the node first.
Setting up your device
The mobile server authenticates to your node with its hardware licence, not with a username and password. The user sign-in fields on the configuration screen are optional and are not needed for mobile server operations, so leave them blank unless your deployment specifically asks for them.
If the Hardware License field is empty, this device has not been registered yet, and the mobile server will say so rather than attempting to sign in. That is the expected state on a fresh install.
The developer option is an opt-in that points this client at a different node, supplied through the FEBRIS_DEVELOPER_API_URL environment variable. It ships with no address configured and there is no Febris operated account behind it, so leaving it off is correct unless you have been given an address to use.
If you are not a developer then the proper URL needs to be set up. Your IT administrator will have set up a private URL for your Febris operations. Domain Prefix, Domain and Domain Port vary by deployment, so ask your IT Administrator if you do not know them, and leave any of those three blank if they do not apply. Domain Path is the exception. It must be api, because that segment is fixed by the node's API rather than chosen per deployment, so blanking it stops the client reaching the node at all.
Pressing update settings saves your new configuration.
Adding a headset
Register one headset at a time. The flow has two stages. Pair with the headset, then install the Companion onto it.
1. Get the headset in front of the server. Start the Companion on the headset and leave it running. It joins the Mobile Server's WiFi Direct group on its own, and that is what puts it in front of the server. There is no Scan button and no Bluetooth discovery. On the first headset, where no Companion is installed yet, do the install in stage 2 first and come back here.
Then open Configuration, press Pair New Device, and press Pair to open the pairing list. It shows devices that are *connected but not yet paired*. A Companion appears there as soon as it joins the WiFi Direct group, which happens before any pairing exists, so seeing it listed does not mean it is paired.
Pairing then shows a six digit code on both devices. Confirm the codes match before accepting. If the list is empty, no Companion has joined the group yet, so the problem is at the headset rather than on this screen.
Once paired, the device is added to your device list.
2. Install the Companion. There is one route and it needs a cable. Put both devices in developer mode first. Connect the OTG cable from the machine running the Mobile Server to the headset. Approve every trust prompt that appears. Push and Install and Install then become available at the top of the pairing page.
Press Push and Install first. It uploads the Companion's apk variants and installs them. If the push fails partway through, try Install on its own before repeating the push. The file it needs is probably already on the headset, and pushing again is usually wasted time.
There used to be a second route over Bluetooth, using an upload button beside each device in the list. That button was removed on 2026-09-01. It pushed a file to a device's Bluetooth address, and the Companion has no Bluetooth receive path, so nothing arrived.
Removing a headset
A headset can be removed by pressing the trashcan icon on the left side of the device on the list.
Api connection issues
The R3 Certification lead to issues with some systems. Previously working applications stopped working in September of 2022. If you are facing it and cannot get a new certificate. There are a few easy steps you can take for a temporary workaround.
Settings > Security > Encryption & Credentials > Trusted Credentials > Digital Signature Trust Co. (toggle)