Redmine ONLYOFFICE integration plugin

This plugin enables users to edit attachments from Redmine using ONLYOFFICE Docs.

The plugin is available in the official Redmine Plugins Directory.

  • Viewing and editing text documents, spreadsheets, presentations, and forms.
  • Co-editing documents in real time using two co-editing modes (Fast and Strict), Track Changes, comments, built-in chat.
  • Settings page to set up connection to the server and JWT authentication, customize the editor's appearance.
  • Mobile view for licensed editors.
  • Creating new attachments using templates that consider the user's language preference.
  • Converting attachments and saving or downloading them.
djvu doc docm docx docxf dot dotm dotx epub* fb2* fodt htm html* mht mhtml odt* oform ott* oxps pdf rtf* stw sxw txt* wps wpt xml xps csv* et ett fods ods* ots* sxc xls xlsb xlsm xlsx xlt xltm xltx dps dpt fodp odp* otp* pot potm potx pps ppsm ppsx ppt pptm pptx sxi
View
Edit
Create
* - to be able to open the format for editing, check it in the formats settings. Due to some format restrictions, data loss may occur.

Before you proceed to the plugin installation, make sure you have an instance of ONLYOFFICE Docs (Document Server) that is resolvable and connectable both from Redmine and any end clients. Additionally, ensure that ONLYOFFICE Docs can directly POST to Redmine.

We recommend using Docker to install ONLYOFFICE Docs. Alternatively, you can follow these instructions for Debian, Ubuntu, or derivatives.

To install the plugin, you will need Redmine version 4.2 or higher, or version 5.0 or higher. It is also important to note that the plugin is compatible with Ruby version 2.7.2 or higher, or 3.0.0 or higher. We recommend using Redmine 5 along with Ruby 3.

  1. If you are new to Redmine, install it by following these instructions.
  2. Download the plugin:

    curl --location https://github.com/ONLYOFFICE/onlyoffice-redmine/releases/latest/download/onlyoffice_redmine.tar.zst --output onlyoffice_redmine.tar.zst
    
  3. Unzip it into the plugins directory:

    tar --extract --file onlyoffice_redmine.tar.zst --directory plugins
    
  4. Install the dependencies of the plugin if Redmine did not do it automatically:

    bundle install
    
  5. Perform the migration:

    RAILS_ENV=production bundle exec rake redmine:plugins:migrate NAME=onlyoffice_redmine
    
  6. Restart Redmine.

Read more about the plugin installation on the Redmine Wiki page.

Configure the plugin via the Redmine interface. Go to Administration -> Plugins, find the ONLYOFFICE integration plugin for Redmine and click Configure:

Redmine settings
  • Document Editing Service address. The URL of the installed ONLYOFFICE Docs (Document Server). Leave blank to disable the plugin.

  • ONLYOFFICE Docs address for internal requests from the server.
  • Server address for internal requests from ONLYOFFICE Docs.
  • Connect to the demo ONLYOFFICE Docs server.
  • Secret key. Starting from version 7.2, JWT is enabled by default and the secret key is generated automatically to restrict the access to ONLYOFFICE Docs and for security reasons and data integrity. Specify your secret key in the ONLYOFFICE Docs config file, then specify the same key in the settings page of the plugin. Leave blank to disable authentication.
  • Authorization header.
  • Disable certificate verification (insecure).
  • Display Chat menu button.
  • Display the header more compact.
  • Display Feedback & Support menu button.
  • Display Help menu button.
  • Display monochrome toolbar header.
  • Specify the list of formats allowed to be opened directly for editing.

The plugin uses the ONLYOFFICE Docs API and is integrated into various Redmine pages, including Documents, Attachments, Files, Issue, News, Wiki, and Forums. Additionally, the plugin adds general pages such as "Create in ONLYOFFICE" and "Convert with ONLYOFFICE".

  • Documents page

    On the Documents page, users can open the attachment to view, edit, create, or convert it. The options displayed in the interface may vary depending on the user permissions.

    Option Permissions
    View documents
    View documents, Edit documents
    View documents, Edit documents
    View documents, Edit documents
    View documents
  • Attachment page

    On the Attachment page, users can open the attachment to view, edit, or convert it. The options displayed in the interface may vary depending on the user's permissions for the module where the attachment is located.

  • Files page

    On the Files page, users can open the attachment to view, edit, or convert it. The options displayed in the interface may vary depending on the user's permissions.

    Option Permissions
    View files
    View files, Manage files
    View files, Manage files
    View files
  • Issues page

    On the Issues page, users can open the attachment to view, edit, or convert it. The options displayed in the interface may vary depending on the user's permissions.

    Option Permissions
    View issues
    View issues, Edit own issues
    View issues, Edit own issues
    View issues
  • News page

    On the News page, users can open the attachment to view, edit, or convert it. The options displayed in the interface may vary depending on the user's permissions.

    Option Permissions
    View news
    View news, Manage news
    View news, Manage news
    View news
  • Wiki page

    On the Wiki page, users can open the attachment to view, edit, or convert it. The options displayed in the interface may vary depending on the user's permissions.

    Option Permissions
    View wiki
    View wiki, Edit wiki pages
    View wiki, Edit wiki pages
    View wiki
  • Forums page

    On the Forums page, users can open the attachment to view, edit, or convert it. The options displayed in the interface may vary depending on the user's permissions.

    Option Permissions
    View messages
    View messages, Edit messages
    View messages, Edit messages
    View messages
  • View Or Edit In ONLYOFFICE

    On the View Or Edit In ONLYOFFICE page, users can view or edit the attachment. The visibility of this page depends on the user's permissions for the module where the attachment is located.

  • Create in ONLYOFFICE

    On the Create in ONLYOFFICE page, users can create the attachment using templates that consider the user's language preference. Take a look at supported formats. The visibility of this page depends on the user's permissions for the module.

  • Convert with ONLYOFFICE

    On the Convert with ONLYOFFICE page, the user can convert the attachment. The visibility of this page depends on the user's permissions for the module where the attachment is located.