Arrmada README

项目的 README,来自 github.com/tristenlammi/Arrmada。合并为一个 markdown 文件:README.md。

Arrmada

Your whole media server in one app — movies, TV, books and requests, without the *arr stack.

Install · Features · Docs · Issues

A TV series in Arrmada: seasons, episodes and what it's searching for

Arrmada finds, downloads and organises your movies, TV, books and audiobooks, lets your household request what they want to watch, and keeps your Plex or Jellyfin library tidy — with one database and one web page instead of half a dozen apps. qBittorrent comes with it, already set up.

Early days: Arrmada is under active development (v0.x). Expect rough edges, and keep backups.

What it does

See everything it does →

Install

You need a Linux server with Docker and Docker Compose (on Unraid: the Docker Compose Manager plugin). On the server, run:

curl -fsSL https://raw.githubusercontent.com/tristenlammi/Arrmada/main/install.sh | sh

It asks where to keep Arrmada's files and where your media lives (press Enter to accept the suggestions), then starts everything. Open the address it prints — http://<your-server>:7878 — create your admin account, and a short setup walks you through the rest in the browser: your free TMDB key, your library folders, your media server (Plex, Jellyfin or both) and indexers.

Install guide, options and Unraid notes →

Prefer Docker Compose?

In an empty folder on the server:

curl -fsSL https://raw.githubusercontent.com/tristenlammi/Arrmada/main/docker-compose.example.yml -o docker-compose.yml

Next to it, a .env with your folders (full paths), and the other settings marked ← in the file if you want to change them (the user and group, your timezone, the port):

ARRMADA_DATA_HOST=/srv/arrmada/data     # Arrmada's database and settings
ARRMADA_STORAGE_HOST=/srv/media         # your libraries and downloads

Then run docker compose up -d, open http://<your-server>:7878 and follow the setup. The compose file itself stays as downloaded, so updating it never loses your settings. To update: docker compose pull && docker compose up -d. That skips the installer's pre-update backup and automatic roll-back; the app still copies its database before any upgrade of it. More →

Using Portainer? The same file works as a stack, with the same lines as its environment variables: Using Portainer →

On Unraid, from the Docker page

Arrmada's Unraid template is one container with qBittorrent and FlareSolverr built in and already connected (switch either off to use your own), plus a SABnzbd (for Usenet) and a Prowlarr that stay off until you switch them on. It's managed and updated from Unraid's Docker tab like your other containers, with your media share at /storage. Arrmada on Unraid →

Update

Run the same line again:

curl -fsSL https://raw.githubusercontent.com/tristenlammi/Arrmada/main/install.sh | sh

It backs up the database, updates, and checks Arrmada comes back — if the new version doesn't start, it goes back to the one you had. (In Arrmada's folder, sh update.sh does the same.)

Installs follow the stable channel: updates bring the latest published release, never unreleased code. Developers can follow main instead, the newest code compiled on the server (Following main). More about updating →

Screenshots

Discover: requests on the way and titles ready to watch The movie library
Requests waiting for approval and on their way The download queue
Describing the file you want in a quality profile The first-run setup

Discover on a phone    Requests on a phone

Requirements

Documentation

Install The one-liner, its options, Unraid, the git checkout way
Unraid The Unraid template: share layout, the built-in qBittorrent or your own, GPU, updates
Updating Updates, rollbacks, published images
Configuration Ports, .env, media folders and hardlinks, recycle bin, reverse proxies
VPN (Gluetun) Sending qBittorrent's traffic through a VPN with Gluetun, Compose or Unraid
GPU Hardware encoding for Convert (Intel, AMD, NVIDIA) and GPU AI subtitles
Backups Backups, restoring, a forgotten admin password
Troubleshooting Common problems and fixes
Features Everything Arrmada does
Alerts to n8n Sending alerts to n8n or any webhook as signed JSON, and every event's fields
API keys for scripts Personal API keys: calling Arrmada from n8n, Home Assistant or curl
Homepage dashboard Arrmada's numbers on a gethomepage.dev dashboard: the widget key, the services.yaml entry and every field
Development Building and testing it yourself
Releasing For maintainers

How it's built and tested

Arrmada is written with heavy AI assistance (Claude): I decide what it does, review the results, and run it on my own server every day, but most of the code is AI-written, and commits say so. It is still pre-1.0. So you can judge it on what's checked rather than on trust, here is what runs before anything reaches main:

If you find a problem, especially in sign-in or anything that touches your files, please open an issue, or report security problems privately (see Security). A second pair of human eyes on the sign-in code is very welcome.

Contributing

Bug reports and ideas are welcome in Issues. For code, see Development — please open an issue before a big change.

License

MIT © 2026 Tristen Lammi

Arrmada (tristenlammi/Arrmada)

正在搜索数据库…

这是什么?Arrmada 是一款自托管应用,可以替代整个“arr 全家桶”:它负责查找、下载、整理并提供电影、剧集、书籍和有声书,允许家庭成员请求影片,并整理 Plex 或 Jellyfin 媒体库,所有功能都在一个应用、一个数据库中完成。
这是用一个应用替代多个独立工具吗?是的。它把 Radarr、Sonarr、Overseerr 和 Tautulli 的功能,加上一个种子下载客户端(内置 qBittorrent),整合进一个自托管网页应用中,而不需要多个独立容器。
我该如何让它运行起来?在装有 Docker 和 Docker Compose 的 Linux 服务器上运行一行安装命令(同时提供 docker-compose.yml)。命令会询问文件和媒体的存放位置,然后启动容器。接着打开终端输出的地址,创建管理员账户,并在浏览器中完成设置(TMDB 密钥、媒体库文件夹、媒体服务器、索引器)。
我需要 TMDB 密钥或自己的下载客户端吗?需要在设置时填入一个免费的 TMDB API 密钥,并安装支持 Compose v2 的 Docker。qBittorrent 已内置并完成配置;用于 Usenet 的 SABnzbd 为可选项,通过 --with-sabnzbd 参数添加。
日常使用够稳定吗?目前还不完全稳定。项目仍处于 v0.x 版本,README 明确提醒,在这个早期开发阶段可能会遇到不少粗糙之处,请务必保留备份。
它能在树莓派上运行,还是只能用于 x86 服务器?两者都可以:任何 x86-64 或 ARM64 的 64 位 Linux 服务器都能运行,包括运行 64 位系统的树莓派 4/5。不过,硬件加速的 Convert 和 AI 字幕功能仅支持 x86-64,在 ARM 上会退回使用 CPU 运算。
我能从 Radarr 和 Sonarr 迁移,而不必从头开始吗?可以。Arrmada 能导入你现有的 Radarr 和 Sonarr 媒体库,包括其中的文件,因此切换时无需重新下载所有内容。
它除了种子,还支持 Usenet 吗?可以选择支持。使用 --with-sabnzbd 安装参数,即可在内置的 qBittorrent 之外添加 SABnzbd,并配合你自己的 Usenet 服务商和索引器使用。
家人和朋友如何提交请求?家庭成员使用自己的 Plex 或 Jellyfin 账户登录,像使用 Overseerr 那样浏览并请求影片,影片就绪时会收到通知。
文件在转换或替换时会怎样?Arrmada 通过硬链接导入、回收站、每晚备份,以及每次修改文件时的一步回滚,防止文件丢失。
大小
21 MB
星标
427
时长
9个月
提交 · 90 天