diff --git a/INSTALL.md b/INSTALL.md index 3117cfeb..52e67b4b 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -40,6 +40,11 @@ python bitmessagemain.py VoilĂ ! Bitmessage is updated! #### Linux +_Some recent Linux distributions don't support QT4 anymore, hence PyBitmessage +won't run with a GUI. However, if you build PyBitmessage as a flatpak, it will +run in a sandbox which provides QT4. See the **Linux flatpak** instructions +in the **Creating a package for installation** section of this document._ + To run PyBitmessage from the command-line, you must download the source, then run `src/bitmessagemain.py`. ``` @@ -97,6 +102,27 @@ rpm.sh - create a RPM package slack.sh - create a package for Slackware ``` +#### Linux flatpak +First make sure you have `flatpak` and `flatpak-builder` installed. Follow the +instructions for your distribution on [flathub](https://flatpak.org/setup/). The +instructions there only cover the installation of `flatpak`, but +`flatpak-builder` should be the same. + +Once you have `flatpak` and `flatpak-builder` installed: +``` +git clone git://github.com/Bitmessage/PyBitmessage.git +cd PyBitmessage/ +flatpak-builder --install _flatpak -install-deps-from=flathub --force-clean --user org.bitmessage.PyBitmessage.json +``` +This will install PyBitmessage to your local flatpak user repository, but it +takes a while to compile because QT4 and PyQt4 have to be build, among others. + +When done you can launch PyBitmessage via: +`flatpak run -v org.bitmessage.PyBitmessage` + +If you want to free up disk space you can remove the `Sdk` runtime again: +`flatpak uninstall org.freedesktop.Sdk//18.08` + #### OS X Please refer to [this page](https://bitmessage.org/forum/index.php/topic,2761.0.html) on the