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.

• Use local directory: Use this option to create a new password store on your phone or to use an existing one that was already synchronised.

• Clone from server: Use this option to clone a store from a remote server

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 a third-party git client or any file synchronisation software (e.g. Nextcloud, Google Drive, Dropbox, bittorrent sync, syncthing... etc) to keep a particular folder on your device synchronised. Select this folder using your system's file tree, not through your synchronisation sotware interface.

Hidden (preferred) – put the password store in the app’s private folder located on your device’s internal storage. This folder is not viewable unless you are rooted

If you selected ‘Clone from server’ 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. Search our issue tracker if you encounter a problem in this step. 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 if you haven’t already. Scroll to the ‘Crypto’ section of the settings and select your OpenPGP provider and GPG key.

You should now be ready to use the app!