Appliance category: 

Roundup

Issue Tracking System

Roundup is a simple-to-use and and powerful issue-tracking system with command-line, web and e-mail interfaces. Roundup is being used for bug tracking and TODO list management, issue management, customer help desk support, and sales lead tracking.

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

  • Roundup configurations:
    • Installed via pip into a python virtual env, within it's own user account. See /var/www for links to file paths.
    • Roundup served via Apache mod_python.
    • Disabled registration confirmation via email (requires mail server).
    • Includes Xapian full text indexer (recommended for large issue DB).
    • Includes full timezone support and documentation.

      Security note: Updates to Roundup may require supervision so they ARE NOT configured to install automatically. See Roundup documentation for upgrading. Please note specific user account and location of virtual env when updating.

  • SSL support out of the box.
  • Postfix MTA (bound to localhost) to allow sending of email (e.g., password recovery).
  • Webmin modules for configuring Apache2, MySQL and Postfix.

Initial configuration: /etc/roundup/tracker-config.ini

Required settings:

[tracker]
web = /                     (before)
web = http://appliance_ip/  (after)
# Note: If not set, links in emails will not include server address.

Recommended settings:

[main]
admin_email = admin
dispatcher_email = admin
[mail]
domain = example.com

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 roundup:

Login as username admin

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.