> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kernelmedia.tv/llms.txt
> Use this file to discover all available pages before exploring further.

# Synology

> Run Kernel on a Synology NAS with Container Manager

Kernel runs on Synology through **Container Manager** (DSM 7.2 or later), using the same Docker images as everywhere else. There's no separate Synology package.

## Server

**1. Install Container Manager**

Open **Package Center** and install **Container Manager**.

**2. Create the folders**

In **File Station**, create `docker/kernel/data` and `docker/kernel/log` on your volume. The project won't start if they're missing.

**3. Create the project**

In Container Manager, go to **Project → Create**, choose a name and path, and paste this as the compose file:

```yaml theme={null}
services:
  kernel:
    image: kernelmedia/server:latest
    container_name: kernel
    network_mode: host
    restart: unless-stopped
    volumes:
      - /volume1/docker/kernel/data:/app/data
      - /volume1/docker/kernel/log:/app/log
      - /volume1/video:/media
```

Change `/volume1/video` to the shared folder that holds your media.

**4. Finish setup**

Open `http://<nas-ip>:9014` to run the [setup wizard](https://docs.kernelmedia.tv/setup/first-run.md). Point your libraries at paths under `/media`.

> [!NOTE]
>
> `network_mode: host` lets Kernel find HDHomeRun tuners and remote transcoders on your network over multicast, which Docker's default bridge network blocks. The server listens on port `9014`.

### Updating

Open the project in Container Manager, stop it, and choose **Build** again so it pulls the latest image. Don't use the in-app updater inside Docker. See [Updating](https://docs.kernelmedia.tv/updating.md#docker).

## Remote transcoder

To run a [remote transcoder node](https://docs.kernelmedia.tv/transcoder/install.md) on a Synology:

1. In File Station, create `docker/kernel-transcoder` and save a `config.yml` in it. The node won't start without one:

   ```yaml theme={null}
   server:
     port: 9014
   node:
     name: synology
   ffmpeg:
     path: /usr/lib/jellyfin-ffmpeg/ffmpeg
   ```

2. In Container Manager, go to **Project → Create** and paste:

   ```yaml theme={null}
   services:
     kernel-transcoder:
       image: kernelmedia/remotenode:latest
       container_name: kernel-transcoder
       network_mode: host
       restart: unless-stopped
       volumes:
         - /volume1/docker/kernel-transcoder:/etc/kernel-transcoder
         - /volume1/video:/media
   ```

Your media must show up at `/media`, the same path your server uses. The node uses port `9014` too, so don't run it on the same NAS as the server. Then [pair it](https://docs.kernelmedia.tv/transcoder/pairing.md) under **Settings → Remote Transcoders** on your server.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.