Skip to content

Reset and Cleanup

ShadowSync stores local state so it can stay incremental between runs. Sometimes that is exactly what you want to remove: a broken config, stale manifest, or shadow cache you no longer trust.

Reset Scripts

The repo provides platform-specific cleanup scripts under tools/reset/:

  • tools/reset/reset-windows.bat
  • tools/reset/reset-macos.sh
  • tools/reset/reset-linux.sh

These scripts are intended to remove the app's per-user state, including:

  • config.json
  • manifest.json
  • sync.log
  • update-state.json
  • wizard.log
  • config.invalid.*.json
  • shadow/
  • current-user startup or autostart entries
  • single-instance lock artifacts

They are for local cleanup. They are not meant to uninstall packaged binaries, remove release artifacts from system install locations, or delete anything from the USB drive itself.

When to Use Them

Use a reset script when:

  • the config was badly broken and you want to start fresh
  • you want to discard the cached manifest and shadow copy
  • you are testing a first-run experience
  • you want to verify behavior without any retained local state

Safer First Steps

Before wiping everything:

  • use the tray action Open raw config
  • use the tray action Open log
  • use the tray action Open app folder
  • back up config.json if you care about your current job setup

After a Reset

After local state is removed:

  1. Launch the app again.
  2. Open Setup Wizard.
  3. Recreate the drive setting:
  4. Windows: drive.letter
  5. macOS/Linux: drive.path
  6. Recreate your jobs and save.

The app will then build fresh local state on the next sync.