Skip to content

troubleshooting.md

Latest commit

 

History

History
107 lines (75 loc) · 2.12 KB

troubleshooting.md

File metadata and controls

107 lines (75 loc) · 2.12 KB

Troubleshooting

Backend won't start

ECONNREFUSED / Connection refused

sudo systemctl start postgresql

Database gamevault does not exist

psql -U postgres
CREATE DATABASE gamevault;
\q

Invalid prisma.user invocation

cd backend
npx prisma migrate dev
npx prisma generate

Frontend won't start

VITE_API_URL is not defined Create frontend/.env with:

VITE_API_URL=http://localhost:3001

Cannot GET / Start the backend first.

Steam OAuth

Invalid return URL STEAM_RETURN_URL in .env must be exactly http://localhost:3001/api/auth/callback. Restart backend after changing.

Unauthorized Invalid Steam API key. Get a new one at https://steamcommunity.com/dev/apikey.

RetroArch

No games after sync

  1. Check that ~/.config/retroarch/playlists/ has at least one .lpl file
  2. Enable RetroArch toggle in Profile
  3. Click Sync All Emulators

Playtime shows 0h Play a game in RetroArch first — runtime logs are only created after a session. Then sync again.

Toggle not persisting after restart Log out and log back in to get a fresh token.

HLTB

HLTB shows no data for some games — this is expected. The unofficial API covers most popular titles but not all. RetroArch games won't show HLTB data due to ROM filename format. The app falls back silently.

To reset stale HLTB data for a wishlist game:

npx prisma studio

Open steam_wishlist, find the game, set hltbMain, hltbExtra, hltbCompletionist, hltbName to null.

Minecraft

No instances showing

  1. Launch Prism Launcher and create at least one instance
  2. Verify the path in .env — default: ~/.local/share/PrismLauncher/instances

Heatmap / Sessions

Heatmap empty

  1. Sync your library — sessions are created during sync
  2. Hard refresh: Ctrl+Shift+R
  3. Check browser console for errors

401 on sessions Log out, log back in to get a fresh JWT token.

Database

Reset everything (deletes all data)

cd backend
npx prisma migrate reset

View data in GUI

npx prisma studio