Fork me on GitHub

Contents

Installation

UPM can installed from the Android Market.

Creating a New Database

The first time you start UPM (or after deleting your database) you'll be presented with the New Database screen.

Click on Create New Database. (See also Restore Database From Backup, Retrieve from HTTP Location, Retrieve from Dropbox).

The next screen will ask for the master password you'd like to use to encrypt your password database. Choose this password carefully. It should be memorable but obviously not so memorable that someone could guess it. If you forget this password there's absolutely no way of opening your database. UPM uses the most seucre encryption available, AES.

Having entered your master password click on the Create. You'll then be presented with the accounts screen which at this point will be empty.

Retrieving a Database From Dropbox

On the "New Database" screen select "Retrieve From Dropbox". If you haven't already done so you'll be prompted to authorise UPM to access your Dropbox account. UPM will only have access to one folder in your account, /Apps/UPM/.

Having authorised UPM you'll be presented with a list of UPM database files saved in your Dropbox account. The files are read from the folder <Dropbox Root>/Apps/UPM/.

The file you select will be downloaded and saved locally. You can keep the local file in sync with the version in Dropbox using Menu -> Sync.

Adding an Account

From the accounts screen click Menu -> Add.

Click Save after entering all the account details.

Opening an Account

To open an account simply select the account name on the Accounts screen.

Editing an Account

There are two ways of editing an account.

Option 1

  1. Open the account by selecting it on the accounts screen.
  2. On the Account Details screen select Menu -> Edit

Option 2

  1. Long click the account on the accounts screen.
  2. Select Edit Account.

Regardless of how you open it the Edit screen looks like this,

When you're finished editing click Save.

Deleting an Account

  1. Open the account from the Acccount list screen
  2. Select Menu -> Delete
  3. Select Yes to confirm deletion

Database Syncing

Sync Using Dropbox

If you have a database on your Android device and you'd like to save it to Dropbox follow these steps,

  1. Select Menu -> Preferences
  2. Under Sync Settings select Sync Method
  3. Select Dropbox
  4. Hit Back to exit Settings and get back to the application
  5. Select Menu -> Sync
If you've not already done so you'll be requested to authorise the UPM application. UPM will only have access to one folder in your Dropbox account, /Apps/UPM/. This folder is created and your database saved there.

If you already have a UPM database on Dropbox see Retrieving a Database From Dropbox.

Sync Using a HTTP Server

See Database Syncing for an overview of this feature and instructions on how to setup your server.

At the outset, there are generally two scenarios you can find yourself in terms of syncing. The first is where you have a password database on your android device that you'd like to upload to your server and make available for syncing to other devices. The second is where there's a password database already on your server and you'd like to sync it to your device.

1. Uploading a database

  1. Select Menu -> Preferences
  2. Select URL, enter the URL where you placed the UPM server files, e.g. https://www.mydomain.co/upm and select OK
  3. If the server location is protected with Basic Authentication then you'll need to provide a username and password. If you haven't already done so add an account with the required username and password. Come back to Preferences, select HTTP Authentication Account and select the appropiate account.
  4. If the URL you're storing your database at uses HTTPS you may recieve this error when you try and sync, "javax.net.ssl.SSLException: Not trusted server certificate". If so then see the section How to Add a Trusted HTTPS Certificate.

2. Downloading a database

  1. Select Menu -> Preferences
  2. The option to download a remote database is available on the same screen from where you create a new database. If you've already got a database you'll need to delete it (Menu -> More -> Delete Database).
  3. Select "Retrieve From HTTP Location" on the New Database screen.
  4. Enter the full URL to your database, e.g. https://www.mydomain.com/upm/upm.db
  5. If the URL uses Basic Authentication enter the User Id and Password.
  6. Click Download
  7. If the database is successfully downloaded you'll be presented with the Enter Master Password screen.

Backup

UPM stores your password database in an area that's inaccessible to other applications. It's referred to as Internal Storage. As a consequence, if UPM is uninstalled or your phone is reset your password database will be deleted. For this reason it's extremely important that you backup regularly.
  1. Open your database
  2. Select Menu -> More -> Backup
Your database will be copied to your SD card with the name upm.db.

Restore

If you've just installed UPM and haven't created a database yet you can restore a version that you backed up previously. On the New Database screen select Restore Database From Backup. This will restore the database named upm.db from your SD card.

If you've already got a database open you can restore a previously backed up version. This will replace the currently open database with the database named upm.db on your SD card. Select Menu -> More -> Restore.

Preferences

How to Add a Trusted HTTPS Certificate

If you use a HTTPS URL for your remote database and the server is using a self signed certificate you may get this error when you attempt to sync, javax.net.ssl.SSLException: Not trusted server certificate. What you need to do is import the server's certificate into UPM so that it knows it can be trusted. Here's how.

Extract a copy of your password database from an Android device

The Backup menu option will copy your password database to your device's SD card. You should do this on a regular basis in case your phone becomes inoperable.

If it happens that you can't access UPM for some reason and you don't have a backup of your database all is not lost. It's still possible to extract the database using adb, one of the Android developer tools. The only cavet to this is that your device must be rooted.

NOTE: These instructions only work on rooted devices

  1. Install adb. Try this guide
  2. If you haven't already done so connect your phone to your PC using your USB cable
  3. Open a command line and execute 'adb pull /data/data/com.u17od.upm/files/upm.db'

You should now have the file upm.db on your PC. This is the encrypted UPM database containing all your usernames and passwords. You can open it using the desktop version of UPM and/or use the Restore menu option using UPM for Android.

I've performed a Factory Reset of my phone. Can I get my password database back?

Not unless you have a backup (see Backup). A factory reset wipes everything on your phone.

How can I transfer my password database to a new device

Usually it should be just a matter of backing up on your old device, moving your SD card to your new device, and restoring your database.

Sometimes the restore step will give the error "the file to restore from doesn't exist: /mnt/sdcard/upm.db". UPM looks for the database file (upm.db) in the ExternalStorageDirectory. This is usually the root directory of your SD card but some devices put it in a sub directory (sometimes called 'data').

To figure out where UPM is looking for your database file try creating a database and backing it up. Have a look on your SD card to see where the file upm.db was written. Replace this file with upm.db from your old device. You should be able to restore it now.