Unraid

Installieren Sie einen AIO-Container. Fügen Sie keine Community-Applications-Vorlagen für Sonarr, Radarr oder Download-Clients hinzu — AIO führt die selbst aus.

Vorlagen in diesem Repo

Datei	Zweck
unraid/templates/aio-media-manager.xml	Docker-Vorlage (Ports, Pfade, Umgebung)
unraid/ca_profile.xml	Profil des Community-Applications-Betreuers
unraid.xml	Älterer Pfad für dieselbe Vorlage (Kompatibilität)

Ordner über SSH anlegen

Aktivieren Sie SSH (Settings → Management Access), dann:

ssh root@<unraid-ip>

Downloads und Medien liegen auf der User Share aio-media-manager (sichtbar in Shares / im Dateibrowser). Die Config bleibt in appdata.

mkdir -p \
  /mnt/user/appdata/aio-media-manager/vpn \
  /mnt/user/backups/aio-media-manager \
  /mnt/user/aio-media-manager/downloads \
  /mnt/user/aio-media-manager/media

chown -R 99:100 \
  /mnt/user/appdata/aio-media-manager \
  /mnt/user/backups/aio-media-manager \
  /mnt/user/aio-media-manager

/mnt/user/backups/aio-media-manager nimmt die Konfigurationssicherungen auf. Nutzen Sie eine Share, die auf dem Array liegt (nicht nur auf dem Cache-Pool), damit ein Cache-Ausfall die Sicherungen nicht mitnimmt.

Serien, Filme, Anime, Musik, Bücher, Comics, vollständige/unvollständige Downloads, Torrent-Kategorien und Transcode-Caches werden beim ersten Start in diesen Mounts angelegt.

99:100 ist Unraid nobody/users (PUID 99, PGID 100). Wenn Sie einen eigenen Share-Benutzer nutzen, führen Sie id thatuser aus und chown auf diese UID:GID.

Für Hardlinks lassen Sie Downloads und Medien als Unterordner eines Cache- oder Plattenpfads (nicht zwei /mnt/user-FUSE-Shares), zum Beispiel eine nur-Cache-Share namens aio-media-manager:

mkdir -p /mnt/cache/aio-media-manager/downloads /mnt/cache/aio-media-manager/media
chown -R 99:100 /mnt/cache/aio-media-manager

Binden Sie /data dann an /mnt/cache/aio-media-manager (dieselbe Share, Plattenpfad) statt an /mnt/user/aio-media-manager.

Aus der Vorlage installieren (Ihr Server)

Option A — lokale Benutzervorlage

1. Kopieren Sie die XML auf den Flash-Stick:

mkdir -p /boot/config/plugins/dockerMan/templates-user
curl -fsSL \
  -o /boot/config/plugins/dockerMan/templates-user/my-aio-media-manager.xml \
  https://raw.githubusercontent.com/Qballjos/aio-media-server-manager/main/deploy/unraid/templates/aio-media-manager.xml

1. Docker → Add Container → wählen Sie aio-media-manager (oder my-aio-media-manager) in der Liste Template.
2. Bestätigen Sie Pfade, PUID/PGID und TZ, dann Apply.
3. Öffnen Sie http://<unraid-ip>:8080 und durchlaufen Sie den Assistenten.

Option B — Add Container von Hand

1. Docker → Add Container → erweiterte Ansicht.
2. Repository: ghcr.io/qballjos/aio-media-server-manager:latest
3. Network: bridge (oder host, wenn jede App-WebUI auf der Unraid-IP liegen soll).
4. Privileged: On (nötig für die VPN-Isolation von qBittorrent / Prowlarr / Flaresolverr). Mit VPN an warten diese Apps auf einen Live-WireGuard-Handshake; AIO cached ihre DNS über den Tunnel, damit kurze Aussetzer Prowlarr-Indexer nicht offline schalten. Details: DOCKER.md.
5. Extra parameters: --cap-add=NET_ADMIN --cap-add=SYS_MODULE
6. Optionales Gerät: /dev/dri für Intel/AMD-Transkodierung (weglassen, wenn es fehlt).
7. Ports (TCP): veröffentlichen Sie 8080 für den Manager und die installierten Kind-WebUIs (Sonarr 8989, Radarr 7878, qBittorrent 8081, SABnzbd 8085, Jellyfin 8096, Prowlarr 9696, Seerr 5055, Plex 32400, …). Vollständige Liste: INSTALL.md. Oder Network host.
8. Pfade:
9. /config → /mnt/user/appdata/aio-media-manager
10. /data → /mnt/user/aio-media-manager
11. /backups → /mnt/user/backups/aio-media-manager
12. /host/sys → /sys (nur lesend). Die Server-Karte auf Start zeigt dann den Netzwerkverkehr des Servers. Die Vorlage nennt das Host sys (erweitert). Ohne diese Zeile ist die Grafik nur der Verkehr dieses Containers.
13. Variablen: PUID=99, PGID=100, TZ=<IANA timezone>, AMM_DOWNLOAD_DIR=/data/downloads, AMM_MEDIA_DIR=/data/media. Optional: GITHUB_TOKEN.

Nach dem Aktualisieren des Images erstellen Sie den Container neu, damit hinzugefügte WebUI-Portzuordnungen gelten.

In Community Applications veröffentlichen (öffentlicher Katalog)

Community Apps hostet Ihre Dateien nicht. Sie halten ein öffentliches GitHub-Repo mit Vorlagen; der CA-Scanner von Lime Technology indexiert es, nachdem Sie es einreichen.

1. Ein Vorlagen-Repository vorbereiten

Empfohlen: ein eigenes öffentliches Repo (zum Beispiel Qballjos/unraid-templates), dessen Wurzel so aussieht:

ca_profile.xml
templates/aio-media-manager.xml

Aus diesem Projekt kopieren:

# from a clone of aio-media-server-manager
mkdir -p ../unraid-templates/templates
cp deploy/unraid/ca_profile.xml ../unraid-templates/
cp deploy/unraid/templates/aio-media-manager.xml ../unraid-templates/templates/

Dann:

1. Legen Sie das öffentliche GitHub-Repo an und pushen Sie main.
2. Bearbeiten Sie templates/aio-media-manager.xml und setzen Sie <TemplateURL> auf die raw-URL dieser Datei im neuen Repo (muss zum echten Pfad auf main passen).
3. Lassen Sie <Repository> bei ghcr.io/qballjos/aio-media-server-manager:latest (das Image bleibt auf GHCR; nur die Vorlagen-XML liegt im Vorlagen-Repo).
4. Optional: öffnen Sie einen Support-Thread im Unraid-Forum und tragen Sie die URL in ca_profile.xml bei <Forum> und in den <Support>-Tags der Vorlage ein (GitHub Issues reicht zum Start).

Sie können stattdessen das Haupt-Repo der App einreichen, wenn die XML auffindbar ist und jede App ein <Repository>-Tag hat, aber ein kleines eigenes Vorlagen-Repo ist, was CA-Betreuer meist erwarten.

2. Einreichen

1. Melden Sie sich unter https://ca.unraid.net/submit mit Ihrem Unraid- / Forenkonto an.
2. Registrieren Sie die GitHub-Repository-URL (das Vorlagen-Repo).
3. Führen Sie Validate und danach Scan aus. Beheben Sie gemeldete XML-Probleme.
4. Warten Sie auf die Moderation. Nach der Freigabe erscheint die App für alle unter dem Reiter Apps.

Hilfreiche Docs:

• Submission help
• Repository XML format
• XML field reference
• Browse catalog (prüfen Sie zuerst Namenskollisionen)

Nutzen Sie nicht den eingestellten Anfrageweg selfhosters/unRAID-CA-templates.

3. Nach der Aufnahme

• Liefern Sie Updates, indem Sie ein neues Container-Image veröffentlichen (:latest oder Semver-Tags). Nutzer aktualisieren über das Docker-Update von Unraid — die Vorlage müssen Sie in der Regel nicht bei jeder Veröffentlichung anheben.
• Ändern Sie die Vorlagen-XML nur, wenn sich Ports, Pfade oder Umgebungsvariablen ändern; CA liest <TemplateURL> beim Aktualisieren neu.

Privat / nur für sich (nicht der öffentliche Katalog)

Um eigene GitHub-Vorlagen ohne CA-Freigabe zu nutzen, hängen Sie die Repo-URL an:

/boot/config/plugins/dockerMan/template-repos

(eine URL pro Zeile). Die Vorlagen erscheinen dann unter Docker → Add Container. Das listet die App nicht im öffentlichen Community-Applications-Katalog.

FUSE / Hardlinks

Bevorzugen Sie /mnt/cache/aio-media-manager oder einen einzelnen Plattenpfad für Downloads und Medien, wenn Hardlinks zählen. /mnt/user (FUSE) mit einer Plattenshare zu mischen kann atomare Verschiebungen brechen.

Updates

Ändern Sie das Repository-Tag oder nutzen Sie das Container-Update von Unraid und erstellen Sie danach neu, damit neue Ports und der Host-sys-Mount gelten. Images werden von main als :latest und von Git-Tags als Semver veröffentlicht. Das aktualisiert AIO. Installierte Apps aktualisieren Sie unter Einstellungen → Updates (Zeitpläne standardmäßig aus).

Spenden

🤖 KI schreibt etwas Code. Ich mache ihn kaputt. Wir reparieren ihn zusammen.

Kein Kleingeld übrig? Geben Sie stattdessen einen Stern auf GitHub. Das füttert das Ego, und das ist fast genauso gut.

PayPal Ko-fi