g0t3nks/amutorrent

aMuTorrent

A unified download manager for aMule, rTorrent, and qBittorrent. Manage ED2K and BitTorrent downloads from a single modern web interface. Features *** integration for torrent search, Torznab indexer and qBittorrent-compatible API for aMule (Sonarr/Radarr integration), push notifications via Apprise, and GeoIP peer location display. Built with Node.js, WebSockets, and React.

!https://raw.githubusercontent.com/got3nks/amutorrent/main/docs/screenshots/home-desktop.png

Docs, screenshots & installation: https://got3nks.github.io/amutorrent

Quick Start

Prerequisites

• At least one of: aMule with External Connections enabled, rTorrent with XML-RPC over HTTP, or qBittorrent with WebUI enabled.

1. Create directories

bash
mkdir -p data logs
sudo chown -R 1000:1000 data logs

2. Create docker-compose.yml

bash
services:
  amutorrent:
    image: g0t3nks/amutorrent:latest
    user: "1000:1000"
    container_name: amutorrent
    ports:
      - "4000:4000"
    environment:
      - NODE_ENV=production
      - PORT=4000
    extra_hosts:
      - "host.docker.internal:host-gateway"
    volumes:
      - ./logs:/usr/src/app/server/logs
      - ./data:/usr/src/app/server/data
    restart: unless-stopped

3. Start and configure

bash
docker compose up -d

Open http://localhost:4000 and follow the setup wizard to configure your download clients.

All-in-One Setup (aMule + rTorrent + qBittorrent + aMuTorrent web controller)

For a complete setup with aMule, rTorrent, and qBittorrent in Docker, see https://raw.githubusercontent.com/got3nks/amutorrent/refs/heads/main/docker-compose.all-in-one.yml

Environment Variables

All optional - the setup wizard is the recommended configuration method.

• PORT – Web server port (default: 4000)
• WEB_AUTH_ENABLED – Enable password protection
• WEB_AUTH_PASSWORD – Web UI password
• AMULE_ENABLED - Enable aMule integration
• AMULE_HOST – aMule hostname or IP
• AMULE_PORT – aMule EC port (default: 4712)
• AMULE_PASSWORD – aMule EC password
• RTORRENT_ENABLED - Enable rTorrent integration
• RTORRENT_HOST - rTorrent hostname or IP
• RTORRENT_PORT - rTorrent XML-RPC port
• RTORRENT_PATH - XML-RPC endpoint path
• RTORRENT_USERNAME - HTTP auth username (if required)
• RTORRENT_PASSWORD - HTTP auth password
• QBITTORRENT_ENABLED - Enable Qbittorrent integration
• QBITTORRENT_HOST - qBittorrent hostname or IP
• QBITTORRENT_PORT - qBittorrent WebUI port
• QBITTORRENT_USERNAME - WebUI username
• QBITTORRENT_PASSWORD - WebUI password
• ***_ENABLED - Enable *** integration
• ***_URL - *** base URL
• ***_API_KEY - *** API key
• SONARR_URL – Sonarr base URL
• SONARR_API_KEY – Sonarr API key
• RADARR_URL – Radarr base URL
• RADARR_API_KEY – Radarr API key
• SKIP_SETUP_WIZARD – Skip wizard (true / false)

Documentation

• https://github.com/got3nks/amutorrent/blob/main/README.md

Support

• Issues: https://github.com/got3nks/amutorrent/issues