Connect to RingLink on Linux

After installing RingLink, you can connect your Linux device to your RingLink network, enabling secure communication with other devices and access to shared resources.

Check if RingLink is Running

Before connecting to a network, ensure the RingLink service is running by using the following command:

sudo systemctl status ringlink.service

If the service is running, you should see output similar to this:

● ringlink.service - RingLink Service
     Loaded: loaded (/etc/systemd/system/ringlink.service; enabled; vendor preset: enabled)
     Active: active (running) since Thu 2024-11-07 03:16:20 UTC; 3 weeks 0 days ago
   Main PID: 20000 (ringlink-daemon)
      Tasks: 5 (limit: 1012)
     Memory: 193.4M
        CPU: 17h 31min 39.917s
     CGroup: /system.slice/ringlink.service
             └─20000 /usr/sbin/ringlink-daemon

If the service isn't running, start it with the following command:

sudo systemctl start ringlink.service

Authenticate with Your RingLink Account

The RingLink client requires you to log in before connecting to a network. Run the following command:

ringlink-cli login

1. The command will generate a unique code (e.g., TTMJ-XKHC) and a login link.

2. Open the link in any browser, and input the code on the webpage.

3. If you're not already signed in, you'll be prompted to log in to your RingLink account.

After successful authentication, return to the terminal to proceed.

Select a Tenant and Network

Once authenticated:

1. Select the organization (tenant) you want to log in to using the Up and Down arrow keys. Press Enter to confirm.
2. A list of available networks will appear. Use the Up and Down keys to navigate, and Space to select one or more networks. Press Enter to connect.

Example:

Select networks to connect(press [space] to select, [enter] to connect):
> [x] 54cd99d2  RingLink Prod   172.30.0.0/20
  [ ] 08131e97  Network2        10.122.192.0/18

Connect to Additional Networks

If you skipped connecting to a network during login or want to connect to a newly created network, there's no need to log in again. Use one of the following methods:

ringlink-cli connect