AMA-Unraid

AMA-Unraid

Docker app from crywolf203's Repository

Overview

AMA-Unraid is a community-maintained Unraid-focused fork of the archived RandomNinjaAtk/docker-ama project. AMA automates music archiving for use with applications such as Plex, Jellyfin, Emby, Kodi, and Lidarr. This template points to ghcr.io/crywolf203/ama-Unraid:latest and exposes the key AMA settings as Unraid template fields. Use only with content and accounts you are authorized to access.

Runtime arguments

Network
bridge
Shell
bash
Privileged
false

Template configuration

ConfigPathrw

Persistent AMA configuration, scripts, logs, cache, lists, and deemix data.

Target
/config
Default
/mnt/cache/appdata/ama-unraid
Value
/mnt/cache/appdata/ama-unraid
Downloads / Music LibraryPathrw

AMA download/output library path. If using Plex notification, this path should match the path your Plex Music library uses inside Plex.

Target
/downloads-ama
Default
/mnt/user/media/music
Value
/mnt/user/media/music
Download ClientVariable

Download backend. Use deemix_api to send albums to the external Deemix WebUI/API container and enable timed LRC fallback.

Target
DOWNLOAD_CLIENT
Default
deemix_api
Value
deemix_api
Deemix API URLVariable

URL for the running Deemix WebUI/API container. Example: http://SERVER-IP:6595

Target
DEEMIX_API_URL
Default
http://10.13.1.138:6595
Value
http://10.13.1.138:6595
Deemix Config Path In ContainerVariable

Container path where the Deemix config/login.json is mounted. Leave as /deemix-config unless you changed the path mapping.

Target
DEEMIX_CONFIG_PATH
Default
/deemix-config
Value
/deemix-config
Deemix Download Path In ContainerVariable

Container path where the Deemix downloads folder is mounted. Leave as /deemix-downloads unless you changed the path mapping.

Target
DEEMIX_DOWNLOAD_PATH
Default
/deemix-downloads
Value
/deemix-downloads
PUIDVariable

User ID for file ownership. 99 is the default Unraid nobody user.

Default
99
Value
99
PGIDVariable

Group ID for file ownership. 100 is the default Unraid users group.

Default
100
Value
100
AutostartVariable

true = run AMA automatically on container startup. false = manual runs only. Recommended to keep false until your configuration is tested.

Target
AUTOSTART
Default
false
Value
false
Script IntervalVariable

Amount of time between script runs when AUTOSTART=true. Examples: 15m, 1h, 1d.

Target
SCRIPTINTERVAL
Default
7d
Value
7d
ModeVariable

Download mode. Common values are artist or discography.

Target
MODE
Default
artist
Value
artist
ARL TokenVariable

Required account token used by the download client. Keep this private. Use only with accounts/content you are authorized to access.

Target
ARL_TOKEN
Related ArtistVariable

Enable related artist discovery from your artist list. Leave false for a safer first setup.

Target
RELATED_ARTIST
Default
false
Value
false
Related Artist RelatedVariable

Enable recursive related artist discovery. Warning: this can greatly expand processing.

Target
RELATED_ARTIST_RELATED
Default
false
Value
false
Related CountVariable

Maximum related artists to import per artist.

Target
RELATED_COUNT
Default
0
Value
0
Fan CountVariable

Minimum fan count required for related artist processing.

Target
FAN_COUNT
Default
10
Value
10
Concurrent DownloadsVariable

Download concurrency. Keep this low until tested.

Target
CONCURRENT_DOWNLOADS
Default
2
Value
2
Embedded Cover QualityVariable

Embedded cover image quality percentage. 100 = no compression.

Target
EMBEDDED_COVER_QUALITY
Default
100
Value
100
FormatVariable

Target audio format. Common values: FLAC, ALAC, AAC, MP3, OPUS.

Target
FORMAT
Default
FLAC
Value
FLAC
BitrateVariable

Target bitrate for lossy conversion when applicable.

Target
BITRATE
Default
320
Value
320
Force ConvertVariable

Force conversion to requested format when supported. Leave false for safer behavior.

Target
FORCECONVERT
Default
true
Value
true
Post Process ThreadsVariable

Number of threads used for format conversion and ReplayGain tagging.

Target
POSTPROCESSTHREADS
Default
8
Value
8
Album Type FilterVariable

Album types to skip/filter. Example: COMPILE, SINGLE, ALBUM, EP.

Target
ALBUM_TYPE_FILTER
Default
COMPILE
Value
COMPILE
Require QualityVariable

Require downloaded files to match the target file extension/quality.

Target
REQUIRE_QUALITY
Default
false
Value
false
ReplayGainVariable

Enable ReplayGain scanning/tagging.

Target
REPLAYGAIN
Default
true
Value
true
Ignore Artist Without ImageVariable

Skip artists with default/non-unique images.

Target
IGNORE_ARTIST_WITHOUT_IMAGE
Default
true
Value
true
Complete My ArtistsVariable

Add artist IDs found in the library that are not already in your list. Leave false unless you understand the workflow.

Target
COMPLETE_MY_ARTISTS
Default
false
Value
false
File PermissionsVariable

File permissions applied to processed files.

Target
FILE_PERMISSIONS
Default
777
Value
777
Folder PermissionsVariable

Folder permissions applied to processed folders.

Target
FOLDER_PERMISSIONS
Default
777
Value
777
Lidarr List ImportVariable

true = import artist list from Lidarr.

Target
LIDARR_LIST_IMPORT
Default
false
Value
false
Lidarr URLVariable

Lidarr URL. Only used when LIDARR_LIST_IMPORT=true. Example: http://10.13.1.138:8686

Target
LIDARR_URL
Lidarr API KeyVariable

Lidarr API key. Only used when LIDARR_LIST_IMPORT=true.

Target
LIDARR_API_KEY
Notify PlexVariable

true = notify Plex after changes. Plex must have a library using the same media path.

Target
NOTIFYPLEX
Default
false
Value
false
Plex Scan Path OverrideVariable

Optional. Path Plex sees for the same folder AMA writes to /downloads-ama. Example: /media/music. Leave blank if Plex also uses /downloads-ama.

Target
PLEXSCANPATH
Plex Library NameVariable

Exact Plex music library name. Only used when NOTIFYPLEX=true.

Target
PLEXLIBRARYNAME
Default
Music
Value
Music
Plex URLVariable

Plex server URL. Only used when NOTIFYPLEX=true.

Target
PLEXURL
Default
http://10.13.1.138:32400
Value
http://10.13.1.138:32400
Plex TokenVariable

Plex token. Only used when NOTIFYPLEX=true.

Target
PLEXTOKEN
Deemix ConfigPathrw

Host path to the Deemix WebUI config folder containing login.json.

Target
/deemix-config
Default
/mnt/cache/appdata/Deemix-1
Value
/mnt/cache/appdata/Deemix-1
Deemix DownloadsPathrw

Host path to the Deemix WebUI downloads folder. AMA reads completed downloads and timed LRC files from here.

Target
/deemix-downloads
Default
/mnt/user/media2/deemix-1
Value
/mnt/user/media2/deemix-1

Details

Repository
ghcr.io/crywolf203/ama-unraid:latest
Last Updated2026-05-31
First Seen2026-05-20

Run AMA-Unraid on Unraid.

AMA-Unraid is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.