yassan/redmine repository overview

⁠docker-redmine

Docker image for running Redmine or Redmica with persistent storage, PostgreSQL support, and plugin compatibility.

⁠Supported Tags

Image tags follow this format:

• <flavor>-<version>

Examples:

• redmine-6.1.2
• redmica-4.1.1

Supported flavors:

• redmine
• redmica

⁠Quick Start

Example with Docker Compose:

services:
  postgresql:
    image: sameersbn/postgresql:14-20230628
    environment:
      DB_USER: redmine
      DB_PASS: redminepass
      DB_NAME: redmine_production
    volumes:
      - postgresql_data:/var/lib/postgresql

  redmine:
    image: yassan/redmine:redmine-6.1.2
    depends_on:
      - postgresql
    ports:
      - "10083:80"
    environment:
      TZ: Asia/Tokyo
      DB_ADAPTER: postgresql
      DB_HOST: postgresql
      DB_PORT: 5432
      DB_USER: redmine
      DB_PASS: redminepass
      DB_NAME: redmine_production
      DB_SSL_MODE: prefer
      REDMINE_PORT: 10083
      REDMINE_HTTPS: "false"
      REDMINE_SECRET_TOKEN: change-me
    volumes:
      - redmine_data:/home/redmine/data
      - redmine_logs:/var/log/redmine

volumes:
  postgresql_data:
  redmine_data:
  redmine_logs:

For Redmica, use a Redmica tag such as:

yassan/redmine:redmica-4.1.1

Then start the stack:

docker compose up -d

⁠Ports

The container serves HTTP on:

• 80/tcp

Typical host mappings:

• 10083:80
• 10084:80

⁠Volumes

Persist these paths outside the container:

• /home/redmine/data
• /var/log/redmine

Plugins should be placed in:

• /home/redmine/data/plugins

⁠Environment Variables

Common settings:

• DB_ADAPTER
• DB_HOST
• DB_PORT
• DB_USER
• DB_PASS
• DB_NAME
• DB_SSL_MODE
• TZ
• REDMINE_PORT
• REDMINE_HTTPS
• REDMINE_RELATIVE_URL_ROOT
• REDMINE_SECRET_TOKEN
• SMTP_*
• IMAP_*
• NGINX_MAX_UPLOAD_SIZE

⁠Plugins

Plugins are supported through the persistent data volume.

At startup, the image can:

• install plugin files
• install required gems
• run plugin migrations when needed

Optional hooks:

• plugins/pre-install.sh
• plugins/post-install.sh

⁠Notes

• The primary intended deployment path is Docker Compose with PostgreSQL
• Use versioned tags for upgrades instead of floating tags
• Test third-party plugins carefully when upgrading Redmine or Redmica

⁠Source

• GitHub: https://github.com/yassan/docker-redmine⁠
• Upstream base: https://github.com/sameersbn/docker-redmine⁠