Multi Account

Multi-Account Parallel Mode

Run unlimited Twitch accounts simultaneously — each as a fully independent miner with its own data, settings, and web dashboard.

---

Dynamic Instance Management (v1.2.7+)

The easiest way to manage instances is from the System → Instances tab in the dashboard:

• Click + Add Instance to spawn a new miner process (port auto-assigned, Nginx auto-updated)
• Click ✕ Remove to stop an instance and remove it from the routing (instance 1 cannot be removed)
• A warning banner appears when running 3+ instances on one IP — Twitch may flag the account
• All changes take effect immediately without editing any config files

---

Architecture

Instance	Port	Data Dir	Dashboard
Account 1	8080	data/	/
Account 2	8082	data2/	/acc2/
Account N	8080+(N-1)×2	dataN/	/accN/

All instances run in parallel. Nginx routes requests to the correct instance based on path.

---

Setup with PM2

# Account 1 (default)
TDM_PORT=8080 TDM_DATA_DIR=data pm2 start "python main.py" --name twitchdrops

# Account 2
TDM_PORT=8082 TDM_DATA_DIR=data2 pm2 start "python main.py" --name twitchdrops2

---

Nginx Reverse Proxy

server {
    listen 80;
    server_name your-domain.com;

    location /acc2/ {
        proxy_pass http://127.0.0.1:8082/;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
    }

    location / {
        proxy_pass http://127.0.0.1:8080/;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
    }
}

---

Docker Compose

services:
  tdm-account1:
    image: ghcr.io/simpliaj/twitchdropsminer:latest
    environment:
      TDM_PORT: "8080"
      TDM_DATA_DIR: "data"
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/data

  tdm-account2:
    image: ghcr.io/simpliaj/twitchdropsminer:latest
    environment:
      TDM_PORT: "8082"
      TDM_DATA_DIR: "data2"
    ports:
      - "8082:8082"
    volumes:
      - ./data2:/app/data2

---

Account Switcher

The web dashboard shows both accounts at the top:

• Buttons display the Twitch username of the logged-in account (e.g. simpliaj, hora)
• Click a button to switch the dashboard view to that account
• Each account has fully isolated data and settings
• The URL parameter ?acc=2 also switches to Account 2 directly

---

Firewall / Port Access

If accessing from outside the server, ensure ports are open:

• Port 8080 — Account 1 dashboard
• Port 8082 — Account 2 dashboard

Or use Nginx (recommended) to expose only port 80/443 and route internally.

---

Rename Accounts

In the dashboard: System → Accounts → click ✏️ next to an account to rename it. The name appears in Discord bot footers and embeds.

---

Shared Accounts Folder

Both instances share the data/accounts/ directory so you can switch which Twitch account each instance uses from the System → Accounts tab without managing separate credential files.