# Installation

[Jellyseerr](https://github.com/Fallenbagel/jellyseerr) is a free and open-source request management and media discovery tool for Jellyfin. It allows users to search for and request media directly from your Jellyfin library or through external indexers.

---

## Prerequisites

- Docker and Docker Compose installed  
- A running Jellyfin instance (optional but recommended)  
- Optional: Sonarr, Radarr, and download clients for full automation

---

## 1. Create Project Directory

```bash
mkdir jellyseerr
cd jellyseerr
```

---

## 2. Create `docker-compose.yml`

```yaml
version: "3"
services:
  jellyseerr:
    image: fallenbagel/jellyseerr:latest
    container_name: jellyseerr
    restart: unless-stopped
    ports:
      - "5055:5055"
    environment:
      - LOG_LEVEL=info
    volumes:
      - ./config:/app/config
```

---

## 3. Start Jellyseerr

```bash
docker compose up -d
```

---

## 4. Access Web UI

Open your browser and go to:

```
http://<your-server-ip>:5055
```

You'll be guided through the setup process:
- Create admin account
- Connect Jellyfin server
- (Optional) Connect Sonarr, Radarr, etc.

---

## 5. Update Instructions

To update Jellyseerr:

```bash
docker compose pull
docker compose up -d
```

---

## 6. Optional: Enable Reverse Proxy

To expose Jellyseerr via a domain name (e.g. `requests.example.com`), set up a reverse proxy using [Traefik](https://doc.traefik.io/traefik/), Nginx, or Caddy. A basic Traefik label example:

```yaml
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.jellyseerr.rule=Host(`requests.example.com`)"
      - "traefik.http.routers.jellyseerr.entrypoints=websecure"
      - "traefik.http.routers.jellyseerr.tls.certresolver=myresolver"
```

---

## References

- Jellyseerr GitHub: https://github.com/Fallenbagel/jellyseerr  
- Docker Hub: https://hub.docker.com/r/fallenbagel/jellyseerr  
- Official Documentation: https://docs.jellyseerr.com