Files
sunnypilot/docs_sp/how-to/preserve-local-changes.md
Jason Wen 83a84ba4bc more
2026-03-11 21:27:32 -04:00

2.3 KiB

title
title
Preserve Local Changes

Preserve Local File Changes on Your comma Device

Overview

By default, the comma device automatically updates sunnypilot, which overwrites any local file modifications you have made. To keep your local changes across reboots, you must disable automatic updates before making modifications.

!!! warning "Complete These Steps First" Local modifications applied before completing the steps below will not be retained. The automatic update process will overwrite them on the next reboot. Complete all steps first, then make your changes.

Steps

1. Enable Advanced Controls

Navigate to SettingsDeveloperShow Advanced Controls and toggle it ON.

This reveals additional settings options that are hidden by default, including the update toggle.

2. Disable Updates

Navigate to SettingsSoftwareDisable Updates and toggle it ON.

This prevents the device from automatically pulling and applying updates from the remote branch.

!!! note "Offroad Only" The Disable Updates toggle can only be changed while the device is offroad (not actively driving). If you are in a drive, complete the drive first and return to the home screen before changing this setting.

3. Reboot the Device

Navigate to SettingsDeviceReboot to restart the device.

The reboot applies the settings change and ensures the update service is fully stopped. A confirmation dialog will appear before the reboot proceeds.

4. Verify

After the device restarts:

  1. Confirm that your settings from steps 1 and 2 are still active
  2. Make your desired local file changes (via SSH or other methods)
  3. Reboot again to confirm your changes persist

!!! info "Automatic Updates Are Paused" With updates disabled, your device will not receive new sunnypilot releases automatically. You will need to re-enable updates manually when you want to update to a newer version. To re-enable, reverse step 2: SettingsSoftwareDisable UpdatesOFF.

!!! tip "When to Use This" This is useful for testing custom parameter values, experimental configurations, or developer modifications that you want to persist across device reboots without being overwritten by the update system.