Add appjail: and rebuild docs

Author: ahze

README.md

@@ -5,16 +5,30 @@ Source: dbuild templates
 
 # Sonarr
 
+[![Build Status](https://img.shields.io/github/actions/workflow/status/daemonless/sonarr/build.yaml?style=flat-square&label=Build&color=green)](https://github.com/daemonless/sonarr/actions)
+[![Last Commit](https://img.shields.io/github/last-commit/daemonless/sonarr?style=flat-square&label=Last+Commit&color=blue)](https://github.com/daemonless/sonarr/commits)
+
 Sonarr TV series management on FreeBSD.
 
 | | |
 |---|---|
 | **Port** | 8989 |
 | **Registry** | `ghcr.io/daemonless/sonarr` |
-| **Docs** | [daemonless.io/images/sonarr](https://daemonless.io/images/sonarr/) |
 | **Source** | [https://github.com/Sonarr/Sonarr](https://github.com/Sonarr/Sonarr) |
 | **Website** | [https://sonarr.tv/](https://sonarr.tv/) |
 
+## Version Tags
+
+| Tag | Description | Best For |
+| :--- | :--- | :--- |
+| `latest` | **Upstream Binary**. Built from official release. | Most users. Matches Linux Docker behavior. |
+| `pkg` | **FreeBSD Quarterly**. Uses stable, tested packages. | Production stability. |
+| `pkg-latest` | **FreeBSD Latest**. Rolling package updates. | Newest FreeBSD features. |
+
+## Prerequisites
+
+Before deploying, ensure your host environment is ready. See the [Quick Start Guide](https://daemonless.io/guides/quick-start) for host setup instructions.
+
 ## Deployment
 
 ### Podman Compose
@@ -29,31 +43,81 @@ services:
       - PGID=1000
       - TZ=UTC
     volumes:
-      - /path/to/containers/sonarr:/config
-      - /path/to/tv:/tv # optional
-      - /path/to/downloads:/downloads # optional
+      - "/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"
     restart: unless-stopped
 ```
 
+### AppJail Director
+
+**.env**:
+
+```
+DIRECTOR_PROJECT=sonarr
+PUID=1000
+PGID=1000
+TZ=UTC
+```
+
+**appjail-director.yml**:
+
+```yaml
+options:
+  - virtualnet: ':<random> default'
+  - nat:
+services:
+  sonarr:
+    name: sonarr
+    options:
+      - container: 'boot args:--pull'
+    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**:
+
+```
+ARG tag=latest
+
+OPTION overwrite=force
+OPTION from=ghcr.io/daemonless/sonarr:${tag}
+OPTION allow.mlock
+```
+
 ### Podman CLI
 
 ```bash
 podman run -d --name sonarr \
   -p 8989:8989 \
   --annotation 'org.freebsd.jail.allow.mlock=true' \
-  -e PUID=@PUID@ \
-  -e PGID=@PGID@ \
-  -e TZ=@TZ@ \
+  -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
+  -v /path/to/tv:/tv # optional \
+  -v /path/to/downloads:/downloads # optional \
   ghcr.io/daemonless/sonarr:latest
 ```
-Access at: `http://localhost:8989`
 
 ### Ansible
 
@@ -65,9 +129,9 @@ Access at: `http://localhost:8989`
     state: started
     restart_policy: always
     env:
-      PUID: "@PUID@"
-      PGID: "@PGID@"
-      TZ: "@TZ@"
+      PUID: "1000"
+      PGID: "1000"
+      TZ: "UTC"
     ports:
       - "8989:8989"
     volumes:
@@ -78,30 +142,36 @@ Access at: `http://localhost:8989`
       org.freebsd.jail.allow.mlock: "true"
 ```
 
-## Configuration
+Access at: `http://localhost:8989`
+
+## Parameters
+
 ### Environment Variables
 
 | 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 |
+
 ### Volumes
 
 | Path | Description |
 |------|-------------|
 | `/config` | Configuration directory |
 | `/tv` | TV Series library (Optional) |
 | `/downloads` | Download directory (Optional) |
+
 ### Ports
 
 | Port | Protocol | Description |
 |------|----------|-------------|
 | `8989` | TCP | Web UI |
 
-## Notes
+**Architectures:** amd64
+**User:** `bsd` (UID/GID via PUID/PGID, defaults to 1000:1000)
+**Base:** FreeBSD 15.0
+
+---
 
-- **Architectures:** amd64
-- **User:** `bsd` (UID/GID set via PUID/PGID)
-- **Base:** Built on `ghcr.io/daemonless/base` (FreeBSD)
-- **.NET App:** Requires `--annotation 'org.freebsd.jail.allow.mlock=true'` and a [patched ocijail](https://daemonless.io/guides/ocijail-patch).
+Need help? Join our [Discord](https://discord.gg/Kb9tkhecZT) community.

compose.yaml

@@ -10,7 +10,8 @@ x-daemonless:
   freshports_url: "https://www.freshports.org/net-p2p/sonarr/"
   user: "bsd"
   mlock: true
-  
+  appjail:
+
   docs:
     env:
       PUID: "User ID for the application process"
@@ -47,4 +48,4 @@ services:
       - /path/to/downloads:/downloads
 
     ports:
-      - 8989:8989
+      - 8989:8989