thelinuxvault blog

Installation of KeePassX Password Manager on Fedora Linux

In today’s digital age, managing multiple strong, unique passwords for various online accounts is a critical security practice. Remembering dozens of complex passwords is impractical, which is where password managers come in. KeePassX is a free, open-source password manager that securely stores your passwords in an encrypted database, protected by a single master password. It offers robust encryption, cross-platform compatibility, and a user-friendly interface—making it an excellent choice for Fedora Linux users.

This blog will guide you through installing KeePassX on Fedora Linux using three methods: via the default package manager (DNF), Flatpak, and compiling from source. We’ll also cover post-installation setup and basic usage to help you get started with secure password management.

2026-02

Table of Contents#

  1. What is KeePassXC?
  2. Prerequisites
  3. Installation Methods
  4. Post-Installation Setup
  5. Basic Usage of KeePassXC
  6. Uninstallation
  7. Conclusion
  8. References

What is KeePassXC?#

KeePassXC is a lightweight, open-source password manager built on the Qt framework. It is a community-driven fork of KeePassX, which was originally a port of the Windows-based KeePass Password Safe to Linux and macOS. KeePassXC continues development with active support and new features. Key features include:

  • Encrypted Databases: Passwords are stored in a single database file encrypted with AES (Advanced Encryption Standard) or Twofish algorithms.
  • Master Password Protection: The entire database is locked with one strong master password (or key file) for easy access.
  • Cross-Platform Compatibility: Databases created with KeePassXC can be opened with KeePass (Windows) and other KeePass-compatible tools.
  • Password Generator: Built-in tool to create strong, random passwords.
  • Auto-Type: Automatically enters usernames/passwords into applications/websites, reducing manual input.

Note: The original KeePassX is no longer actively maintained. KeePassXC is the recommended alternative for ongoing support and new features.

Prerequisites#

Before installing KeePassXC, ensure your Fedora system meets these requirements:

  • A Fedora Linux system (tested on Fedora 38/39; older versions may work but are untested).
  • Internet connection (to download packages).
  • sudo privileges (to install system-wide software).

Installation Methods#

Method 1: Install via DNF (Fedora's Default Package Manager)#

Fedora's official DNF repositories include KeePassXC, the actively maintained community-driven fork of KeePassX. This method covers installing KeePassXC via DNF.

Step 1: Update System Packages#

First, update your system to ensure all existing packages are up-to-date (optional but recommended):

sudo dnf update -y

Step 2: Search for KeePassXC#

Verify the keepassxc package exists in Fedora's repos:

sudo dnf search keepassxc

You should see output similar to:

keepassxc.x86_64 : Cross-platform password manager

Step 3: Install KeePassXC#

Install the package with:

sudo dnf install -y keepassxc

Step 4: Verify Installation#

Check if KeePassXC installed correctly:

  • Command Line: Run keepassxc --version to see the installed version: 
    keepassxc --version  
# Output: KeePassXC 2.x.x (or similar)
  • Graphical Interface: Launch KeePassXC from your application menu (e.g., GNOME's Activities → search for "KeePassXC").

Method 2: Install via Flatpak#

Flatpak is a universal package manager that provides sandboxed applications. Use this method if you want the latest KeePassXC version (or if dnf doesn’t have KeePassXC).

Step 1: Install Flatpak (if missing)#

Fedora pre-installs Flatpak, but verify with:

flatpak --version

If missing, install it via dnf:

sudo dnf install -y flatpak

Step 2: Add the Flathub Repository#

Flathub is the largest Flatpak repository. Add it (if not already added):

flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

Step 3: Install KeePassXC via Flatpak#

Install KeePassXC from Flathub:

flatpak install -y flathub org.keepassxc.KeePassXC

Step 4: Launch KeePassXC#

Launch via the command line:

flatpak run org.keepassxc.KeePassXC

Or from your application menu (search for “KeePassXC”).

Method 3: Compile from Source (Advanced)#

For users who specifically need the original KeePassX (though it is no longer maintained) or want custom builds, compile from source.

Step 1: Install Build Dependencies#

KeePassXC requires development tools and libraries. Install them with:

sudo dnf install -y gcc cmake qt5-devel libgcrypt-devel zlib-devel make

Step 2: Download the Source Code#

Download the latest KeePassX source from the official website or GitHub mirrors:

wget https://downloads.sourceforge.net/project/keepassx/keepassx/2.0.3/keepassx-2.0.3-src.tar.bz2

Step 3: Extract and Build#

Extract the source archive and compile:

# Extract the tarball  
tar -xvf keepassx-2.0.3-src.tar.bz2  
cd keepassx-2.0.3  
 
# Configure the build  
cmake -DCMAKE_INSTALL_PREFIX=/usr/local .  
 
# Compile the source  
make -j$(nproc)  # Uses all CPU cores for faster compilation  
 
# Install system-wide  
sudo make install

Step 4: Verify Installation#

Check the version:

keepassx --version  
# Output: KeePassX 2.0.3

Post-Installation Setup#

Once installed, follow these steps to set up your password database:

Step 1: Launch KeePassXC#

Open KeePassXC from your application menu or via keepassxc (DNF/source) or flatpak run org.keepassxc.KeePassXC (Flatpak).

Step 2: Create a New Database#

  • Click File → New Database.
  • Choose a location to save the database file (e.g., ~/Documents/Passwords.kdbx).
  • Set a Master Password: Use a long, unique passphrase (e.g., “CorrectHorseBatteryStaple123!”).
  • (Optional) Use a Key File: For added security, generate a key file (stored separately from the database) and require it to unlock the database.
  • Select Encryption Algorithm: Choose AES (default) or Twofish (both are secure).

Step 3: Customize Database Settings#

Adjust options like database name, description, or compression (under the “Database Settings” tab) before finalizing.

Basic Usage of KeePassXC#

Add a New Password Entry#

  1. In the left pane, select a group (e.g., “Internet” or create a new group with Group → New).
  2. Click Entry → New (or press Ctrl+N).
  3. Fill in details:
    • Title: Name of the entry (e.g., “Gmail”).
    • Username: Your account username/email.
    • Password: Enter manually or use the Generate button to create a strong password.
    • URL: Website/application URL (optional).
    • Notes: Additional details (optional).
  4. Click OK to save.

Generate Strong Passwords#

Use KeePassX’s built-in generator:

  • In the “New Entry” window, click Generate.
  • Adjust length (12–20 characters recommended), and include uppercase, lowercase, numbers, and symbols.
  • Click OK to auto-fill the password field.

Auto-Type Passwords#

To auto-enter credentials into apps/websites:

  1. Select the entry.
  2. Press Ctrl+V (or right-click → Auto-Type).
  3. KeePassX will “type” the username and password into the active window (ensure the cursor is in the username field first).

Uninstallation#

Uninstall via DNF#

sudo dnf remove -y keepassxc

Uninstall via Flatpak#

flatpak uninstall -y org.keepassxc.KeePassXC

Uninstall Source Build#

From the source directory:

cd keepassx-2.0.3  
sudo make uninstall

Conclusion#

KeePassXC is a reliable, open-source password manager for Fedora Linux, offering secure storage and easy access to your credentials. This guide covered installing KeePassXC via DNF and Flatpak, and compiling the original KeePassX from source. With your encrypted database set up, you can safely manage passwords and enhance your digital security.

References#