Skip to content

Configuration

Opengist provides flexible configuration options through either a YAML file and/or environment variables. You would only need to specify the configuration options you want to change — for any config option left untouched, Opengist will simply apply the default values.

The configuration cheat sheet lists all available configuration options.

Configuration via YAML file

The configuration file must be specified when launching the application, using the --config flag followed by the path to your YAML file.

Usage with Docker Compose :

yml
services:
  opengist:
    # ...
    volumes:
    # ...
    - "/path/to/config.yml:/config.yml"

Usage via command line :

shell
./opengist --config /path/to/config.yml

You can start by copying and/or modifying the provided config.yml file.

Configuration via Environment Variables

Usage with Docker Compose :

yml
services:
  opengist:
    # ...
    environment:
      OG_LOG_LEVEL: "info"
      # etc.

Usage via command line :

shell
OG_LOG_LEVEL=info ./opengist

Using Docker Compose secrets

You can use Docker Compose secrets to not expose sensitive information in your compose file, using a .env file.

dotenv
# file secrets.env
OG_GITLAB_CLIENT_KEY=your_gitlab_client_key
OG_GITLAB_SECRET=your_gitlab_secret_key

And then use it in your compose file :

yml
services:
  opengist:
    # ...
    secrets:
      - opengist_secrets

secrets:
  opengist_secrets:
    file: ./secrets.env