Epic Games Free Games

Automatically login and find available free games on the Epic Games Store. The web portal sends prepopulated checkout links so you can complete purchases after logging in. Supports multiple accounts and scheduled runs.

What You Can Do After Deployment

1. Visit your domain — the web portal loads where you manage accounts and complete captchas
2. Add your Epic Games account — configure your email in the config volume
3. Set a schedule — runs automatically on a cron schedule (default: every 6 hours)
4. Complete captchas — when needed, the portal presents captchas for you to solve
5. Set up notifications (optional) — get notified via Discord, Telegram, email, Pushover, Gotify, ntfy, or Bark

Key Features

• Automatic detection and claiming of free Epic Games Store titles
• Web portal for account login and captcha completion
• Cron-based scheduling with configurable intervals
• Multiple account support
• Notifications via Discord, Telegram, email, Apprise, Pushover, Gotify, Home Assistant, Bark, and ntfy
• JSON5 configuration with environment variable overrides
• Persistent login sessions across restarts

Configuration

• RUN_ON_STARTUP — set to true to check for free games immediately on startup
• CRON_SCHEDULE — cron expression for check frequency (default: 0 0,6,12,18 * * *)
• BASE_URL — set to your public domain URL for the web portal to work correctly
• Config file — mount a config.json5 to /usr/app/config for full configuration including accounts and notifiers

License

ISC — GitHub