Linux Client

Discover how Pleasant Password Server will enhance KeePass for business.

Pleasant Passwords now supports all of these client apps in Linux environments:

Web app
KeePass for Pleasant Passwords (with Wine or Mono)
Linux Desktop client app (universal app)
Auto-filler Browser extension

Download Linux Desktop Client (Universal app)

(versions 9.0.2+)

The Linux Client is available for download from Client Downloads in the web browser client app.

Same features as the mobile app,
But many less features than the KeePass for Pleasant desktop app for Linux.

Additional features and changes are ongoing. Please let us know which features you would like to see next as this client continues to evolve!

Download KeePass Desktop - for Linux

(versions 9.5.2+)

Setup Instructions

Select your distribution below, then choose a runtime. We recommend Wine + .NET Framework for most users — it avoids a number of rendering quirks present under Mono. Mono is a fully supported alternative if you'd rather avoid Wine.

Distribution

Runtime

Debian — Wine + .NET Framework

Install Wine and the real Microsoft .NET Framework via winetricks:

sudo dpkg --add-architecture i386
sudo apt update
sudo apt install wine wine32:i386 winetricks
winetricks dotnet48

Expect a lot of terminal output during this step: winetricks dotnet48 commonly prints many warnings/errors while it runs — that's normal. As long as it doesn't report the overall install as failed, you're good.

If winetricks isn't found: Debian's default installer only enables the main repository component. Add contrib to each deb/deb-src line in /etc/apt/sources.list, then run sudo apt update and retry.

If anything prompts you to install Wine Mono, decline it — this app requires the real .NET Framework installed above, not Wine's built-in Mono runtime.

Download KeePass for Pleasant from Client Downloads (the file is named Pleasant KeePass Client.exe), then run it through Wine to install it:

wine "Pleasant KeePass Client.exe"

Install this only after winetricks dotnet48 above: the installer needs .NET Framework 4.8 to run at all and will fail if it's not already present.

The installer shows a wizard-style interface, but doesn't offer any configurable options — just click through it. It installs to:

~/.wine/drive_c/Program Files/Pleasant Solutions/KeePass for Pleasant Password Server/

To add a desktop launcher, create ~/.local/share/applications/KeePass for Pleasant Password Server.desktop containing:

[Desktop Entry]
Name=KeePass for Pleasant Password Server
Exec=sh -c 'wine "$HOME/.wine/drive_c/Program Files/Pleasant Solutions/KeePass for Pleasant Password Server/KeePass.exe"'
Type=Application

KDE clipboard history note: On KDE Plasma with Klipper enabled, a copied password may briefly remain visible in Klipper's clipboard history even after KeePass's auto-clear timeout. The app already asks Klipper to exclude passwords from its history, but not every Plasma version honors this. If this matters to you, disable Klipper (right-click its system tray icon → Quit) or clear its history manually.

Debian — Mono

Install Mono:

sudo apt install mono-complete

Install KeePass for Pleasant on a Windows machine, then copy the installed files to a folder on this machine, for example /opt/keepass/. By default it installs to C:\Program Files\Pleasant Solutions\KeePass for Pleasant Password Server\ on Windows.

To add a desktop launcher, create ~/.local/share/applications/KeePass for Pleasant Password Server.desktop containing:

[Desktop Entry]
Name=KeePass for Pleasant Password Server
Exec=mono "/opt/keepass/KeePass.exe"
Type=Application

Rendering quirks under Mono: Some dialogs may show blank buttons (the text doesn't render, but the buttons still work in their usual position/order), the desktop theme may apply inconsistently, and the system tray icon's presentation depends on your desktop environment. These are known Mono/WinForms limitations, not specific to this app.

Ubuntu — Wine + .NET Framework

Install Wine and the real Microsoft .NET Framework via winetricks:

sudo dpkg --add-architecture i386
sudo apt update
sudo apt install wine wine32:i386 winetricks
winetricks dotnet48

(Ubuntu's standard desktop ISO already enables the universe repository component, so no extra repository step is needed here.)

If anything prompts you to install Wine Mono, decline it — this app requires the real .NET Framework installed above, not Wine's built-in Mono runtime.

Download KeePass for Pleasant from Client Downloads (the file is named Pleasant KeePass Client.exe), then run it through Wine to install it:

wine "Pleasant KeePass Client.exe"

Install this only after winetricks dotnet48 above: the installer needs .NET Framework 4.8 to run at all and will fail if it's not already present.

The installer shows a wizard-style interface, but doesn't offer any configurable options — just click through it. It installs to:

~/.wine/drive_c/Program Files/Pleasant Solutions/KeePass for Pleasant Password Server/

To add a desktop launcher, create ~/.local/share/applications/KeePass for Pleasant Password Server.desktop containing:

[Desktop Entry]
Name=KeePass for Pleasant Password Server
Exec=sh -c 'wine "$HOME/.wine/drive_c/Program Files/Pleasant Solutions/KeePass for Pleasant Password Server/KeePass.exe"'
Type=Application

Ubuntu — Mono

Install Mono:

sudo apt install mono-complete

To add a desktop launcher, create ~/.local/share/applications/KeePass for Pleasant Password Server.desktop containing:

[Desktop Entry]
Name=KeePass for Pleasant Password Server
Exec=mono "/opt/keepass/KeePass.exe"
Type=Application

Rendering quirks under Mono: Some dialogs may show blank buttons (the text doesn't render, but the buttons still work in their usual position/order), the desktop theme is generally ignored, and the system tray icon may not appear at all depending on your desktop environment. These are known Mono/WinForms limitations, not specific to this app.

Fedora — Wine + .NET Framework

Install Wine and the real Microsoft .NET Framework via winetricks:

sudo dnf install wine wine.i686 winetricks
winetricks dotnet48

Note: Fedora's wine package installs Wine Mono automatically as a dependency — that's fine and expected. Just make sure you also run the winetricks dotnet48 command above; this app needs the real .NET Framework, not Wine Mono, to work correctly.

Download KeePass for Pleasant from Client Downloads (the file is named Pleasant KeePass Client.exe), then run it through Wine to install it:

wine "Pleasant KeePass Client.exe"

Install this only after winetricks dotnet48 above: the installer needs .NET Framework 4.8 to run at all and will fail if it's not already present.

The installer shows a wizard-style interface, but doesn't offer any configurable options — just click through it. It installs to:

~/.wine/drive_c/Program Files/Pleasant Solutions/KeePass for Pleasant Password Server/

To add a desktop launcher, create ~/.local/share/applications/KeePass for Pleasant Password Server.desktop containing:

[Desktop Entry]
Name=KeePass for Pleasant Password Server
Exec=sh -c 'wine "$HOME/.wine/drive_c/Program Files/Pleasant Solutions/KeePass for Pleasant Password Server/KeePass.exe"'
Type=Application

Tip: if the login browser fails to open on a completely fresh system (Firefox not already running), use the login window's Copy Link button and paste the URL into a manually-opened browser instead.

Fedora — Mono

Install Mono:

sudo dnf install mono-complete

To add a desktop launcher, create ~/.local/share/applications/KeePass for Pleasant Password Server.desktop containing:

[Desktop Entry]
Name=KeePass for Pleasant Password Server
Exec=mono "/opt/keepass/KeePass.exe"
Type=Application

Rendering quirks under Mono: Some dialogs may show blank buttons (the text doesn't render, but the buttons still work in their usual position/order), the whole application may render larger than expected, and on GNOME the system tray icon typically doesn't appear at all. These are known Mono/WinForms limitations, not specific to this app.

Arch — Wine + .NET Framework

Make sure the multilib repository is enabled (uncomment the [multilib] section in /etc/pacman.conf if it isn't already), then install Wine and winetricks:

sudo pacman -Syu
sudo pacman -S wine winetricks
winetricks dotnet48

If winetricks dotnet48 fails the first time (e.g. a ShellExecuteEx failed error), delete the Wine prefix and try again — this has been seen to resolve on a clean retry:

rm -rf ~/.wine
winetricks dotnet48

Download KeePass for Pleasant from Client Downloads (the file is named Pleasant KeePass Client.exe), then run it through Wine to install it:

wine "Pleasant KeePass Client.exe"

Install this only after winetricks dotnet48 above: the installer needs .NET Framework 4.8 to run at all and will fail if it's not already present.

The installer shows a wizard-style interface, but doesn't offer any configurable options — just click through it. It installs to:

~/.wine/drive_c/Program Files/Pleasant Solutions/KeePass for Pleasant Password Server/

To add a desktop launcher, create ~/.local/share/applications/KeePass for Pleasant Password Server.desktop containing:

[Desktop Entry]
Name=KeePass for Pleasant Password Server
Exec=sh -c 'wine "$HOME/.wine/drive_c/Program Files/Pleasant Solutions/KeePass for Pleasant Password Server/KeePass.exe"'
Type=Application

KDE clipboard history: On a current KDE Plasma release, Klipper correctly excludes copied passwords from its clipboard history — no extra configuration needed.

Arch — Mono

Install Mono:

sudo pacman -S mono

No additional packages are needed — confirmed working as-is.

To add a desktop launcher, create ~/.local/share/applications/KeePass for Pleasant Password Server.desktop containing:

[Desktop Entry]
Name=KeePass for Pleasant Password Server
Exec=mono "/opt/keepass/KeePass.exe"
Type=Application

Rendering quirks under Mono: Some dialogs may show blank buttons (the text doesn't render, but the buttons still work in their usual position/order), and the desktop theme's behavior may vary by distribution/Plasma version — these are known Mono/WinForms limitations, not specific to this app.

Known Limitations

These apply on Linux regardless of which distribution or runtime you choose:

Auto-type and global keyboard shortcuts are not currently supported.
System tray icon presentation varies by desktop environment — it generally works well on KDE, and may render differently or not appear at all on some GNOME setups.
openSUSE Leap 16.0 is not currently supported — it doesn't ship native 32-bit runtime libraries (needed by Wine), and no official Mono package has been built for this release yet. This is a distribution packaging gap rather than a permanent limitation, since Leap 16.0 is a very recent release (October 2025); we'll revisit as its packaging ecosystem matures.