Sign inSign up

sliky1992/gamesync-hub

By sliky1992

•Updated 24 days ago

Self-hosted hub for real-time game-save sync across devices — dashboard, versioned Vault, covers

Image
0

354

sliky1992/gamesync-hub repository overview

⁠GameSync Hub

Self-hosted hub for real-time game-save sync across devices. This image is the central server: a Fastify API + WebSocket sync engine, a SQLite database (Prisma), and a web dashboard. Pair it with the Windows client to sync game saves between PCs automatically.

šŸ“¦ Source, full docs & Windows client: https://github.com/sliky1992/gamesync⁠


⁠Quick start

docker run -d --name gamesync-hub \
  -p 8080:8080 \
  -v gamesync-data:/data \
  -e STEAMGRIDDB_API_KEY=your_key_here \
  --restart unless-stopped \
  sliky1992/gamesync-hub:latest

Open the dashboard at http://localhost:8080⁠.

Or with Docker Compose:

services:
  hub:
    image: sliky1992/gamesync-hub:latest
    container_name: gamesync-hub
    ports:
      - "8080:8080"
    environment:
      STEAMGRIDDB_API_KEY: "${STEAMGRIDDB_API_KEY:-}"
      API_TOKEN: "${API_TOKEN:-}"
    volumes:
      - gamesync-data:/data
    restart: unless-stopped

volumes:
  gamesync-data:

⁠Configuration

Env varDefaultPurpose
STEAMGRIDDB_API_KEY(empty)Free key from SteamGridDB⁠ for cover art & search. Read server-side.
API_TOKEN(empty)Optional shared secret. If set, clients and the dashboard must send it as a bearer token.
MAX_UPLOAD_BYTES536870912 (512 MB)Max save-upload size.
DATABASE_URLfile:/data/gamesync.dbSQLite location (inside the volume).
STORAGE_DIR/data/storageWhere versioned save zips are stored (inside the volume).
PORT8080HTTP/WebSocket port.
  • Port: 8080 (HTTP + WebSocket).
  • Volume: /data — holds the SQLite DB and all save versions. Back this up; it's your data.

⁠Tags

  • latest, 1.0.0 — linux/amd64.

⁠What it does

  • Real-time sync — pushes new saves to other devices over a WebSocket within seconds.
  • Content-hash versioning — same save hashes identically on every machine; safe conflict handling (nothing silently overwritten).
  • Vault — browse every saved version per game: download, restore (roll back), or prune.
  • SteamGridDB cover art and search.

To sync a machine, install the Windows client from the GitHub Releases⁠ page (or the dashboard's Setup tab) and point it at this hub.

Tag summary

Content type

Image

Digest

sha256:34ea76e8f…

Size

161.4 MB

Last updated

24 days ago

docker pull sliky1992/gamesync-hub