https://github.com/eaudeweb/redmine.docker
Dockerization of helpdesk.eaudeweb.ro
https://github.com/eaudeweb/redmine.docker
docker redmine
Last synced: 4 months ago
JSON representation
Dockerization of helpdesk.eaudeweb.ro
- Host: GitHub
- URL: https://github.com/eaudeweb/redmine.docker
- Owner: eaudeweb
- Created: 2017-09-25T07:25:51.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2025-12-01T09:43:05.000Z (7 months ago)
- Last Synced: 2025-12-03T21:18:59.408Z (7 months ago)
- Topics: docker, redmine
- Language: Dockerfile
- Size: 12.8 MB
- Stars: 2
- Watchers: 16
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## Eau de Web Redmine setup (helpdesk.eaudeweb.ro)
### Prerequisites
- Install [Docker](https://docs.docker.com/installation/)
- Install [Compose](https://docs.docker.com/compose/install/)
### 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 .`
1. 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 helpdesk@eaudeweb.ro mail account!