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 KeePassX?
  2. Prerequisites
  3. Installation Methods
  4. Post-Installation Setup
  5. Basic Usage of KeePassX
  6. Uninstallation
  7. Conclusion
  8. References

What is KeePassX?#

KeePassX is a lightweight, open-source password manager built on the Qt framework. It was originally a port of the Windows-based KeePass Password Safe to Linux and macOS, but it has since evolved into a standalone tool. 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 KeePassX 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: KeePassX is no longer actively maintained. The community-driven fork KeePassXC is the recommended alternative for ongoing support and new features. However, this guide focuses on KeePassX as requested.

Prerequisites#

Before installing KeePassX, 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)#

The easiest way to install KeePassX on Fedora is via the dnf package manager, as it’s available in Fedora’s official repositories.

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 KeePassX#

Verify the keepassx package exists in Fedora’s repos:

sudo dnf search keepassx

You should see output similar to:

keepassx.x86_64 : Cross-platform password manager

Step 3: Install KeePassX#

Install the package with:

sudo dnf install -y keepassx

Step 4: Verify Installation#

Check if KeePassX installed correctly:

  • Command Line: Run keepassx --version to see the installed version: 
    keepassx --version  
# Output: KeePassX 2.0.3 (or similar)
  • Graphical Interface: Launch KeePassX from your application menu (e.g., GNOME’s Activities → search for “KeePassX”).

Method 2: Install via Flatpak#

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

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 KeePassX via Flatpak#

Install KeePassX from Flathub:

flatpak install -y flathub org.keepassx.KeePassX

Step 4: Launch KeePassX#

Launch via the command line:

flatpak run org.keepassx.KeePassX

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

Method 3: Compile from Source (Advanced)#

For users who want the latest (unofficial) KeePassX version or need custom builds, compile from source.

Step 1: Install Build Dependencies#

KeePassX 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 (unofficial 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 KeePassX#

Open KeePassX from your application menu or via keepassx (DNF/source) or flatpak run org.keepassx.KeePassX (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 KeePassX#

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 keepassx

Uninstall via Flatpak#

flatpak uninstall -y org.keepassx.KeePassX

Uninstall Source Build#

From the source directory:

cd keepassx-2.0.3  
sudo make uninstall

Conclusion#

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

References#