docker-mailserver/.github/ISSUE_TEMPLATE/bug_report.yml

name: Bug Report
description: File a bug report
title: 'bug report: '
labels:
  - kind/bug/report
  - meta/needs triage

body:
  - type: markdown
    attributes:
      value: |
        # Filing a report

        Thank you for participating in this project and reporting a bug. Docker Mail Server (DMS) is a community-driven project, and each contribution counts. Maintainers and moderators are volunteers that need you to fill this template with accurate information in order to help you in the best and quickest way. We will have to label your request with `meta/no template - no support` if your request is sloppy and provides no way to help you correctly.

        Markdown formatting can be used in almost all text fields. The description will tell you if this is not the case for a specific field.

        Be as precise as possible, and if in doubt, it's best to add more information that too few.

        We provide official support for all options not marked with "not officially supported" or "unsupported". When something is "not officially supported", support for these cases is dependent on specific maintainers.

        ---
  - type: checkboxes
    id: preliminary-checks
    attributes:
      label: Preliminary Checks
      description: Please read these carefully.
      options:
        - label: I checked that all ports are open and not blocked by my ISP / hosting provider.
          required: true
        - label: I know that SSL errors are likely the result of a wrong setup on the user side and not caused by DMS itself. I'm confident my setup is correct.
          required: true
        - label: I searched the issue tracker but was unable to find my issue.
          required: true
        - label: I read the [extended documentation in general](https://docker-mailserver.github.io/docker-mailserver/latest/) but found nothing to resolve the issue.
          required: true
        - label: I read the [documentation on debugging](https://docker-mailserver.github.io/docker-mailserver/latest/config/debugging/), tried the proposed steps to debug the problem, but was still unable to resolve the issue.
          required: true
        - label: I have read this project's [Code of Conduct](https://github.com/docker-mailserver/docker-mailserver/blob/master/CODE_OF_CONDUCT.md) and I agree
          required: true
  - type: input
    id: affected-components
    attributes:
      label: Affected Component(s)
      description: What is affected by this bug? Please describe it with only a few words here. Detailed description can be given later.
      placeholder: No debug output is shown.
    validations:
      required: true
  - type: textarea
    id: when-does-it-occur
    attributes:
      label: What happened and when does this occur?
      description: Tell us what happened. Use [fenced code blocks](https://docs.github.com/en/github/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks#fenced-code-blocks) when pasting lots of text!
      placeholder: Although `LOG_LEVEL=debug` is set, I see no debug output.
    validations:
      required: true
  - type: textarea
    id: what-did-you-expect-to-happen
    attributes:
      label: What did you expect to happen?
      description: Tell us what you expected.
      placeholder: I expected to see debug messages.
    validations:
      required: true
  - type: textarea
    id: how-do-we-replicate-this-issue
    attributes:
      label: How do we replicate the issue?
      description: What did you do and how can we replicate this issue?
      value: |
        1.
        2.
        3.
        ...        
    validations:
      required: true
  - type: input
    id: mailserver-version
    attributes:
      label: DMS version
      description: On which version (image tag) did you encounter this bug?
      placeholder: v10.1.2
    validations:
      required: true
  - type: dropdown
    id: operating-system
    attributes:
      label: What operating system is DMS running on?
      options:
        - Linux
        - macOS (not officially supported)
        - Windows (unsupported)
        - Other (unsupported)
    validations:
      required: true
  - type: input
    id: operating-system-version
    attributes:
      label: Which operating system version?
      placeholder: e.g. Debian 11
    validations:
      required: true
  - type: dropdown
    id: isa
    attributes:
      label: What instruction set architecture is DMS running on?
      options:
        - AMD64 / x86_64
        - ARM64 / AArch64 (ARM v8 and newer)
        - Other (unsupported)
    validations:
      required: true
  - type: dropdown
    id: container-orchestrator
    attributes:
      label: What container orchestration tool are you using?
      options:
        - Docker
        - Docker Compose
        - Podman (not officially supported)
        - Kubernetes (not officially supported)
        - Other (unsupported)
    validations:
      required: true
  - type: textarea
    id: important-environment-variables
    attributes:
      label: docker-compose.yml
      description: Show us your `docker-compose.yml` file or your equivalent `docker run` command, if applicable. This filed is formatted as YAML.
      render: yml
  - type: textarea
    id: relevant-log-output
    attributes:
      label: Relevant log output
      description: Show us relevant log output here. You can enable debug output by setting the environment variable `LOG_LEVEL` to `debug` or `trace`. This field's contents are interpreted as pure text.
      render: Text
  - type: textarea
    id: other-relevant-information
    attributes:
      label: Other relevant information
      description: If there is more, you can tell us here.
  - type: checkboxes
    id: experience
    attributes:
      label: What level of experience do you have with Docker and mail servers?
      description: >
        **You are not obliged to answer this question**.
        We do encourage answering though as it provides context to better assist you.
        Less experienced users tend to make common mistakes, which is ok; by letting us know we can spot those more easily. If you are experienced, we can skip basic questions and save time.        

      options:
        - label: I am inexperienced with docker
        - label: I am rather experienced with docker
        - label: I am inexperienced with mail servers
        - label: I am rather experienced with mail servers
        - label: I am uncomfortable with the CLI
        - label: I am rather comfortable with the CLI
  - type: input
    id: form-improvements
    attributes:
      label: Improvements to this form?
      description: If you have criticism or general feedback about this issue form, feel free to tell us so we can enhance the experience for everyone.
    validations:
      required: false