Installation

Containers

A container is built on every push to the git repository and uploaded to the codeberg package registry.

docker run codeberg.org/slidge/slidge-whatsapp  # works with podman too

Use the :latest-amd64 tag for the latest release, :vX.X.X-amd64 for release X.X.X, and :main-amd64 for the bleeding edge. -arm64 images are also available.

Python packages

PyPI package version

slidge-whatsapp is available on the python package index (PyPI).

If you are not familiar with python packaging, we recommend using pipx to set up slidge-whatsapp and its dependencies, isolated from the rest of your system.

# for the latest stable release published to PyPI, if any
pipx install slidge-whatsapp

slidge-whatsapp --help

Bleeding edge versions are also available on codeberg’s python index.

# for the bleeding edge
pipx install slidge-whatsapp \
    --pip-args='--extra-index-url https://codeberg.org/api/packages/slidge/pypi/simple/ --pre'

Unofficial debian package

If you are using debian you might be interested in installing the slidge (unofficial) debian package which bundles slidge-whatsapp along with other slidge-based XMPP gateways.

Follow the instructions in the repository README; edit /etc/slidge/conf.d/common.conf and /etc/slidge/whatsapp.conf; run sudo systemctl start slidge@whatsapp; watch the logs with sudo journalctl -u slidge@whatsapp -f.