Skip to content

Getting Started

This quick start gets Weaver running with persistent configuration, intermediate storage, complete storage, and your first browser session.

Save as docker-compose.yml, replacing /path/to/downloads with your own folder:

services:
weaver:
image: ghcr.io/scryer-media/weaver:latest
container_name: weaver
restart: unless-stopped
ports:
- "9090:9090"
volumes:
- weaver-config:/config
- /path/to/downloads:/downloads
volumes:
weaver-config:

Start it:

Terminal window
docker compose up -d

Open http://localhost:9090.

  1. Open Settings > General and confirm the data, intermediate, and complete directories.
  2. Open Settings > Servers and add only the connection records Weaver should use.
  3. Open Settings > Categories if your jobs need named destination overrides.
  4. Use Upload to submit NZB files and create your first jobs.
  5. Watch Queue, Monitoring, and Logs as your first job runs.

To upgrade a Docker install, pull the latest image and restart:

Terminal window
docker compose pull
docker compose up -d

For more detail, see Upgrading.

To host Weaver at a subpath like https://example.com/weaver/, add a command override:

command: ["--config", "/config", "serve", "--port", "9090", "--base-url", "/weaver"]

Then point your reverse proxy at Weaver’s port and preserve the /weaver path.

Terminal window
brew install scryer-media/weaver/weaver-usenet
brew services start weaver-usenet

Open http://localhost:9090.

Homebrew creates a live service config at $(brew --prefix)/etc/weaver/config.env.

Edit that file to change the Homebrew-managed config path, port, or base URL:

Terminal window
nano "$(brew --prefix)/etc/weaver/config.env"

Then restart the service:

Terminal window
brew services restart weaver-usenet

Download weaver-windows-x86_64.zip from the latest release, unzip it, and start weaver.exe. Open http://localhost:9090.