Eau de Web Redmine setup (helpdesk.eaudeweb.ro)

Prerequisites

• Install Docker
• Install Compose

First time installation

Clone the repository

cd /var/local/deploy
git clone https://github.com/eaudeweb/redmine.docker
cd redmine.docker

Edit the secrets

cp .env.example .env
vim .env

Start redmine

docker compose up -d

Initial configuration

• Login using admin/admin and change password for admin user
• Go to /admin and load the default configuration
• Enable CKEditor: /settings > General > Text formatting
• Go to /settings?tab=repositories, Enable WS for repository management, generate an API key and configure fixing keywords
• Write the API key into .redmine.secret (SYNC_API_KEY), this is needed by cron job redmine_github_sync
• Create projects (enable Kanbans or Agile module)
• Configure trackers and workflows
• Add users
• etc.

Adding support for repositories

To track changes from remote repositories, enter the redmine repository and clone them locally, for instance:

#> docker exec -ti redmine bash
#> cd /var/local/redmine/repositories
#> git clone --mirror https://github.com/account/repo.git

A cron task will update the repository every 15 minutes.

Local development and testing

For local development and testing, create the ignored compose.override.yml from the tracked example if it does not already exist:

cp compose.dev.yml compose.override.yml

The override builds the image locally, exposes Redmine on port 8090, and starts the dummy SMTP service. Docker Compose loads it automatically alongside compose.yml; no -f options are needed.

Rebuild and start the local stack with:

docker compose build --no-cache redmine
docker compose up -d --force-recreate redmine

The tracked compose.dev.yml is kept as an example configuration.

To reset your password

Enter MySQL container

docker exec -ti redmine_mysql mysql -ps3cr3t redmine -e "UPDATE users SET auth_source_id = NULL WHERE id = XX"

Setup OAUTH for IMAP using Microsoft O365

See docker volume redmine-imap-oauth:/usr/src/redmine/oauth/. This is where the .yml config files are stored. App registration can be created at https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade, following instructions from https://gitlab.com/muttmua/mutt/-/blob/master/contrib/mutt_oauth2.py.README#L184

Once you have the tenant id, client id, client secret, run inside the docker container:

rake redmine:email:o365_oauth2_init token_file=/usr/src/redmine/oauth/edw_oauth2 client=$client_id tenant=$tenant_id secret=$app_registration_secret_value

Important: when you are asked go to URL: https://login.microsoftonline.com/..., make sure to log in using helpdesk@eaudeweb.ro mail account!