Skip to content

Scottmg1/Sentry-USB

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,517 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Sentry USB

A modern, feature-rich USB drive manager for Tesla vehicles — built on the foundation of TeslaUSB, fully rebranded and revamped at Scottmg1/Sentry-USB.

What is Sentry USB?

Sentry USB turns a Raspberry Pi (or compatible SBC) into a smart USB drive for your Tesla's dashcam system. It automatically archives recordings, serves a modern web UI, and can be fully configured through a browser — no SSH or config file editing required.

Key features:

  • Modern Web UI — Dark glassmorphism design with sidebar navigation, real-time dashboard, multi-camera viewer, file browser, and live log tailing
  • Setup Wizard — 9-step guided configuration covering WiFi, storage, archiving, keep-awake, notifications, security, and advanced settings — all from your browser
  • Go API Server — Lightweight single-binary backend that cross-compiles for ARM, replacing nginx + CGI scripts
  • Multi-camera Viewer — 6 layout options for synchronized playback of all Tesla camera angles
  • Archive Support — CIFS/SMB, rsync, rclone (cloud), and NFS
  • Keep-Awake — BLE, TeslaFi, Tessie, and Webhook methods
  • 13+ Notification Providers — Pushover, Discord, Telegram, Slack, Signal, Matrix, AWS SNS, IFTTT, Gotify, NTFY, Webhooks, Sentry Connect

Documentation

  • Wiki — Getting Started, Setup Wizard Guide, Archive Methods, Notifications, Troubleshooting, FAQ, Developer Guide
  • Build Guide — Building from source

Prerequisites

  • A Raspberry Pi (Zero 2 W, Pi 3, Pi 4, or Pi 5) or compatible SBC with USB OTG
  • A MicroSD card, 64 GB minimum (128 GB+ recommended)
  • USB cable to connect the Pi to the Tesla

Quick Start

  1. Flash Raspberry Pi OS Lite (64-bit) to your SD card using Raspberry Pi Imager — configure WiFi, hostname (sentryusb), and SSH in the imager settings before writing
  2. Boot the Pi, SSH in, and install:
sudo -i
curl -fsSL https://usb.sentry-six.com | bash
  1. Open http://sentryusb.local, complete the Setup Wizard, wait for reboots (10–20 min), plug into your Tesla

Note: The Pi will reboot several times during setup — this is normal. Do not power off.

See the Getting Started guide for detailed instructions.

Based On

Sentry USB is a modernized fork of TeslaUSB by marcone and contributors, fully rebranded and revamped by Scottmg1.

Coming from TeslaUSB?

Sentry USB is a full rewrite with a new Go backend and React frontend. A fresh install is required — there is no in-place upgrade path from TeslaUSB. Your archive server credentials and notification settings will need to be reconfigured via the web UI Setup Wizard.

License

MIT — see LICENSE for details.

About

A smart USB drive for Tesla Dashcam - extended storage, auto archive, web viewer

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • TypeScript 42.0%
  • Shell 30.8%
  • Go 21.6%
  • Python 4.4%
  • C++ 0.7%
  • CSS 0.3%
  • Other 0.2%