You are here
Roundup
![](https://www.turnkeylinux.org/files/images/icons/roundup.jpg)
Issue Tracking System
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.
Run from browser
V 18.0
V 17.1
GitHub
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:
- http://12.34.56.789/ - not encrypted so no browser warning
- 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:
- Adminer; login as MySQL username adminer:
https://12.34.56.789:12322/ - Adminer database management web app
- 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.
- Point your browser to:
- https://12.34.56.789:12321/ - System control panel
- https://12.34.56.789:12320/ - Web based command line terminal
- 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.