FAQ

Issues

Can't save a password

• Is folder initialised? Easiest way is to use the [Users] button and make sure you can encrypt for someone (eg. yourself)
• Are you using Git? If not, make sure it is switched off.

I have an issue with GNOME keyring

• Disable GNOME keyring
• Create a ~/.gnupg/gpg-agent.conf containing:

enable-ssh-support
write-env-file
use-standard-socket
default-cache-ttl 600
max-cache-ttl 7200

• See the pass FAQ for more troubleshooting tips.

I don't get a passphrase / PIN dialog

• You'll need to install pinentry-qt (or -gtk) and possibly set the full path to that executable in your ~/.gnupg/gpg-agent.conf for example: pinentry-program /usr/bin/pinentry-qt
• On some systems it might be necessary to create a symbolic link /usr/bin/pinentry to your pinentry application of choice eg: ln -s /usr/bin/pinentry-qt /usr/bin/pinentry
• On macOS pinentry-program /usr/local/bin/pinentry-mac works after installing pinentry-mac from Homebrew.

I have an other issue with gpg

• Possibly you have you key only in gpg and not in gpg2

gpg --export [ID] > public.key
gpg --export-secret-key [ID] > private.key
gpg2 --import public.key
gpg2 --import private.key
rm public.key private.key

Where [ID] is your gpg key-id.

• It might be the case where it is the other way around, exchange gpg and gpg2 accordingly . .

Git doesn't work on Windows

Git for Windows comes with an ssh-askpass compatible command, git-gui--askpass (located in /mingw64/libexec/git-core/git-gui--askpass on PortableGit version, presumably some place similar for the installed version).

Git has issues with GPG SSH Authentication

This tutorial might resolve your issues. https://Github.com/git-for-windows/git/wiki/OpenSSH-Integration-with-Pageant

GPG says "Public key unusable" or "No secret key"

Your GPG key may not be trusted or has expired. Run gpg --edit-key <KEYID> and:

• Set the trust level to "ultimate" (trust command)
• Check if the key has expired (expire command to extend if needed)
• For smartcards/YubiKeys, ensure the card is connected and unlocked

OTP QR codes don't work on macOS

Applications launched from Finder don't inherit the shell PATH. Install QtPass via Homebrew (which sets up PATH correctly) or create a wrapper script that sets PATH before launching QtPass.

QtPass doesn't follow my system language

QtPass uses the system language at startup. On some desktop environments, you may need to launch QtPass from the terminal or configure your desktop environment to pass the correct locale environment variables.

Where is the configuration stored?

QtPass tries to use the native config choice for the OS it's running.

• Linux and BSD: $HOME/.config/IJHack/QtPass.conf
• macOS: $HOME/Library/Preferences/com.IJHack.QtPass.plist
• Windows registry: HKEY_CURRENT_USER\Software\IJhack\QtPass

These settings can be over-ruled by a qtpass.ini file in the folder where the application resides. So called "portable config".

There are some things to take care of when trying to sync on some systems (especially OSX, with regards to text and binary .plist files).

More information: https://doc.qt.io/qt-5/qsettings.html#platform-specific-notes

Where can I ask for help?

• Create an issue issues on GitHub.
• Send an email to help@qtpass.org

Can I import from KeePass, LastPass or X?

• Yes, check passwordstore.org/#migration for more info.

I don't see icons on the buttons

You do not have the Qt SVG library installed. Please install using your favorite package manager.

I get icons that do not fit my (X11) default

• On some WindowManagers, Qt doesn't know what icon set to use. A trick:

export DESKTOP_SESSION=gnome

• Another possible reason is that the currently installed Qt version gives problems. Then you'll have to install the current version via your package manager or download it from https://www.qt.io/download/ and build from source.

I don't like the design, what gives?

• It's all on GitHub, clone, change and send a pull request.
• Open an issue and point out defects or better yet propose changes.

QtPass is not in my native language

• Unfortunately, QtPass might not support your native language, or the translations might be incomplete. Check if newer versions of QtPass support it.
• If translations are available but aren't working, try to set the language manually (see below) or open an issue.

How do I set the language manually?

QtPass uses the system language. Changing it depends on your system:

• on Linux: LANGUAGE=fr qtpass will run QtPass in French.

How can I help improve QtPass?

I would like to donate

• Time:
  • Read contributing documentation.
  • Fork, clone hack and send a pull request.
  • Find an issue to work on..
  • Participate in our bug bounty, you submit an issue and help us fix it, I send you a bounty.
• Money:
  • IJhack takes donations in Bitcoin