Instructions frustratingly incomplete: Switching to OPVault from Agile Keychain

Community Member

I'm trying to switch from Agile Keychain to OPVault, following the incomplete list of hints and observations that don't constitute complete instructions, in the document "Switching to OPVault from Agile Keychain." The first instruction under step 3 says, "To convert existing sync data from Agile Keychain to OPVault, you will need to first disable sync for the vault you wish to convert on the Sync preference pane." The words "disable sync" are shown in bold, as though they constitute some specific, meaningful, and important element of the process. Clicking on those words does nothing to elucidate their meaning, nor the procedure. Going through the One Password Preferences does not reveal "disable sync" under any of the icons, so far as I could see. Do you call these icons "preference panes"? Or does that mean something else? There isn't a "disable sync" option under the Sync icon in the Preferences. Right clicking around on the items and elements in this preference doesn't do anything. There is the option "None" in a dropdown menu. Is that the same as "disable"? Hard to tell. It shares no words with the bolded term "disable sync", so it doesn't seem likely to be the same thing. Nor a reference to "disable sync" in any of the menus for One Password.

Could you possible be referring to a Preference Pane under Apple's System Preferences? Who knows? I couldn't find anything there, either.

To be precise, what I called "the first instruction under step 3" is not really an instruction, it is just a statement. It tells me what I will need to do first. This step doesn't promise to tell me how to do the things that must be done. Earlier in the document, I read that "This article describes how to switch to the OPVault format." Silly me, I focused on the words, "how to switch", and overlooked the statement that this document merely "describes" elements of the process, rather than providing instructions.

I have no doubt that the procedure is perfectly clear for someone who already knows how to do it. But for me, it is very frustrating to be told that something must be done, without listing the steps and procedures to accomplish the task. Perhaps a different document exists, which would provide usable and complete instructions for accomplishing the goal that is merely "described" in this document.

1Password Version: 5.4.1
Extension Version: Not Provided
OS Version: 10.10.5
Sync Type: Dropbox
Referrer: kb:switch-to-opvault


  • Drew_AG
    1Password Alumni

    Hi @Nekoninda,

    I'm very sorry our instructions for switching to OPVault have been so frustrating for you! In Step 3, the reason "disable sync" is in bold is simply to bring attention to the fact that you'll need to do that - but you're right, and I agree that we should have more specific steps there. I've let our documentation team know about that, and hopefully we'll be able to update that with clearer steps soon. I apologize for the inconvenience!

    After you enter the correct Terminal command (as described in Step 2), you can follow these steps to complete the conversion to the OPVault sync format:

    • Open the main 1Password app and go to 1Password > Preferences in the menu bar.
    • Click the Sync tab, choose a vault on the left (you might only have one), then change the sync setting from Dropbox to None.
    • Click the box to Delete data from Dropbox, then click Disable Sync.
    • Change the sync from None to Dropbox.
    • Click the Choose button and select your main Dropbox folder (then click Open).
    • Click Create New to create a new .opvault file in Dropbox/1Password/.
    • Allow Dropbox to fully sync.

    On your other devices, 1Password will give you an error when it realizes the .agilekeychain file for your vault is gone, and you'll need to re-enable Dropbox sync and choose the new .opvault file. If you need the exact steps to do that, please let us know what other devices & versions of 1Password you're using. And of course if you need more help with any of this, we'll be happy to help! :)

This discussion has been closed.