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

# 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

# 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

# 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

# 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

# Run
.\torrentarr.exe

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
   
   # For ARM64
   # sudo curl -L -o /usr/local/bin/torrentarr \
   #   https://github.com/Feramance/Torrentarr/releases/latest/download/torrentarr-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
   
   # For Apple Silicon use: .../torrentarr-macos-arm64
   chmod +x ~/Downloads/torrentarr
   

2. Move to Applications (optional):

   sudo mv ~/Downloads/torrentarr /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 from releases

2. Move to a permanent location:

   C:\Program Files\Torrentarr\torrentarr.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¶

Binary installations do not support auto-update. You must manually download and replace the binary.

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 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
3. Replace old file
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
• Single file distribution
• Easy to deploy
• Consistent across systems
• No dependency conflicts

❌ Disadvantages¶

• Large file size (50-100MB)
• No auto-update support
• Manual updates required
• May trigger antivirus warnings
• Slower startup than dotnet tool install

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

# Binary in dist/
ls dist/

See the Development Guide for more details.

Next Steps¶

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