Skip to content

User Guide (Docker)

Trung Le edited this page Jun 12, 2021 · 29 revisions

Example

Download & Use EFC

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. Copy this to any folder.

Installation

Install Docker

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

Download or Update EFC app

  • Open a CMD or Powershell in the folder that has device_auths.json.
  • Pull the Docker image. For specific version, replace latest with the version tag that is supported in EFC GithubPackage
docker pull ghcr.io/jackblk/epicgames-freebies-claimer:latest

Run EFC via Docker

Once again, make sure your CMD/Powershell is currently in the folder that has device_auths.json.

Windows

Run this command:

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

Mac/Linux

Run this command:

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

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 & Tag image

You can build an tag it with multiple name:tag. Below example is building & tagging for Github Package and Dockerhub, assuming we are building for the latest version 1.5.0.

docker build --rm \
    -t ghcr.io/jackblk/epicgames-freebies-claimer:latest \
    -t ghcr.io/jackblk/epicgames-freebies-claimer:1.5.0 \
    -t jackblk/epicgames-freebies-claimer:latest \
    -t jackblk/epicgames-freebies-claimer:1.5.0 \
    .

Authenticate to Dockerhub/GithubPackage

Push the image

Push the image with name:tag that you built earlier.

# Pushing the latest version (1.5.0) to Github Package
 docker push ghcr.io/jackblk/epicgames-freebies-claimer:1.5.0
 docker push ghcr.io/jackblk/epicgames-freebies-claimer:latest

# Pushing the latest version (1.5.0) to Docker Hub
 docker push jackblk/epicgames-freebies-claimer:1.5.0
 docker push jackblk/epicgames-freebies-claimer:latest