Skip to content
Weaver Docs

Installation

Weaver runs on Docker, Unraid, macOS via Homebrew or a desktop app, Windows via Winget or an MSI, and Linux via a portable binary. Pick the method that fits, follow its sub-page, then come back here for the first run.

  • Docker for servers and NAS boxes, including Unraid.
  • Homebrew for a macOS service.
  • Winget for Windows from the command line.
  • Desktop App And Binaries for the macOS and Windows desktop apps and headless portable archives.

Before installing, decide on three paths and keep them on storage that survives restarts and upgrades: the data directory, the intermediate directory for in-progress work, and the complete directory for finished output. Storage Layout explains each.

First-Run Setup

Section titled “First-Run Setup”

If the wizard asks for a setup code, Setup Code shows where to find it for each install method.

The first time you open a native install, Weaver asks two questions. Both are changeable later in Settings → Security.

  • Who can open Weaver. Require a login everywhere, require it except on your local network, or run without one. The local-network option fits most home setups.
  • How can I access Weaver. This machine only, or your whole network. Widening takes effect after a restart, and the wizard offers a Restart Weaver button that performs it on the spot.

Setup is only accepted from the machine Weaver runs on or an already-trusted network. A container cannot meet that rule, so containers set their login in the compose file instead of the wizard. See Docker.

First Configuration Pass

Section titled “First Configuration Pass”
  1. Open Settings → General and confirm the data, intermediate, and complete directories.
  2. Open Settings → Servers and add your Usenet providers. See Servers.
  3. Open Settings → Categories if jobs need separate destinations.
  4. Use Upload to submit one NZB and watch it through Queue, Monitoring, and Logs.
  5. Connect Scryer, Sonarr, or Radarr. See NZBGet-compatible API.
  6. Review Security And Access before exposing Weaver beyond a trusted network.
Section titled “Related”
  • Configuration lists every environment variable and which ones only apply on first run.
  • Reverse Proxy covers subpaths and allowed hostnames.
  • Upgrading covers every install method.
  • Storage Layout explains the three directories and how to share a mount with Scryer.