photoprism/.github/ISSUE_TEMPLATE/bug_report.md
2022-01-10 15:05:04 +01:00

2.7 KiB

name about title labels assignees
Bug Report Create a report to help us improve Bug: Short Issue Description bug

What does not work as expected?

ONLY CREATE A NEW ISSUE AFTER YOU HAVE VERIFIED THAT NO SIMILAR OR RELATED ISSUE ALREADY EXISTS: https://github.com/photoprism/photoprism/issues

Never use GitHub Issues if you are unsure, have a general question, or need assistance. Thank you! 💐

You are welcome to use GitHub Discussions instead: https://github.com/photoprism/photoprism/discussions

Our troubleshooting checklists help you quickly find and fix common problems: https://docs.photoprism.app/getting-started/troubleshooting/

Sponsors receive direct technical support via email: https://photoprism.app/contact 📬

How can we reproduce it?

Steps to reproduce the behavior:

  1. Go to '...'
  2. Click on '....'
  3. Scroll down to '....'
  4. See error

If reporting a performance or indexing issue, please include the number and type of pictures in your library, as well as any configuration options you have changed e.g. for thumbnail quality.

What behavior do you expect?

A clear and concise description of what you expected to happen.

What could be the cause of your problem?

Before reporting a bug, try to determine the cause of your problem: https://docs.photoprism.app/getting-started/troubleshooting/

Can you provide us with example files for testing, error logs, or screenshots?

Please add example files or screenshots that help to reproduce your problem. You may also send files via email or share a download link: https://photoprism.app/contact

Learn how to diagnose frontend issues: https://docs.photoprism.app/getting-started/troubleshooting/browsers/

Which software versions do you use?

Your app version / build number can be found in Settings when you scroll to the bottom.

  • PhotoPrism Architecture & Build Number
  • Database Type & Version (MySQL or SQLite)
  • Operating System Types & Versions (Linux, Windows, Android,...)
  • Browser Types & Versions (Firefox, Chrome, Safari on iPhone,...)
  • Browser Plugins (if any)

What device is the backend running on?

This is especially important if you are reporting a performance, timing, or indexing problem. You can skip this if you are reporting a problem found on our public demo, or if it is a completely unrelated issue, such as a broken page layout.

  • Device / Processor Type (Raspberry Pi 4, AMD Ryzen, Intel,...)
  • Physical Memory incl Swap Space (in GB)
  • Storage Type (HDD, SSD, RAID, USB, Network Storage,...)
  • anything else that might be helpful

Do you use a proxy, load balancer, firewall, VPN, or CDN?

If yes, please specify type and version. You can skip this if you are reporting a completely unrelated issue.