Prerequisites

Before using QtPass, you need:

Step 1: Install QtPass

Download QtPass for your platform:

Step 2: Configure QtPass

On first launch, QtPass opens the configuration dialog. Key settings:

Click OK to save, then click Initialize to create a new password store.

Step 3: Initialize Your Password Store

QtPass needs a password store to work with. You have two options:

Option A: Create a new store

  1. Click the Initialize button in QtPass
  2. Select your GPG key(s) for encryption
  3. Choose where to store your passwords (default: ~/.password-store)

Option B: Use existing store

  1. If you already use pass, just point QtPass to your existing store
  2. Go to Config and set the password store directory

Step 4: Add Your First Password

  1. Click the + button or press Ctrl+N
  2. Enter a name (e.g., github.com)
  3. Add your password and any other details (username, URL, notes)
  4. Click Save

Step 5: Copy Password to Clipboard

  1. Select the password entry in the list
  2. Press Ctrl+C or click the copy button
  3. The password is copied and will auto-clear after configurable seconds

Step 6: Sync Across Devices (Optional)

QtPass works great with Git for syncing your password store:

  1. Initialize a Git repository in your password store
  2. Add a remote (GitHub, GitLab, self-hosted, etc.)
  3. QtPass can automatically push/pull changes

Next Steps

Learn more about QtPass features in the Advanced Usage guide, including: