fantomfp/poezio-omemo repository overview

⁠Quick reference

• Maintained by: Matthieu Saulnier a.k.a. Casper
• Sources of the Docker image: here⁠
• Contact (email): fantom at fedoraproject.org
• XMPP: casper at casperlefantom.net

⁠Supported tags and image versioning

• Current version of poezio: 0.14
• Current version of the Docker image: 9
• Timezone by default: fr

Current tag: 0.14-9.fr.x64

⁠Supported image architecture

• x86_64, amd64 (image tagged as x64)
• arm64v8, aarch64

⁠What is Poezio

Poezio is a client for instant messaging⁠. It is running in terminal or TTY console and provides an easy way to connect to Jabber/XMPP servers around the world.

Poezio-OMEMO is an external plugin for Poezio XMPP client.

OMEMO is an extension of the XMPP protocol defined as XEP-0384. It provides multi-end to multi-end encryption, allowing messages to be synchronized securely across multiple clients, even if some of them are offline.

Libraries about cryptography algorithms required by OMEMO are in beta release, security audit is welcome.

⁠How to use this image

Before to pull the image and run the container, follow the checklist:

• Use DNS server custom or not
• Choose your timezone
• Create a directory tree like the following:
• /container/poezio-prod/config
• /container/poezio-prod/data
• /container/poezio-prod/proxychains
• Check if your Linux user is allowed to run "docker run" command with sudo

On GNU/Linux system, launch a new container like this:

docker run -ti -e TERM --dns 192.168.0.1 \
--log-driver none \
-e TZ="Europe/Paris" \
-v /container/poezio-prod/config:/home/poezio-user/.config/poezio:Z \
-v /container/poezio-prod/data:/home/poezio-user/.local/share/poezio:Z \
-v /container/poezio-prod/proxychains:/home/poezio-user/proxychains:Z \
fantomfp/poezio-omemo:0.14-9.fr.x64 /usr/bin/poezio

The container will be stopped when Poezio will be closed. All user datas will be saved and stay available for a new container launched.

Can be launched with Podman too:

$ podman run --userns=keep-id -ti -e TERM --dns 192.168.0.1 \
--log-driver none \
-e TZ="Europe/Paris" \
-v $HOME/podman/poezio-stable/config:/home/poezio-user/.config/poezio:Z \
-v $HOME/podman/poezio-stable/data:/home/poezio-user/.local/share/poezio:Z \
-v $HOME/podman/poezio-stable/proxychains:/home/poezio-user/proxychains:Z \
docker.io/fantomfp/poezio-omemo:0.14-9.fr.x64 /usr/bin/poezio