Jira

​

What It Does

• fetches issues from one or more Jira projects using a JQL query
• converts issue content (summary, description) to Markdown for indexing
• optionally ingests issue comments as separate indexed content
• runs ingestion on configurable schedules

​

Authentication

• Basic auth (auth_type: basic): uses an email address and an API token. Suitable for Jira Cloud. Generate a token at id.atlassian.com/manage-profile/security/api-tokens.
• Personal Access Token (auth_type: token): uses a PAT as a Bearer token. Suitable for Jira Server, Data Center, and Jira Cloud.

​

Required Environment Variables

• JIRA1_SERVER_URL: base URL of your Jira instance (example: https://yourorg.atlassian.net)
• JIRA1_API_TOKEN: API token (basic auth) or Personal Access Token (PAT auth)
• JIRA1_EMAIL: Jira account email — required only when auth_type is basic
• JIRA1_JQL: JQL query to select issues (example: project = MYPROJECT ORDER BY updated DESC)
• JIRA1_SCHEDULES: ingestion interval in seconds (default: 3600)

​

config.yaml Example

​

Basic auth (Jira Cloud)

sources:
  - type: "jira"
    name: "jira1"
    enabled: true  # optional, default: true
    config:
      server_url: "${JIRA1_SERVER_URL}"
      auth_type: "basic"
      email: "${JIRA1_EMAIL}"
      api_token: "${JIRA1_API_TOKEN}"
      jql: "${JIRA1_JQL}"
      max_results: 50           # optional, default 50
      load_comments: true
      max_comments: 10          # optional, default 10
      schedules: "${JIRA1_SCHEDULES}"

​

PAT auth (Jira Server / Data Center)

sources:
  - type: "jira"
    name: "jira1"
    config:
      server_url: "${JIRA1_SERVER_URL}"
      auth_type: "token"
      api_token: "${JIRA1_API_TOKEN}"
      jql: "${JIRA1_JQL}"
      max_results: 50           # optional, default 50
      load_comments: true
      max_comments: 10          # optional, default 10
      schedules: "${JIRA1_SCHEDULES}"

​

Configuration Reference

​

Multiple Jira Sources