ManaVault is a self-hosted Magic: The Gathering collection and deck workspace. It gives you one local source of truth for the cards you own, where they live, which decks are using them, and what still needs to be bought or pulled from storage.
It is built for players who care about exact printings, physical inventory, and repeatable deck-building workflows without handing collection data to a hosted service.
- Own your data. Production state lives in SQLite and local files under your mounted data directory.
- Track real cardboard. Quantity, condition, language, finish, purchase price, storage location, and exact Scryfall printing stay attached to each collection item.
- Reserve cards intentionally. Deck allocation connects deck cards to the physical copies that satisfy them, so one card is not promised to two decks by accident.
- Turn deck gaps into actions. Missing-card views and buylist exports show what a deck still needs after owned and allocated copies are counted.
- Run it anywhere boring. One container, one SQLite database, no Postgres, Redis, object storage, or hosted backend required.
ManaVault syncs Scryfall bulk data locally, then lets you search cards and exact printings with prices, images, legalities, rulings, Scryfall oracle tags, deck categories, and themes. Full-screen printing previews keep high-resolution card art close while you choose the copy you want.
Import TXT/CSV exports, add individual cards, organize cards into locations, filter and sort across the full collection, track purchase price versus current value, and export filtered CSV/TXT lists. Collection state is preserved while you move between locations and cards, so back navigation returns to the same view.
Create decks, import/export decklists, manage commander/main/side/maybe zones, choose preferred printings and finishes, group cards by theme or category, tag decks, check format legality, and inspect mana curve, mana production, and token creation summaries.
Allocation status shows which deck cards are satisfied, missing, unavailable, or already allocated elsewhere. Bulk allocation can reserve matching collection items, and missing-card/buylist exports can include or exclude basics and target exact or matching printings.
Commander decks can pull EDHREC recommendations, cuts, commander pages, themes, and stats. Add recommendations directly to mainboard, maybeboard, or sideboard. Decks also include a browser playtest table and share links with read-only deck view, playtest, copy, and export actions.
The responsive web app can be installed as a PWA. Optional Capacitor Android and iOS shells load your ManaVault server, handle native back/app controls, and accept text/CSV share or open-with flows for collection imports.
Manual backup/restore tasks create SQLite-safe zip artifacts. In-app cloud backup settings support Google Drive and S3-compatible storage, including Cloudflare R2, with scheduled UTC CRON runs and staged restores.
For a localhost-only smoke test with auth disabled:
mkdir -p data
docker run --rm \
-p 4000:4000 \
-v "$PWD/data:/data" \
-e SECRET_KEY_BASE="$(openssl rand -base64 48)" \
-e MANAVAULT_AUTH_DISABLED=true \
-e PHX_HOST=localhost \
ghcr.io/cfbender/manavault:0.13.0Then visit http://localhost:4000. For anything exposed beyond localhost, enable built-in auth and follow the self-hosting guide.
- Feature reference - concepts and product-area behavior.
- Self-hosting - Docker, data layout, auth, environment variables, backups, and restores.
- Development - local setup, tests, and native shell dev commands.
- Android builds - official APK behavior, Share/Open with imports, custom domains, App Links, and release signing.
- Releasing - changelog, version bump, tag, container, and APK release flow.
Phoenix, Absinthe GraphQL, Ecto/SQLite, Vite, React, TanStack Router/Query, Tailwind/DaisyUI styling, and optional Capacitor native shells.