RingLinkRingLink
NAS

Synology

This guide explains how to run RingLink on Synology NAS using Docker, and how to resolve TUN device issues.

Prerequisites

  1. Docker is installed on your Synology NAS.
  2. You have a RingLink Config Key, User ID, and Network ID.

Create the TUN Device

By default, Synology does not create the /dev/net/tun device. You need to create it manually. SSH into your NAS and run:

sudo mkdir -p /dev/net
sudo mknod /dev/net/tun c 10 200
sudo chmod 600 /dev/net/tun

If /dev/net/tun is missing after a NAS reboot, please re-run the above commands.

You can use Synology's Docker (Container Manager) graphical interface to run RingLink easily:

  1. Open the Container Manager (or Docker) app on your Synology NAS.
  2. Go to the Registry tab, search for ringlink/ringlink:latest, and download the image.
  3. Go to the Image tab, select the downloaded image, and click Launch.
  4. In the container setup wizard:
    • Set the container name (e.g., ringlink).
    • Under Advanced Settings:
      • Enable Auto-restart (optional).
      • Go to Volume and add:
        • /dev/net/tun (host) → /dev/net/tun (container)
        • /volume1/docker/ring-link (host) → /var/lib/ring-link (container)
      • Go to Environment and add variables:
        • CONFIG_KEY, USER_ID, NETWORK_ID (see below)
      • Go to Capabilities and add NET_ADMIN.
      • Go to Network and select host mode.
  5. Complete the wizard and start the container.

Parameter Explanation

  • CONFIG_KEY: Configuration key (optional); can be generated in the RingLink dashboard under Config Keys.
  • USER_ID: User ID (optional); see Users.
  • NETWORK_ID: 8-digit hexadecimal network ID (optional); see Networks.

If you did not specify the above parameters, you can log in interactively after the container is running. Open the container's Terminal tab and run:

/app/ringlink-cli login

For detailed login instructions, see Authenticate with Your RingLink Account.

Reference

For more Docker run options and advanced usage, see the Docker documentation.