Skip to content

About

A simple request and administration layer for Sonarr, Radarr, Prowlarr, qBittorrent, and Emby.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

1 watching

Forks

Provisionarr

Provisionarr terminal, media, and wrench mark

I built Provisionarr as a request and administration layer for Sonarr, Radarr, Prowlarr, and qBittorrent. Household users can search for movies and shows, request titles, and track request status. Administrators get a separate setup and operations surface.

Service credentials stay on the server. Users don't receive API keys, torrent identifiers, filesystem paths, or raw upstream errors.

Development status

The existing-stack request and administration interface is the supported core. Managed-stack onboarding is available as preview code on main. It remains a preview until clean ARM64 and AMD64 installation, upgrade, and rollback checks are recorded.

See project scope before opening an issue or pull request. It separates the supported core, onboarding preview, contribution lanes, and deferred work.

Onboarding preview

The owner-only onboarding work connects and tests Sonarr, Radarr, Prowlarr, and qBittorrent through their native APIs. The current preview can:

  • create the selected Sonarr and Radarr root folders;
  • register qBittorrent in Sonarr and Radarr with separate TV and movie categories;
  • create and test the Sonarr and Radarr application links in Prowlarr;
  • show every proposed change before it is applied;
  • verify the resulting root folders, download clients, and Prowlarr links; and
  • keep a private backup for one-click rollback.

These capabilities aren't a supported managed installation yet. Keep write orchestration disabled outside an isolated test stack.

I don't create indexer-provider credentials. Administrators add indexers in Prowlarr, which then synchronizes them to the linked applications.

Keep PROVISIONARR_ORCHESTRATION_WRITES_ENABLED=false while reviewing a plan. The write path is owner-only and rejects an expired or altered preview.

Run Provisionarr

You can run Provisionarr in Docker or as a native Node.js service. The web service runs without Docker. The generated four-service media bundle uses Docker Compose when you select that deployment option. See native installation for the systemd path.

For a local checkout with Node.js 22 or newer:

npm ci --ignore-scripts
npm start

The default listener uses port 3000. Set PORT and the documented PROVISIONARR_* environment variables in a private environment file when the default is unsuitable. Never commit that file.

Access profiles

LAN HTTP, a separately configured reverse proxy, and tailnet-only HTTPS are supported access profiles. Tailnet-only HTTPS is optional. It does not change the application authentication requirement, and it must not expose Sonarr, Radarr, Prowlarr, or qBittorrent ports directly.

Remote browser access uses HTTPS. A private LAN deployment can remain on HTTP when the network boundary is trusted. Tailscale Serve is one private HTTPS recipe; a conventional reverse proxy is another. Public tunnel access requires its own access policy and release review.

Requests

Search accepts an exact movie or series title and an optional season. A confirmed request is translated into the native Sonarr or Radarr action. The request history reports queue, download, import, ready, and failure states from the ARR services and qBittorrent.

Storage holds and request limits are shown before a request is confirmed. A held request stays visible to the system administrator instead of silently starting a download that the configured storage cannot support.

Generated stack deployment

Guided setup can generate pinned Compose, environment, and instruction files for Sonarr, Radarr, Prowlarr, and qBittorrent. Generation only returns files. The separate host command provides dry-run, apply, verify, and rollback actions.

See generated stack deployment for the commands and the data-preserving rollback behavior.

Operations and project status

Release status and test results are recorded in release evidence. A pending item is not a passed release gate.

License

I license Provisionarr under the GNU Affero General Public License v3.0 only (AGPL-3.0-only).

About

A simple request and administration layer for Sonarr, Radarr, Prowlarr, qBittorrent, and Emby.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages