# GOG Free Games Claimer

GOG Free Games Claimer is a minimal self-hosted Docker container that lets homelab users claim the current free GOG.com giveaway by sending an authenticated request to GOG's claim endpoint, using a single pasted. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2262/gog-free-games-claimer

## Description

GOG Free Games Claimer is a minimal self-hosted Docker container that lets homelab users claim the current free GOG.com giveaway by sending an authenticated request to GOG's claim endpoint, using a single pasted session cookie instead of a full browser, so it can run on a schedule without headless Chromium.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

37/100 (Low), based on 3 of 4 factors.
- Maintained: 57 (last commit 181 days ago)
- Popular: 6 (1 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/corylewis/gog-free-games-claimer
- Official website: https://www.gog.com
- Unraid: https://ca.unraid.net/apps/gog-free-games-claimer-1j8bga11a8dlgd?q=GOG-Free-Games-Claimer
- GitHub: https://github.com/mecharmor/gog-free-claimer

## Common questions

### How do I provide my GOG session cookie?

Log in to the GOG site, open your browser's network panel, copy the entire Cookie request header from an authenticated request, and paste that full value into GOG_COOKIE. You only need to do this until your session expires, which is typically every few months.

### Can I test the cookie before making a real claim?

Yes. Run the claimer with --dry-run to validate the cookie without claiming the game.

### Where is claim history stored and what should I persist?

Claims are saved to data/claims.json. Mount a host directory to /app/data so the history persists between runs.

### Does it need a reverse proxy or published ports?

No. The container makes an outbound authenticated HTTP request, and the provided Docker run command publishes no ports. There is no web service that needs to be exposed.

### Does the container keep running after a claim?

No. The Docker instructions use --rm for a one-shot claim, so the container does not need to remain running.

### Can it send notifications when it runs?

Set DISCORD_WEBHOOK_URL to an optional Discord webhook to receive run updates. If it is omitted, webhook notifications are skipped.

---
Source: Our Local Host (https://ourlocalhost.com/app/2262/gog-free-games-claimer), the self-hosted and open-source app directory.
