.env.example

# Redmine MCP Configuration
# Copy this file to .env and update the values

# Authentication Options:
# Option 1: Username and Password (traditional)
REDMINE_URL=https://your-redmine-server.com
REDMINE_USERNAME=your_username
REDMINE_PASSWORD=your_password


# Option 2: API Key (alternative to username/password)
# Uncomment and set this if you want to use API key authentication instead
# REDMINE_API_KEY=your_api_key

# Authentication mode: "oauth" or "legacy" (default: legacy)
# - legacy: uses REDMINE_API_KEY or REDMINE_USERNAME/REDMINE_PASSWORD below
# - oauth:  validates per-request Bearer tokens against Redmine; requires REDMINE_MCP_BASE_URL
REDMINE_AUTH_MODE=legacy

# OAuth2 configuration (only required when REDMINE_AUTH_MODE=oauth)
# Public base URL of this MCP server (no trailing slash)
# e.g. https://redmine.mcp.example.com or http://localhost:3040
REDMINE_MCP_BASE_URL=http://localhost:3040

# Server configuration
SERVER_HOST=0.0.0.0
SERVER_PORT=8000

# Public URL configuration for file serving
# External hostname/IP for generated download URLs
PUBLIC_HOST=localhost
PUBLIC_PORT=8000

# File Management (Optional)
# Directory where downloaded attachments are stored
ATTACHMENTS_DIR=./attachments

# Automatic cleanup configuration
AUTO_CLEANUP_ENABLED=true
CLEANUP_INTERVAL_MINUTES=10

# Default expiry time for downloaded attachments (in minutes)
ATTACHMENT_EXPIRES_MINUTES=60

# Read-only mode (optional)
# When enabled, write operations (create/update/delete) are blocked
# REDMINE_MCP_READ_ONLY=false

# Required custom field autofill (optional)
# Retries once on relevant create/update validation errors (blank/invalid custom fields)
# REDMINE_AUTOFILL_REQUIRED_CUSTOM_FIELDS=false
# REDMINE_REQUIRED_CUSTOM_FIELD_DEFAULTS={}

# SSL Certificate Configuration (Optional)
# Enable/disable SSL certificate verification (default: true)
# WARNING: Only set to false for development/testing environments!
REDMINE_SSL_VERIFY=true

# Path to custom CA certificate file for self-signed certificates
# Supports .pem, .crt, .cer formats
# Example: REDMINE_SSL_CERT=/path/to/ca-bundle.crt
# REDMINE_SSL_CERT=

# Client certificate for mutual TLS authentication
# Single file: REDMINE_SSL_CLIENT_CERT=/path/to/client.pem
# Separate cert and key: REDMINE_SSL_CLIENT_CERT=/path/to/cert.pem,/path/to/key.pem
# Note: Private keys must be unencrypted
# REDMINE_SSL_CLIENT_CERT=