basic structure

homelabbing/docs/software/mediastack/jellyseerr/installation.md

@@ -0,0 +1,95 @@
+# 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