RingLink Docs
Getting Started/Install RingLink

Install RingLink on Linux

This guide provides a step-by-step walkthrough for installing RingLink on Linux systems. RingLink supports a wide range of Linux distributions, ensuring seamless integration across various environments.

Prerequisites

Before installing, make sure your system meets the following requirements:

  • iptables: Ensure that iptables is installed on your system.

Run sudo apt install iptables (for Debian/Ubuntu-based systems) or sudo yum install iptables (for RHEL-based systems) to install it.

Installation Instructions

To install RingLink on your Linux system, open your terminal and execute the following command:

curl -fsSL https://assets.ring.link/install.sh | sudo bash

For users behind a firewall

If your device is behind a Symmetric NAT or Firewall (like, AWS Security Groups, GCP Firewall, Azure Network Security Groups) without open ports, it may not accept passive direct connections. So, traffic is relayed through the ultra-fast Orb, but this limits the available paths. For best work, configure your firewall to allow direct connections. See Firewall Configuration for details.

Firewall Configuration

RingLink requires an open port on your firewall to accept passive direct connections (P2P) with other devices. By default, RingLink uses a random port between 1024 and 65535. If your Linux device is behind a firewall, open a port or enable UPnP (if available) to allow RingLink to accept direct connections. To use a fixed port for firewall configuration, specify the port by setting the RINGLINK_PORT environment variable in the RingLink service (/etc/systemd/system/ringlink.service).

[Unit]
Description=RingLink Service
After=network.target
 
[Service]
StateDirectory=ring-link
LogsDirectory=ring-link
CacheDirectory=ring-link
RuntimeDirectory=ring-link
ExecStart=/usr/sbin/ringlink-daemon
Restart=on-failure
AmbientCapabilities=CAP_NET_ADMIN CAP_NET_RAW
Environment="RINGLINK_PORT=12345"
 
[Install]
WantedBy=multi-user.target

After changing the port, reload the systemd configuration and restart the RingLink service:

sudo systemctl daemon-reload
sudo systemctl restart ringlink.service

Supported Linux Distributions

RingLink supports a wide range of Linux distributions. Below is a comprehensive list of supported versions:

Debian-based

RedHat-based

Other

Previous

Quick Start

Next

Install RingLink on macOS

On this page