Skip to content

Configuration

All configuration is done via environment variables with the MATTERMOST_ prefix.

For authentication-related variables (MATTERMOST_AUTH_MODE, MATTERMOST_TOKEN, all MATTERMOST_OAUTH_*), see Authentication.

Required Variables

Variable Description
MATTERMOST_URL Mattermost server URL (e.g., https://mattermost.example.com)

Optional Variables

Variable Default Description
MATTERMOST_TIMEOUT 30 Request timeout in seconds (1-300)
MATTERMOST_MAX_RETRIES 3 Maximum retry attempts for failed requests (0-10)
MATTERMOST_VERIFY_SSL true Verify SSL certificates
MATTERMOST_EXTRA_CA_CERTS Path to extra PEM CAs appended to the default trust store
MATTERMOST_LOG_LEVEL INFO Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
MATTERMOST_LOG_FORMAT json Log format: json for production, text for development
MATTERMOST_API_VERSION v4 Mattermost API version

Environment File

You can also use a .env file in the working directory:

MATTERMOST_URL=https://mattermost.example.com
MATTERMOST_TOKEN=your-token-here
MATTERMOST_TIMEOUT=60
MATTERMOST_LOG_LEVEL=DEBUG