Redmine

Integrated SCM & Project Management

Redmine is a Rails web application that provides integrated project management features, issue tracking, and support for multiple version control programs. It includes calendar and gantt charts to aid visual representation of projects and their deadlines. It also features multi-project support, role based access control, a per-project wiki, and project forums.

The Redmine appliance includes all the standard features in TurnKey Core, and on top of that:

  • Redmine configurations:
    • Installed from upstream source code to /var/www/redmine

    Security note: Updates to Redmine may require supervision so they ARE NOT configured to install automatically. See Redmine documentation for upgrading.

    • Supports Git and Subversion.
    • Includes exemplary helloworld repositories.
    • Loaded default roles, trackers, statuses, workflows and enumerations.
    • Configured projects to use all available trackers (bug, feature, support).
  • SSL support out of the box.
  • Includes Phusion Passenger for Apache web server (mod_rails).
  • Postfix MTA (bound to localhost) to allow sending of email (e.g., password recovery).
  • Webmin modules for configuring Apache2, MySQL and Postfix.
  • Repository access:
    Name        Protocol access
    ----        ---------------
    Git         http://$ipaddr/git
                https://$ipaddr/git
                ssh://vcs@$ipaddr/git
    Subversion  http://$ipaddr/svn
                svn://addr/svn
                svn+ssh://vcs@$ipaddr/srv/repos/svn
    

    Repositories are stored in /srv/repos.

  • Recommended configurations:
    • settings->hostname and path
    • settings->email notifications

Usage details & Logging in for Administration

No default passwords: For security reasons there are no default passwords. All passwords are set at system initialization time.

Ignore SSL browser warning: browsers don't like self-signed SSL certificates, but this is the only kind that can be generated automatically. If you have a domain configured, then via Confconsole Advanced menu, you can generate free Let's Encypt SSL/TLS certificates.

Web - point your browser at either:

  1. http://12.34.56.789/ - not encrypted so no browser warning
  2. https://12.34.56.789/ - encrypted with self-signed SSL certificate

Note: some appliances auto direct http to https.

Username for redmine:

Login as username admin

Username for git, svn:

Login as username vcs

Username for database administration:

  1. Adminer; login as MySQL username adminer:

    https://12.34.56.789:12322/ - Adminer database management web app

  2. MySQL command line tool; log in as root (no password required):
    $ mysql --user root
    Welcome to the MySQL monitor.  Commands end with ; or \g.
    Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
    
    mysql>
    

Username for OS system administration:

Login as root except on AWS marketplace which uses username admin.

  1. Point your browser to:
  2. Login with SSH client:
    ssh root@12.34.56.789
    

    Special case for AWS marketplace:

    ssh admin@12.34.56.789
    

* Replace 12.34.56.789 with a valid IP or hostname.