Install Redmine 6.0.3 on Debian 12.4 (MySQL)¶
Step 1: System Preparation¶
You need root privileges.
- Ensure all existing packages are up-to-date
- install vim
- install sudo
- Create user redmine - # set 17 random characters password
- make redmine to have sudo priviledges
- switch to redmine
- Install required dependencies
Step 2: Install and configure MySQL¶
- Secure the MySQL installation - be ready for many questions
- Create a database and user for Redmine - prepare <password>
- Check users
Step 3: Install Redmine¶
- Download and extract the latest stable Redmine version
Step 4: File Permissions¶
sudo chown -R www-data:www-data /opt/redmine sudo chmod -R 755 /opt/redmine sudo mkdir -p /opt/redmine/tmp /opt/redmine/tmp/pdf /opt/redmine/public/plugin_assets sudo chown -R www-data:www-data /opt/redmine/tmp /opt/redmine/public/plugin_assets sudo chmod -R 755 /opt/redmine/tmp /opt/redmine/public/plugin_assets
Step 5: Configure Redmine¶
- Ensure all existing packages are up-to-date
- Create the database configuration
- Add the following configuration (adjust as needed):
- Install Bundler
- Install required gems
- Generate the secret token
- Set up the database
Step 6: Configure Apache¶
- Create an Apache virtual host configuration
- Add the following configuration
<VirtualHost *:80> ServerName <your.domain.com> ServerAdmin <admin_email> DocumentRoot /opt/redmine/public <Directory "/opt/redmine/public"> Allow from all Require all granted Options -MultiViews </Directory> ErrorLog ${APACHE_LOG_DIR}/redmine_error.log CustomLog ${APACHE_LOG_DIR}/redmine_access.log combined PassengerRuby /usr/bin/ruby </VirtualHost> - check the syntax of your Apache configuration
- Enable the site and required modules
- check status
Step 7: Final Configuration¶
- Access Redmine through your web browser at http://your.domain.com
- If you see Apache2 Debian Default Page - Check the default Apache site is conflicting with your Redmine site
- Log in with default credentials:
- Username: admin
- Password: admin - Change the admin password immediately after the first login!
DONE.