Requirements

📋 Requirements

System requirements and dependencies for running easiarr and its applications.

---

Minimum Requirements

Component	Minimum	Recommended	Notes
CPU	2 cores	4+ cores	More cores = better transcoding performance
RAM	4 GB	8+ GB	Each *arr app uses ~200-500MB
Storage	20 GB	SSD recommended	For config files; media storage separate
Network	10 Mbps	100+ Mbps	For streaming and downloads

---

Software Requirements

Required

Software	Minimum Version	Purpose
Bun	1.0+	JavaScript runtime for easiarr
Docker	20.10+	Container runtime
Docker Compose	v2+	Container orchestration

Optional

Software	Purpose
Git	For cloning the repository
VPN Subscription	For anonymous downloading via Gluetun
Cloudflare Account	For Cloudflare Tunnel external access

---

Operating System Support

easiarr runs on any OS that supports Docker and Bun:

OS	Status	Notes
Linux	✅ Fully Supported	Best performance, native Docker
macOS	✅ Fully Supported	Via Docker Desktop
Windows	✅ Supported	Via Docker Desktop or WSL2
NAS (Synology, QNAP, etc.)	⚠️ Manual Setup	Install Docker manually, run easiarr from separate machine

Linux Distribution Recommendations

Distribution	Notes
Ubuntu 22.04+	Excellent support
Debian 11+	Stable and reliable
Fedora 38+	Modern packages
Arch Linux	Rolling release, latest versions

---

Hardware Acceleration (Optional)

For transcoding with Plex/Jellyfin/Tdarr:

Technology	GPU Type	Notes
NVIDIA NVENC	NVIDIA	Requires nvidia-docker
Intel Quick Sync	Intel iGPU	Built into most Intel CPUs
AMD VCE/VCN	AMD	Supported in newer kernels

NVIDIA Setup

# Install NVIDIA Container Toolkit
distribution=$(. /etc/os-release;echo $ID$VERSION_ID)
curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add -
curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | \
  sudo tee /etc/apt/sources.list.d/nvidia-docker.list

sudo apt update
sudo apt install -y nvidia-container-toolkit
sudo systemctl restart docker

---

Storage Recommendations

Media Storage

Type	Pros	Cons
HDD	Cheap, high capacity	Slower access
SSD	Fast access, silent	More expensive per TB
NVMe	Fastest	Most expensive
NAS	Centralized, expandable	Network overhead

Folder Structure Requirements

easiarr follows TRaSH Guides' recommended structure:

/your/media/root/           # Single root for all data
├── config/                  # Application configs
└── data/                    # Downloads and media
    ├── torrents/            # Torrent downloads
    ├── usenet/              # Usenet downloads
    └── media/               # Organized library

Important: Both download and media folders must be on the same filesystem to enable hardlinks.

---

Network Requirements

Ports

Default ports used by easiarr applications:

Port Range	Category
7000-9999	*arr apps, download clients
3000-3100	Dashboards, web UIs
32400	Plex
8096	Jellyfin
80/443	Traefik (if using reverse proxy)

Firewall

For local access only, no firewall changes needed. For external access:

• Cloudflare Tunnel: No inbound ports required (recommended)
• Direct access: Forward ports 80/443 to Traefik

---

Architecture Support

easiarr supports multiple CPU architectures:

Architecture	Status	Notes
x86_64 (amd64)	✅ Full Support	Standard Intel/AMD processors
ARM64 (aarch64)	✅ Most Apps	Raspberry Pi 4+, Apple Silicon
ARM v7	⚠️ Limited	Older Raspberry Pi, limited container support

Architecture-Specific Notes

• Readarr: Deprecated, no ARM64 support
• Some apps: May not have ARM images, check Docker Hub

---

Resource Usage

Approximate resource usage per application:

Application	RAM	CPU	Notes
Radarr	200-400 MB	Low	Increases with large libraries
Sonarr	200-400 MB	Low	Increases with large libraries
Prowlarr	100-200 MB	Low
qBittorrent	100-500 MB	Variable	Depends on active torrents
Plex	500 MB - 4 GB	Variable	High during transcoding
Jellyfin	500 MB - 4 GB	Variable	High during transcoding

Tip: Start with minimal apps and add more as needed. Monitor with docker stats.

---

Next Steps

• Installation - Install easiarr and dependencies
• Quick-Start - Get started with the setup wizard