Articles in this section

See more

How to deploy Redmine in Plesk

Avatar
Kuzma Ivanov
Updated
Follow
Plesk Onyx for Linux Plesk Onyx for Windows kb: how-to

Applicable to:

  • Plesk Onyx for Linux
  • Plesk Onyx for Windows

Question

How to deploy Ruby on Rails application Redmine in Plesk?

Answer

Note: Redmine is a 3rd-party application. If you encounter any issues during Redmine deployment, please refer to Redmine forums for assistance.

The steps below were tested on Plesk Onyx 17.8 and Plesk Obsidian for CentOS 7 with default system package repositories.

  1. Install the Plesk component Tools required for building Ruby gems via Plesk Installer.

  2. Download the latest available version of Redmine in a .zip file at www.redmine.org to your PC/MAC.

  3. In Plesk, go to Domains > example.com > File Manager and upload the .zip file from step 2 to the httpdocs directory.

    Note: We recommend to remove all default files from the httpdocs directory to avoid file name conflicts.

  4. Select the checkbox next to the uploaded .zip file > click Screenshot_2018-11-22_File_Manager_for_example_com_-_Plesk_Onyx_17_8_11_2_.png > OK.

  5. Open the unzipped redmine-X.X.X directory > select all items > click Screenshot_2018-11-23_File_Manager_for_example_com_-_Plesk_Onyx_17_8_11.png and transfer these items to the httpdocs directory.

  6. Go to example.com > Databases and create a new database (For example, redmine) with a database user.

  7. Go back to File Manager > open the config directory and rename database.yml.example to database.yml ( Screenshot_2018-11-23_File_Manager_for_example_com_-_Plesk_Onyx_17_8_11_1_.png > Rename).

  8. Open the database.yml file and update the database information specifying a correct database name, username and password in the "production" section. Once finished, click OK.

    CONFIG_TEXT: production:
    adapter: mysql2
    database: redmine
    host: localhost
    username: database_user
    password: "database_user_password"
    encoding: utf8

    Note: In some cases, Redmine will not start up if the "development" section is not filled in. Update the same information under the "development" section.

  9. Go to Domains > example.com > Ruby.

  10. Set Application Root to httpdocs.

  11. Select a required Ruby version. For example, if Redmine version is 3.4, set Ruby version to 2.4. For more Ruby versions, visit this Redmine documentation page.

  12. Click Enable Ruby.

  13. Click Bundle install (Installation might take several minutes to complete).

  14. Click Run rake task:

    14.1. Insert generate_secret_token to the Task parameters field and click Run (if the task completes successfully, no output will be generated).

    14.2. Insert RAILS_ENV=production db:migrate to the Task parameters field and click Run.

    14.3. Insert RAILS_ENV=production REDMINE_LANG=en redmine:load_default_data to the Task parameters field and click Run.

    14.4. Close the window.

  15. Open your website in a web-browser and sign in to Redmine administration panel with default login and password (admin/admin).

    Note: Language for the admin user can be changed at My Account > Language.

Comments

12 comments

Sort by Date Votes
  • Avatar
    conformist

    Hi! A have already done all instructions but encounter an error:

    Application error

    Rails application failed to start properly

    How can I find out what went wrong?

    0
    Comment actions Permalink
  • Avatar
    Bulat Tsydenov

    @conformist, Hi!

    Please clarify which step you receive this error?

    0
    Comment actions Permalink
  • Avatar
    conformist

    @Tsydenov I'm already solve my issue. distro Debian 8.9, problem is:

    ruby 2.4.2 passenger 4.0.53 undefined symbol: rb_thread_blocking_region

    so I setup passenger from here https://www.phusionpassenger.com/library/install/apache/install/oss/jessie/ and now it works fine

    0
    Comment actions Permalink
  • Avatar
    Vacoi (Edited )

    Hi,

    I receive the following error when install bundle:

    • An error occurred while installing ffi (1.9.18), and Bundler cannot continue.
    • Make sure that `gem install ffi -v '1.9.18'` succeeds before bundling.
    • ERROR:rubymng:Command '['/opt/psa/admin/sbin/filemng', 'planner', 'exec', '/var/www/vhosts/planner.domain.net/httpdocs/redmine', '/bin/bash', '-l', '-c', 'bundle install --path vendor/bundle']' returned non-zero exit status 5

    Thanks.

    0
    Comment actions Permalink
  • Avatar
    Lev Iurev

    @Vacoi

    was `gem install ffi -v '1.9.18'` succeeds before bundling?

    0
    Comment actions Permalink
  • Avatar
    colori

    I got similar problem when bundle installing redmine 3.4.6.

    bundle install failed at nokogiri.

    • An error occurred while installing nokogiri (1.8.5), and Bundler cannot continue.
    • Make sure that `gem install nokogiri -v '1.8.5' --source 'https://rubygems.org/'` succeeds before bundling.

    so I input command in plesk user ssh terminal.

    my server is CentOS7 (AWS EC2), switch plesk user ('su myuser_id') after logged in default 'centos' user.

    -bash-4.2$ gem install nokogiri -v '1.8.5' --source 'https://rubygems.org/'
    ERROR: While executing gem ... (Gem::FilePermissionError)
    You don't have write permissions for the /opt/plesk/ruby/2.4.4/lib64/ruby/gems/2.4.0

    0
    Comment actions Permalink
  • Avatar
    Artyom Volov

    Hello @colori,

    I have double checked the solution from the article - I successfully installed Remine 3.4.7 using Ruby version 2.4.4.

    However, I was able to reproduce a similar error by trying to install Redmine on the server without an installed component in Tools & Settings > Updates and Upgrades > Web hosting > Tools required for building Ruby gems.

    Please check that this component is installed. In case it is not - install it and try to install Redmine again.

    In case it is already installed - please submit a request to Plesk Support using the link https://support.plesk.com/hc/.

    0
    Comment actions Permalink
  • Avatar
    colori (Edited )

    @Artyom

    Oh..sorry, I didn't notice first step..

    I noticed user(centos) .rbenv version is symbolic link to /opt/plesk/ruby/, manual install gem.

    $ sudo /opt/plesk/ruby/2.4.4/bin/gem install nokogiri 
    Building native extensions. This could take a while... 
    Successfully installed nokogiri-1.8.5 
    Parsing documentation for nokogiri-1.8.5 
    Installing ri documentation for nokogiri-1.8.5 
    Done installing documentation for nokogiri after 13 seconds 
    1 gem installed

    As I installed "Tools required for building Ruby gems", another application will have no problem.
    Thanks !!

    0
    Comment actions Permalink
  • Avatar
    Artyom Volov

    Hi @colori,

    Glad to hear that the issue was resolved!

    0
    Comment actions Permalink
  • Avatar
    Benjamin Wiens

    I get an Error on "14.2. Insert RAILS_ENV=production db:migrate to the Task parameters field and click Run."
    Can someone Help me?

    ** Invoke db:migrate (first_time)
    ** Invoke db:load_config (first_time)
    ** Invoke environment (first_time)
    ** Execute environment
    ** Execute db:load_config
    ** Execute db:migrate
    rake aborted!
    ArgumentError: string contains null byte
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/mysql2-0.5.2/lib/mysql2/client.rb:90:in `connect'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/mysql2-0.5.2/lib/mysql2/client.rb:90:in `initialize'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/activerecord-5.2.3/lib/active_record/connection_adapters/mysql2_adapter.rb:22:in `new'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/activerecord-5.2.3/lib/active_record/connection_adapters/mysql2_adapter.rb:22:in `mysql2_connection'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/activerecord-5.2.3/lib/active_record/connection_adapters/abstract/connection_pool.rb:811:in `new_connection'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/activerecord-5.2.3/lib/active_record/connection_adapters/abstract/connection_pool.rb:855:in `checkout_new_connection'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/activerecord-5.2.3/lib/active_record/connection_adapters/abstract/connection_pool.rb:834:in `try_to_checkout_new_connection'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/activerecord-5.2.3/lib/active_record/connection_adapters/abstract/connection_pool.rb:795:in `acquire_connection'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/activerecord-5.2.3/lib/active_record/connection_adapters/abstract/connection_pool.rb:523:in `checkout'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/activerecord-5.2.3/lib/active_record/connection_adapters/abstract/connection_pool.rb:382:in `connection'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/activerecord-5.2.3/lib/active_record/connection_adapters/abstract/connection_pool.rb:1014:in `retrieve_connection'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/activerecord-5.2.3/lib/active_record/connection_handling.rb:118:in `retrieve_connection'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/activerecord-5.2.3/lib/active_record/connection_handling.rb:90:in `connection'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/activerecord-5.2.3/lib/active_record/tasks/database_tasks.rb:172:in `migrate'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/activerecord-5.2.3/lib/active_record/railties/databases.rake:60:in `block (2 levels) in '
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/rake-12.3.3/lib/rake/task.rb:273:in `block in execute'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/rake-12.3.3/lib/rake/task.rb:273:in `each'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/rake-12.3.3/lib/rake/task.rb:273:in `execute'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/rake-12.3.3/lib/rake/task.rb:214:in `block in invoke_with_call_chain'
    /opt/plesk/ruby/2.6.3/lib/x86_64-linux-gnu/ruby/2.6.0/monitor.rb:230:in `mon_synchronize'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/rake-12.3.3/lib/rake/task.rb:194:in `invoke_with_call_chain'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/rake-12.3.3/lib/rake/task.rb:183:in `invoke'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/rake-12.3.3/lib/rake/application.rb:160:in `invoke_task'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/rake-12.3.3/lib/rake/application.rb:116:in `block (2 levels) in top_level'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/rake-12.3.3/lib/rake/application.rb:116:in `each'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/rake-12.3.3/lib/rake/application.rb:116:in `block in top_level'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/rake-12.3.3/lib/rake/application.rb:125:in `run_with_threads'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/rake-12.3.3/lib/rake/application.rb:110:in `top_level'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/rake-12.3.3/lib/rake/application.rb:83:in `block in run'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/rake-12.3.3/lib/rake/application.rb:186:in `standard_exception_handling'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/rake-12.3.3/lib/rake/application.rb:80:in `run'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/gems/rake-12.3.3/exe/rake:27:in `'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/bin/rake:23:in `load'
    /var/www/vhosts/xxxxx/vendor/bundle/ruby/2.6.0/bin/rake:23:in `
    '
    Tasks: TOP => db:migrate
    0
    Comment actions Permalink
  • Avatar
    Julian Bonpland Mignaquy

    @Benjamin, I recommend reaching out to Redmine Support https://www.redmine.org/projects/redmine/boards to address this issue. If it persists afterward please open a ticket with us here https://support.plesk.com/hc/en-us/articles/213953025-How-to-get-support-directly-from-Plesk-

    1
    Comment actions Permalink
  • Avatar
    Benjamin Wiens

    @Julian Bonpland Mignaquy

    I know now why it didn't work. I wanted to install Redmine 4.X. The manual only works with v3.4.X.

    With Redmine 3.4.X everything worked fine 👌

    0
    Comment actions Permalink

Please sign in to leave a comment.

Have more questions? Submit a request

Related articles