add troubleshooting tips for Docker image pull issues

README.md

@@ -18,7 +18,7 @@
 </div>
 
 
-MediaManager is modern software to manage your TV and movie library. It is designed to be a replacement for Sonarr,
+MediaManager is a modern software to manage your TV and movie library. It is designed to be a replacement for Sonarr,
 Radarr, Overseer, and Jellyseer.
 It supports TVDB and TMDB for metadata, supports OIDC and OAuth 2.0 for authentication and supports Prowlarr and
 Jackett.
@@ -63,7 +63,6 @@ docker compose up -d
 <a href="https://buymeacoffee.com/maxdorninger"><img src="https://cdn.buymeacoffee.com/uploads/profile_pictures/2025/11/2VeQ8sTGPhj4tiLy.jpg" width="80px" alt="PuppiestDoggo" /></a>&nbsp;&nbsp;
 <a href="https://github.com/seferino-fernandez"><img src="https://avatars.githubusercontent.com/u/5546622" width="80px" alt="Seferino" /></a>&nbsp;&nbsp;
 
-
 ## Star History
 
 [![Star History Chart](https://api.star-history.com/svg?repos=maxdorninger/MediaManager&type=Date)](https://www.star-history.com/#maxdorninger/MediaManager&Date)

Writerside/topics/configuration-overview.md

@@ -30,4 +30,35 @@ The recommended way to install and run Media Manager is using Docker and Docker
 * For more information on the available configuration options, see the [Configuration section](Configuration.md) of the
   documentation.
 
-<include from="notes.topic" element-id="auth-admin-emails"></include>
+<include from="notes.topic" element-id="auth-admin-emails"></include>
+
+## MediaManager and MetadataRelay Docker Images
+
+MediaManager is available as a Docker image on both Red Hat Quay.io and GitHub Container Registry (GHCR):
+
+- `quay.io/maxdorninger/mediamanager`
+- `ghcr.io/maxdorninger/mediamanager/mediamanager`
+
+MetadataRelay Images are also available on both registries:
+
+- `quay.io/maxdorninger/metadata_relay`
+- `ghcr.io/maxdorninger/mediamanager/metadata_relay`
+
+From v1.12.1 onwards, both MediaManager and MetadataRelay images are available on both Quay.io and GHCR.
+The reason for the switch to Quay.io as the primary image registry is due
+to [GHCR's continued slow performance](https://github.com/orgs/community/discussions/173607).
+
+<note>
+    You can use either the Quay.io or GHCR images interchangeably,
+    as they are built from the same source and the tags are the same across both registries.
+</note>
+
+### Tags
+
+Both registries support the following tags:
+- `latest`: Points to the latest stable release.
+- `master`: Points to the latest commit on the master branch (may be unstable).
+- `X.Y.Z`: Specific version tags (e.g., `1.12.0`).
+- `X.Y`: Points to the latest release in the X.Y series (e.g., `1.12`).
+- `X`: Points to the latest release in the X series (e.g., `1`).
+- `pr-<number>`: Points to the latest commit in the specified pull request (e.g., `pr-67`).

Writerside/topics/troubleshooting.md

@@ -43,4 +43,15 @@ your media library, hard linking will not work.
 - If you configured a category with a special save path,
   <a href="qBittorrent-Category.md">carefully read this page about MM with qBittorrent save paths.</a>
 
-<note>If it still doesn't work, <a href="https://github.com/maxdorninger/MediaManager/issues">please open an Issue.</a> It is possible that a bug is causing the issue.</note>
+<note>If it still doesn't work, <a href="https://github.com/maxdorninger/MediaManager/issues">please open an Issue.</a> It is possible that a bug is causing the issue.</note>
+
+## Docker Image Pull Issues
+
+- If you get a 401 or 403 error when pulling the image from GHCR, this is not a permission issue with the
+  repository/image. It errors because your Docker client is misconfigured.
+- This is not a MediaManager issue per se, so please don't open an issue about this on the MediaManager GitHub repo.
+
+### Possible Fixes:
+
+- [Unable to pull image from GitHub Container Registry (Stack Overflow)](https://stackoverflow.com/questions/74656167/unable-to-pull-image-from-github-container-registry-ghcr)
+- [Try pulling the image from Quay.io](configuration-overview.md#mediamanager-and-metadatarelay-docker-images)

docker-compose.yaml

@@ -1,7 +1,7 @@
 services:
   mediamanager:
     container_name: mediamanager_server
-    image: ghcr.io/maxdorninger/mediamanager/mediamanager:latest
+    image: quay.io/maxdorninger/mediamanager:latest
     ports:
       - "8000:8000"
     environment: