1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
# Install Gajim via Flatpak
## Install pre-built version
Make sure to follow the [setup guide](https://flatpak.org/setup/) before installing.
*Note: Remove `--user` if you want a system-wide installation.*
For file system access (e.g. for sending files), you may need to install additional 'xdg-desktop-portals'. Some examples:
* xdg-desktop-portal
* xdg-desktop-portal-kde
* xdg-desktop-portal-gtk
* xdg-desktop-portal-gnome
### Stable
```bash
flatpak install --user https://flathub.org/repo/appstream/org.gajim.Gajim.flatpakref
```
### Nightly/master
```bash
flatpak install --user https://ftp.gajim.org/flatpak/appstream/org.gajim.Gajim.Devel.flatpakref
```
[Migrate your profile data](#migrate-your-data) if you like.
### Install plugins
To list available stable/nightly plugins, run
```bash
flatpak search gajim.plugin
```
or
```bash
flatpak remote-ls gajim-nightly
```
respectively.
To install the stable/nightly version of PGP, for example, run
```bash
flatpak install --user flathub org.gajim.Gajim.Plugin.pgp
```
or
```bash
flatpak install --user gajim-nightly org.gajim.Gajim.Devel.Plugin.pgp
```
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.
```bash
git clone --recurse-submodules 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.
- Remove `--user` if you want a system-wide installation.
- Replace `org.gajim.Gajim.yaml` with `org.gajim.Gajim.Devel.yaml` if you want to build the current master branch
```bash
flatpak --user remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak-builder --user --repo=gajim_flatpak_repo --install-deps-from=flathub --force-clean ~/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](#migrate-your-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.
```bash
cd ~/Gajim
git pull --rebase
```
### Install and update Gajim
```bash
flatpak-builder --repo=gajim_flatpak_repo --force-clean ~/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`
## Usage with custom installed CAs or self signed certs
Gajims HTTP library uses OpenSSL as TLS backend. It cannot see installed self signed certs or CAs on the host. To make them available use `flatpak override`.
e.g `flatpak override --user --filesystem=host-etc:ro --env=SSL_CERT_FILE=/run/host/etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem org.gajim.Gajim`
|
