photoprism/.github/ISSUE_TEMPLATE/bug_report.md

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

---

**What does not work as expected?**

If you ARE UNSURE, need TECHNICAL SUPPORT, or have a GENERAL QUESTION:
PLEASE NEVER USE GITHUB ISSUES! THANK YOU 💐

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.