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.
This guide installs Docker and Docker Compose on Ubuntu so you can run Znuny using the Docker Compose installation.
Newer releases generally work if a current Docker version is available.
| 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 |
Update package sources and install:
sudo apt updatesudo apt install -y docker.io docker-compose-v2 git[!NOTE] The
docker-compose-v2package is available from Ubuntu 22.04 onwards. On older versions, install the official Docker repository or use the legacydocker-composepackage.
Enable and start Docker:
sudo systemctl enable --now dockerOptional — run Docker without sudo (log out and back in afterwards):
sudo usermod -aG docker $USERVerify:
docker --versiondocker compose versionContinue 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 Ubuntu.
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.
The guide officially supports Ubuntu 20.04 LTS, 22.04 LTS, and 24.04 LTS for installing Znuny with Docker. While newer releases may work, compatibility is generally ensured if a current and stable Docker version is available for that specific Ubuntu release. It's always recommended to use Long Term Support (LTS) versions for production environments due to their extended support and stability, offering a predictable update cycle and long-term maintenance. This ensures a more reliable and secure foundation for your Znuny instance.
To install Docker and Docker Compose on Ubuntu, you should first update your package sources using sudo apt update. Then, install the necessary packages with sudo apt install -y docker.io docker-compose-v2 git. The docker-compose-v2 package is recommended and available from Ubuntu 22.04 onwards. For Ubuntu 20.04 or older versions, you might need to install the official Docker repository or use the legacy docker-compose package. After installation, enable and start the Docker service using sudo systemctl enable --now docker to ensure it runs automatically on boot and is active.
For running Znuny with Docker on Ubuntu, the minimum system requirements include a 2-core CPU, 4 GB of RAM, and 20 GB of free disk space. It's also essential to have Docker version 20.10 or newer, Docker Compose v2, and Git 2.17 or newer. For optimal performance, especially in production or high-load environments, the recommended specifications are a 4+ core CPU, 8 GB or more of RAM, and 40 GB+ of SSD disk space. Using the latest stable versions of Docker, Docker Compose, and Git is always advised for the best experience, security, and access to the newest features.
Once Docker, Docker Compose, and Git are successfully installed and verified on your Ubuntu system, the next step is to proceed with the full Znuny stack setup using Docker Compose. This involves cloning a community Docker Compose project, which provides the necessary configuration files for Znuny and its dependencies. You will then configure the MariaDB database, and subsequently run the Znuny web installer, typically accessible at /znuny/installer.pl through your web browser. The comprehensive guide for this process also covers important aspects like managing Docker volumes for data persistence, updating your Znuny instance, and troubleshooting common issues that may arise during deployment.
By default, Docker commands require sudo privileges for security reasons, as they interact directly with the Docker daemon. To run Docker commands as a non-root user without sudo, you need to add your user to the docker group. This can be done by executing the command sudo usermod -aG docker $USER. After running this command, it is crucial to log out of your current session and log back in for the changes to take effect. This action grants your user the necessary permissions to interact with the Docker daemon directly, improving convenience for development and administrative tasks, but also requires careful consideration of security implications.
A traditional installation of Znuny, without Docker, is typically considered for production environments on bare metal servers where you might prefer direct control over the underlying system components, have specific integration requirements, or need to adhere to existing infrastructure standards that don't involve containerization. This method involves following the official Znuny installation guide, which details the manual setup of prerequisites such as a web server (like Apache), a database (MariaDB 10.3+ or MySQL 8.0+), and various Perl modules. This approach offers fine-grained control but generally requires more manual configuration, dependency management, and ongoing maintenance compared to a Dockerized deployment.