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

If you want to test changes locally:

1. build a custom image locally docker build -t eaudeweb/redmine-local .
2. Copy docker-compose.dev.yml to docker-compose.override.yml to include the local image.

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 [email protected] mail account!