# My cgit docker container

## Usage

### Docker compose

Bind mount your git repos to `/repos`.

The `SITE_ADDRESS` environment variable is passed directly to Caddy as the site address. If unset, defaults to `:80` (plain HTTP, no TLS).

### Standalone (Caddy handles TLS)

Mount a data folder to `/root/.local/share/caddy` to persist certificates.

    services:
      cgit:
        build: ./cgit
        ports:
          - "443:443"
          - "80:80"
        volumes:
          - ~/repos:/repos
          - ./data:/root/.local/share/caddy
        environment:
          SITE_ADDRESS: git.example.com

### Behind a reverse proxy

Leave `SITE_ADDRESS` unset (defaults to `:80`). Bind the port to localhost only and let the external proxy handle TLS.

    services:
      cgit:
        build: ./cgit
        ports:
          - "127.0.0.1:8080:80"
        volumes:
          - ~/repos:/repos

Then in your external Caddyfile:

    git.example.com {
        reverse_proxy localhost:8080
    }