Running Under Linux - ligos/readablepassphrasegenerator GitHub Wiki
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
)
- 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.
- Install .NET Core for your Linux distribution
-
Download the Console app marked
PassphraseGenerator Console NetCore <version>.zip
and unzip. - Run with
dotnet PassphraseGenerator.dll
.
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
.
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.
This:
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).
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.