# ![Seerr](<https://daemonless.io/images/logos/seerr.svg>) Seerr

[![Build Status](<https://img.shields.io/github/actions/workflow/status/daemonless/seerr/build.yaml?style=flat-square&amp;label=Build&amp;color=green>)](<https://github.com/daemonless/seerr/actions>) [![Last Commit](<https://img.shields.io/github/last-commit/daemonless/seerr?style=flat-square&amp;label=Last+Commit&amp;color=blue>)](<https://github.com/daemonless/seerr/commits>) [![OCI Pulls](<https://img.shields.io/docker/pulls/daemonless/seerr?style=flat-square&amp;label=OCI+Pulls&amp;color=blue>)](<https://hub.docker.com/r/daemonless/seerr>)

Unified media request management (Plex, Jellyfin, Emby) on FreeBSD.

[[![Seerr screenshot 1](<https://daemonless.io/images/screenshots/seerr/preview_1.jpg>)](</images/screenshots/seerr/preview_1.jpg>)](</images/screenshots/seerr/preview_1.jpg>)

|  |  |
| --- | --- |
| **Port** | `5055` |
| **Registry** | [`ghcr.io/daemonless/seerr`](<https://github.com/daemonless/seerr/pkgs/container/seerr>) |
| **Daemonless** | [daemonless/seerr](<https://github.com/daemonless/seerr>) |
| **Source** | [seerr-team/seerr](<https://github.com/seerr-team/seerr>) |
| **Website** | [seerr.io](<https://seerr.io/>) |

## Prerequisites

Before deploying, ensure your host environment is ready. See the [Quick Start Guide](<https://daemonless.io/guides/quick-start/index.md>) for host setup instructions, including the security model for host vs. container privileges.

## Deployment

**Customize Paths, UID & Ports**

Install and manage **Seerr** on FreeBSD with [fjord](<https://fjord.daemonless.io>):

```
fjord install seerr
```

Or open the **App Store** in the fjord web UI and install **Seerr** from the wizard. New to fjord? See the [Install Guide](<https://fjord.daemonless.io/install/>).

**Database** Where the app keeps its data. The default needs nothing else running.

SQLitePostgreSQLYour own

`seerr:latest` — data in `/containers/seerr`

A file in the app's config folder. Right for one person, nothing extra to run.

Save as `compose.yaml`:

```
name: seerr

services:
  seerr:
    image: ghcr.io/daemonless/seerr:latest
    container_name: seerr
    restart: unless-stopped

    environment:
      - PUID=1000
      - PGID=1000
      - TZ=UTC
      - DB_TYPE=${DB_TYPE:-sqlite}
      - DB_HOST=${DB_HOST:-}
      - DB_PORT=${DB_PORT:-5432}
      - DB_USER=${DB_USER:-}
      - DB_PASS=${DB_PASS:-}
      - DB_NAME=${DB_NAME:-}

    volumes:
      - /containers/seerr:/config

    ports:
      - 5055:5055
```

Then run `podman-compose up -d`.

`seerr:latest` · `postgres:17` — data in `/containers/seerr`, `/containers/seerr/postgres`

One more container, its data in its own folder. For a household, or an app that wants it.

**1\.** Save as `.env` and fill in what is empty:

```
# Database: PostgreSQL
DB_TYPE=postgres
DB_HOST=postgres
DB_PORT=5432
DB_USER=seerr
DB_PASS=  # set one
DB_NAME=seerr
DATABASE_LOCATION=/containers/seerr/postgres
```

**2\.** Save as `compose.yaml`:

```
name: seerr

services:
  seerr:
    depends_on: [postgres]
    image: ghcr.io/daemonless/seerr:latest
    container_name: seerr
    restart: unless-stopped

    environment:
      - PUID=1000
      - PGID=1000
      - TZ=UTC
      - DB_TYPE=${DB_TYPE:-sqlite}
      - DB_HOST=${DB_HOST:-}
      - DB_PORT=${DB_PORT:-5432}
      - DB_USER=${DB_USER:-}
      - DB_PASS=${DB_PASS:-}
      - DB_NAME=${DB_NAME:-}

    volumes:
      - /containers/seerr:/config

    ports:
      - 5055:5055
  postgres:
    image: ghcr.io/daemonless/postgres:17
    restart: always
    annotations:
      org.freebsd.jail.allow.sysvipc: "true"
    environment:
      - POSTGRES_USER=${DB_USER}
      - POSTGRES_PASSWORD=${DB_PASS}
      - POSTGRES_DB=${DB_NAME}
    volumes:
      - "${DATABASE_LOCATION}:/var/lib/postgresql/data"
```

Then run `podman-compose up -d`.

`seerr:latest` · your own database — data in `/containers/seerr`

A database you already run, here or on another machine. Nothing extra runs; you give the address and the account.

**1\.** Save as `.env` and fill in Kind, Host, Port, User, Password, Database:

```
# Database: Your own
DB_TYPE=  # Kind: postgres
DB_HOST=  # Host
DB_PORT=  # Port
DB_USER=  # User
DB_PASS=  # Password
DB_NAME=  # Database
```

**2\.** Save as `compose.yaml`:

```
name: seerr

services:
  seerr:
    image: ghcr.io/daemonless/seerr:latest
    container_name: seerr
    restart: unless-stopped

    environment:
      - PUID=1000
      - PGID=1000
      - TZ=UTC
      - DB_TYPE=${DB_TYPE:-sqlite}
      - DB_HOST=${DB_HOST:-}
      - DB_PORT=${DB_PORT:-5432}
      - DB_USER=${DB_USER:-}
      - DB_PASS=${DB_PASS:-}
      - DB_NAME=${DB_NAME:-}

    volumes:
      - /containers/seerr:/config

    ports:
      - 5055:5055
```

Then run `podman-compose up -d`.

**Database** Where the app keeps its data. The default needs nothing else running.

SQLitePostgreSQLYour own

`seerr:latest` — data in `/containers/seerr`

A file in the app's config folder. Right for one person, nothing extra to run.

```
# .env

DIRECTOR_PROJECT=seerr
PUID=1000
PGID=1000
TZ=UTC
DB_TYPE=sqlite
DB_HOST=
DB_PORT=5432
DB_USER=
DB_PASS=<DB_PASS>
DB_NAME=
```

```
# appjail-director.yml

options:
  - virtualnet: ':<random> default'
  - nat:
services:
  seerr:
    name: seerr
    options:
      - container: 'args:--pull'
      - expose: '5055:5055 proto:tcp'
    oci:
      user: root
      environment:
        - PUID: !ENV '${PUID}'
        - PGID: !ENV '${PGID}'
        - TZ: !ENV '${TZ}'
        - DB_TYPE: !ENV '${DB_TYPE}'
        - DB_HOST: !ENV '${DB_HOST}'
        - DB_PORT: !ENV '${DB_PORT}'
        - DB_USER: !ENV '${DB_USER}'
        - DB_PASS: !ENV '${DB_PASS}'
        - DB_NAME: !ENV '${DB_NAME}'
    volumes:
      - seerr: /config
volumes:
  seerr:
    device: '/containers/seerr'
```

```
# Makejail

ARG tag=latest

OPTION container=boot
OPTION overwrite=force
OPTION from=ghcr.io/daemonless/seerr:${tag}
```

Save the files above, then run `appjail-director up`.

`seerr:latest` · `postgres:17` — data in `/containers/seerr`, `/containers/seerr/postgres`

One more container, its data in its own folder. For a household, or an app that wants it.

```
# .env

DIRECTOR_PROJECT=seerr
PUID=1000
PGID=1000
TZ=UTC
DB_TYPE=postgres
DB_HOST=seerr_postgres
DB_PORT=5432
DB_USER=seerr
DB_PASS=
DB_NAME=seerr
DATABASE_LOCATION=/containers/seerr/postgres
```

```
# appjail-director.yml

options:
  - virtualnet: ':<random> default'
  - nat:
services:
  seerr:
    name: seerr
    options:
      - container: 'args:--pull'
      - expose: '5055:5055 proto:tcp'
    oci:
      user: root
      environment:
        - PUID: !ENV '${PUID}'
        - PGID: !ENV '${PGID}'
        - TZ: !ENV '${TZ}'
        - DB_TYPE: !ENV '${DB_TYPE}'
        - DB_HOST: !ENV '${DB_HOST}'
        - DB_PORT: !ENV '${DB_PORT}'
        - DB_USER: !ENV '${DB_USER}'
        - DB_PASS: !ENV '${DB_PASS}'
        - DB_NAME: !ENV '${DB_NAME}'
    volumes:
      - seerr: /config
  postgres:
    name: seerr_postgres
    priority: 10
    options:
      - from: ghcr.io/daemonless/postgres:17
      - template: !ENV '${PWD}/postgres-template.conf'
    oci:
      environment:
        - POSTGRES_USER: !ENV '${DB_USER}'
        - POSTGRES_PASSWORD: !ENV '${DB_PASS}'
        - POSTGRES_DB: !ENV '${DB_NAME}'
    volumes:
      - database: /var/lib/postgresql/data
volumes:
  seerr:
    device: '/containers/seerr'
  database:
    device: !ENV '${DATABASE_LOCATION}'
```

```
# Makejail

ARG tag=latest

OPTION container=boot
OPTION overwrite=force
OPTION from=ghcr.io/daemonless/seerr:${tag}
```

```
# The jail PostgreSQL runs in: SysV shared memory, which a jail does not
# get by default. ip4/ip6 are set here because the director's ip4_inherit
# option is a no-op in AppJail 5.5.0.

exec.start: "/bin/sh /etc/rc"
exec.stop: "/bin/sh /etc/rc.shutdown jail"
sysvmsg: new
sysvsem: new
sysvshm: new
mount.devfs
persist
ip4: inherit
ip6: inherit
```

Save the files above, then run `appjail-director up`.

`seerr:latest` · your own database — data in `/containers/seerr`

A database you already run, here or on another machine. Nothing extra runs; you give the address and the account.

```
# .env

DIRECTOR_PROJECT=seerr
PUID=1000
PGID=1000
TZ=UTC
DB_TYPE=
DB_HOST=
DB_PORT=
DB_USER=
DB_PASS=
DB_NAME=
```

```
# appjail-director.yml

options:
  - virtualnet: ':<random> default'
  - nat:
services:
  seerr:
    name: seerr
    options:
      - container: 'args:--pull'
      - expose: '5055:5055 proto:tcp'
    oci:
      user: root
      environment:
        - PUID: !ENV '${PUID}'
        - PGID: !ENV '${PGID}'
        - TZ: !ENV '${TZ}'
        - DB_TYPE: !ENV '${DB_TYPE}'
        - DB_HOST: !ENV '${DB_HOST}'
        - DB_PORT: !ENV '${DB_PORT}'
        - DB_USER: !ENV '${DB_USER}'
        - DB_PASS: !ENV '${DB_PASS}'
        - DB_NAME: !ENV '${DB_NAME}'
    volumes:
      - seerr: /config
volumes:
  seerr:
    device: '/containers/seerr'
```

```
# Makejail

ARG tag=latest

OPTION container=boot
OPTION overwrite=force
OPTION from=ghcr.io/daemonless/seerr:${tag}
```

Save the files above, then run `appjail-director up`.

Open `http://<server>:5055` from another machine (the server's own browser can't use a published port).

## 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 |
| `DB_TYPE` | `sqlite` | sqlite or postgres; set by the Database choice |
| `DB_HOST` | \`\` | PostgreSQL host (Database choice) |
| `DB_PORT` | `5432` | PostgreSQL port (Database choice) |
| `DB_USER` | \`\` | PostgreSQL user (Database choice) |
| `DB_PASS` | `<DB_PASS>` | PostgreSQL password (Database choice) |
| `DB_NAME` | \`\` | PostgreSQL database name (Database choice) |

### Volumes

| Path | Description |
| --- | --- |
| `/config` | Configuration and database directory |

### Ports

| Port | Protocol | Description |
| --- | --- | --- |
| `5055` | TCP | Web UI |

## Version Tags

Multi-arch manifests — resolve automatically to the right image for your platform.

| Tag | Description | Best For |
| :--- | :--- | :--- |
| `latest` | **Upstream Binary**. Built from official release. | Most users — recommended. |

| Tag | Description | Best For |
| :--- | :--- | :--- |
| `latest-amd64` | **Upstream Binary**. Built from official release. | Most users — recommended. |

| Tag | Description | Best For |
| :--- | :--- | :--- |
| `latest-aarch64` | **Upstream Binary**. Built from official release. | Most users — recommended. |

> [!NOTE]
>
> **Implementation Details**
>
> - **Architectures:** amd64, aarch64
> - **User:** `bsd` (UID/GID set via [PUID/PGID](<https://daemonless.io/guides/permissions/index.md>)). Defaults to `1000:1000`.
> - **Base:** Built on `ghcr.io/daemonless/base` (FreeBSD 15.1).

---

Need help? Join our [Discord](<https://discord.gg/Kb9tkhecZT>) community.
