# Intro

[Trac](https://trac.edgewall.org/) is a minimalistic approach to web-based management of software projects. Its goal is to simplify effective tracking and handling of software issues, enhancements and overall progress. 

Tracd running as a Standalone Server with [htpasswd](https://trac.edgewall.org/wiki/TracStandalone#BasicAuthorization:Usingahtpasswdpasswordfile) authentication enabled.

# Usage

The container run tracd service with UID=2000, expose 8055 port and mount /home/trac directory from host to tracd for projects. 

Here are some example snippets to help you get started creating a container.

## docker-compose

```yaml
services:
  trac:
    build:
      context: https://git.bitdeals.org/private/trac.git
      dockerfile: ./docker/Dockerfile
    image: registry.bitdeals.org/trac
    environment:
      - USER_UID=2000
      - USER_GID=2000
    volumes:
      - /home/trac:/home/trac
    ports:
      - "8055:8055"
```

## docker cli

```sh
docker run -d \
  -e USER_UID=2000 \
  -e USER_GID=2000 \
  -v /home/trac:/home/trac \
  -p 8055:8055 \
  registry.bitdeals.org/trac
```

# Parameters

Container images are configured using parameters passed at runtime.

|Parameter|Function|
|:--------|:-------|
|-p 8055|the port number to bind to|
|-e USER_UID=|tracd proccess UID|
|-e USER_GID=|tracd proccess GID|