Redmine

Redmine Cloud Attachment Pro is a versatile Redmine plugin that enables dynamic storage of file attachments in multiple backends like Local Disk, Amazon S3, and future support for Google Cloud Storage and Microsoft Azure Blob Storage.

Redmine Cloud Attachment Pro – Installation Guide

This plugin enables Redmine to store attachments in Amazon S3, Google Cloud Storage, Azure Blob Storage, or locally, based on your configuration.

Prerequisites

Redmine 6.1 or later

Ruby 3.0 or later

Rails 7 or later

Bundler installed

Cloud storage credentials (S3, GCS, or Azure)

Installation Steps

Clone the plugin into Redmine’s plugins directory:

cd /path/to/your/redmine/plugins
git clone https://github.com/your-org/redmine_cloud_attachment_pro.git
Install plugin dependencies:

bundle install
Run plugin migrations (if required):

bundle exec rake redmine:plugins:migrate RAILS_ENV=production
Configure storage in config/configuration.yml:

default:
    storage: s3   # or 'gcs', 'azure', or 'local'

s3:
    access_key_id: YOUR_AWS_KEY
    secret_access_key: YOUR_AWS_SECRET
    region: YOUR_AWS_REGION
    bucket: your-s3-bucket
    path: redmine/files

gcs:
    project_id: your-gcp-project
    bucket: your-gcs-bucket
    gcs_credentials: /path/to/credentials.json
    path: redmine/files

azure:
    account_name: your-account
    access_key: your-access-key
    container: your-container
    path: redmine/files

Restart Redmine:

For Passenger:

touch tmp/restart.txt
For Puma/Thin/Unicorn: restart the app server service.

Optional: Run RSpec Tests

If you're developing or testing:

cd plugins/redmine_cloud_attachment_pro
bundle exec rspec
Optional: Prefix Existing Attachment Filenames

To prefix disk filenames with s3_, gcs_, or azure_ for existing files:

bundle exec rake attachments:prefix_cloud_filenames[s3] RAILS_ENV=production
Replace s3 with gcs or azure based on your configuration.