Unraid Template Forge

// Import Existing Template Load a saved my-achievement-engine.xml or my-abs-stats.xml to pre-fill all fields below.

General Config

Container Name

Repository locked

Network

Dashboard Port (Host)

Timezone (TZ)

Path Mappings

// Achievement Engine

Data Path (/data)

Covers Path (/data/covers)

Optional: path for locally-served cover images.

Static/HTML Path (/static)

// ABS-Stats

AppData Path (/data)

Creates /mnt/user/appdata/abs-stats in Unraid.

Core System Variables

ABSSTATS_BASE_URL

POLL_SECONDS

XP Start Date

Converted to Unix timestamp at 00:01 on the selected day.

Logic & Thresholds

Verify Listen Threshold (0.0 - 1.0)

Strict Verification

Require Duration for Credit

Require In-Scope Session

Wrapped Boss HP

Wrapped Enabled

Show or hide Wrapped pages and links.

Wrapped Year (admin only)

Admin-only reporting year for Wrapped.

Radar Check Interval (hours)

How often Release Radar polls Audible for new releases. Default: 12

Admin Email

Email address for user Series Request submissions via /request page.

Maintenance

Run Achievement Backfill

Set true for one boot, then false.

Backfill Once Key

Notification Settings (SMTP)

SMTP Host

SMTP Port

SMTP Username

SMTP Password

SMTP From

SMTP To Override

User & Dashboard Customization

User Icons

User Aliases Mapping

Format: username:Alias,username2:Alias2

Allowed Users (optional)

Comma-separated ABS usernames to include.

Per-User XP Start Dates

Optional. Set an individual XP start date per username. Listening before this date won't count toward that user's levels. Leave blank to use the global XP Start Date for all users.

Username

Start Date

Place the downloaded user_xp_start.json into:
[your data path]/json/user_xp_start.json

ABS-Stats Container

ABS-Stats Connection

API Port (Host)

Host port abs-stats listens on (container always uses 3000). Change if 3000 is already in use.

Audiobookshelf URL

Full URL of your ABS server, e.g. http://192.168.1.50:13378

Engine URL (internal)

Internal URL for Achievement Engine container, e.g. http://achievement-engine:8000

ABS-Stats Auth & Users

ABS Token (single user)

Single-user API token from ABS Settings > Users > API Token. Leave empty if using per-user tokens.

ABS Tokens (per-user)

Format: username1:token1,username2:token2. Leave empty if using single token above.

Allowed Usernames

Comma-separated ABS usernames to track, or * for all users.

Discord Webhook URL

Optional. Discord webhook for achievement notifications.