Installing the hub

The hub installs itself: it downloads the site's system, brings up the tunnel to the panel and starts reporting to Abriu. There are two ways, and both use the same one-time code Abriu hands over (see What the installer gets from Abriu).

Before turning it on

• The code or the first-boot file at hand, within its period (14 days from issue). Expired, Abriu makes another in minutes.
• A network cable to the site's router, with the internet working (see What the hub reaches on the internet).
• The model's official supply (see The hub).
• A computer with Raspberry Pi Imager 2.0 or newer, for the card.

Way 1: the card with the first-boot file

The simplest: no keyboard, screen or command.

1. In Raspberry Pi Imager, choose the Pi's model and the system Raspberry Pi OS (64-bit), the one with a desktop (not Lite). When Imager asks about customization (user, Wi-Fi, SSH), answer no: Abriu's file does that.
2. Write the card.
3. With the card still in the computer, open the partition called bootfs (the only one Windows and macOS show) and replace the user-data file with the one Abriu sent. If the hub will use Wi-Fi, replace network-config too. Some browsers save user-data without an extension and ask whether to keep it: keep it, and do not rename it.
4. Put the card in the hub, plug in the network cable and, last, the power.
5. Wait 10 to 20 minutes. The green LED blinks while the hub works.

Without a network cable and without the network-config, connect the Wi-Fi from the hub's desktop (with a screen and a keyboard): it waits for the internet and goes on by itself. If the power goes or it has to be restarted midway, it carries on at the next boot, until it is done.

The first-boot file carries the install code: until the hub is installed, keep the card as you would keep the code.

Way 2: the command, on a Pi that already has a system

For a hub that already has Raspberry Pi OS (64-bit) and a keyboard and screen or SSH:

curl -fsSL https://fleet-api.abriu.app/install | sudo bash -s -- XXXX-XXXX-XXXX-XXXX

Replace the Xs with the code. The command installs everything and ends with "Pronto.". If it fails after the download (network, clock), fix the cause and run the same command again: the code keeps working until the installation ends.

Knowing it worked

1. The site's panel opens: https://<id>.abriu.app shows the login screen (before that, a Cloudflare error page).
2. The manager gets the e-mail to create the panel's password (check the spam). It goes out when the system comes up on the hub.
3. The status page, https://status.abriu.app/<id>, shows the system up.
4. For Abriu, the site leaves "Aguardando instalação" in the fleet. To confirm, message support.

None of this within 30 minutes: see The hub does not install.

After the installation

• The hub needs nothing more: it updates itself (Abriu controls when) and reports every 5 minutes.
• Do not unplug the hub day to day; if needed, turn it off from the panel or tell Abriu. Power cuts are expected and the hub comes back on its own.
• Keep the case closed and out of reach (see Where to install the hub).
• The card with the first-boot file has been consumed: the code no longer works, but the card stays in the hub.

Replacing or reinstalling a hub

If the hub breaks or the card corrupts, Abriu makes a new code and the new hub installs the same way. The site's data comes back from the external backup the hub sends every night. The steps, for a planned replacement and for a hub that died, are in Replacing the hub. The terminals keep working while the hub is out.