First time setup

This is a walkthrough of the options you will be presented with the first time you start the app. All of these options can be changed later in the settings.

Create new – select this if you do not already use pass or do not have your password store synchronized with git

Clone existing – if your password store is synchronized with git you can clone it

Regardless of which of the above you pick you will be asked for the repository location:

SD-card – put the password store in a folder you specify. You should select this if you use something like bittorrent sync or syncthing to keep a particular folder on your device synchronized

Hidden (preferred) – put the password store in the app’s private folder located on your device’s internal storage http://developer.android.com/guide/topics/data/data-storage.html#filesInternal. This folder is not viewable unless you are rooted

If you selected ‘Clone existing’ at the first step you will be asked for repository information. As you fill it in make sure the resulting URL looks right.

If you then select ssh-key for your authentication mode you will be prompted to either import your private key or generate a key pair.

Tap the ‘Clone’ button and the app will attempt to clone the git repository. This is where problems usually occur. Search https://github.com/zeapo/Android-Password-Store/issues if you encounter a problem. There is a wide range of possible server configurations and the app has to rely on somewhat outdated versions of libraries so it is sometimes difficult to replicate issues, determine if it’s out of the app’s control, etc.

When you try to create or view a password for the first time you will be prompted to select the OpenPGP provider. You should install and set up OpenKeychain https://github.com/open-keychain/open-keychain if you haven’t already. Scroll to the ‘Crypto’ section of the settings and select everything there.

You should now be ready to use the app.