Arkham Horror LCG

The goal of this project is to implement a web version of Arkham Horror with as many of the rules implemented as possible.

Warning

This is very much a work in progress. Things may break at any time, but if they do, please file a bug.

Features

• Multiplayer up to 4 players
• Multiplayer solitaire
• Tarot Readings
• Deck import from ArkhamDB and arkham.build

Finished Content

Player Cards

• All player cards before 2026

Campaigns

• Night of the Zealot
  • Return to Night of the Zealot
• The Dunwich Legacy
  • Return to The Dunwich Legacy
• The Path To Carcosa
  • Return to The Path To Carcosa
• The Forgotten Age
  • Return to The Forgotten Age
• The Circle Undone
  • Return to The Circle Undone
• The Dream-Eaters
• The Innsmouth Conspiracy
• Edge of the Earth

Side Stories

• The Curse of the Rougarou
• Carnevale of Horrors
• Murder at the Excelsior Hotel
• The Midwinter Gala
• Film Fatale

I just want to try this out on my computer

Install Docker, then run:

curl -fsSL https://raw.githubusercontent.com/halogenandtoast/ArkhamHorror/main/install.sh | bash

This creates an arkham-horror/ directory, downloads the required files, generates a database password, and starts the app. Open http://localhost:3000 when it's done.

Windows users: Run the command above inside a WSL2 terminal. Docker Desktop integrates with WSL2 so docker compose will work from there.

The script will ask if you want to download game images (~2.9 GB). If you skip this step, the app loads images from the CDN automatically — no extra setup needed.

Manual setup (alternative)

If you prefer not to use the install script, you'll need four files:

mkdir -p arkham-horror/config arkham-horror/frontend/public/img
cd arkham-horror
curl -fsSL https://raw.githubusercontent.com/halogenandtoast/ArkhamHorror/main/docker-compose.yml -o docker-compose.yml
curl -fsSL https://raw.githubusercontent.com/halogenandtoast/ArkhamHorror/main/setup.sql -o setup.sql
# Generate a strong password
openssl rand -base64 32 > config/postgres_password.txt
docker compose up -d

The app automatically detects whether local images are present:

• No local images (default after install) → images load from the CDN automatically
• Local images present (after running the fetch service) → images served locally

To fetch images locally, use the fetch-images Docker service. Once fetched, restart with docker compose restart web and the app will switch to local images.

# English only (~1.3 GB) — portraits, tokens, icons, card images
docker compose --profile fetch-images run --rm fetch-images en

# English + a specific language (recommended for non-English play)
docker compose --profile fetch-images run --rm fetch-images en+fr   # French
docker compose --profile fetch-images run --rm fetch-images en+es   # Spanish
docker compose --profile fetch-images run --rm fetch-images en+ita  # Italian
docker compose --profile fetch-images run --rm fetch-images en+ko   # Korean
docker compose --profile fetch-images run --rm fetch-images en+zh   # Chinese

# A single language's card translations only (English assets still load from CDN)
docker compose --profile fetch-images run --rm fetch-images fr

# Everything (~2.9 GB)
docker compose --profile fetch-images run --rm fetch-images all

Images are stored in frontend/public/img/ and mounted into the container. After fetching, run docker compose restart web to pick them up.

To switch back to CDN at any time, add this to the web service environment in docker-compose.yml:

    environment:
      - ASSET_HOST=https://assets.arkhamhorror.app

Updating

docker compose pull
docker compose up -d

Local dev

Dependencies

• Stack for GHC
• Node
• Postgresql
• Sqitch (optional: for migrations)

Local Setup

Running via Docker

The image is setup to use an external database passed via the DATABASE_URL environment variable. Follow the steps below to setup the database and then run the following commands

docker build -t arkham .
docker run -t -i -e PORT=3000 -e DATABASE_URL="postgres://docker:docker@host.docker.internal:5432/arkham-horror-backend" -p 3000:3000 arkham

Backend

Run stack setup in the backend directory, then run stack build --fast (note: this will still take a long time)

Frontend

Run npm install in the frontend directory

Images

Image assets (~2.9 GB) are not stored in the git repository. They are hosted on CloudFront and the app loads them from the CDN by default in both development and production — no extra setup needed.

If you need local copies (e.g. for offline development), use the fetch script (requires aws CLI and curl):

make fetch-images     # Everything (~2.9 GB)
make fetch-cards      # English card images only (~755 MB)

# Or use the script directly:
./scripts/fetch-assets.sh en        # All English/static images (~1.3 GB)
./scripts/fetch-assets.sh en+fr     # English + French (recommended for French play)
./scripts/fetch-assets.sh en+es     # English + Spanish
./scripts/fetch-assets.sh en+ita    # English + Italian
./scripts/fetch-assets.sh en+ko     # English + Korean
./scripts/fetch-assets.sh en+zh     # English + Chinese
./scripts/fetch-assets.sh fr        # French card translations only

If you only have Docker (no local AWS CLI), use the Docker-based targets instead:

make fetch-images-docker    # Everything via Docker (~2.9 GB)
make fetch-cards-docker     # English card images only via Docker

# Or run directly with the same targets as above:
docker compose --profile fetch-images run --rm fetch-images en
docker compose --profile fetch-images run --rm fetch-images en+fr
docker compose --profile fetch-images run --rm fetch-images fr

To use local images instead of CDN in local dev, create frontend/.env.development.local:

VITE_ASSET_HOST=

To revert to CDN, remove the file or set VITE_ASSET_HOST=https://assets.arkhamhorror.app.

If you add new images, sync them to S3 and regenerate the manifest:

make sync-and-manifest

To install a git hook that warns if you forget to update the manifest:

make install-hooks

Database

Create the local database:

createdb arkham-horror-backend
cd migrations
sqitch deploy db:pg:arkham-horror-backend

If you do not have sqitch you can cat migrations/deploy/* to see the create table statements and run them manually, you will want to specifically run the users and arkham_games create table statements first.

Running the server

• start the backend with cd backend && make api.watch
• start the frontend with cd frontend && npm run serve

Copyright Disclaimer

The information presented in this app about Arkham Horror: The Card Game™, both textual and graphical, is © Fantasy Flight Games 2024. This app is a fan project and is not produced, endorsed, or supported by, or affiliated with Fantasy Flight Games.

All artwork and illustrations are the intellectual property of their respective creators. All Arkham Horror: The Card Game™ images and graphics are copyrighted by Fantasy Flight Games.