Skip to content

Config Sync

Config sync lets you back up your PicGo config (uploader settings, plugin config, hotkeys, etc.) to PicGo Cloud and keep it in sync across devices.

Relationship with file hosting

Config sync and file hosting are independent features. Config sync is available on all plans, including Free — only the number of history versions differs:

PlanConfig sync history versions
Free3
Starter10
Pro50
Max100

Starting a sync

  1. Log in to PicGo Cloud from the GUI app.
  2. Go to the PicGo Cloud page and click "Config Sync".
  3. Wait for the result (success / warning / error).
  4. If prompted to restart, choose "Restart now" or "Later".

For step-by-step screenshots, see PicGo Cloud in the GUI app.

Encryption modes

Config sync offers three encryption modes, selectable from the dropdown next to the sync button:

Auto

Follows whatever encryption method was used last time on the server. If you've never chosen one, it defaults to server-side encryption (SSE). Good for most users — no extra steps needed.

Server-side encryption

  • Your config is encrypted in transit via SSL/TLS and stored with AES-256 encryption on the server.
  • PicGo manages the encryption keys, so you don't need to remember a password.
  • If you forget your account password, you can still access your config by logging in again via OAuth.
  • Best for users who value convenience and don't need maximum privacy.

End-to-end encryption

  • Your config is encrypted on your device with a PIN you set before it leaves your machine. The server only stores ciphertext and cannot decrypt it.
  • Even if the server were compromised, your config would remain safe.
  • When syncing across devices, every device needs the same PIN.

DANGER

If you enable E2EE and set a PIN, keep it safe. If you forget your PIN, PicGo cannot recover your encrypted config — the data becomes permanently inaccessible.

For more on encryption, see the PicGo Blog.

Conflict resolution

TIP

Most of the time, PicGo merges remote and local config automatically. The conflict dialog only appears when it can't resolve things on its own.

When multiple devices edit the config and then sync, conflicts may arise. When that happens:

  1. PicGo opens a conflict resolver dialog.
  2. For each conflicting item, pick either the "Local" or "Cloud" version.
  3. You can also use bulk actions: "All Local", "All Cloud", or "Reset".
  4. Click "Confirm & Sync" when you're done, or "Abort" to cancel.

Sync history and versions

PicGo Cloud keeps your most recent sync history versions (the exact number depends on your plan — see the table above). You can view past versions on the Config page at cloud.picgo.app.

Things to keep in mind

  • Config sync covers PicGo's config files — it does not include your actual image files.
  • After your subscription expires, config sync still works, but the history is reduced to the Free plan's 3 versions. See Subscription lifecycle for details.