Redmine

A flexible project management web application.

Accessing the Web Interface

Visit the web interface: https://IP (replace IP with your server’s IP address)

Accept SSL warning (self-signed certificate).

Login using the default Redmine credentials:

  • Username: admin
  • Password: admin

Immediately change the admin password after first login.

Configure authentication settings: AdministrationSettingsAuthentication (or directly: /settings?tab=authentication)

  • Authentication required
  • Self-registration

Important Files & Directories

  • Application installation: /root/redmine
  • Docker Compose file: /root/redmine/docker-compose.yml
  • Environment variables: /root/redmine/.env
  • MySQL data volume: /var/lib/docker/volumes/redmine_mysql_data/_data
  • Redmine attachments (files): /var/lib/docker/volumes/redmine_redmine-data/_data
  • Redmine plugins: /var/lib/docker/volumes/redmine_redmine-plugins/_data
  • Redmine themes: /var/lib/docker/volumes/redmine_redmine-themes/_data
  • Nginx site config: /etc/nginx/sites-available/redmine
  • SSL certificates: /etc/nginx/ssl/

Service Management

Check container status:

docker ps

Restart Redmine:

docker restart redmine

View Redmine logs:

docker logs -f redmine

Check Nginx status:

systemctl status nginx

Restart Nginx:

systemctl restart nginx

Enabling SSL with a Domain

1. Point your domain to the server IP.

2. Edit Nginx config and replace both server_name <IP>; with your domain (<your-domain>) for both HTTP (port 80) and HTTPS (port 443) blocks:

vim /etc/nginx/sites-available/redmine

3. Install Certbot:

apt install -y certbot python3-certbot-nginx

4. Run the following command to generate a valid Let’s Encrypt certificate:

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

5. Replace SSL paths in Nginx config:

vim /etc/apache2/sites-available/redmine
# Before:
    # ssl_certificate /etc/nginx/ssl/fullchain.pem;
    # ssl_certificate_key /etc/nginx/ssl/privkey.pem;
# After:
    # ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    # ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

6. Restart Nginx to apply the changes:

systemctl restart nginx

7. Open your browser and visit: https://yourdomain.com

Application Details