4XLink 4XLink for NAS Quick install
Version 2.0.1
Quick installation guide

Install in three steps

Download 4XLink, create the container, then open it in your browser. No advanced Docker knowledge is required.

Before you begin:

Make sure Docker is installed on your NAS (called Container Manager on Synology and Container Station on QNAP).

Step 01

Download 4XLink

Choose either method. Use Docker if you are comfortable with a terminal, or download a TAR image directly.

Docker download

Recommended
docker pull docker.io/4xvr/4xlink-nas:latest

Docker automatically downloads the x86-64 or ARM64 version that matches your NAS.

Step 02

Create the container

Use either the graphical interface or Compose to create the 4XLink container.

Method Best for What to do
Graphical interface For beginners First-time Docker users who prefer selecting each setting. Select 4XLink under Local Images, choose Create Container, then apply the three settings below.
Compose NAS systems with a Project, Application, or Compose feature. Create a project, paste the configuration, and replace the NAS paths.

Where is the image? After using Docker download, select 4xvr/4xlink-nas:latest under Local Images. For a TAR download, import the file from the Images page first.

  1. 1 Set networking to host

    Select host networking so the headset can discover the NAS on your local network.

  2. 2 Add a data directory

    Choose a NAS folder and mount it to /data with read/write permission.

  3. 3 Add a video directory

    Choose the folder containing your videos and mount it to /shared/video with read-only permission.

Keep all other options at their defaults, then create and start the container.

Step 03

Open 4XLink

Enter the address below in a desktop or mobile browser. Replace NAS-IP with the LAN address of your NAS.

http://NAS-IP:18080

On the page, select Add Folder and choose /shared/video to add your video library.

Having trouble?
How do I add an external USB drive?

USB drives are not added to the container automatically. Mount the drive path separately to /shared/usb.Common host paths include:

Synology /volumeUSB1/usbshare1-1
QNAP /share/external/DEV3301_1
UGREEN /mnt/@usb/sdc1
OpenWrt /tmp/mountd/disk1_part1

Use the actual path shown by your NAS. Add a storage mount to the container:

Actual USB path → /shared/usb and set it to read-only.

Recreate or restart the container. In 4XLink, select Add Folder and open /shared/usb. Additional drives can be mounted as /shared/usb2, /shared/usb3.

How do I create it with compose.yaml?

Create a project in the NAS Project, Application, or Compose page and paste the configuration below. Replace only the three NAS paths to the left of the colons. Remove the USB line if no USB drive is used.

services:
  4xlink-nas:
    image: 4xvr/4xlink-nas:latest
    container_name: 4xlink-nas
    restart: unless-stopped
    network_mode: host

    volumes:
      # 4XLink data directory, read/write
      - /path/to/4xlink-data:/data

      # NAS video directory, read-only
      - /path/to/videos:/shared/video:ro

      # Optional USB drive, read-only
      - /path/to/usb-drive:/shared/usb:ro

    stop_grace_period: 30s

The paths on the right, /data, /shared/video and /shared/usb are container paths. Keep them unchanged. Leave the command and environment variables empty.