# 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