# Vettarr

Vettarr is a self-hosted gatekeeper that checks media requests — links, Telegram posts, magnets, .torrent files, and Seerr requests — against rules you set for age ratings, genres, size, seeders, and your existing. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/7028/vettarr

## Description

Vettarr is a self-hosted gatekeeper that checks media requests — links, Telegram posts, magnets, .torrent files, and Seerr requests — against rules you set for age ratings, genres, size, seeders, and your existing library, then approves, holds, or refuses them. Approved items go to qBittorrent, Radarr, Sonarr, or back to Seerr. Every decision keeps its reasons, and a shadow mode previews decisions without acting, so homelab media-library owners can see what it would allow before enabling it.

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Links

- Unraid: https://ca.unraid.net/apps/vettarr-1dmh5530k7sqw3?q=vettarr
- GitHub: https://github.com/GeiserX/vettarr

## Common questions

### Which file configures rules, and where should secrets go?

Edit /data/config.yaml, starting from config.example.yaml. Secrets should stay in the container's variables as ${VAR}.

### Do I need to create the Postgres schema manually?

No. The database starts empty, and vettarr creates the schema on the first start and upgrades it on later starts.

### How do I enable authentication for the web UI?

Run the vettarr web hash-password command, put the printed hash in .env as WEB_PASSWORD_HASH, and uncomment web.auth in config.yaml.

### Which port should I use for the web UI?

The web UI is served on port 4850 according to the quick start.

### Can I review items from a phone or Telegram?

Yes. The web UI has Inbox and Review pages usable from a phone, and the Telegram bot can push each item that needs you with the same actions.

### Do approved items download immediately after setup?

Not from the example config. It starts in shadow mode, and no source reads anything or downloads until you turn sources and actions on.

---
Source: Our Local Host (https://ourlocalhost.com/app/7028/vettarr), the self-hosted and open-source app directory.