Home

Appendix

Application Icon   Sync

DEVONthink allows you to keep your databases in sync with multiple Macs and iOS devices running DEVONthink To Go. Set up your sync location, choose which databases are synced, and how often they're synced.

Locations

The Locations column lists all available sync locations, whether these are the built-in options, ones you've added yourself, or ones detected on your network, e.g., WebDAV services. Activate or disable sync locations via its checkbox. Inactive or inaccessible locations are shown in grey. And if a sync location is using encryption, will appear to the right of the name.

Use the buttons below the Locations list for more options:

  • Icon
    Add Location: Add a new sync location with the + button e.g., to add another local sync store.
  • Icon
    Remove Location: Remove a selected sync location with the - button. It is generally a good idea to clean the location before removing it.
  • Icon
    Show Info: Display a popup with editable details of the selected sync location.

The Locations Action menu also is used for information, troubleshooting, and removing chosen sync locations.

  • Icon
    Reveal in Finder: Opens a Finder window revealing a selected local sync sync store.
  • Icon
    Verify Location: Used in troubleshooting situations, this quickly verifies the integrity of the sync data of the chosen sync location. Hold the ⌥ key to select Verify Location Thoroughly.
  • Icon
    Clean Location: Also used in troubleshooting, this removes all the sync data in the selected location.

Sync Location Options

When setting up a sync location or editing the options on an existing one, you will see some of these options in the Info popup for the location. The options shown are dependent on the specific sync method:

  • Icon
    Encryption: The key used to encrypt the sync data (AES-256). This is not mandatory, but recommended. There are no length or character requirements.
  • Icon
    Sync Store Name: The name of the sync store, ideally with no spaces for broader compatibility, e.g., DTSync or work_2025. If you are setting up an already active sync location, e.g., you've already synced from another device, click the dropdown menu to choose from a list of existing stores.
  • Icon
    Synchronize label names & colors: Synchronize label names and colors using this location. Be aware, changes to the colors and names on any syncing machine will sync to the others.
  • Icon
    Synchronize reading positions: Synchronize reading and playback positions using this location. This can help you keep your place in PDFs you're reading or audio/video you're playing.
  • Icon
    Synchronize custom metadata definitions: Synchronize custom metadata definitions found in the the higher editions of DEVONthink and actively used on items in your databases. If you are collaboratively syncing, you may want to disable this option to avoid the other party from receiving your specific metadata definitions.
  • Icon
    Synchronize content of indexed files: Synchronize the content of indexed files. If you uncheck this option only the metadata about the document will be synchronized. This is generally only used in special circumstances.
  • Icon
    Verify uploaded items: Verify all uploaded items to make sure the sync data is intact. Usually only necessary with unstable network connections/servers or in case you experience troubles with defective files.
  • Icon
    URL: The URL of a WebDAV server, often including a port and folder where the sync store is located, e.g, https://herax.local:65501/DEVONsync. The path is case-sensitive.
  • Icon
    User name: The user name for the service.
  • Icon
    Password: The password for the service.

Databases

With a sync location selected, the Databases column lists all currently open databases as well as all databases available remotely in the selected location. The Local section lists all open database and a message about their sync status, e.g, the timestamp of the last sync. The Remote section lists all databases available for import or currently not currently open on the machine. When attempting to import the latter, the local database will be opened by DEVONthink.

Start and stop syncing a specific database to the selected location. Uncheck databases you want to discontinue syncing with the selected location, but be aware this does not remove the sync data. See the Clean Database command below.

Use the buttons below the Databases list for more options:

  • Icon
    Import Database: Select a remote database and click to download the data of the database and save it locally. The database will be automatically configured to sync with this location. Alternatively, you can double-click a remote database to import it.
  • Icon
    Synchronize Database: Select a checked database and click to manually sync the database with this location.
  • Icon
    Refresh List: Refreshes the list of remote databases available in the selected location.

The Databases Action menu also contains commands for importing, manually synchronzing, troubleshooting, and removing sync data.

  • Icon
    Import Database: Import a database in an unencrypted state. It is possible to import an encrypted database as an unencrypted one, if the situation warrants it.
  • Icon
    Import Encrypted Database: Import a database as an encrypted database. You will need to specify the maximum database size and an encryption key. This option also can be used when importing an unencrypted database.
  • Icon
    Import Audit-Proof Database: Imports an audit-proof database. This can only be used to import an audit-proof database.
  • Icon
    Verify Database: Used in troubleshooting situations, this quickly verifies the integrity of the sync data of the chosen database. Hold the ⌥ key to select Verify Database Thoroughly.
  • Icon
    Clean Database: Also used in troubleshooting situations, this removes the sync data for the chosen database from the current sync location.
  • Icon
    Refresh List: Manually update the Databases list.

Sync messages: Under each listed database in the Databases list, is a message about its sync state. You will see one of these:

  • Icon
    Not yet synchronized, upload database: This database has never been synced to this location.
  • Icon
    Not yet synchronized, merge with remote database: This database has been synced to this location from another device, but not yet from this Mac.
  • Icon
    Last Synchronization,…: This database has been synced to this location at the time shown.

Sync Options

Sync Options: The settings at the bottom of the pane control the behavior for all active sync locations, from how often to sync to how sync conflicts are handled.

  • Icon
    Synchronize: Choose if you want to synchronize automatically, manually, or in fixed intervals. Check On Quit or Deactivation to automatically synchronize when you quit DEVONthink or when you switch to another application.
  • Icon
    Max. Connections: Choose the maximum number of connections DEVONthink should open. The faster your internet connection the higher you can usually go. The recommended value is 16. Note the maximum number is controlled by the service you're using.
  • Icon
    Conflicts: Choose how to solve the conflict if an item was changed both locally and remotely before either device synced. Use latest document preserves the most recently changed document. Duplicate documents keeps both versions of the conflicting item and appends "copy" to the end of one's filename.

Bonjour Options

Click the button Bonjour Options to control if and how other instances of DEVONthink or DEVONthink To Go can connect to your Mac. Your Mac becomes the sync server, the other devices the clients.

  • Icon
    Enable incoming connections: Allow other devices connect to your copy of DEVONthink and synchronize.
  • Icon
    Open databases automatically: Open a database automatically when a client device requests syncing with an unopened database.
  • Icon
    Port: Set the port number used for incoming connections, if you need to assign a specific port. If not, leave this empty and DEVONthink will choose a random port for you.
  • Icon
    Password: Create a password to be used by client devices needing to connect to this Mac as a server. This password is mandatory. This password also encrypts the client-server connection at all times.

Read more about synchronization