Synchronizing your configurations using the Plucky users site allows you to:

  1. Use a common configuration on different devices.

  2. Make your configuration changes visible to others for accountability.

  3. Restore your local configuration from the online backup if your local configuration is lost.

    On Android, synchronization occurs automatically, so if you’re only using Android you can stop reading here.

    For desktop Plucky, synchronization can be initiated in one of two ways:

  4. Uploading a configuration.

  5. Assigning a remote configuration to your device.

Uploading a configuration

By default, the desktop version of Plucky stores configuration only on your local computer and does not copy it to the users site.

If you would like to share the configuration from your local computer with another device, you first need to upload it. To do this open a console and in it type:

pluck sync

After that, the configuration should automatically synchronize to and from the users site. It can then be shared with another device by assigning the configuration to another device, or by importing it in another configuration.

Assigning a remote configuration

You can create a general configuration on the users site and assign it to your device. Doing so will cause your device to use the newly created configuration rather than the configuration that already exists on the device. Only a general configuration may be assigned to a device.

If you have a substantial local configuration, you may want to upload it before assigning another configuration to your device.

Synchronizing local configuration with remote

After you have assigned a remote configuration (i.e., one on the users site) to your device, you can synchronize your local version with the remote one by running:

pluck sync

However, changes made remotely may still take some time to come into effect on your devices. Hence, if you need to make an immediate change that will not be subject to your delay (e.g., adding a block rule), you should make the change on the device (i.e., by interacting with the browser extension or by typing pluck commands in a console) and then use pluck sync.


Last updated: 2023-05-02