This guide will show you how to install Redmine 7 via the Docker Compose using Ubuntu 26.04. We are going to set up the Docker engine with PostgreSQL database.
- Docker engine installation steps
- Project Directory Creation
- Docker compose configuration
- Starting the Redmine Container
Docker engine installation steps
The following steps are going to add the Docker's official tools and repository.
sudo apt update
sudo apt install -y ca-certificates curl gnupg
Official GPG key of the Docker
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
Adding the Docker repository to Apt sources
echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \ $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \ sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
Docker components installation
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin
docker-compose-plugin
To enable the docker run without sudo, please do the next
It requires logging out and back in afterward
sudo usermod -aG docker $USER
Project Directory Creation
The following commands will create a folder for your Redmine 7 deployment configs as well as data persistent mounts:
mkdir -p ~/redmine-docker/data
cd ~/redmine-docker
Docker compose configuration
Now we are about to set up Redmine with the database (PostgreSQL).
Please generate a secure secret key via this command:
openssl rand -hex 64
As a result you have a long string of random numbers and letters. This is your secure secret key.
Now you have to create a docker-compose.yml file using the below command:
nano docker-compose.yml
And paste the following config. Please replace YOUR_GENERATED_SECRET_KEY with your secure secret key:
services:
db:
image: postgres:15-alpine
restart: always
environment:
POSTGRES_DB: redmine
POSTGRES_USER: redmine
POSTGRES_PASSWORD: my_secure_db_password
volumes:
- pgdata:/var/lib/postgresql/data
redmine:
container_name: dimitar_container
image: redmine:latest
restart: always
ports:
- "8080:3000"
environment:
REDMINE_DB_POSTGRES: db
REDMINE_DB_DATABASE: redmine
REDMINE_DB_USERNAME: redmine
REDMINE_DB_PASSWORD: my_secure_db_password
REDMINE_SECRET_KEY_BASE: "YOUR_GENERATED_SECRET_KEY"
SECRET_KEY_BASE: "YOUR_GENERATED_SECRET_KEY"
volumes:
- ./data:/usr/src/redmine/files
depends_on:
- db
volumes:
pgdata:
You may check this picture for more detail.
