Skip to main content
Configure Jenkins Job Insight using environment variables. All configuration options can also be overridden per-request in API payloads.

​
Jenkins Configuration

Jenkins connection settings. The service is tied to a single Jenkins instance via JENKINS_URL.
​
JENKINS_URL
string
required
Jenkins server URL. The service connects to this Jenkins instance for all analysis requests.
JENKINS_URL=https://jenkins.example.com
​
JENKINS_USER
string
required
Jenkins username for authentication.
JENKINS_USER=your-username
​
JENKINS_PASSWORD
string
required
Jenkins password or API token. Using an API token is recommended for security.
JENKINS_PASSWORD=your-api-token
​
JENKINS_SSL_VERIFY
boolean
default:"true"
Enable SSL certificate verification. Set to false for self-signed certificates.
JENKINS_SSL_VERIFY=false
In production, use properly signed certificates and keep this set to true.

​
AI Provider Configuration

​
AI_PROVIDER
string
required
AI provider to use for analysis. Must be one of: claude, gemini, or cursor.
AI_PROVIDER=claude
​
AI_MODEL
string
required
AI model identifier for the selected provider.
AI_MODEL=claude-opus-4-6[1m]
Model names vary by provider. Refer to your AI provider’s documentation for available models.
​
AI_CLI_TIMEOUT
integer
default:"10"
Timeout for AI CLI calls in minutes. Increase for slower models.
AI_CLI_TIMEOUT=15
Must be greater than 0. Invalid values default to 10 minutes.

​
Claude CLI Configuration

Claude CLI supports two authentication methods:
​
ANTHROPIC_API_KEY
string
Direct API key authentication (simplest method).
ANTHROPIC_API_KEY=your-anthropic-api-key
Vertex AI Authentication:
​
CLAUDE_CODE_USE_VERTEX
boolean
Enable Vertex AI authentication for Claude.
CLAUDE_CODE_USE_VERTEX=1
​
CLOUD_ML_REGION
string
Vertex AI region.
CLOUD_ML_REGION=us-east5
​
ANTHROPIC_VERTEX_PROJECT_ID
string
Google Cloud project ID for Vertex AI.
ANTHROPIC_VERTEX_PROJECT_ID=your-project-id

​
Gemini CLI Configuration

​
GEMINI_API_KEY
string
API key for Gemini CLI authentication.
GEMINI_API_KEY=your-gemini-api-key
Alternatively, use OAuth by running gemini auth login. No environment variable needed for OAuth.

​
Cursor Agent CLI Configuration

​
CURSOR_API_KEY
string
API key for Cursor Agent CLI authentication.
CURSOR_API_KEY=your-cursor-api-key
For web-based authentication in Docker, run: docker exec <container-name> agent login

​
Application Configuration

​
LOG_LEVEL
string
default:"INFO"
Log verbosity level. Options: DEBUG, INFO, WARNING, ERROR.
LOG_LEVEL=DEBUG
  • DEBUG - Detailed operation logs
  • INFO - Milestones and important events
  • WARNING - Warnings only
  • ERROR - Errors only
​
DEBUG
boolean
default:"false"
Enable debug mode with hot reload for development.
DEBUG=true
Only use in development environments. Not recommended for production.
​
HTML_REPORT
boolean
default:"true"
Generate HTML reports for analysis results.
HTML_REPORT=false
When enabled, self-contained dark-themed HTML reports are generated alongside JSON results.

​
Optional Defaults

These settings provide default values that can be overridden per-request in API payloads.
​
TESTS_REPO_URL
string
Default tests repository URL for cloning context.
TESTS_REPO_URL=https://github.com/org/test-repo
Can be overridden via tests_repo_url in the request payload.
​
CALLBACK_URL
string
Default callback webhook URL for async analysis results.
CALLBACK_URL=https://your-service.com/webhook/results
Can be overridden via callback_url in the request payload.
​
CALLBACK_HEADERS
string
Default callback headers as JSON string.
CALLBACK_HEADERS={"Authorization": "Bearer xxx"}
Can be overridden via callback_headers in the request payload.

​
Custom Prompt Configuration

​
PROMPT_FILE
string
default:"/app/PROMPT.md"
Path to custom analysis prompt file for AI behavior customization.
PROMPT_FILE=/app/PROMPT.md
Mount your custom prompt file to this path to customize AI analysis behavior. See Custom Prompts for details.

​
Jira Integration (Optional)

Jira integration is completely optional. When configured, the service searches Jira for existing bugs matching PRODUCT BUG failures.
​
JIRA_URL
string
Jira instance URL (Cloud or Server/DC). Setting this enables Jira integration.
# Jira Cloud
JIRA_URL=https://your-org.atlassian.net

# Jira Server/DC
JIRA_URL=https://jira.your-company.com
​
ENABLE_JIRA
boolean
Explicitly enable or disable Jira integration (overrides auto-detection).
ENABLE_JIRA=true
When omitted, Jira is automatically enabled if JIRA_URL and credentials are configured.

​
Jira Cloud Authentication

​
JIRA_EMAIL
string
Email address for Jira Cloud authentication.
JIRA_EMAIL=[email protected]
Required for Jira Cloud. Use with JIRA_API_TOKEN.
​
JIRA_API_TOKEN
string
API token for Jira Cloud authentication.
JIRA_API_TOKEN=your-jira-api-token
Generate API tokens from your Jira Cloud account settings.

​
Jira Server/DC Authentication

​
JIRA_PAT
string
Personal Access Token for Jira Server/DC authentication.
JIRA_PAT=your-personal-access-token

​
Jira Search Configuration

​
JIRA_PROJECT_KEY
string
Scope Jira searches to a specific project.
JIRA_PROJECT_KEY=PROJ
When omitted, searches across all projects accessible to the authenticated user.
​
JIRA_SSL_VERIFY
boolean
default:"true"
SSL certificate verification for Jira connections.
JIRA_SSL_VERIFY=false
Only disable for self-signed certificates in development/testing environments.
​
JIRA_MAX_RESULTS
integer
default:"5"
Maximum number of Jira results per search.
JIRA_MAX_RESULTS=10
Must be greater than 0. AI filters results for relevance after retrieval.

​
Per-Request Overrides

Most environment variables can be overridden in API request payloads. This allows different configurations per analysis without changing the server environment.
See the Request Models for the complete list of request fields that override environment variables.
Exceptions (server-level only):
  • DEBUG - Server reload toggle
  • LOG_LEVEL - Server log verbosity
  • PROMPT_FILE - Server-local file path

​
Example .env File

# Jenkins Configuration (Required)
JENKINS_URL=https://jenkins.example.com
JENKINS_USER=your-username
JENKINS_PASSWORD=your-api-token
JENKINS_SSL_VERIFY=true

# AI Provider (Required)
AI_PROVIDER=claude
AI_MODEL=claude-opus-4-6[1m]

# Claude Authentication
ANTHROPIC_API_KEY=your-anthropic-api-key

# Logging
LOG_LEVEL=INFO

# Optional Defaults
TESTS_REPO_URL=https://github.com/org/test-repo

# Jira Integration (Optional)
JIRA_URL=https://your-org.atlassian.net
JIRA_EMAIL=[email protected]
JIRA_API_TOKEN=your-jira-api-token
JIRA_PROJECT_KEY=PROJ

Build docs developers (and LLMs) love

Get started for freeTalk to us