Microsoft-Rewards-Script/docs/docker.md

🐳 Docker Guide

Run the script in a container

---

⚡ Quick Start

1. Create Required Files

Ensure you have:

• src/accounts.json with your credentials
• src/config.jsonc (uses defaults if missing)

2. Start Container

docker compose up -d

3. View Logs

docker logs -f microsoft-rewards-script

That's it! Script runs automatically.

---

🎯 What's Included

The Docker setup:

• ✅ Chromium Headless Shell — Lightweight browser
• ✅ Scheduler enabled — Daily automation
• ✅ Volume mounts — Persistent sessions
• ✅ Force headless — Required for containers

---

📁 Mounted Volumes

Host Path	Container Path	Purpose
./src/accounts.json	/usr/src/.../accounts.json	Account credentials (read-only)
./src/config.jsonc	/usr/src/.../config.json	Configuration (read-only)
./sessions	/usr/src/.../sessions	Cookies & fingerprints

---

🌍 Environment Variables

Set Timezone

services:
  rewards:
    environment:
      TZ: Europe/Paris

Use Inline JSON

docker run -e ACCOUNTS_JSON='{"accounts":[...]}' ...

Custom Config Path

docker run -e ACCOUNTS_FILE=/custom/path/accounts.json ...

---

🔧 Common Commands

# Start container
docker compose up -d

# View logs
docker logs -f microsoft-rewards-script

# Stop container
docker compose down

# Rebuild image
docker compose build --no-cache

# Restart container
docker compose restart

---

🛠️ Troubleshooting

Problem	Solution
"accounts.json not found"	Mount file in docker-compose.yml
"Browser launch failed"	Ensure FORCE_HEADLESS=1 is set
"Permission denied"	Check file permissions (chmod 644)
Scheduler not running	Verify schedule.enabled: true in config

Debug Container

# Enter container shell
docker exec -it microsoft-rewards-script /bin/bash

# Check Node.js version
docker exec -it microsoft-rewards-script node --version

# View config
docker exec -it microsoft-rewards-script cat config.json

---

🎛️ Custom Configuration

Use Built-in Scheduler

Default docker-compose.yml:

services:
  rewards:
    build: .
    command: ["npm", "run", "start:schedule"]

Single Run (Manual)

services:
  rewards:
    build: .
    command: ["node", "./dist/index.js"]

External Cron (Alternative)

services:
  rewards:
    environment:
      CRON_SCHEDULE: "0 7,16,20 * * *"
      RUN_ON_START: "true"

---

📚 Next Steps

Need 2FA?
→ Accounts & TOTP Setup

Want notifications?
→ Discord Webhooks

Scheduler config?
→ Scheduler Guide

---

← Back to Hub | Getting Started