NAS
Synology
This guide explains how to run RingLink on Synology NAS using Docker, and how to resolve TUN device issues.
Prerequisites
- Docker is installed on your Synology NAS.
- 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.
Run the RingLink Container
You can use Synology's Docker (Container Manager) graphical interface to run RingLink easily:
- Open the Container Manager (or Docker) app on your Synology NAS.
- Go to the Registry tab, search for
ringlink/ringlink:latest
, and download the image. - Go to the Image tab, select the downloaded image, and click Launch.
- 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.
- Set the container name (e.g.,
- 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.