Home / Guides
Installation Guide
Difficulty: Moderate
Version Note: 0.8.17+
Devices: comma 3 / 3X / 4

sunnypilot Installation Guide

Install sunnypilot on comma 3, 3X, or comma 4 with the correct branch URL, then use SunnyLink for easier remote configuration on comma 4.

Prerequisites
Factory reset first
Begin with a clean install
Switching from another fork requires a reset before installing sunnypilot.

Start clean — always factory reset before switching forks.

Switching from another fork?

⚠️ Uninstall Guide — read this first →

Install Methods

Use the custom software URL on-device for normal installs, or SSH if you need the manual release-c3 path.

Step 1

Factory reset your comma device if another fork was previously installed.

Step 2

On the Choose Software screen, select Custom Software.

Step 3

Enter the stable comma 3 / 3X install URL (no https:// needed on comma three). .

Step 4

Follow the on-screen instructions to complete setup.

Compatibility
Compatible Devices

sunnypilot supports the comma 3 / 3X (stable release) and comma 4 (dev and staging branches). A stable release branch for comma 4 is coming soon.

  • comma 3
  • comma 3X
  • comma 4 (MICI) — supported via dev and staging branches. Stable release branch is coming soon.
  • comma 2 — not supported (deprecated)

comma 4 users: The comma 4 screen is smaller, making on-device settings harder to navigate. Use SunnyLink (sunnylink.ai) for remote configuration and settings sync.

Installed on 0.8.17+
Switching Branches
Move between stable, staging, and development branches from the software menu.
1

Open Settings -> Software.

2

At Download, press CHECK.

3

At Target Branch, press SELECT.

4

Pick your desired branch and update.

Branch URLs

Use the branch that matches your hardware and risk tolerance.

BranchURLDevicesFor
release-c3comma 3 / 3XStable daily use
staging-c3comma 3 / 3XPre-release testing
dev-c3comma 3 / 3XDevelopment
devcomma 4comma 4 daily use (dev)
stagingcomma 4comma 4 pre-release testing

Support and Safety

Install help, behavior notes, and validation guidance after setup.