Running Under Linux - ligos/readablepassphrasegenerator GitHub Wiki

Running Under *nix

The Readable Passphrase Generator has been tested under Linux using Mono and .NET Core.

It should work anywhere Mono 2.10 or newer is available, OR where .NET Core 2.1 or newer is available.

The plugin and console app are supported under Mono, but just the console app is supported with .NET Core. The core ReadablePassphrase.dll library is a .NET Standard library and is available on NuGet; Linux developers can reference it as they need.

Important If you run into problems running under Linux with Mono, make sure you have the full Mono framework installed (eg: apt-get install mono-complete)

Screenshot Running In Ubuntu 16.04

Screenshot Running The Console App

Screenshot Running The Console App on Debian 9 on WSL

How-to - KeePass Plugin

  • Install the full mono developer toolkit
    • sudo apt-get install mono-complete
    • The Mono runtime is installed by default, but you need all the developer components to use KeePass plgx plugins
  • Copy the plugin to your KeePass folder as root (or you will get write permissions errors)
    • sudo cp /home/username/downloads/ReadablePassphrase.plgx /usr/lib/keepass2
  • OR, make sure you run a root-permission file manager when copying, eg: gksudo nautilus

Thanks to Phil for some additional pointers here.

How-to - Console App (.NET Core)

Your Plugin is Incompatible!

Your Plugin is Incompatible

Sorry, KeePass is lying here.

If you get an error from KeePass saying your plugin is incompatible, make sure you install the full mono developer kit. That is, run sudo apt-get install mono-complete.

Caveat Time

I'm a Windows guy. I developed the plugin under Windows, in Visual Studio. And I'm proud of that. Once, long long ago, in a galaxy far away, I was a Linux guy. I compiled kernals, mastered vi by trial and error, and wrote multithreaded C programs for Solaris using real Sun hardware (back before Sun went out of business). But those days are long gone.

I really don't know what I'm doing in the Unix world. And I'm painfully aware of that.

That the plugin works at all is a testament to the Mono and .NET Core developers. So I'd gladly take the advice of any Unix or Linux developer if I'm wrong about, well, anything I say here.

What Goes Wrong

This:

Incorrect Mono Packages Error

If you just apt-get install keepass2 in Ubuntu, KeePass will work, but plugins won't (specifically the new plgx ones). For whatever reason, KeePass's package does not have the right Mono dependencies to compile plgx plugins (well, at least my one).

If you try to run Readable Passphrase Generator under Linux and get the generic "Your plugin is not compatible" error, it's a lie. I love KeePass, but its telling terrible lies here.

If you re-run KeePass in debug mode (mono /path/to/KeePass.exe --debug), it will tell you the actual error. And if it looks like the one above, you can fix it by installing all of Mono like so:

sudo apt-get install mono-complete

Of course, if you have a different error, go file a bug report.

I'm sure you don't actually need all of Mono to make the plugin work correctly. But I can't untangle the long list of sub-packages which combine to make Mono (well, actually I just don't have the time), and I know installing everything works. So install it all and forget about it. If you do know the exact packages you need to install to make plgx files work, please Contact Me (and go tell the KeePass developers too, so they can correct their package dependencies).

But I Don't Use Ubuntu! (or a Debian based distribution)

Sorry, I can't help you.

If you can figure out how to get you distribution to install Mono, you should be able to download KeePass and run mono KeePass.exe. Its all about getting a recent version of Mono on your system.

If you do manage to get Readable Passphrase Generator running under RedHat or Slackware or your Rasberry Pi or whatever, please contact me to let me know and I'll update this page.

⚠️ **GitHub.com Fallback** ⚠️