Skip to content

mastermindg/trac-docker-ubuntu

Repository files navigation

trac-docker

Docker Hub

This repo is used to host a bunldle to create a docker container (based on Ubuntu Trusty) 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.

The Dockerfile comes with a number of environment variables that can be set at build time or at run time.

How to get the image

  • Build it using Dockerfile

    $ git clone https://github.com/mastermindg/trac-docker-ubuntu $ cd trac-docker-ubuntu $ docker build -t trac ./ 
  • just pull it from Dockerhub

    $ docker pull mastermindg/trac-ubuntu 

How to run the container

Quick Start

Just run

$ docker run -d -p 80:80 --name my_trac mastermindg/trac-ubuntu 

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

Environment Variables Explanations

Most of below

  • TRAC_ADMIN_NAME (default is trac_admin):

    the admin username of Trac

  • TRAC_ADMIN_PASS (default is passw0rd):

    the admin password of Trac

  • TRAC_PROJECT_NAME (default is trac_project):

    the Trac project name

  • TRAC_DIR (default is /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.

      • Build it for use with a MySQL database
      $ git clone https://github.com/mastermindg/trac-docker-ubuntu $ cd trac-docker-ubuntu $ docker build -t trac --build-arg DB_LINK="mysql://trac:trac@mysql:3306/trac" . 

      OR

      • Run it with a MySQL Database
      $ docker run -d -p 80:80 --name trac -e DB_LINK="mysql://trac:trac@mysql:3306/trac" mastermindg/trac-ubuntu 

This can be run off of a mount to persist the data:

docker run -d --name trac -p 80:80 -v /home/me/trac:/trac -e TRAC_PROJECT_NAME=custom_name mastermindg/trac-ubuntu 

Reference

About

Trac on an Ubuntu-based Docker Image

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages