Achievement Engine Portainer Stack Builder

Import Existing Stack

Auto-fill from YML

Import a portainer-stack.yml to pre-fill all fields. Imported values flash green. Fields that are still required will be highlighted in amber.

Stack Basics

Shared Portainer Settings

Stack Name

Used only as a label in Portainer instructions.

Docker Network Name

Both containers join this bridge network.

Restart Policy

State DB Path In Container

Usually leave this alone.

Storage Mode

Use named volumes for a stack that works across Docker hosts. Use bind mounts only if you need direct host file access.

Achievement Engine Container

Image, Port, Volumes

Image

Container Name

Host Dashboard Port

Host Data Directory

Host Icons Directory

Needed if you use custom user icons and want to manage them from the host.

Host Covers Directory

Optional Host Static Override

Leave blank if you do not want to override built-in static files.

Timezone

Achievement Engine Environment

Core, Users, Progression, Wrapped

Poll Seconds

XP Start Timestamp

Verify Listen Threshold

Wrapped Year

Discord Proxy URL

Set this if you configured a Discord webhook on abs-stats. Routes achievement notifications through abs-stats to Discord.

Wrapped Boss HP

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.

Backfill Once Key

Strict Verification Require proof rules instead of trusting completion timestamps alone. Require Duration For Credit Exclude books with unknown duration when strict verification is on. Require In-Scope Session Require at least one valid listening session inside the progression window. Run Achievement Backfill Once Use for one startup only, then turn it back off. Wrapped Enabled Enable the Wrapped year-end feature, boss battle, and related pages.

Allowed Users

Optional achievement-engine user filter.

User Aliases

User Icons

Pick an avatar for each user. Saved as /icons/users/filename.png paths in the YML.

User Emails

SMTP

Optional Email Notifications

SMTP Host

SMTP Port

SMTP Username

SMTP Password

SMTP From

SMTP To Override

Send Test Email on Startup Sends one test message when the container starts. Turn off again after confirming delivery.

ABS Stats Container

Companion Service

Image

Container Name

Host ABS Stats Port

Host ABS Stats Data Directory

Audiobookshelf URL* required

Full URL to your Audiobookshelf server. Without this abs-stats cannot fetch any listening data.

Engine URL Inside Docker Network

ABS Token

Single-user mode. Leave blank if using per-user tokens below.

ABS Tokens

Multi-user mode from the Unraid template.

Allowed Usernames

Discord Webhook URL

Optional XP Start Overrides

Generates user_xp_start.json

One username/date pair per line. Format: username=YYYY-MM-DD. This file should live inside the achievement engine data folder if you use it.

XP Start Overrides

Achievement Engine + ABS Stats

Import Existing Stack

Stack Basics

Achievement Engine Container

Achievement Engine Environment

SMTP

ABS Stats Container

Optional XP Start Overrides