FAQ Troubleshooting

This repository has not received any direct error reports yet, so here are some developmental hiccups that have happened.

Auth & Accounts

• "I was logged out and can't log back in"

Most likely cause: JWT_SECRET was changed or regenerated in .env. This invalidates all existing sessions. Users just need to log in again, no data was lost

• "I can't register an account"

OpenMTG does not have open registration. Only admins can create user accounts via the Settings panel. If you're the first user, the admin account is created during the initial setup prompt on first launch.

• "I lost access to my admin account"

This would require a database-level fix. W.I.P. If this happens, please report in Issues, this will launch a proper investigation.

Cards & Importing

• "Some lines were skipped during import"

Scryfall couldn't resolve the card name. Common causes: misspelling, tokens, art cards, or Alchemy-only cards that aren't in the Scryfall dataset. The import results screen lists exactly which lines failed. Correct the name and re-import those lines. If the card name is 100% correct, the API may be in a rate-limited mode. In this case, please wait about an hour for each card affected.

• "A card's price shows as '-'"

Scryfall doesn't have pricing data for every card. Entries for basics, tokens, some promos, and older reserved list cards often have no listed price. This is a Scryfall data limitation, not a bug.

• "My foil card is showing the non-foil price"

If Scryfall has no foil price for that printing, OpenMTG falls back to the non-foil price. The display will note it as "foil" but the price reflects what Scryfall has available.

• "My collection value looks off"

Prices are condition-adjusted using multipliers. An MP card will show less than its listed NM Scryfall price. This is intentional. The displayed price reflects estimated real-world value for that condition, not actual API calls for condition-based pricing.

Price Refresh

• "Prices haven't updated"

The auto-refresh check runs every 30 minutes and only updates cards older than the configured interval (default 72 hours). If your cards were just added, they're considered fresh and won't be refreshed yet. You can lower the interval or run a manual scan in the admin Settings panel.

-"Price refresh seems slow"

The Scryfall rate limit setting controls how fast bulk refreshes run. The default is 1 request/second to stay within Scryfall's guidelines, a large collection will take time. Increasing this is possible but risks rate limiting or blocks from Scryfall.

Exports

• "My Moxfield export is missing cards"

Any card not flagged as Commander, Mainboard, or Sideboard won't appear in the correct section. Check that cards were added to the right zone in the deck builder. The Moxfield format requires cards to be in one of those three zones.

• "My deck JSON export has the wrong deck ID in the filename"

The filename is generated as deck.json, not the deck name. This is cosmetic, rename the file after downloading if needed.

Data & Persistence

• "My data disappeared after restarting"

Check that DATA_PATH in .env is not a relative path that wasn't preserved, or the volume wasn't mounted correctly. DATA_PATH must point to a stable location and the directory must exist on the host before starting the stack.