Binary Installation¶

Download and run pre-built Torrentarr binaries for Linux, macOS, or Windows. No Python installation required!

Prerequisites¶

• 64-bit x86 or ARM64 (Linux, macOS, or Windows)
• qBittorrent running and accessible
• At least one Arr instance (Radarr, Sonarr, or Lidarr)

Download¶

Latest Release¶

Visit the GitHub Releases page and download the binary for your platform:

Command Line Download¶

# Download latest release
curl -L -o torrentarr https://github.com/Feramance/Torrentarr/releases/latest/download/torrentarr-linux-x64
curl -fL -o torrentarr-workers-linux-x64 https://github.com/Feramance/Torrentarr/releases/latest/download/torrentarr-workers-linux-x64
chmod +x torrentarr-workers-linux-x64

# Make executable
chmod +x torrentarr

# Run
./torrentarr

# Download latest release
curl -L -o torrentarr https://github.com/Feramance/Torrentarr/releases/latest/download/torrentarr-linux-arm64
curl -fL -o torrentarr-workers-linux-arm64 https://github.com/Feramance/Torrentarr/releases/latest/download/torrentarr-workers-linux-arm64
chmod +x torrentarr-workers-linux-arm64

# Make executable
chmod +x torrentarr

# Run
./torrentarr

# Download latest release
curl -L -o torrentarr https://github.com/Feramance/Torrentarr/releases/latest/download/torrentarr-macos-x64
curl -fL -o torrentarr-workers-osx-x64 https://github.com/Feramance/Torrentarr/releases/latest/download/torrentarr-workers-osx-x64
chmod +x torrentarr-workers-osx-x64

# Make executable
chmod +x torrentarr

# Run (you may need to allow in Security settings)
./torrentarr

# Download latest release
curl -L -o torrentarr https://github.com/Feramance/Torrentarr/releases/latest/download/torrentarr-macos-arm64
curl -fL -o torrentarr-workers-osx-arm64 https://github.com/Feramance/Torrentarr/releases/latest/download/torrentarr-workers-osx-arm64
chmod +x torrentarr-workers-osx-arm64

# Make executable
chmod +x torrentarr

# Run (you may need to allow in Security settings)
./torrentarr

# Download with PowerShell
Invoke-WebRequest -Uri https://github.com/Feramance/Torrentarr/releases/latest/download/torrentarr-windows-x64.exe -OutFile torrentarr.exe
Invoke-WebRequest -Uri https://github.com/Feramance/Torrentarr/releases/latest/download/torrentarr-workers-windows-x64.exe -OutFile torrentarr-workers-windows-x64.exe

# Run
.\torrentarr.exe

Download both the Host and matching worker from the same release. Keep the worker beside the Host with its release filename. Both executables are required for Arr processing.

Installation¶

Linux¶

Use torrentarr-linux-x64 for Intel/AMD 64-bit, or torrentarr-linux-arm64 for ARM64.

1. Download and install:

   # For x64 (Intel/AMD)
   sudo curl -L -o /usr/local/bin/torrentarr \
     https://github.com/Feramance/Torrentarr/releases/latest/download/torrentarr-linux-x64
     sudo curl -fL -o /usr/local/bin/torrentarr-workers-linux-x64 https://github.com/Feramance/Torrentarr/releases/latest/download/torrentarr-workers-linux-x64
     sudo chmod +x /usr/local/bin/torrentarr-workers-linux-x64
   
   # For ARM64
   # sudo curl -L -o /usr/local/bin/torrentarr \
   #   https://github.com/Feramance/Torrentarr/releases/latest/download/torrentarr-linux-arm64
   # sudo curl -fL -o /usr/local/bin/torrentarr-workers-linux-arm64 \
   #   https://github.com/Feramance/Torrentarr/releases/latest/download/torrentarr-workers-linux-arm64
   # sudo chmod +x /usr/local/bin/torrentarr-workers-linux-arm64
   
   sudo chmod +x /usr/local/bin/torrentarr
   

2. Run:

   torrentarr
   

macOS¶

Use torrentarr-macos-x64 for Intel or torrentarr-macos-arm64 for Apple Silicon.

1. Download:

   # For Intel
   curl -L -o ~/Downloads/torrentarr \
     https://github.com/Feramance/Torrentarr/releases/latest/download/torrentarr-macos-x64
     curl -fL -o ~/Downloads/torrentarr-workers-osx-x64 https://github.com/Feramance/Torrentarr/releases/latest/download/torrentarr-workers-osx-x64
     chmod +x ~/Downloads/torrentarr-workers-osx-x64
   
   # For Apple Silicon use torrentarr-macos-arm64 and torrentarr-workers-osx-arm64.
   chmod +x ~/Downloads/torrentarr
   

2. Move to Applications (optional):

   sudo mv ~/Downloads/torrentarr ~/Downloads/torrentarr-workers-osx-* /usr/local/bin/
   

3. First run (security prompt):

   ./torrentarr
   

If macOS blocks it: - Go to System Preferences → Security & Privacy - Click "Allow Anyway" next to the torrentarr message - Run again

Windows¶

1. Download torrentarr-windows-x64.exe and torrentarr-workers-windows-x64.exe from the same release

2. Move to a permanent location:

   C:\Program Files\Torrentarr\torrentarr.exe
   C:\Program Files\Torrentarr\torrentarr-workers-windows-x64.exe
   

3. Run:

4. Double-click torrentarr.exe

5. Or run from PowerShell: .\torrentarr.exe

6. Add to PATH (optional):

7. Search for "Environment Variables"
8. Edit "Path" system variable
9. Add C:\Program Files\Torrentarr

First Run¶

1. Start Torrentarr:

   ./torrentarr  # or torrentarr.exe on Windows
   

2. Configuration file created:

Binary installations use these default paths:

=== "Linux/macOS"

~/.config/torrentarr/config.toml
~/.local/share/torrentarr/logs/

=== "Windows"

%APPDATA%\torrentarr\config.toml
%APPDATA%\torrentarr\logs\

1. Stop Torrentarr: Press Ctrl+C

2. Edit configuration: See First Run Guide

3. Start again:

   ./torrentarr
   

Configuration Location¶

Custom Config Path¶

Set a custom config directory:

export TORRENTARR_CONFIG=/path/to/config/config.toml
./torrentarr

$env:TORRENTARR_CONFIG = "C:\path\to\config\config.toml"
.\torrentarr.exe

Running as a Service¶

Linux (systemd)¶

Create /etc/systemd/system/torrentarr.service:

[Unit]
Description=Torrentarr
After=network.target

[Service]
Type=simple
User=your-user
ExecStart=/usr/local/bin/torrentarr
Restart=always

[Install]
WantedBy=multi-user.target

Enable and start:

sudo systemctl daemon-reload
sudo systemctl enable --now torrentarr

Windows¶

Use Task Scheduler:

1. Open Task Scheduler
2. Create Basic Task
3. Name: "Torrentarr"
4. Trigger: "When the computer starts"
5. Action: "Start a program"
6. Program: C:\Program Files\Torrentarr\torrentarr.exe
7. Finish

Or use NSSM:

nssm install Torrentarr "C:\Program Files\Torrentarr\torrentarr.exe"
nssm start Torrentarr

macOS (LaunchAgent)¶

Create ~/Library/LaunchAgents/com.torrentarr.plist:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.torrentarr</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/bin/torrentarr</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
</dict>
</plist>

Load:

launchctl load ~/Library/LaunchAgents/com.torrentarr.plist

Updating¶

You can update by downloading a new release and replacing both the Host and matching worker. If enabled, the WebUI can also download and apply a GitHub release binary for the current platform (see Auto-updates).

Linux/macOS¶

Use the same filename as your platform: torrentarr-linux-x64, torrentarr-linux-arm64, torrentarr-macos-x64, or torrentarr-macos-arm64.

# Backup current binary
sudo mv /usr/local/bin/torrentarr /usr/local/bin/torrentarr.bak

# Download latest (example for Linux x64; use torrentarr-linux-arm64 for ARM64, or torrentarr-macos-* for macOS)
sudo curl -L -o /usr/local/bin/torrentarr \
  https://github.com/Feramance/Torrentarr/releases/latest/download/torrentarr-linux-x64
  sudo curl -fL -o /usr/local/bin/torrentarr-workers-linux-x64 https://github.com/Feramance/Torrentarr/releases/latest/download/torrentarr-workers-linux-x64
  sudo chmod +x /usr/local/bin/torrentarr-workers-linux-x64

sudo chmod +x /usr/local/bin/torrentarr

# Restart service
sudo systemctl restart torrentarr  # if using systemd

Windows¶

1. Stop Torrentarr (or the service)
2. Download new torrentarr-windows-x64.exe and matching torrentarr-workers-windows-x64.exe
3. Replace both old files
4. Start Torrentarr again

Troubleshooting¶

Binary Won't Run¶

ldd ./torrentarr

# Remove quarantine flag
xattr -d com.apple.quarantine ./torrentarr

Permission Denied¶

chmod +x torrentarr

Config File Not Found¶

Check config location:

./torrentarr --show-config-path

Create config directory manually:

mkdir -p ~/.config/torrentarr

New-Item -ItemType Directory -Path "$env:APPDATA\torrentarr"

Large Binary Size¶

Binary files are 50-100MB because they include: - .NET runtime - All application dependencies - Compiled native libraries

This is normal for .NET self-contained single-file binaries.

Advantages & Disadvantages¶

✅ Advantages¶

• No Python installation required
• Two executable distribution
• Easy to deploy
• Consistent across systems
• No dependency conflicts

❌ Disadvantages¶

• Large file size (50-100MB)
• Manual updates if you do not use WebUI apply-update
• May trigger antivirus warnings
• Slower cold start than a framework-dependent build (self-contained single-file extraction)

Building from Source¶

To build your own self-contained binary:

# Clone repository
git clone https://github.com/Feramance/Torrentarr.git
cd Torrentarr

# Publish as self-contained single-file binary
dotnet publish src/Torrentarr.Host \
  --configuration Release \
  --runtime linux-x64 \
  --self-contained true \
  -p:PublishSingleFile=true \
  --output ./dist

dotnet publish src/Torrentarr.Workers \
  --configuration Release \
  --runtime linux-x64 \
  --self-contained true \
  -p:PublishSingleFile=true \
  --output ./dist

# Host and worker in dist/
ls dist/

See the Development Guide for more details.

Next Steps¶

• First Run Guide
• Configure qBittorrent
• Configure Arr Instances
• Troubleshooting