basic structure

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

@@ -0,0 +1,82 @@
+# Installation
+
+This guide shows you how to install [Jellyfin](https://jellyfin.org/) via Docker Compose. Make sure Docker Engine is already installed on your system.
+
+## Prerequisites
+
+- Docker Engine installed (follow the official guide linked above)  
+- Docker Compose available  
+- Linux host system
+
+---
+
+## 1. Create a project directory
+
+```bash
+mkdir jellyfin
+cd jellyfin
+```
+
+---
+
+## 2. Create `docker-compose.yml`
+
+```yaml
+version: "3"
+services:
+  jellyfin:
+    image: jellyfin/jellyfin
+    container_name: jellyfin
+    user: uid:gid           # replace uid:gid with your actual user ID and group ID
+    network_mode: "host"    # optional: needed for DLNA and certain integrations
+    volumes:
+      - ./config:/config
+      - ./cache:/cache
+      - /path/to/media:/media
+        # Add more media folders if needed
+    restart: unless-stopped
+    environment:
+      - JELLYFIN_PublishedServerUrl=http://your-domain-or-ip
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
+```
+
+---
+
+## 3. Start Jellyfin
+
+```bash
+docker compose up -d
+```
+
+---
+
+## 4. Access Jellyfin
+
+Open a browser and navigate to `http://<your-host-ip>:8096` to begin setup via the web UI.
+
+---
+
+## 5. (Optional) Manage updates
+
+When a new version is available:
+
+```bash
+docker compose pull
+docker compose up -d
+```
+
+---
+
+## Notes
+
+- Ensure user ID (`uid`) and group ID (`gid`) match your Linux user to prevent permissions issues.  
+- Host network mode is required for DLNA and some integrations only; you can remove it if not needed.  
+- This setup uses bind-mounted folders (`./config`, `./cache`, `/path/to/media`) for persistent data.
+
+---
+
+## References
+
+- Official Docker installation guide: https://docs.docker.com/engine/install/  
+- Jellyfin Docker Compose instructions