How to configure Redmine
To configure Redmine, you need to follow a series of steps that involve installing dependencies, setting up the database, configuring the application, and preparing your web server. These steps are similar across most installations, whether you use Ubuntu or another supported platform.
Basic Redmine Configuration Steps:
-
Install Required Dependencies
-
Install necessary packages such as Ruby, Rails, a web server (Apache or Nginx with Passenger), and a database (MySQL, MariaDB, or PostgreSQL).
-
-
Install Redmine
-
You can install Redmine from the package manager or download it from the official website.
-
-
Set Up the Database
-
Create a new database and database user for Redmine. Grant the required permissions.
-
-
Configure the Database Connection
-
Copy the sample database configuration file and edit it with your database credentials:
textcp config/database.yml.example config/database.yml
nano config/database.yml
Fill in the username, password, and database name you created.
-
-
Generate a Secret Token
-
This is necessary for session security:
textbundle exec rake generate_secret_token
-
-
Create the Database Schema
-
Initialize the Redmine database with the required tables:
textRAILS_ENV=production bundle exec rake db:migrate
-
On Windows:
textset RAILS_ENV=production bundle exec rake db:migrate
-
-
-
Load Default Data (Optional but Recommended)
-
This step populates the database with default configuration data, including languages:
textRAILS_ENV=production bundle exec rake redmine:load_default_data
-
-
Set File System Permissions
-
Ensure the web server or Redmine user owns and can write to the necessary directories like
files
,log
,tmp
, and relevant asset directories.
-
-
Configure Your Web Server
-
For Apache:
-
Edit Apache config files, set up Passenger, and create needed symlinks.
-
Restart the web server after changes:
textsudo service apache2 restart
-
-
-
Start Redmine
-
Start the application server (e.g., Puma or Passenger). Verify access via a web browser.
-
-
Log In as Administrator
-
Default credentials are usually:
-
Username:
admin
-
Password:
admin
-
-
Change the password after the first login.
-
-
Adjust Redmine Settings
-
Go to Administration > Settings in the web interface to customize notification, email, attachment, issue tracking, and integration settings.
-