About this repo

There are many trac docker or AWS marketplace (turnkey trac), but none of them allow users to follow the Trac official document.

This repo's spirit is: make a Docker for trac users to follow the official documents!

trac-docker

This repo is used to host a bunldle to create a docker container (based on latest Ubuntu server) running Trac, which is an enhanced wiki and issue tracking system for software development projects.

Trac uses a minimalistic approach to web-based software project management. It helps developers write great software while staying out of the way. Trac should impose as little as possible on a team's established development process and policies.

How to get the image

• Build it using Dockerfile

git clone https://github.com/silencej/trac-docker
cd trac-docker

docker build -t owen263/trac ./
# Or if you are in China, use China mirrors:
docker build -t owen263/trac --build-arg INCHINA=true .

• just pull it from Dockerhub

$ docker pull owen263/trac

How to run the container

Quick Start

Just run

docker run -d -p 8123:8123 --name my_trac stephenhsu/trac

After several seconds, you can visit the web page at http://localhost:8123

Environment Variables Explanations

Most of below

• TRAC_AUTH (default is ``):

  After configuring Account Manager, add TRAC_ADMIN user, set this to ACCTMNGR, to use the Account Manager plugin as the LoginModule.

• TRAC_ADMIN_NAME (default is trac_admin):

  the admin username of Trac

• TRAC_ADMIN_PASSWD (default is passw0rd):

  the admin password of Trac

• TRAC_PROJECT_NAME (default is trac_project):

  the Trac project name

• TRAC_DIR (default is /var/local/trac):

  This directory stores all the data and configurations. You can bind a volume when starting a container.

• TRAC_INI (default is $TRAC_DIR/conf/trac.ini):

  This ini file will be automatically generated by the container. Also you can made some customizations based on your needs.

• DB_LINK (default is sqlite:db/trac.db):

  A database system is needed. The database can be either SQLite, PostgreSQL or MySQL.

  Please refer https://trac.edgewall.org/wiki/TracInstall#MandatoryDependencies for more detailed infomation.

  • For the PostgreSQL database

    See DatabaseBackend for details.

  • For the MySQL database

    Trac works well with MySQL. Given the caveats and known issues surrounding MySQL, read the MySqlDb page before creating the database.

Wants More Secure

This container image is powered by Apache Web Server. You can make your own customizations (such as adding TLS etc.) in ./trac.conf and map to /etc/apache2/sites-available/trac.conf when starting a container.

docker run -d -p 8123:8123 -v ./trac.conf:/etc/apache2/sites-available/trac.conf --name my_trac stephenhsu/trac

Reference

• Trac Official Doc