Try Libertas
Try a client first, with the Libertas Cloud Hub: a Hub hosted for you, with nothing to set up. The current release is Beta 2.
AndroidLibertas One on Google Play
iOSComing to the App Store
WebThe Cloud Hub in your browser
In the App, tap Add a new Hub → Libertas Cloud Hub, then sign in in the browser that opens. On the web, just sign in.
Run your own Hub
Your own Hub runs Ubuntu 26.04, x86-64 or ARM64.
Home Hub in Incus (Linux or Mac)
It runs on a computer at home, so phones on your Wi-Fi find it. You need Incus:
- Linux:
sudo apt-get install incus && sudo incus admin init --auto. Your LAN interface is the oneip route show defaultnames, such aseno1. - Mac: with Homebrew, run
brew install colima incusandcolima start --runtime incus --network-mode bridged --network-interface en0(en0is usually Wi-Fi; use your LAN interface). Your LAN interface inside Colima iscol0. Dropsudofrom the commands below.
-
Create an Incus container on your LAN, with
LANreplaced by that interface:Shellsudo incus init images:ubuntu/26.04 libertas-hub -c security.nesting=true sudo incus config device add libertas-hub eth0 nic nictype=macvlan parent=LAN sudo incus start libertas-hub && sleep 10 -
Install the Hub in it:
Shellsudo incus exec libertas-hub -- bash -c ' apt-get update && apt-get install -y curl install -d -m 0755 /etc/apt/keyrings curl -fsSL https://apt.libertasiot.com/ubuntu/keys/libertasiot-archive-keyring.gpg \ > /etc/apt/keyrings/libertasiot-archive-keyring.gpg echo "deb [signed-by=/etc/apt/keyrings/libertasiot-archive-keyring.gpg] https://apt.libertasiot.com/ubuntu resolute main" \ > /etc/apt/sources.list.d/libertasiot.list apt-get update && apt-get install -y libertasd' -
Find its address:
sudo incus list libertas-hubshows the Hub's LAN address. Phones and other computers reach it; the computer running it cannot (a macvlan limit). -
On the same Wi-Fi, tap Add a new Hub → Search Local Network in the App and choose the Hub. Agree to the EULA and create the administrator in Setup Admin Account. That password is the master password: write it down.
Your own Cloud Hub on a server
It runs on an Ubuntu 26.04 server with a public address. Open TCP ports 8080 and 8443, and run these steps on the server itself.
-
Install the Hub:
Shellsudo install -d -m 0755 /etc/apt/keyrings curl -fsSL https://apt.libertasiot.com/ubuntu/keys/libertasiot-archive-keyring.gpg \ | sudo tee /etc/apt/keyrings/libertasiot-archive-keyring.gpg >/dev/null echo 'deb [signed-by=/etc/apt/keyrings/libertasiot-archive-keyring.gpg] https://apt.libertasiot.com/ubuntu resolute main' \ | sudo tee /etc/apt/sources.list.d/libertasiot.list >/dev/null sudo apt-get update && sudo apt-get install -y libertasd sudo mkdir -p /etc/systemd/system/libertasd.service.d printf '[Service]\nEnvironment=LIBERTAS_CLOUD_HUB=1\n' \ | sudo tee /etc/systemd/system/libertasd.service.d/10-cloud-hub.conf >/dev/null sudo systemctl daemon-reload && sudo systemctl stop libertasd -
Commission it with the address clients will use. The first run prints where to read the Beta EULA and the
--accept-eulavalue; rerun with it. Type the master password when asked and write it down: it cannot be recovered.Shellsudo env LIBERTAS_CLOUD_HUB=1 libertasd commission \ --connection static --connection-address hub.example.com:8080 sudo env LIBERTAS_CLOUD_HUB=1 libertasd commission --accept-eula <value> \ --connection static --connection-address hub.example.com:8080 sudo systemctl start libertasd -
In the App, tap Add a new Hub → By IP Address, enter
hub.example.com:8080, and log in as Admin with the master password.
Studio
- Install Node.js and Rust, then the Libertas Studio extension in VS Code; it checks its prerequisites on first launch.
- Run Libertas: Manage Hubs and add the Hub by name and address
(
192.168.1.50for a Home Hub,hub.example.com:8080for your own Cloud Hub). - Studio shows Authorize Libertas Hub with a QR code. In the signed-in Libertas One app, use Scan Login QR Code.
- Run Libertas: Create New Project, then follow Developing Apps.
Next: Using Studio · Administration · Troubleshooting