Use Dropbox as the storage backend for your Redmine installation

Installation

To install the plugin, execute the following commands from the root of your redmine directory:

cd plugins
git clone git://github.com/alexbevi/redmine_dropbox_attachments.git
bundle install

More information on installing Redmine plugins can be found at redmine.org

After the plugin is installed you will need to restart Redmine for the plugin to be available.

Configuration

The plugin must be configured from Administration > Plugins > Dropbox Attachment Storage > Configure

Screenshot01

Authorization

Before Redmine can store files on a shared Dropbox folder, it must be authorized. This is done by clicking Authorize Redmine with Dropbox, then selecting Allow from Dropbox’s authorization page.

Specifying a Base Directory

By default, the plugin will write to your Dropbox’s Apps > redmine_files directory.

If you specify a Base Directory value, that subdirectory will be creted under Apps/redmine_files and used to store attachements for the plugin.

Screenshot02

Storing Attachments for Multiple Redmine’s

Since you can only register a single instance of this plugin with Dropbox, if you want to store attachments for multiple installations of Redmine, the steps are:

1) Authorize the plugin ONCE with Dropbox

2) Copy the Dropbox Token and Dropbox Secret values from the authorized installation

3) Paste the token/secret values to each additional installation

Note that if you have multiple installations, it’s a good idea to specify different base directories.

Acknowledgement

This plugin is heavily based on the Redmine S3 plugin. Thanks to all the contributors there who’ve made this such an easy plugin to build ;)

I also used the Redmine DropBox plugin to find some quick answers to interacting with dropbox.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
Copyright (c) 2012 Alex Bevilacqua

Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.