Connect your first device

This guide takes you from nothing to a Raspberry Pi that shows as Online in your Suta dashboard.

Before you begin

You need:

• A Raspberry Pi with a 64-bit processor, such as a Pi 5, Pi 4 or Pi Zero 2 W.
• An internet connection for the Pi, over Ethernet or Wi-Fi.
• A computer running macOS or Linux.

For the full list, see Requirements.

Create your workspace

1. Go to app.suta.dev and select Create account.

2. Sign in, then name your workspace. A workspace holds your devices and the people who can manage them. You can rename it later.

Connect a device

Choose the tab that matches your Pi.

Pi is already running

Use this path if your Pi already runs 64-bit Raspberry Pi OS (Bookworm or Trixie) and you can connect to it over SSH. Suta doesn’t change your operating system, network settings or services.

1. Open an SSH session to your Pi.

2. Run the installer:

   curl -fsSL https://suta.dev/install.sh | bash

3. When asked what to install, choose Suta agent.

4. Open the registration link that the installer prints. Give the device a name, then select Register device.

5. Keep the SSH session open until the installer reports that the device is connected.

New Pi

Use this path to start from a blank SD card. You flash the card with the Suta CLI, then set the Pi up over Bluetooth.

1. On your computer, install the Suta CLI:

   curl -fsSL https://suta.dev/install.sh | bash

   When asked what to install, choose Suta CLI.

2. Insert an SD card of 16 GB or more, then run:

   suta flash

   Use the arrow keys to choose your card and confirm that you want to erase it.

3. Put the card in your Pi and turn it on. Wait a minute or two for the first boot to finish.

4. In Chrome on your Mac, go to Devices > Add device > Flash an SD card and select Find my device.

5. Choose your Pi in the Bluetooth window, name it, then select Claim this device.

6. Choose Ethernet or Wi-Fi, then wait for Device connected.

Tip

Not on Chrome for macOS? Run suta device add in your terminal instead. It walks you through the same steps. See Set up from the terminal.

Check that it worked

Open Devices. Your Pi appears with a green Online status. A device is online only after it sends Suta its own signed heartbeat, so this status means it’s really connected.

Seeing “Waiting for connection”?

The device is registered but hasn’t reached Suta yet. Check that it has internet access. See Troubleshooting.

What’s next

Turn on monitoringSee CPU, memory, temperature and service logs.

Invite your teamAdd people and choose what they can do.

Set up alertsGet told when a device goes offline.