TURNKEYGNU / LINUX
English

Ready-to-use server

Roundup

Issue Tracking System

PythonIssue tracking
Web management interface: System overviewWeb management interface: System overview Roundup - List issuesRoundup - List issues Roundup - New issueRoundup - New issue

Roundup is a simple-to-use 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:

    • Roundup 2.6 is installed from its verified official PyPI source distribution in /home/roundup/venv. Python, the MariaDB driver and timezone data are maintained through Debian Trixie packages.

    • Roundup served via Apache mod_wsgi.

    • Domain to serve, set on first boot.

    • Disabled registration confirmation via email (requires mail server).

    • Includes full timezone support and documentation.

      Security note: Roundup updates may require a tracker migration, so they are not installed automatically. Back up the appliance, read the Roundup documentation, then install a selected release with:

      roundup-update VERSION

      The command obtains the release URL and SHA-256 digest from the official PyPI metadata, updates the deployed virtual environment, runs the Roundup tracker migration, and restarts Apache.

  • 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

Recommended settings:

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

Credentials (passwords set at first boot)

  • Webmin, Webshell, SSH, MySQL: username root

  • Roundup: username admin

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.