Installing Znuny on Ubuntu with Docker

This guide installs Docker and Docker Compose on Ubuntu so you can run Znuny using the Docker Compose installation.

Supported Ubuntu versions

• Ubuntu 20.04 LTS
• Ubuntu 22.04 LTS
• Ubuntu 24.04 LTS

Newer releases generally work if a current Docker version is available.

System requirements

Component	Minimum	Recommended
CPU	2 cores	4+ cores
RAM	4 GB	8 GB or more
Disk	20 GB free	40 GB+ (SSD)
Docker	20.10	latest
Docker Compose	v2	latest
Git	2.17	latest

Step 1: Install Docker, Docker Compose, and Git

Update package sources and install:

sudo apt update
sudo apt install -y docker.io docker-compose-v2 git

[!NOTE] The docker-compose-v2 package is available from Ubuntu 22.04 onwards. On older versions, install the official Docker repository or use the legacy docker-compose package.

Enable and start Docker:

sudo systemctl enable --now docker

Optional — run Docker without sudo (log out and back in afterwards):

sudo usermod -aG docker $USER

Verify:

docker --version
docker compose version

Step 2: Install Znuny

Continue with the full stack setup:

Installing Znuny with Docker Compose

That guide clones a community compose project, configures MariaDB, runs the web installer at /znuny/installer.pl, and covers volumes, updates, and troubleshooting.

Traditional installation (without Docker)

For production on bare metal, follow the official Znuny installation guide for Apache, MariaDB, and Perl modules on Ubuntu.

Frequently asked questions

Which Ubuntu versions are supported for Znuny with Docker?

Ubuntu 20.04 LTS, 22.04 LTS, and 24.04 LTS are supported. Newer releases generally work if a current Docker version is available.

How do I install Docker Compose on Ubuntu for Znuny?

Use apt to install docker.io, docker-compose-v2, and git, then enable the Docker service. On Ubuntu 20.04 you may need the official Docker repository or the legacy docker-compose package.