Skip to content

Installing Znuny on Debian with Docker

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

  • Debian 11 (Bullseye)
  • Debian 12 (Bookworm)

Older versions (Debian 10) generally work if a current Docker version can be installed.

ComponentMinimumRecommended
CPU2 cores4+ cores
RAM4 GB8 GB or more
Disk20 GB free40 GB+ (SSD)
Docker20.10latest
Docker Composev2latest
Git2.17latest

Step 1: Install Docker, Docker Compose, and Git

Section titled “Step 1: Install Docker, Docker Compose, and Git”

Update package sources and install:

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

[!NOTE] On older Debian versions without the docker-compose-v2 package, install the official Docker repository or use the legacy docker-compose package.

Enable and start Docker:

Terminal window
sudo systemctl enable --now docker

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

Terminal window
sudo usermod -aG docker $USER

Verify:

Terminal window
docker --version
docker compose version

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.

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

Get Znuny professionally installed

Avoid trial and error in production: Softoft handles turnkey Znuny deployment, Docker or bare-metal setup, security hardening, and baseline configuration.

Frequently asked questions

Which Debian versions are supported for installing Znuny with Docker?

Znuny with Docker is officially supported on Debian 11 (Bullseye) and Debian 12 (Bookworm). These versions provide a stable and up-to-date environment for Docker and its components, ensuring compatibility and access to the latest security patches. While older releases like Debian 10 might technically work, it is crucial that a current and compatible Docker version can be successfully installed on them. Using the latest supported Debian versions is always recommended to leverage the most recent features and maintain optimal system security and performance for your Znuny instance.

Quellen / Sources:

What are the minimum system requirements for running Znuny with Docker on Debian?

To ensure a smooth operation of Znuny with Docker on Debian, certain minimum system requirements should be met, with recommended specifications for optimal performance. You will need at least 2 CPU cores, though 4 or more are recommended for heavier workloads. For RAM, a minimum of 4 GB is required, but 8 GB or more is highly recommended, especially for larger installations or multiple concurrent users. Disk space should be at least 20 GB free, with 40 GB or more on an SSD being ideal for better I/O performance. Regarding software, Docker version 20.10 or newer, Docker Compose v2 or newer, and Git version 2.17 or newer are essential. Meeting these requirements ensures your Znuny instance runs efficiently and reliably within its Dockerized environment.

Quellen / Sources:

How do I install Docker, Docker Compose, and Git on Debian for a Znuny deployment?

To prepare your Debian system for a Znuny Docker deployment, you first need to install Docker, Docker Compose, and Git. Begin by updating your package sources with sudo apt update. Then, install the necessary packages using sudo apt install -y docker.io docker-compose-v2 git. For older Debian versions that may not have the docker-compose-v2 package, you might need to install the official Docker repository or use the legacy docker-compose package. After installation, ensure the Docker service is enabled and started by running sudo systemctl enable --now docker. Optionally, to run Docker commands without sudo, add your user to the docker group with sudo usermod -aG docker $USER and then log out and back in. Finally, verify the installations with docker --version and docker compose version.

Quellen / Sources:

What is the "community compose stack" for Znuny, and how do I continue the Znuny installation after setting up Docker?

The "community compose stack" for Znuny refers to a pre-configured Docker Compose project, often maintained by the community, designed to simplify the deployment of Znuny and its dependencies. A prominent example is the Erik-Donath/znuny-docker project, which provides a production-ready setup including Apache2, Cron, the Znuny Daemon, and MariaDB as separate containers. After successfully installing Docker, Docker Compose, and Git on your Debian system, the next step is to proceed with the full stack setup. This typically involves cloning such a community compose project, configuring the MariaDB database, and then running the Znuny web installer, usually accessible at /znuny/installer.pl in your browser. The comprehensive guide for Installing Znuny with Docker Compose will walk you through these steps, including managing volumes, performing updates, and troubleshooting common issues.

Quellen / Sources:

Are there alternative installation methods for Znuny on Debian besides Docker?

Yes, besides the Docker-based installation, there are traditional methods for deploying Znuny on Debian, particularly for production environments on bare metal. For a traditional installation, you would follow the official Znuny installation guide. This approach involves manually setting up a web server like Apache, choosing and configuring a database such as MariaDB, MySQL, PostgreSQL, or Oracle, and installing various required Perl modules. This method offers granular control over each component but requires more manual configuration and maintenance compared to a Dockerized setup. Additionally, while the community compose stack is recommended for Docker, other community-maintained Docker images, such as juanluisbaptiste/znuny, also exist, offering alternative containerization options.

Quellen / Sources: