User Guide (Docker)

Intro

Package links

• DockerHub
• GithubPackage

Example / Quickstart

Prerequisites

Export your EpicGames secrets

• Download DeviceAuthGenerator for EpicGames. Currently only Windows binary is supported. For Mac/Linux user, follow the guide in README.
• Follow the User Guide
• After exporting, you should have a file device_auths.json.

Install Docker

Install Docker Desktop on your PC. Make sure Docker is running.

Install Docker Engine if you're using non-PC system.

Docker version should be >= 20.10.7.

Run EFC via Docker

Open CMD/Powerbash/Terminal and make sure it is currently in the folder that has device_auths.json.

For specific version, replace latest with the version tag that is supported in EFC GithubPackage

To save claim history, create history.json with content of {} or download the file from master. Then you can use "using local history.json" command.

Change in V1.5.4

In V1.5.4, config.json history.json and device_auths.json have been moved to data folder in order to isolate config files with code. So while upgrading from V1.5.3 and below to V1.5.4, you need to change your docker run command to mount config files to data folder.

Windows

V1.5.4 and above

docker run --rm --pull always -it --volume "%cd%/device_auths.json:/app/data/device_auths.json" ghcr.io/jackblk/epicgames-freebies-claimer:latest

Using your local history.json:

docker run --rm --pull always -it --volume "%cd%/device_auths.json:/app/data/device_auths.json" --volume "%cd%/history.json:/app/data/history.json" ghcr.io/jackblk/epicgames-freebies-claimer:latest

Before V1.5.4

These commands are for CMD, if you use Powershell, replace %cd% with $(pwd)

Run this command:

docker run --rm --pull always -it --volume "%cd%/device_auths.json:/app/device_auths.json" ghcr.io/jackblk/epicgames-freebies-claimer:latest

Using your local history.json:

docker run --rm --pull always -it --volume "%cd%/device_auths.json:/app/device_auths.json" --volume "%cd%/history.json:/app/history.json" ghcr.io/jackblk/epicgames-freebies-claimer:latest

Mac/Linux

V1.5.4 and above

Run this command:

docker run --rm --pull always -it --volume "$(pwd)/device_auths.json:/app/data/device_auths.json" ghcr.io/jackblk/epicgames-freebies-claimer:latest

Using your local history.json:

docker run --rm --pull always -it --volume "$(pwd)/device_auths.json:/app/data/device_auths.json" --volume "$(pwd)/history.json:/app/data/history.json" ghcr.io/jackblk/epicgames-freebies-claimer:latest

Before V1.5.4

Run this command:

docker run --rm --pull always -it --volume "$(pwd)/device_auths.json:/app/device_auths.json" ghcr.io/jackblk/epicgames-freebies-claimer:latest

Using your local history.json:

docker run --rm --pull always -it --volume "$(pwd)/device_auths.json:/app/device_auths.json" --volume "$(pwd)/history.json:/app/history.json" ghcr.io/jackblk/epicgames-freebies-claimer:latest

docker-compose

Make a docker-compose.yml file as follows in the directory that contains device_auths.json:

V1.5.4 and above

version: "3.2"
  services:
    epic_free:
      image: ghcr.io/jackblk/epicgames-freebies-claimer:latest
      container_name: 'epic_free'
      volumes:
        - ./device_auths.json:/app/data/device_auths.json
      stdin_open: true # docker run -i
      tty: true        # docker run -t

Before V1.5.4

version: "3.2"
  services:
    epic_free:
      image: ghcr.io/jackblk/epicgames-freebies-claimer:latest
      container_name: 'epic_free'
      volumes:
        - ./device_auths.json:/app/device_auths.json
      stdin_open: true # docker run -i
      tty: true        # docker run -t

Run it with: docker-compose run epic_free

---

Developer Guide 🚀

This guide is for Mac/Linux, but it is nearly the same for Windows. Alter it a bit if you're using Windows 😄.

Build & Test locally

Note: This will only build for 1 platform on your system. To build for other architectures (ARM-based), read chapter "Pushing images".

To build and test the image locally, use:

docker build --rm -t epicgames-freebies-claimer .

Test locally:

# Without `history.json`
docker run --rm -it \
    --volume "$(pwd)/device_auths.json:/app/data/device_auths.json" \
    epicgames-freebies-claimer

# With local `history.json`
docker run --rm -it \
    --volume "$(pwd)/device_auths.json:/app/data/device_auths.json" \
    --volume "$(pwd)/history.json:/app/data/history.json" \
    epicgames-freebies-claimer

# Debug via shell
docker run --rm -it epicgames-freebies-claimer sh

Authenticate to DockerHub/GithubPackage

• Github Package Guide
• Docker Hub: docker login. More info here: docker login

Push images

MAKE SURE YOUR LOCAL IMAGE WORKS before using below commands. It it build and push to the registries.

Notes:

• Available architectures are inherited from Node Base Image supported architectures.
• Only linux/amd64 image is tested.

docker buildx build --rm \
    --platform linux/amd64,linux/arm64,linux/ppc64le,linux/s390x,linux/arm/v7,linux/arm/v6 \
    --push \
    -t ghcr.io/jackblk/epicgames-freebies-claimer:latest \
    -t ghcr.io/jackblk/epicgames-freebies-claimer:1.5.5 \
    -t jackblk/epicgames-freebies-claimer:latest \
    -t jackblk/epicgames-freebies-claimer:1.5.5 \
    .