Automated TV series collection manager that monitors, grabs, and manages your TV library via Usenet and BitTorrent.
| Port | 8989 |
| Registry | ghcr.io/daemonless/sonarr |
| Source | https://github.com/Sonarr/Sonarr |
| Website | https://sonarr.tv/ |
| Tag | Description | Best For |
|---|---|---|
latest |
Upstream Binary. Built from official release. | Most users — recommended. |
develop / nightly |
Develop branch — Sonarr's pre-release channel, also published as develop. Sonarr has no separate nightly branch, so nightly and develop are the same build. One-way DB migrations; back up /config before switching back to release. |
Alternative build. |
pkg |
FreeBSD Quarterly. Uses stable, tested packages. | Production stability. |
pkg-latest |
FreeBSD Latest. Rolling package updates. | Staying current. |
Before deploying, ensure your host environment is ready. See the Quick Start Guide for host setup instructions.
services:
sonarr:
image: "ghcr.io/daemonless/sonarr:latest"
container_name: sonarr
environment:
- PUID=1000 # User ID for the application process
- PGID=1000 # Group ID for the application process
- TZ=UTC # Timezone for the container
volumes:
- "/path/to/containers/sonarr:/config"
- "/path/to/tv:/tv" # optional
- "/path/to/downloads:/downloads" # optional
ports:
- "8989:8989"
annotations:
org.freebsd.jail.allow.mlock: "true"
# always (not unless-stopped) so FreeBSD's podman rc.d auto-starts it at boot
restart: alwaysSave as compose.yaml, then run podman-compose up -d.
.env:
# .env
DIRECTOR_PROJECT=sonarr
PUID=1000
PGID=1000
TZ=UTC
appjail-director.yml:
# appjail-director.yml
options:
- virtualnet: ':<random> default'
- nat:
services:
sonarr:
name: sonarr
options:
- container: 'args:--pull'
- expose: '8989:8989 proto:tcp'
- template: !ENV '${PWD}/template.conf'
oci:
user: root
environment:
- PUID: !ENV '${PUID}'
- PGID: !ENV '${PGID}'
- TZ: !ENV '${TZ}'
volumes:
- sonarr: /config
- tv: /tv
- downloads: /downloads
volumes:
sonarr:
device: '/path/to/containers/sonarr'
tv:
device: 'tv'
downloads:
device: 'downloads'Makejail:
# Makejail
ARG tag=latest
OPTION container=boot
OPTION overwrite=force
OPTION from=ghcr.io/daemonless/sonarr:${tag}
template.conf:
# template.conf
exec.start: "/bin/sh /etc/rc"
exec.stop: "/bin/sh /etc/rc.shutdown jail"
mount.devfs
persist
allow.mlock
Save the files above, then run appjail-director up.
Warning
Exposing ports in AppJail means that your service can be reached from remote hosts. If that is not your intention, do not expose the ports and communicate with the service using the jail's IPv4 address or hostname assigned by the virtual network.
To avoid exposing ports, just remove the expose option in your appjail-director.yml or from your command-line arguments.
podman run -d --name sonarr \
-p 8989:8989 \
--annotation 'org.freebsd.jail.allow.mlock=true' \
-e PUID=1000 \
-e PGID=1000 \
-e TZ=UTC \
-v /path/to/containers/sonarr:/config \
-v /path/to/tv:/tv # optional \
-v /path/to/downloads:/downloads # optional \
ghcr.io/daemonless/sonarr:latestSave as run.sh, then run sh run.sh.
appjail oci run -Pd \
-o overwrite=force \
-o container="args:--pull" \
-o virtualnet=":<random> default" \
-o nat \
-o template=template.conf \
-o expose="8989:8989 proto:tcp" \
-e PUID=1000 \
-e PGID=1000 \
-e TZ=UTC \
-o fstab="/path/to/containers/sonarr /config <pseudofs>" \
-o fstab="/path/to/tv /tv <pseudofs>" \ # optional
-o fstab="/path/to/downloads /downloads <pseudofs>" \ # optional
ghcr.io/daemonless/sonarr:latest sonarrtemplate.conf:
# template.conf
exec.start: "/bin/sh /etc/rc"
exec.stop: "/bin/sh /etc/rc.shutdown jail"
mount.devfs
persist
allow.mlock
Save the files above, then run sh run.sh.
Warning
Exposing ports in AppJail means that your service can be reached from remote hosts. If that is not your intention, do not expose the ports and communicate with the service using the jail's IPv4 address or hostname assigned by the virtual network.
To avoid exposing ports, just remove the expose option in your appjail-director.yml or from your command-line arguments.
Warning
Bastille's OCI support is experimental. It requires buildah and shares the host network stack (inherit). Mount volumes with --volume HOST JAIL; without it, image-declared volumes are stored under ${bastille_volumesdir}/${jail}.
services:
sonarr:
name: sonarr
image: "ghcr.io/daemonless/sonarr:latest"
network:
- mode: host
environment:
- PUID=1000
- PGID=1000
- TZ=UTC
volumes:
- "/path/to/containers/sonarr:/config"
- "/path/to/tv:/tv"
- "/path/to/downloads:/downloads"Save as bastille-compose.yml, then run bastille up. Or via CLI:
bastille create -O \
--env PUID=1000 \
--env PGID=1000 \
--env TZ=UTC \
--volume /path/to/containers/sonarr /config \
--volume /path/to/tv /tv \
--volume /path/to/downloads /downloads \
sonarr ghcr.io/daemonless/sonarr:latest inherit- name: Deploy sonarr
containers.podman.podman_container:
name: sonarr
image: "ghcr.io/daemonless/sonarr:latest"
state: started
restart_policy: always
env:
PUID: "1000"
PGID: "1000"
TZ: "UTC"
ports:
- "8989:8989"
volumes:
- "/path/to/containers/sonarr:/config"
- "/path/to/tv:/tv" # optional
- "/path/to/downloads:/downloads" # optional
annotation:
org.freebsd.jail.allow.mlock: "true"Save as sonarr-deploy.yaml, then run ansible-playbook sonarr-deploy.yaml.
Access at: http://localhost:8989
| Variable | Default | Description |
|---|---|---|
PUID |
1000 |
User ID for the application process |
PGID |
1000 |
Group ID for the application process |
TZ |
UTC |
Timezone for the container |
| Path | Description |
|---|---|
/config |
Configuration directory |
/tv |
TV Series library (Optional) |
/downloads |
Download directory (Optional) |
| Port | Protocol | Description |
|---|---|---|
8989 |
TCP | Web UI |
Architectures: amd64
User: bsd (UID/GID via PUID/PGID, defaults to 1000:1000)
Base: FreeBSD 15.1
Need help? Join our Discord community.