Skip to content

Getting Started

github-actions[bot] edited this page Nov 9, 2026 · 19 revisions

Getting Started

Total time: roughly 10–15 minutes of hands-on work, plus the time it takes to download and write the image.

Before you start: check the supported boards. Notably, the Pi 3B/3B+ cannot work at all (hardware limitation), and a Pi 3A+ needs a USB-A-to-USB-A cable.

There are two ways to install:

  • Sentry USB image (recommended for Raspberry Pi): write it with Raspberry Pi Imager, plug in, done. No SSH.
  • Manual install: for other boards, or a Pi that already runs Raspberry Pi OS.

Install with the Sentry USB image

1. Write the image

  1. Download and install Raspberry Pi Imager (version 2 or newer).
  2. Download Sentry-USB-for-Raspberry-Pi-Imager.rpi-imager-manifest from the latest release.
  3. Double-click the downloaded file. Raspberry Pi Imager opens with Sentry USB in its list.
  4. Insert your microSD card (or USB drive) into your computer.
  5. On the Device step, pick your Pi model. On the OS step, pick Sentry USB. On the Storage step, pick your card.

Imager then walks you through its customisation steps. Fill them in and click Next (don't click Skip customisation):

  • Hostname: leave it blank. If Imager filled in a name from last time, clear it. The Pi then appears as sentryusb.local.
  • Localisation: pick your nearest capital city. This also sets your time zone and WiFi country.
  • User: set a username and password. Imager requires one.
  • Wi-Fi: choose Secure network, then enter your WiFi name (SSID) and password.
  • Remote access: optional. Turn on SSH only if you want a terminal on the Pi.

On the Writing step, click Write, then I understand, erase and write. Imager downloads the image and writes it.

Note

Download the .rpi-imager-manifest file, not the .img.xz image. The manifest is what makes Imager ask for your Wi-Fi; an image written on its own can't join your network.

2. Boot the Pi

  1. Eject the card and put it into the Pi.
  2. Power on the Pi with any USB power supply. (Later you'll move the Pi to the car and power it from the Tesla using the same port.)
  3. Wait about a minute (a couple of minutes on a Pi Zero 2 W or Pi 3A+). The first start sets up the card, restarts once and joins your WiFi. On a Pi 5 the light then stays red with a short dark gap every three seconds. Before setup that's normal: Sentry USB is running and its storage isn't set up yet. See Status light.

3. Open the web UI

Open your browser and go to:

http://sentryusb.local

The Setup Wizard will walk you through the rest. If the page doesn't load, find the Pi in your router's device list (look for sentryusb) and open http://<its-IP> instead.

Then connect to your Tesla.

Manual Install

1. Flash the SD card

You'll use Raspberry Pi Imager to write Pi OS to your microSD card.

  1. Download Raspberry Pi Imager and open it.
  2. Insert your microSD card into your computer.
  3. On the Device step, pick your Pi model, then click Next.
  4. On the OS step, pick Raspberry Pi OS (other) → Raspberry Pi OS Lite (64-bit), then click Next.
  5. On the Storage step, pick your SD card, then click Next.

Imager then walks you through the customization steps. Fill in each one and click Next (don't click Skip customisation):

  • Hostname: leave it blank. Sentry USB sets its own hostname during install.
  • Localisation: pick your nearest capital city. This also sets your time zone, keyboard layout and WiFi country.
  • User: set a username and password. Write them down.
  • Wi-Fi: choose Secure network, then enter your WiFi name (SSID) and password.
  • Remote access: turn on Enable SSH → Use password authentication.
  • Leave any other steps (such as Raspberry Pi Connect) as they are and click Next.

On the Writing step, click Write, then I understand, erase and write.

2. Boot the Pi

  1. Eject the SD card from your computer and put it into the Pi.
  2. Power on the Pi with any USB power supply. (Later you'll move the Pi to the car and power it from the Tesla using the same port.)
  3. Wait about 60 seconds for it to boot and join your WiFi.

3. Find the Pi's IP address

Open your router's admin page in a browser. The address is usually http://192.168.1.1 or http://192.168.0.1 — check the sticker on the bottom of your router.

Log in and find the device list (sometimes called "Connected Devices", "DHCP Clients", or "LAN Status"). Look for a device named raspberrypi and note its IP address (something like 192.168.1.47).

4. SSH in and install

From your computer's terminal (Terminal on Mac, PowerShell on Windows):

ssh <your-username>@<the-IP-from-step-3>

Type the password you set in Pi Imager.

Once you're in, run:

sudo apt update && sudo apt upgrade -y
sudo -i
curl -fsSL https://usb.sentry-six.com | bash

Important

Don't skip the apt update && apt upgrade step. Pi OS images carry an apt cache from whenever the image was built. If Debian has published a point release since then, the cache points at .deb files that no longer exist on the mirrors and you'll see 404 Not Found errors mid-install. The upgrade can take a couple of minutes — that's normal.

The installer itself then takes 2–5 minutes. It downloads the Sentry USB binary, sets up the system service, installs mDNS, and renames the Pi to sentryusb. Your SSH session may drop near the end when the hostname changes — that's expected.

5. Open the web UI

Open your browser and go to:

http://sentryusb.local

The Setup Wizard will walk you through the rest — picking your archive method, configuring notifications, etc.

Tip

Keep the IP address the installer printed handy. Setup reboots the Pi several times, and sentryusb.local can briefly stop resolving after a reboot on some networks — if the page doesn't reconnect, open http://<ip> instead and setup picks up right where it left off.

6. Connect to your Tesla

After you finish the Setup Wizard:

  1. Unplug the Pi from your power supply. Sentry USB is built to lose power whenever the car sleeps, so this is safe once setup has finished.
  2. Plug your USB 3.0 cable into your Tesla's glovebox USB port (newer Teslas) or one of the front USB ports (older Teslas).
  3. Plug the other end into the Pi.
  4. The Pi boots from the car's power. Within a few seconds, your dashcam icon will appear and start recording to the Pi.

Important

Tesla introduced dashcam encryption in update 2026.20. At the moment, there is no way to decrypt the files on-device. To use Sentry USB, please disable "Encrypt Dashcam Recordings" in the settings. This feature is only available on AMD-equipped vehicles.

To find the toggle, navigate to:
Settings → Safety → Dashcam

Need help?

Clone this wiki locally