Install on an existing Pi

Use this guide when your Raspberry Pi is already online and you can connect to it over SSH. The installer adds the Suta agent alongside what’s already there. It doesn’t upgrade the OS, reboot, change network settings or touch your services.

Before you begin

• Check that the Pi meets the requirements.
• Make sure you have a Suta workspace. If you don’t, create one at app.suta.dev.

Install the agent

1. Open an SSH session to the Pi, using an account that can run sudo.

2. Run the installer:

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

3. When asked what to install, choose Suta agent. The installer checks the Pi, explains what it will add, then asks you to continue.

4. Open the registration link that the installer prints. Sign in if asked.

5. On the Register your device page, check the workspace shown. To use a different one, switch workspace in the sidebar. Enter a Display name and, optionally, some tags. To compare the identity with the one shown on the Pi, expand Check device identity.

6. Select Register device.

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

The device now appears in Devices. Monitoring and remote access start off. Turn them on from the device page when you need them.

Caution

If the Pi already has an unrelated account or file named suta, the installer stops without changing anything. Rename or remove the conflicting item first.

Update the software

To update all Suta software on the device, run the installer again. It keeps the device’s identity, registration and settings.

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

To update without prompts, for example from a script, pass --agent --yes:

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

--yes never resets registration.

To update only the agent from the dashboard, see Update the Suta agent.

Finish an interrupted registration

If registration didn’t finish, for example because you closed the browser, run:

sudo suta register

Uninstall

sudo suta uninstall

This removes the Suta software but keeps the device’s identity and settings, so you can reinstall later. It doesn’t remove the device from your workspace. To revoke its access, remove it in the dashboard.