Install Gajim via Flatpak

Install pre-built version

Make sure to follow the setup guide before installing.

Note: Remove --user if you want a system-wide installation.

Stable

flatpak install --user https://flathub.org/repo/appstream/org.gajim.Gajim.flatpakref

Nightly/master

flatpak install --user https://ftp.gajim.org/flatpak/appstream/org.gajim.Gajim.Devel.flatpakref

Migrate your profile data if you like.

Install plugins

To list available stable/nightly plugins, run

flatpak search gajim.plugin

or

flatpak remote-ls gajim-nightly

respectively.

To install the stable/nightly version of OMEMO, for example, run

flatpak install --user flathub org.gajim.Gajim.Plugin.omemo

or

flatpak install --user gajim-nightly org.gajim.Gajim.Devel.Plugin.omemo

respectively.

Note that you need to restart Gajim for Plugins to be enabled.

Install from source

Prerequisites:

You need to have flatpak and flatpak-builder installed. For this example, we use git for downloading/updating Gajim's sources.

Download Gajim's sources

In this example, we do a git clone of the repository, so you need to have git installed. Alternatively, you can also download the sources from our Gitlab via web browser.

git clone https://dev.gajim.org/gajim/gajim.git ~/Gajim
cd ~/Gajim

Note: Source tarballs and snapshots do not include 'org.gajim.Gajim.yaml', which is necessary for installation via Flatpak.

Install Gajim and dependencies

Replace install path ~/Gajim/gajim_flatpak with an install path of your choice.

Note: Remove --user if you want a system-wide installation.

flatpak --user remote-add --from gnome https://sdk.gnome.org/gnome.flatpakrepo
flatpak --user install gnome org.gnome.Platform//3.34
flatpak --user install gnome org.gnome.Sdk//3.34
flatpak-builder --repo=gajim_flatpak_repo ~/Gajim/gajim_flatpak ~/Gajim/flatpak/org.gajim.Gajim.yaml
flatpak --user remote-add --no-gpg-verify gajim_flatpak_repo gajim_flatpak_repo
flatpak --user install gajim_flatpak_repo org.gajim.Gajim
flatpak run org.gajim.Gajim

That's it, you are now running Gajim via Flatpak!

Migrate your profile data if you like.

How to update

Update Gajim's sources

In this example, we use git to update the repository. You can also download the sources from our Gitlab via webbrowser.

cd ~/Gajim
git pull --rebase

Remove previous Flatpak directory

rm -r ~/Gajim/gajim_flatpak

Install and update Gajim

flatpak-builder --repo=gajim_flatpak_repo ~/Gajim/gajim_flatpak ~/Gajim/flatpak/org.gajim.Gajim.yaml
flatpak --user update
flatpak run org.gajim.Gajim

Gajim is now updated.

Migrate your data

When switching to Flatpak you might want to migrate your user data (accounts, history, ...) from your previous installation. Just copy your user data from/to the following directories:

Copy .local/share/gajim -> .var/app/org.gajim.Gajim/data/gajim

Copy .config/gajim -> .var/app/org.gajim.Gajim/config/gajim