# Unraid MCP Server Deployment Configuration

This file contains the docker run command or docker-compose configuration needed to deploy the MCP server on an Unraid host.

## Prerequisites

*   The host must have Docker installed (standard for Unraid).
*   The container must run in **privileged mode** to interact with host system calls and devices.

## Docker Run Command

```bash
docker run -d \
  --name unraid-mcp-server \
  --privileged \
  --restart unless-stopped \
  -p 8000:8000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /usr/bin:/usr/bin \
  -v /usr/sbin:/usr/sbin \
  -v /mnt:/mnt \
  -v /proc:/proc \
  -v /sys:/sys \
  -v $(pwd)/.env:/app/.env \
  unraid-mcp-server:latest
```

## Volume Mappings Explained

| Host Path | Container Path | Purpose |
| :--- | :--- | :--- |
| `/var/run/docker.sock` | `/var/run/docker.sock` | Allows managing host Docker containers. |
| `/usr/bin` | `/usr/bin` | Provides access to Unraid management binaries. |
| `/usr/sbin` | `/usr/sbin` | Provides access to administrative host binaries. |
| `/mnt` | `/mnt` | Access to the Unraid user shares and array disks. |
| `/proc` | `/proc` | Access to kernel/process information. |
| `/sys` | `/sys` | Access to hardware/kernel sysfs. |
| `$(pwd)/.env` | `/app/.env` | Passes environment variables from the host. |

## Docker Compose Configuration

```yaml
services:
  mcp-server:
    build: .
    container_name: unraid-mcp-server
    privileged: true
    restart: unless-stopped
    ports:
      - "8000:8000"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /usr/bin:/usr/bin
      - /usr/sbin:/usr/sbin
      - /mnt:/mnt
      - /proc:/proc
      - /sys:/sys
      - ./.env:/app/.env
```