New to KeePassXC? We have an excellent Getting Started Guide that will get you up and running quickly. If you need help troubleshooting the browser connection, please read the Setup Browser Integration section.
Looking for more comprehensive documentation? This is found in the User Guide. All major features are documented here including Auto-Type, SSH Agent integration, and KeeShare
Build and install instructions, and other technical guides, can be found in the Wiki.
share/wordlistsfolder inside your KeePassXC installation directory and then restarting KeePassXC.
/usr/share/keepassxc, on macOS it's
/Applications/KeePassXC.app/Contents/Resourcesand on Windows
C:\Program Files (x86)\KeePassXCfor 32-bit).
-DWITH_XC_NETWORKING=OFF(see Building KeePassXC).
*.AppImagefile execution permissions:
After that you can execute it either from the terminal or by double clicking it just like any other program.
chmod +x ./KeePassXC-*.AppImage
snapdinstalled. This is primarily Ubuntu, but also Debian, Fedora, OpenSUSE, Arch Linux and many more. For a full list and more information visit snapcraft.io. Note that not all systems that can run Snaps also support confinement via AppArmor.
raw-usbinterface in order to use your YubiKey. Issue the following command from a terminal to enable this interface:
sudo snap connect keepassxc:raw-usb core:raw-usb
/media/into the file open dialog to see them.
/media/directory then you may need to enable this permission in the Ubuntu store. Open the Ubuntu store, choose the KeePassXC app, and click permissions.
ssh-agentis running by default and no further setup is required.
ssh-agentrunning and the SSH_AUTH_SOCK environment variable available for KeePassXC at launch. Arch Linux wiki has a generic guide how to manually run
ssh-agentif it's not already set up. Sometimes other applications like GNOME Keyring or
gpg-agentalready provide a compatible agent that also works with KeePassXC.
OpenSSH Authentication Agent(commonly referred to as
ssh-agent). This process is documented in Microsoft's documentation for user keys.
ssh-keygento modify the comment.
Agent protocol errorif you are using confirm-on-use option for your keys (e.g. set via the environment variable
SSH_ASKPASS_REQUIRE). In that case
ssh-agentneeds to have a
ssh-agentif you are stuck with an older version.
-icommand line option or the
IdentityFiledirective in your OpenSSH config file (
~/.ssh/config) to pass the path to the respective private key file.
IdentityFiledirective, you likely want to use the
IdentitiesOnlydirective, too. The Arch Linux wiki has a generic guide on how to manage multiple keys.
IdentityFiledirective point to a private key file, let it point to your public key file. The SSH Agent will use the provided information to select the correct private key.
PATHvariable inside the Git Bash, e.g.
export PATH="/c/Windows/System32/OpenSSH:$HOME/bin:$PATH"or use the
GIT_SSH_COMMANDenvironment variable (
core.sshCommandin the Git configuration file) to override the path to the SSH binary specifically for Git.