authelia/.github/ISSUE_TEMPLATE/bug-report.yml

---
name: 'Bug Report'
description: 'Report a bug'
labels:
  - 'type/bug/unconfirmed'
  - 'status/needs-triage'
  - 'priority/4/normal'
body:
  - type: 'markdown'
    attributes:
      value: |
        Thanks for taking the time to fill out this bug report. If you are unsure if this is actually a bug and you still need some form of support we generally recommend creating a [Question and Answer Discussion](https://github.com/authelia/authelia/discussions/new?category=q-a) first.

        Please review the following requirements before submitting this issue type:

        1. Please ensure you do not report security vulnerabilities via this method. See our [Security Policy](https://www.authelia.com/security-policy).
        2. Please try to give as much information as possible for us to be able to reproduce the issue and provide a quick fix.
        3. Please ensure an issue does not already exist for this potential bug.
        4. Please only provide specific versions. Latest is not a version.
        5. Please only report bugs with Authelia itself. Issues which match one of the following criteria should not be reported here but should be a [discussion](https://github.com/authelia/authelia/discussions/new/choose) instead:
            - Bugs with third-party software.
            - Mistakes in the documentation.
            - Potential bugs where it is not somewhat clear that it's a bug with Authelia itself.
        6. Please read the [Troubleshooting](https://www.authelia.com/r/troubleshooting) reference guide:
            - Do not truncate any logs unless you are complying with the specific instructions in the [Logs](https://www.authelia.com/r/troubleshooting#logs) section.
            - If you plan on sanitizing, removing, or adjusting any values for the logs or configuration files please read the [Sanitization](https://www.authelia.com/r/troubleshooting#sanitization) section.
        7. Please consider including a [HTTP Archive File](https://www.authelia.com/r/har) if you're having redirection issues.
  - type: 'dropdown'
    id: 'version'
    attributes:
      label: |
        Version
      description: |
        What version(s) of Authelia can you reproduce this bug on?
      multiple: true
      options:
        - 'v4.37.5'
        - 'v4.37.4'
        - 'v4.37.3'
        - 'v4.37.2'
        - 'v4.37.1'
        - 'v4.37.0'
        - 'v4.36.9'
        - 'v4.36.8'
        - 'v4.36.7'
        - 'v4.36.6'
        - 'v4.36.5'
        - 'v4.36.4'
        - 'v4.36.3'
        - 'v4.36.2'
        - 'v4.36.1'
        - 'v4.36.0'
        - 'v4.35.6'
        - 'v4.35.5'
        - 'v4.35.4'
        - 'v4.35.3'
        - 'v4.35.2'
        - 'v4.35.1'
        - 'v4.35.0'
        - 'v4.34.6'
        - 'v4.34.5'
        - 'v4.34.4'
        - 'v4.34.3'
        - 'v4.34.2'
        - 'v4.34.1'
        - 'v4.34.0'
        - 'v4.33.2'
        - 'v4.33.1'
        - 'v4.33.0'
        - 'v4.32.2'
        - 'v4.32.1'
        - 'v4.32.0'
    validations:
      required: true
  - type: 'dropdown'
    id: 'deployment'
    attributes:
      label: |
        Deployment Method
      description: |
        How are you deploying Authelia?
      options:
        - 'Docker'
        - 'Kubernetes'
        - 'Bare-metal'
        - 'Other'
    validations:
      required: true
  - type: 'dropdown'
    id: 'proxy'
    attributes:
      label: |
        Reverse Proxy
      description: |
        What reverse proxy are you using?
      options:
        - 'Caddy'
        - 'Traefik'
        - 'Envoy'
        - 'Istio'
        - 'NGINX'
        - 'SWAG'
        - 'NGINX Proxy Manager'
        - 'HAProxy'
    validations:
      required: true
  - type: 'input'
    id: 'proxy-version'
    attributes:
      label: |
        Reverse Proxy Version
      description: |
        What is the version of your reverse proxy?
      placeholder: 'x.x.x'
    validations:
      required: false
  - type: 'textarea'
    id: 'description'
    attributes:
      label: |
        Description
      description: |
        Describe the bug.
    validations:
      required: true
  - type: 'textarea'
    id: 'reproduction'
    attributes:
      label: |
        Reproduction
      description: |
        Describe how we can reproduce this issue. This should be step by step and should include detailed and specific information. Abstract or generic information should be avoided. For example this should include specific application names and versions if relevant. Reproducing the issue is important so we can verify it exists, add relevant tests, and verify it is solved.
    validations:
      required: true
  - type: 'textarea'
    id: 'expectations'
    attributes:
      label: |
        Expectations
      description: |
        Describe the desired or expected results.
    validations:
      required: false
  - type: 'textarea'
    id: 'configuration'
    attributes:
      label: |
        Configuration (Authelia)
      description: |
        Provide a complete configuration file (the template will automatically put this content in a code block).
      render: 'yaml'
    validations:
      required: false
  - type: 'textarea'
    id: 'logs'
    attributes:
      label: |
        Logs (Authelia)
      description: |
        Provide complete logs with the log level set to debug or trace. Complete means from application start until the issue occurring. This is clearly explained in the [Logs](https://www.authelia.com/r/troubleshooting#logs) section of the troubleshooting guide.

        The template will automatically put this content in a code block so you can just paste it.
      render: 'shell'
    validations:
      required: true
  - type: 'textarea'
    id: 'logs-other'
    attributes:
      label: |
        Logs (Proxy / Application)
      description: |
        Provide complete debug logs for the affected proxy and/or application if available and relevant (the template will automatically put this content in a code block).
      render: 'shell'
    validations:
      required: false
  - type: 'textarea'
    id: 'documentation'
    attributes:
      label: |
        Documentation
      description: |
        Provide any relevant specification or other documentation if applicable.
    validations:
      required: false
  - type: 'checkboxes'
    id: 'checklist'
    attributes:
      label: |
        Pre-Submission Checklist
      description: |
        By submitting this issue confirm all of the following.
      options:
        - label: |
            I agree to follow the [Code of Conduct](http://www.authelia.com/code-of-conduct)
          required: true
        - label: |
            This is a bug report and not a support request
          required: true
        - label: |
            I have read the security policy and this bug report is not a security issue or security related issue
          required: true
        - label: |
            I have either included the complete configuration file or I am sure it's unrelated to the configuration
          required: true
        - label: |
            I have provided all of the required information in full with the only alteration being reasonable sanitization in accordance with the [Troubleshooting Sanitization](https://www.authelia.com/r/sanitize) reference guide
          required: true
        - label: |
            I have checked for related proxy or application logs and included them if available
          required: true
        - label: |
            I have checked for related issues and checked the documentation
          required: true
...