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-tizi 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 3X on the stable release branch, comma 3 on staging-tici only, and comma 4 on the unified dev and staging branches. Stable release branches for comma 3 and comma 4 are not available yet.

  • comma 3X (TIZI) — stable on release.sunnypilot.ai via the release-tizi branch
  • comma 3 (TICI) — staging-tici only at install.sunnypilot.ai/staging-tici
  • comma 4 (MICI) — supported via dev and staging unified branches. Stable release-mici 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-tizicomma 3XStable daily use — recommended
stagingcomma 3X / 4Pre-release testing (unified)
devcomma 3X / 4Development (unified)
staging-ticicomma 3comma 3 staging only — no stable yet

Support and Safety

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