# Contact MusicHoarder

> How to reach the MusicHoarder project: GitHub issues for bugs and features, private security advisories for vulnerabilities, and pull requests for contributions.

## Where to reach us

MusicHoarder is an open-source project rather than a company, so every support channel is public and lives on GitHub. There is no sales team and no support contract — but issues are read, and a reproducible bug report is the fastest way to get something fixed.

- [Report a bug or request a feature](https://github.com/Jeffreyyvdb/MusicHoarder/issues): the main channel; include your version, logs and steps to reproduce
- [Report a security vulnerability](https://github.com/Jeffreyyvdb/MusicHoarder/security): private advisory — please do not use a public issue
- [Contribute a change](https://github.com/Jeffreyyvdb/MusicHoarder/pulls): pull requests welcome; see CONTRIBUTING.md in the repository
- [Maintainer](https://github.com/Jeffreyyvdb): Jeffrey van den Brink

## Before you open an issue

MusicHoarder is self-hosted, which means most problems are reproducible only with a little context from your deployment. Including the following turns a report into a fix instead of a conversation:

- The release version you are running, from the footer of your instance or the Releases page.
- How you deployed: Docker Compose, a build from source, or the Aspire dev stack.
- What you expected to happen and what happened instead, with the relevant API or container logs.
- For a matching problem: the file involved, the provider verdicts shown in the Inbox, and whether fpcalc and an AcoustID key are configured.

Please do not include secrets in an issue. API keys, database passwords and magic-link URLs are all worth redacting before you paste a log.

## Response times

This is a side project maintained in spare time, so support is best effort. Security reports get priority and usually receive an initial response within a few days. Bug reports and feature requests are triaged in the open on the issue tracker, and there is no private queue that jumps ahead of it.

_Last updated: 2026-08-21._