portainer/portainer

View on GitHub
.github/ISSUE_TEMPLATE/bug_report.yml

Summary

Maintainability
Test Coverage
name: Bug Report
description: Create a report to help us improve.
labels: kind/bug,bug/need-confirmation
body:

  - type: markdown
    attributes:
      value: |
        # Welcome!
        
        The issue tracker is for reporting bugs. If you have an [idea for a new feature](https://github.com/orgs/portainer/discussions/categories/ideas) or a [general question about Portainer](https://github.com/orgs/portainer/discussions/categories/help) please post in our [GitHub Discussions](https://github.com/orgs/portainer/discussions).
        
        You can also ask for help in our [community Slack channel](https://join.slack.com/t/portainer/shared_invite/zt-txh3ljab-52QHTyjCqbe5RibC2lcjKA).
        
        **DO NOT FILE ISSUES FOR GENERAL SUPPORT QUESTIONS**.

  - type: checkboxes
    id: terms
    attributes:
      label: Before you start please confirm the following.
      options:
        - label: Yes, I've searched similar issues on [GitHub](https://github.com/portainer/portainer/issues).
          required: true
        - label: Yes, I've checked whether this issue is covered in the Portainer [documentation](https://docs.portainer.io) or [knowledge base](https://portal.portainer.io/knowledge).
          required: true

  - type: markdown
    attributes:
      value: |
        # About your issue

        Tell us a bit about the issue you're having.

        How to write a good bug report:

        - Respect the issue template as much as possible.
        - Summarize the issue so that we understand what is going wrong.
        - Describe what you would have expected to have happened, and what actually happened instead.
        - Provide easy to follow steps to reproduce the issue. 
        - Remain clear and concise.
        - Format your messages to help the reader focus on what matters and understand the structure of your message, use [Markdown syntax](https://help.github.com/articles/github-flavored-markdown).

  - type: textarea
    attributes:
      label: Problem Description
      description: A clear and concise description of what the bug is. 
    validations:
      required: true

  - type: textarea
    attributes:
      label: Expected Behavior
      description: A clear and concise description of what you expected to happen.
    validations:
      required: true

  - type: textarea
    attributes:
      label: Actual Behavior
      description: A clear and concise description of what actually happens.
    validations:
      required: true

  - type: textarea
    attributes:
      label: Steps to Reproduce
      description: Please be as detailed as possible when providing steps to reproduce.
      placeholder: |
        1. Go to '...'
        2. Click on '....'
        3. Scroll down to '....'
        4. See error   
    validations:
      required: true

  - type: textarea
    attributes:
      label: Portainer logs or screenshots
      description: Provide Portainer container logs or any screenshots related to the issue.
    validations:
      required: false

  - type: markdown
    attributes:
      value: |
        # About your environment

        Tell us a bit about your Portainer environment.

  - type: dropdown
    attributes:
      label: Portainer version
      description: We only provide support for the most recent version of Portainer and the previous 3 versions. If you are on an older version of Portainer we recommend [upgrading first](https://docs.portainer.io/start/upgrade) in case your bug has already been fixed.
      multiple: false
      options:
        - '2.20.2'
        - '2.20.1'
        - '2.20.0'
        - '2.19.5'
        - '2.19.4'
        - '2.19.3'
        - '2.19.2'
        - '2.19.1'
        - '2.19.0'
        - '2.18.4'
        - '2.18.3'
        - '2.18.2'
        - '2.18.1'
        - '2.17.1'
        - '2.17.0'
        - '2.16.2'
        - '2.16.1'
        - '2.16.0'
    validations:
      required: true

  - type: dropdown
    attributes:
      label: Portainer Edition
      multiple: false
      options:
        - 'Business Edition (BE/EE) with 5NF / 3NF license'
        - 'Business Edition (BE/EE) with Home & Student license'
        - 'Business Edition (BE/EE) with Starter license'
        - 'Business Edition (BE/EE) with Professional or Enterprise license'
        - 'Community Edition (CE)'
    validations:
      required: true

  - type: input
    attributes:
      label: Platform and Version
      description: |
        Enter your container management platform (Docker | Swarm | Kubernetes) along with the version. 
        Example: Docker 24.0.3 | Docker Swarm 24.0.3 | Kubernetes 1.26
        You can find our supported platforms [in our documentation](https://docs.portainer.io/start/requirements-and-prerequisites).
    validations:
      required: true

  - type: input
    attributes:
      label: OS and Architecture
      description: |
        Enter your Operating System, Version and Architecture. Example: Ubuntu 22.04, AMD64 | Raspbian OS, ARM64
    validations:
      required: true

  - type: input
    attributes:
      label: Browser
      description: | 
        Enter your browser and version. Example: Google Chrome 114.0
    validations:
      required: false

  - type: textarea
    attributes:
      label: What command did you use to deploy Portainer?
      description: |
        Example: `docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest`
        If you deployed Portainer using a compose file or manifest you can provide this here as well.
      render: bash
    validations:
      required: false

  - type: textarea
    attributes:
      label: Additional Information
      description: Any additional information about your environment, the bug, or anything else you think might be helpful.
    validations:
      required: false