{"id":11964,"date":"2022-03-29T14:29:36","date_gmt":"2022-03-29T11:29:36","guid":{"rendered":"https:\/\/kifarunix.com\/?p=11964"},"modified":"2024-03-09T10:35:52","modified_gmt":"2024-03-09T07:35:52","slug":"install-redmine-on-ubuntu-22-04","status":"publish","type":"post","link":"https:\/\/kifarunix.com\/install-redmine-on-ubuntu-22-04\/","title":{"rendered":"Install Redmine on Ubuntu 22.04"},"content":{"rendered":"\n<p>In this guide, you will learn how to install Redmine on Ubuntu 22.04.&nbsp;<a href=\"https:\/\/www.redmine.org\/projects\/redmine\/wiki\" target=\"_blank\" rel=\"noreferrer noopener\">Redmine<\/a>&nbsp;is cross-platform and cross-database, flexible project management tool written on Ruby on Rails Framework.<\/p>\n\n\n\n<div class=\"wp-block-rank-math-toc-block\" id=\"rank-math-toc\"><h2>Table of Contents<\/h2><nav><ul><li><a href=\"#install-redmine-on-ubuntu-22-04\">Install Redmine on Ubuntu 22.04<\/a><ul><li><a href=\"#redmine-features\">Redmine Features<\/a><\/li><li><a href=\"#run-system-update\">Run system update<\/a><\/li><li><a href=\"#install-required-build-tools-and-dependencies\">Install Required Build Tools and Dependencies<\/a><\/li><li><a href=\"#install-apache-http-server-on-ubuntu-22-04\">Install Apache HTTP Server on Ubuntu 22.04<\/a><\/li><li><a href=\"#install-ruby-interpreter\">Install Ruby interpreter<\/a><\/li><li><a href=\"#create-redmine-system-user\">Create Redmine System User<\/a><\/li><li><a href=\"#install-my-sql-database-on-ubuntu-22-04\">Install MySQL Database on Ubuntu 22.04<\/a><ul><li><a href=\"#create-redmine-database-and-database-user\">Create Redmine Database and Database User<\/a><\/li><\/ul><\/li><li><a href=\"#download-and-install-redmine\">Download and Install Redmine<\/a><\/li><li><a href=\"#configuring-redmine-on-ubuntu-22-04\">Configuring Redmine on Ubuntu 22.04<\/a><ul><li><a href=\"#create-redmin-configuration-files\">Create Redmin Configuration Files<\/a><\/li><li><a href=\"#configure-redmine-database-settings\">Configure Redmine Database Settings<\/a><\/li><li><a href=\"#install-redmine-ruby-dependencies\">Install Redmine Ruby Dependencies<\/a><\/li><li><a href=\"#generate-secret-session-token\">Generate Secret Session Token<\/a><\/li><li><a href=\"#create-database-schema-objects\">Create Database Schema Objects<\/a><\/li><li><a href=\"#configure-file-system-permissions\">Configure FileSystem Permissions<\/a><\/li><\/ul><\/li><li><a href=\"#testing-redmine-installation\">Testing Redmine Installation<\/a><\/li><li><a href=\"#configure-apache-for-redmine-on-ubuntu-22-04\">Configure Apache for Redmine on Ubuntu 22.04<\/a><\/li><li><a href=\"#access-redmine-on-browser\">Access Redmine on Browser<\/a><\/li><li><a href=\"#reference\">Reference<\/a><\/li><li><a href=\"#other-tutorials\">Other Tutorials<\/a><\/li><\/ul><\/li><\/ul><\/nav><\/div>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"install-redmine-on-ubuntu-22-04\">Install Redmine on Ubuntu 22.04<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"redmine-features\">Redmine Features<\/h3>\n\n\n\n<p>Some of the main features of Redmine are:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Multiple projects support<\/li>\n\n\n\n<li>Flexible&nbsp;role based access control<\/li>\n\n\n\n<li>Flexible&nbsp;issue tracking system<\/li>\n\n\n\n<li>Gantt chart&nbsp;and&nbsp;calendar<\/li>\n\n\n\n<li>News,&nbsp;documents&nbsp;&amp;&nbsp;files&nbsp;management<\/li>\n\n\n\n<li>Feeds &amp; email notifications<\/li>\n\n\n\n<li>Per project&nbsp;wiki<\/li>\n\n\n\n<li>Per project&nbsp;forums<\/li>\n\n\n\n<li>Time tracking<\/li>\n\n\n\n<li>Custom fields&nbsp;for issues, time-entries, projects and users<\/li>\n\n\n\n<li>SCM integration&nbsp;(SVN, CVS, Git, Mercurial and Bazaar)<\/li>\n\n\n\n<li>Issue creation via email<\/li>\n\n\n\n<li>Multiple&nbsp;LDAP authentication&nbsp;support<\/li>\n\n\n\n<li>User self-registration&nbsp;support<\/li>\n\n\n\n<li>Multilanguage support<\/li>\n\n\n\n<li>Multiple databases&nbsp;support<\/li>\n<\/ul>\n\n\n\n<p>Read more about Redmine features on the&nbsp;<a rel=\"noreferrer noopener\" href=\"https:\/\/www.redmine.org\/projects\/redmine\/wiki\/Features\" target=\"_blank\">features page<\/a>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"run-system-update\">Run system update<\/h3>\n\n\n\n<p>To begin with, ensure that your system packages are up-to-date.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>apt update<\/code><\/pre>\n\n\n\n<p>Redmine is not available on the default Ubuntu 22.04.<\/p>\n\n\n\n<p>Therefore, to install Redmine, you need to build and install it from the source.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"install-required-build-tools-and-dependencies\">Install Required Build Tools and Dependencies<\/h3>\n\n\n\n<p>To install Redmine from the source code, you need install the required build tools and dependencies.<\/p>\n\n\n\n<pre class=\"scroll-box\"><code>apt install build-essential \\\n\truby-dev \\\n\tlibxslt1-dev \\\n\tlibmysql++-dev \\\n\tlibxml2-dev \\\n\tzlib1g-dev \\\n\timagemagick \\\n\tlibmagickwand-dev \\\n\tcurl \\\n\tgnupg2 \\\n\tbison \\\n\tlibbison-dev \\\n\tlibgdbm-dev \\\n\tlibncurses-dev \\\n\tlibncurses5-dev \\\n\tlibreadline-dev \\\n\tlibssl-dev \\\n\tlibyaml-dev \\\n\tlibsqlite3-dev \\\n\tsqlite3 -y\n<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"install-apache-http-server-on-ubuntu-22-04\">Install Apache HTTP Server on Ubuntu 22.04<\/h3>\n\n\n\n<p>Install Apache web server and Apache modules for the Passenger, lightweight web server for Ruby.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>apt install apache2 libapache2-mod-passenger<\/code><\/pre>\n\n\n\n<p>Start and enable Apache to run on system boot.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>systemctl enable --now apache2<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"install-ruby-interpreter\">Install Ruby interpreter<\/h3>\n\n\n\n<p><a href=\"https:\/\/www.redmine.org\/projects\/redmine\/wiki\/RedmineInstall#Ruby-interpreter\" target=\"_blank\" rel=\"noreferrer noopener\">Redmine version 5.1 supports&nbsp;upto Ruby 3.2<\/a> as of this post update!<\/p>\n\n\n\n<p>Ruby is installed as part of the above package dependencies. To check the current version of installed Ruby;<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">ruby -v<\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code>ruby 3.0.2p107 (2021-07-07 revision 0db68f0233) &#91;x86_64-linux-gnu]<\/code><\/pre>\n\n\n\n<p>This falls within the supported versions.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"create-redmine-system-user\">Create Redmine System User<\/h3>\n\n\n\n<p>Create a Redmine system user that can be used to install Redmine Ruby dependencies via bundler command. Set its home directory to <code>\/opt\/redmine<\/code> as this is where we will install Redmine app.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>useradd -r -m -d \/opt\/redmine -s \/usr\/bin\/bash redmine<\/code><\/pre>\n\n\n\n<p>Add Apache web server user to Redmine group.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>usermod -aG redmine www-data<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"install-my-sql-database-on-ubuntu-22-04\">Install MySQL Database on Ubuntu 22.04<\/h3>\n\n\n\n<p>Run the command below to install MySQL 8 database server on Ubuntu 22.04<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">apt install mysql-server<\/pre>\n\n\n\n<p>MySQL is started and enabled to run on boot upon installation.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>systemctl status  mysql<\/code><\/pre>\n\n\n\n<pre class=\"scrollbox\"><code>\u25cf mysql.service - MySQL Community Server\n     Loaded: loaded (\/lib\/systemd\/system\/mysql.service; enabled; vendor preset: enabled)\n     Active: active (running) since Sun 2024-03-03 11:47:41 UTC; 1min 41s ago\n    Process: 12582 ExecStartPre=\/usr\/share\/mysql\/mysql-systemd-start pre (code=exited, status=0\/SUCCESS)\n   Main PID: 12590 (mysqld)\n     Status: \"Server is operational\"\n      Tasks: 37 (limit: 2241)\n     Memory: 364.0M\n        CPU: 1.598s\n     CGroup: \/system.slice\/mysql.service\n             \u2514\u250012590 \/usr\/sbin\/mysqld\n\nMar 03 11:47:40 osboxes systemd[1]: Starting MySQL Community Server...\nMar 03 11:47:40 osboxes mysqld[12590]: 2024-03-03T11:47:40.726951Z 0 [System] [MY-010116] [Server] \/usr\/sbin\/mysqld (mysqld 8.0.36-0ubuntu0.22.04.1) starting as process 125>\nMar 03 11:47:40 osboxes mysqld[12590]: 2024-03-03T11:47:40.732580Z 1 [System] [MY-013576] [InnoDB] InnoDB initialization has started.\nMar 03 11:47:40 osboxes mysqld[12590]: 2024-03-03T11:47:40.926104Z 1 [System] [MY-013577] [InnoDB] InnoDB initialization has ended.\nMar 03 11:47:41 osboxes mysqld[12590]: 2024-03-03T11:47:41.084287Z 0 [Warning] [MY-010068] [Server] CA certificate ca.pem is self signed.\nMar 03 11:47:41 osboxes mysqld[12590]: 2024-03-03T11:47:41.084318Z 0 [System] [MY-013602] [Server] Channel mysql_main configured to support TLS. Encrypted connections are n>\nMar 03 11:47:41 osboxes mysqld[12590]: 2024-03-03T11:47:41.105453Z 0 [System] [MY-011323] [Server] X Plugin ready for connections. Bind-address: '::' port: 33060, socket: \/>\nMar 03 11:47:41 osboxes mysqld[12590]: 2024-03-03T11:47:41.105476Z 0 [System] [MY-010931] [Server] \/usr\/sbin\/mysqld: ready for connections. Version: '8.0.36-0ubuntu0.22.04.>\nMar 03 11:47:41 osboxes systemd[1]: Started MySQL Community Server.\n<\/code><\/pre>\n\n\n\n<p>If not already started, run the command below to start it;<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">systemctl enable --now mysql<\/pre>\n\n\n\n<p>Run initial MySQL database secure script to remove default databases, test tables, disable remote root login,<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">mysql_secure_installation<\/pre>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"create-redmine-database-and-database-user\">Create Redmine Database and Database User<\/h4>\n\n\n\n<p>Once MySQL is installed, login as root user and create Redmine database and database user.<\/p>\n\n\n\n<p><strong>Replace the names of the database and the database user accordingly<\/strong>.<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">mysql -u root -p<\/pre>\n\n\n\n<pre class=\"wp-block-preformatted\">create database redminedb;<\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code>create user redmineuser@localhost identified by 'P@ssW0rD';<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-preformatted\">grant all on redminedb.* to redmineuser@localhost;<\/pre>\n\n\n\n<p>Reload privilege tables and exit the database.<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\"><code>flush privileges;\nquit<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"download-and-install-redmine\">Download and Install Redmine<\/h3>\n\n\n\n<p>Navigate&nbsp;<a href=\"https:\/\/www.redmine.org\/releases\/\" target=\"_blank\" rel=\"noreferrer noopener\">Redmine releases page<\/a>&nbsp;and grab Redmine tarball for the current <a href=\"https:\/\/www.redmine.org\/projects\/redmine\/wiki\/Download#Stable-releases\" target=\"_blank\" rel=\"noreferrer noopener\">stable release version<\/a>.<\/p>\n\n\n\n<p>You can simply download and extract the Redmine tarball to the Redmine install directory, <code>\/opt\/redmine<\/code>.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>VER=5.1.1<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code>curl -s https:\/\/www.redmine.org\/releases\/redmine-$VER.tar.gz | \\\nsudo -u redmine tar xz -C \/opt\/redmine\/ --strip-components=1<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"configuring-redmine-on-ubuntu-22-04\">Configuring Redmine on Ubuntu 22.04<\/h3>\n\n\n\n<p>Once you have installed Redmine under the&nbsp;<code>\/opt\/redmine<\/code>&nbsp;directory, you can now proceed to configure it.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"create-redmin-configuration-files\">Create Redmin Configuration Files<\/h4>\n\n\n\n<p>Create Redmine configuration file by renaming the sample configuration files as shown below;<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>su - redmine<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code>cp \/opt\/redmine\/config\/configuration.yml{.example,}<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code>cp \/opt\/redmine\/public\/dispatch.fcgi{.example,}<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code>cp \/opt\/redmine\/config\/database.yml{.example,}<\/code><\/pre>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"configure-redmine-database-settings\">Configure Redmine Database Settings<\/h4>\n\n\n\n<p>Open the created Redmine database configuration setting and set the Redmine database connection details for MySQL.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>vim \/opt\/redmine\/config\/database.yml<\/code><\/pre>\n\n\n\n<pre class=\"scroll-box\"><code>...\nproduction:\n  adapter: mysql2\n  database: redminedb\n  host: localhost\n  username: redmineuser\n  password: \"P@ssW0rD\"\n  # Use \"utf8\" instead of \"utfmb4\" for MySQL prior to 5.7.7\n  encoding: utf8mb4\n...\n<\/code><\/pre>\n\n\n\n<p>Save and exit the file.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"install-redmine-ruby-dependencies\">Install Redmine Ruby Dependencies<\/h4>\n\n\n\n<p><strong>Logout as redmine user<\/strong> by running the exit.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><strong>exit<\/strong><\/code><\/pre>\n\n\n\n<p>&nbsp;As privileged user, navigate to Redmine install directory and install the Ruby dependencies.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>cd \/opt\/redmine<\/code><\/pre>\n\n\n\n<p>Install Bundler for managing gem dependencies.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>sudo gem install bundler<\/code><\/pre>\n\n\n\n<p>Install the Base64 module.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>sudo gem install base64<\/code><\/pre>\n\n\n\n<p>Next, install the required gems dependencies as redmine user.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>su - redmine<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code>bundle config set --local path 'vendor\/bundle'<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code>bundle install<\/code><\/pre>\n\n\n\n<p>Also update the gems;<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>bundle update<\/code><\/pre>\n\n\n\n<p>Install updated io-wait and strscan gems;<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>gem install io-wait strscan webrick --user-install<\/code><\/pre>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"generate-secret-session-token\">Generate Secret Session Token<\/h4>\n\n\n\n<p>To prevent tempering of the cookies that stores session data, you need to generate a random secret key that Rails uses to encode them.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>bundle exec rake generate_secret_token<\/code><\/pre>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"create-database-schema-objects\">Create Database Schema Objects<\/h4>\n\n\n\n<p>Create Rails database structure by running the command below;<\/p>\n\n\n\n<p>Ensure you set the correct database credentials above,<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>RAILS_ENV=production bundle exec rake db:migrate<\/code><\/pre>\n\n\n\n<p>Once the database migration is done, insert default configuration data into the database by executing;<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>RAILS_ENV=production REDMINE_LANG=en bundle exec rake redmine:load_default_data<\/code><\/pre>\n\n\n\n<p>You can safely ignore the Ruby warnings.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"configure-file-system-permissions\">Configure FileSystem Permissions<\/h4>\n\n\n\n<p>Ensure that the following directories are available on Redmine directory,&nbsp;<strong>\/opt\/redmine.<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>tmp and tmp\/pdf<\/li>\n\n\n\n<li>public and public\/plugin_assets<\/li>\n\n\n\n<li>log<\/li>\n\n\n\n<li>files<\/li>\n<\/ul>\n\n\n\n<p>If they do not exist, simply create them and ensure that they are owned by the user used to run Redmine.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>for i in tmp tmp\/pdf public\/plugin_assets; do &#91; -d $i ] || mkdir -p $i; done<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code>chown -R redmine:redmine files log tmp public\/plugin_assets<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code>chmod -R 755 \/opt\/redmine<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"testing-redmine-installation\">Testing Redmine Installation<\/h3>\n\n\n\n<p>The setup of Redmine on Ubuntu 22.04 is now done.<\/p>\n\n\n\n<p>Redmine listens on TCP port 3000 by default. Hence, before running the tests, open port 3000\/tcp on firewall if it is running.<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\"><code>redmine@ubuntu22:~$ <strong>exit<\/strong><\/code><\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code>sudo ufw allow 3000\/tcp<\/code><\/pre>\n\n\n\n<p>You can now test Redmine using WEBrick by executing the command below;<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>su - redmine<\/code><\/pre>\n\n\n\n<p>Add webrick to Gemfile;<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>echo 'gem \"webrick\"' &gt;&gt; Gemfile<\/code><\/pre>\n\n\n\n<p>Install webrick gem and test the installation;<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>bundle install<\/code><\/pre>\n\n\n\n<pre id=\"block-cb556ad3-ebd1-450d-9c96-b5d3925e5d51\" class=\"wp-block-code\"><code>bundle exec rails server -u webrick -e production<\/code><\/pre>\n\n\n\n<p>Sample output;<\/p>\n\n\n\n<pre class=\"scrollbox\"><code>=> Booting WEBrick\n=> Rails 6.1.7.6 application starting in production http:\/\/0.0.0.0:3000\n=> Run `bin\/rails server --help` for more startup options\n[2024-03-03 11:59:32] INFO  WEBrick 1.8.1\n[2024-03-03 11:59:32] INFO  ruby 3.0.2 (2021-07-07) [x86_64-linux-gnu]\n[2024-03-03 11:59:32] INFO  WEBrick::HTTPServer#start: pid=14164 port=3000\n<\/code><\/pre>\n\n\n\n<p>Navigate to the browser and enter the address,&nbsp;<strong>http:\/\/server-IP-or-Hostname:3000<\/strong>. Replace the&nbsp;<strong>server-IP-or-Hostname<\/strong>&nbsp;accordingly.<\/p>\n\n\n\n<p>If all is well, you should land on Redmine web user interface.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1901\" height=\"280\" src=\"https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/08\/redmine-webrick.png\" alt=\"Install Redmine on Ubuntu 22.04\" class=\"wp-image-10012\" title=\"\" srcset=\"https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/08\/redmine-webrick.png?v=1628626525 1901w, https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/08\/redmine-webrick-768x113.png?v=1628626525 768w, https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/08\/redmine-webrick-1536x226.png?v=1628626525 1536w\" sizes=\"(max-width: 1901px) 100vw, 1901px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"configure-apache-for-redmine-on-ubuntu-22-04\">Configure Apache for Redmine on Ubuntu 22.04<\/h3>\n\n\n\n<p>Now that you have confirmed that Redmine is working as expected, proceed to configure Apache to server Redmine.<\/p>\n\n\n\n<p>Press CTRL+C to stop Redmine in foreground and exit redmine user account.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>exit<\/code><\/pre>\n\n\n\n<p>next, create Redmine Apache VirtualHost configuration file.<\/p>\n\n\n\n<pre class=\"scroll-box\"><code>\ncat &gt; \/etc\/apache2\/sites-available\/redmine.conf &lt;&lt; 'EOL'\nListen 3000\n&lt;VirtualHost *:3000&gt;\n\tServerName redmine.kifarunix-demo.com\n\tRailsEnv production\n\tDocumentRoot \/opt\/redmine\/public\n\n\t&lt;Directory \"\/opt\/redmine\/public\"&gt;\n\t        Allow from all\n\t        Require all granted\n\t&lt;\/Directory&gt;\n\n\tErrorLog ${APACHE_LOG_DIR}\/redmine_error.log\n        CustomLog ${APACHE_LOG_DIR}\/redmine_access.log combined\n&lt;\/VirtualHost&gt;\nEOL\n<\/code><\/pre>\n\n\n\n<p>Ensure the value of the ServerName, the domain, is resolvable! You can use hosts file to define the IP address if you dont have a DNS server.<\/p>\n\n\n\n<p>Disable the default site configuration.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>a2dissite 000-default.conf<\/code><\/pre>\n\n\n\n<p>Check Apache configuration for errors.<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">apachectl configtest<\/pre>\n\n\n\n<pre class=\"wp-block-preformatted\"><code>Syntax OK<\/code><\/pre>\n\n\n\n<p>Ensure that Passenger module is loaded;<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>apache2ctl -M | grep -i passenger<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-preformatted\"><code>passenger_module (shared)<\/code><\/pre>\n\n\n\n<p>If not enabled, run the command below to enable it.<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\"><code>a2enmod passenger<\/code><\/pre>\n\n\n\n<p>Enable Redmine site.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>sudo a2ensite redmine<\/code><\/pre>\n\n\n\n<p>Reload Apache<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>sudo systemctl restart apache2<\/code><\/pre>\n\n\n\n<p>Check to ensure that Redmine is now listening on port 3000.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>sudo lsof -i :3000<\/code><\/pre>\n\n\n\n<pre class=scroll-box>\nCOMMAND  PID     USER   FD   TYPE DEVICE SIZE\/OFF NODE NAME\napache2 7630     root    6u  IPv6  48985      0t0  TCP *:3000 (LISTEN)\napache2 7645 www-data    6u  IPv6  48985      0t0  TCP *:3000 (LISTEN)\napache2 7646 www-data    6u  IPv6  48985      0t0  TCP *:3000 (LISTEN)\n<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"access-redmine-on-browser\">Access Redmine on Browser<\/h3>\n\n\n\n<p>Next, you can now access and sign in to Redmine on browser using the address&nbsp;<strong>http:\/\/server-IP-or-domain-address:3000<\/strong>.<\/p>\n\n\n\n<p>Click <strong>Sign in<\/strong> at the top right corner.<\/p>\n\n\n\n<p>Default credentials:&nbsp;<strong>admin:admin<\/strong>.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1894\" height=\"475\" src=\"https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/08\/redmine-login.png\" alt=\"Install Redmine on Ubuntu 22.04\" class=\"wp-image-10027\" title=\"\" srcset=\"https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/08\/redmine-login.png?v=1628661264 1894w, https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/08\/redmine-login-768x193.png?v=1628661264 768w, https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/08\/redmine-login-1536x385.png?v=1628661264 1536w\" sizes=\"(max-width: 1894px) 100vw, 1894px\" \/><\/figure>\n\n\n\n<p>When prompted, reset your admin password.<\/p>\n\n\n\n<p>Setup your Redmine profile;<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1882\" height=\"816\" src=\"https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/08\/redmine-dashboard-3.png\" alt=\"install Redmine on Ubuntu\" class=\"wp-image-10028\" title=\"\" srcset=\"https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/08\/redmine-dashboard-3.png?v=1628661338 1882w, https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/08\/redmine-dashboard-3-768x333.png?v=1628661338 768w, https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/08\/redmine-dashboard-3-1536x666.png?v=1628661338 1536w\" sizes=\"(max-width: 1882px) 100vw, 1882px\" \/><\/figure>\n\n\n\n<p>Create Projects<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1902\" height=\"695\" src=\"https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/08\/project-1.png\" alt=\"install Redmine on Ubuntu\" class=\"wp-image-10029\" title=\"\" srcset=\"https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/08\/project-1.png?v=1628661383 1902w, https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/08\/project-1-768x281.png?v=1628661383 768w, https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/08\/project-1-1536x561.png?v=1628661383 1536w\" sizes=\"(max-width: 1902px) 100vw, 1902px\" \/><\/figure>\n\n\n\n<p>That concludes our guide on how to install Redmine on Ubuntu. You can now explore this awesome tool.<\/p>\n\n\n\n<p>Read more on how to use&nbsp;<a href=\"https:\/\/www.redmine.org\/projects\/redmine\/wiki\/Guide\" target=\"_blank\" rel=\"noreferrer noopener\">Redmine User Guide<\/a>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"reference\">Reference<\/h3>\n\n\n\n<p><a rel=\"noreferrer noopener\" href=\"https:\/\/www.redmine.org\/projects\/redmine\/wiki\/RedmineInstall\" target=\"_blank\">Redmine Install<\/a><\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"other-tutorials\">Other Tutorials<\/h3>\n\n\n\n<p><a href=\"https:\/\/kifarunix.com\/install-vtiger-crm-on-rocky-linux-8\/\" target=\"_blank\" rel=\"noreferrer noopener\">Install Vtiger CRM on Rocky Linux 8<\/a><\/p>\n\n\n\n<p><a href=\"https:\/\/kifarunix.com\/install-redmine-on-rocky-linux-8\/\" target=\"_blank\" rel=\"noreferrer noopener\">Install Redmine on Rocky Linux 8<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>In this guide, you will learn how to install Redmine on Ubuntu 22.04.&nbsp;Redmine&nbsp;is cross-platform and cross-database, flexible project management tool written on Ruby on Rails<\/p>\n","protected":false},"author":1,"featured_media":10031,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"rank_math_lock_modified_date":false,"footnotes":""},"categories":[121],"tags":[4767,4770,1172,4769,4768],"class_list":["post-11964","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-howtos","tag-install-redmine-on-ubuntu","tag-install-redmine-on-ubuntu-on-ubuntu-22-04","tag-redmine","tag-redmine-ubuntu-22-04","tag-ubuntu-22-04-redmine","generate-columns","tablet-grid-50","mobile-grid-100","grid-parent","grid-50","resize-featured-image"],"_links":{"self":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts\/11964"}],"collection":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/comments?post=11964"}],"version-history":[{"count":14,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts\/11964\/revisions"}],"predecessor-version":[{"id":20425,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts\/11964\/revisions\/20425"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/media\/10031"}],"wp:attachment":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/media?parent=11964"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/categories?post=11964"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/tags?post=11964"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}