Install trac

Download Desktop Edition

A free-to-use desktop version is available on Docker. To access it, run this command in your Docker Desktop Terminal:

docker pull fintrac/trac-desktop:latest

You should now see the image listed. Click the pull icon and expand the optional settings.

The host port should be 8080. The container path is /mnt/trac. For the host path, create an empty folder on your local machine and select that.

Click Run. After a minute you should see a message saying “… Service is up and running”

Click on the host port link to open the application.

Note

If your organisation has an enterprise deployment of trac, your system administrator should be able to provide access, typically via the enterprise SSO mechanism.

Corporate firewalls

If you plan to use the Desktop version inside a corporate firewall you may need to install the company Root Certificate to avoid being blocked from accessing repositories. Seeing errors about network connections to GitHub is a sign you need to do this.

First, find your root certificate. An easy way to do this is to open a Chrome browser, connect to any external website and click the controller icon next to the website address.

Then click on the certificate to view it.

Select the root and then export.

The certificate should be stored in the config folder inside the trac data directory (the host path) assigned earlier. It needs a lower case name with no spaces, ending in .crt.

Finally, open the trac-platform.yaml file in your trac directory and add a reference to the root certificate in the top section, as highlighted.