Skip to content
Zephras Isle artwork from World of Warcraft: Forever
Artwork from World of Warcraft: Forever, © Blizzard Entertainment.

Five steps

Get started

Five steps take you from nothing to your first uploaded scan. Steps 1 and 5 happen in game; the rest happen here. The whole thing takes about ten minutes.

Sign in and this page checks each step off as you go.

Step 01

Install the addon

Get AHledger from CurseForge with the CurseForge app or by unzipping into your Forever Interface/AddOns folder. In game, type /ahl to open the window. The addon works on its own; the rest of this list connects it to the site.

Get the addon on CurseForge

The site cannot see whether the addon is installed. Step 5 confirms it indirectly.

Step 02

Create an account

Sign in with your email. No password; a link arrives and signs you in. The account holds your upload keys, your watchlist, and email alerts.

Step 03

Create an upload key

The easy way: press Connect in AHledger sync (step 4) and approve the code it shows; the key is made for you and this step checks off. Or press Create key on the account page and copy the key id and secret straight away, since the secret is shown once. One key per machine is the idea.

Step 04

Install AHledger sync and connect

Download AHledger sync 0.2.27, run it, and press Connect with ahledger.com (or paste a key id and secret by hand). It watches the addon's saved data and uploads each scan. It only needs to be running when you scan.

Download AHledger sync 0.2.27

Used sync during the beta? Press Detect and pick the AHledger.lua under the _forever_ folder, then Save and start: the beta's file stopped changing at launch. More on moving to the live folder.

This step checks off when the first upload lands, which needs step 5.

Step 05

Scan the auction house

Open the auction house in game and press Scan in the AHledger window, or type /ahl scan. When the scan finishes, log out or /reload so the game writes its saved data; sync picks it up within a minute and the market page updates on the next refresh.

Stuck? Use the contact form and say which step; include the text of any error the addon or sync shows.

After setup

After setup

  • Watch items and set email alerts for drops, spikes, and thin supply.
  • Read the profession pages for crafting margins on the markets you play.
  • Scan often. Each scan you upload improves the medians every other player sees. The scanning guide covers the details.
  • Pick a name under Contributor leaderboard on your account page and your scans count on the contributors page, this week and since launch.

The people scanning

Join the Discord