Managing Multiple Hubs

Multiple Hubs can be added to user’s smartphone together. For example, “main residence” and “vacation house”.

Connect to a New Liberty IoT Hub

The user trying to connect to a new Hub will automatically become the Hub super user (administrator or simply admin).

First time admin is required to be able to physically access the Hub. With a smartphone App running in the same local network (e.g. wifi) as the Hub.

First turn on the Hub, once the Hub is turn on, the “Loading” screen will show up on the Hub.


Please note the “loading icon” on lower right corner of the icon, above “LIBRE HOME” text.

Wait for about 1-2 minutes, when loading is finished, the “loading” icon will change to “setup” icon. Loading

Note, in order to protect the OLED screen. The screen will automatically turn off after about 1 minutes.

Searching Hub on Your Smartphone.

Start the Smartphone App. The initial screen is the “Hub List” screen.

Click the “Add” button, on either upper right or lower right corner.

Add Hub

The “Add Hub” menu will pop up.

Choose “Search Local Network”.

Add Hub

Another screen will show up and start searching the Liberty IoT Hubs in the local network.

Usually there should be only one hub in the local network. If there are more than one, contact system administrator for further help, or just guess.

Add Hub

Setup Administrator Account

Choose the new Hub from screen above. An 8 letter passcode will be displayed on Hub screen with Key icon.

Enter the correct passcode, user is then allowed to setup Admin Name and password.

Add Hub

Hub Connection Settings

Liberty-IoT-OS is all about liberty. The sole purpose of Liberty-IoT-OS is to give users total control over their IoT devices, identity and data. The sole purpose of our network service is to help user (from their smartphone) to locate their Liberty IoT Hub in order to create end-to-end encrypted connection.

From Smartphone App, there are 3 ways to connect to your Liberty IoT Hub at home, from anywhere in the world.

Hub IP Types

Through Libre Home Secure Bridge Network

Both Smartphone and Liberty IoT Hub connect to our bridge network. The bridge network will forward messages between Liberty IoT Hub and your Smartphone. The message is end-to-end encrypted so the bridge will not understand the content.

This method is for users with no technical knowledge at all.

By Port Forwarding

User can set up port forwarding on their home router to the Liberty IoT Hub (punch a hole). In this case Smartphone App only needs to know the port number.

Liberty IoT Hub still needs to connect to our network periodically so that our system will know the current IP of the Liberty IoT Hub.

In this case our network service acts as a secure authenticated DNS. Only Smartphone clients with valid key can get IP for a specific hub.

Hub IP Types

Using Static IP

In this case, both IP and port are required to set up the Hub. All Smartphone Apps will directly connect to the IP/port.

Still, the Hub may need to connect to our network if it needs to send some notifications to the users (to their Smartphone). It is required because at least on IoS platform, the only way to send real-time notification is through Apple’s own network.

But don’t worry, all messages (including notifications) are still end-to-end encrypted. Neither us or Apple/Google will be able to know the content of the messages.

Hub IP Types

Connect to an Existing Liberty IoT Hub

Note only admin users are required to give a password to their accounts. A regular user is not even required to input a password. If the user chooses not to give a password, the user is highly dependent on Hub admin. If the regular user wants to connect to the Hub from a new Smartphone without a valid password, he/she will need help from admin to add the new device to Hub.

Users with valid password will be able to add new smartphone from network. In local network, follow the same instruction above Searching Hub on Your Smartphone. Once you connect to the Hub, a screen will pop up prompting password.

Recover an Account

There are two ways to recover an account.

Recover an Account from Local Network

Recover an Account over Internet