Raspberry Pi

Installing the Synpse agent on a Raspberry Pi

In this tutorial how to install Synpse on a Raspberry Pi with Docker. This tutorial works similarly on any other Linux based devices as well.


  1. Synpse CLI installed and logged in to Synpse Cloud

  2. Raspberry Pi with an SD card

  3. SD card burner such as Etcher or Raspberry Pi Imager

Setting up Raspberry Pi OS

Raspberry Pi devices need an OS to run. You can find detailed instructions here or shorter instructions here. This normally means that you need to:

  1. Download the OS image

  2. Use either Etcher or Raspberry Pi Imager to burn the image into an SD card

  3. Insert the SD card into your device and plug in the power supply

Install Docker

To install Docker, simply run the command in the terminal:

curl -sSL https://get.docker.com | sh

To check whether Docker works on the device, run:

docker ps

It should show an empty list of running container. If you have issues installing Docker, I recommend going to the Docker documentation and looking for instructions for your system.

Install Synpse agent

Go to the project devices page and use the displayed command:

Alternatively, click on a "provision device" button. It should display you a command that already has your project and registration token prepared:

$ curl https://downloads.synpse.net/install.sh | \

After a few seconds, you should be able to see the device in your dashboard.

Last updated