---
name: Bug report
about: Found something not working as expected? Please file a detailed bug report so we can fix it quickly!
title: "[BUG] <short description>"
labels: bug
assignees: ""
---

🛑 **Note**: Please search existing issues before filing a new one. This helps avoid duplicates and ensures we can address your concern efficiently!

## 🐞 Bug Description

A clear and concise description of the issue. What went wrong?

## 🔄 Steps to Reproduce

Steps to reproduce the behavior:

1.
2.
3.
4. Observe the error

## ✅ Expected Behavior

What did you expect Voyage to do?

## 📸 Screenshots / Logs

- Attach screenshots if it helps explain the problem.
- If possible, include **relevant log excerpts** (be sure to remove sensitive info).

## 🐳 Environment Details

- **Platform:** (Docker, Synology, Proxmox, TrueNAS, Unraid, etc.)
- **Install Method:** (Docker Compose, Quick Install Script, Manual, etc.)
- **Voyage Version:** (e.g., v0.12.0)
- **Reverse Proxy:** (e.g., Nginx, Traefik, Caddy, etc. or None)

If using Docker and the issue is related to the container, it may be helpful to include your `docker-compose.yml` or relevant variables below.  
⚠️ Please remember to redact any sensitive information such as passwords or API keys.

## 📎 Additional Context

Anything else that might be useful (custom configuration, network setup, database version, etc.)?

---

Thank you for taking the time to report this issue! We appreciate your help in making Voyage better. We’ll look into it as soon as we can. 🙌
