sunnypilotInstall softwareAdvanced

Install sunnypilot over SSH

Connect over SSH, remove the old software folder, download the sunnypilot branch with its submodules, then reboot.

comma four with its screen on

Who this is for

Developers and testers who are comfortable in a terminal; most people should use the URL method.

comma fourcomma 3Xcomma three

You need

  • SSH already working to your comma device
  • A GitHub account with an SSH key
  • The branch name you want

In plain words

Why this guide matters

Most people install sunnypilot by typing a link, but developers sometimes need to pull a branch by hand. This page gives the exact SSH commands: remove the old folder, clone the branch with submodules, pull large files, reboot. Use it when you already have SSH working and know which branch you want.

The short version

What the full guide walks you through

  1. Connect to the device over SSH.

  2. Remove the existing openpilot folder.

  3. Download the sunnypilot branch with submodules and large files.

  4. Reboot the device.

Before you start

  • A typo can leave the device with no software; keep the URL method as a fallback.

The full written guide belongs to sunnypilot. Checked on September 10, 2026. Their last update was March 13, 2026.

Quick answers

Questions people ask

Should a beginner use the SSH method?

No; the URL method is simpler and safer. Keep it as a fallback if an SSH install goes wrong.

What do I need first?

SSH access to the device using your GitHub key, a branch name and a stable Wi-Fi connection.

How long does it take?

Cloning with submodules and large files can take a while on slow Wi-Fi. Plan for more than a few minutes.

Related

All community guides

Not sure this is your path?

Check your exact car first, then choose software and hardware.

Photos: comma.ai. Guide content belongs to sunnypilot. CommaGuide is an independent guide and is not affiliated with comma.ai or sunnypilot.

Was this guide helpful?