RONIN LINK - Our Handy Desktop App!

RONIN LINK is a free desktop app for Windows, macOS and Linux that connects you to your RONIN machines in one click. Open a terminal or a full desktop, move files, and open apps like RStudio and Jupyter, all over a secure SSH connection.

RONIN LINK - Our Handy Desktop App!
Last updated:

RONIN LINK is a free desktop app for Windows, macOS and Linux that connects you to your RONIN machines in one click. Open a terminal or a full desktop, move files between your computer and your machine, and open apps like RStudio and Jupyter, all over a secure SSH connection. You don't need to touch the command line or set up any ports.

RONIN LINK showing four linked machines
RONIN LINK showing four linked machines

What you can do with it

Your computerDownloadThen
Windows 10 or 11Windows installer (.exe)Run the installer
Mac with Apple silicon (M1 or later)macOS Apple silicon (.dmg)Open it and drag RONIN LINK into Applications
Mac with an Intel chipmacOS Intel (.dmg)Open it and drag RONIN LINK into Applications
LinuxLinux AppImageMake it executable (chmod +x ronin-link-*.AppImage), then run it
Linux tip: if the AppImage doesn't open on Ubuntu 22.04 or later, install FUSE with sudo apt install libfuse2 (libfuse2t64 on Ubuntu 24.04).

From RONIN (the easy way)

  1. Download your machine's key from RONIN and keep it in your Downloads or .ssh folder. On a RONIN Isolate desktop, keep it in your Home Folder.
  2. On your machine's page in RONIN, click Open with RONIN LINK.
  3. RONIN LINK opens and fills in the machine's address, username and key, and your machine appears as a card. For a Windows machine, type in its password, then click LINK TO MACHINE.
Clicking Open with RONIN LINK in RONIN adds the machine to RONIN LINK
Clicking Open with RONIN LINK in RONIN adds the machine to RONIN LINK

By hand

Fill in the Link to your machine card:

  • Machine address: the address shown on your machine's page in RONIN.
  • User name: the arrow lists RONIN's default usernames, such as ubuntu for Ubuntu or Administrator for Windows.
  • Key or Password: choose your machine's key file, or switch to PASSWORD for a Windows machine.

Then click LINK TO MACHINE.

The Link to your machine card filled in
The Link to your machine card filled in

Your machine's card

Each machine gets a card. AVAILABLE in green means RONIN LINK can reach it. If it can't, the card turns red and says why. Hover over the message for more detail.

The ⋮ menu refreshes the card, restarts or shuts down the machine, or removes the card. Removing a card only removes it from RONIN LINK; your machine isn't affected. Passwords you save are encrypted by your computer.

A machine card with its menu open
A machine card with its menu open

Connect to your machine

Click CONNECT TO MACHINE on a card. Everything you can do with that machine is in this one window.

The connect window
The connect window

Some options only work on Linux machines, on Windows machines, most of the same tools can be accessed via the Desktop.

Terminal

Click TERMINAL, or the >_ button on the machine's card, for a terminal that's already logged in to your machine. You can change its colours and font size in Settings.

A RONIN LINK terminal connected to an Ubuntu machine
A RONIN LINK terminal connected to an Ubuntu machine

Desktop

Click DESKTOP for your machine's full desktop in its own window, powered by NICE DCV. The first time, RONIN LINK installs the desktop for you. This takes a few minutes, and you can follow along in a terminal window. After that, the desktop opens straight away.

Desktops work on Ubuntu and Windows, with beta support for other Linux distributions such as Red Hat, Rocky and Amazon Linux.

A machine's desktop open in RONIN LINK
A machine's desktop open in RONIN LINK

Transfer files (NEW)

Click FILES to move files between your computer and a Linux machine. Your computer is on the left and your machine is on the right.

The Files window, with this computer on the left and the machine on the right
The Files window, with this computer on the left and the machine on the right
  • Send files: drag them to the other side, or select them and click the arrow in the middle. Dropping onto a folder puts them inside it, and you can drag files straight from Finder or Explorer onto your machine's side.
  • Send a single file quickly: double-click it to send it to the folder open on the other side.
  • Track transfers: they're listed along the bottom with their progress, speed and time left. You can cancel a transfer, or try one again if it fails.
  • Manage files: right-click to rename, make a new folder, delete or copy a path. Files you delete on your computer go to the Trash or Recycle Bin.
Dragging two items from this computer to a folder on the machine
Dragging two items from this computer to a folder on the machine

If a file is already there, RONIN LINK asks whether to replace it, keep both, or skip it. Nothing is overwritten without asking.

RONIN LINK asking what to do with a file that's already there
RONIN LINK asking what to do with a file that's already there

To transfer files on a Windows machine, use its desktop instead. For more about Files, see Transferring files with RONIN LINK.

RStudio and Jupyter

Click RSTUDIO or JUPYTER. If it isn't on your machine yet, RONIN LINK offers to install it. Then it opens in your browser through a secure link.

The link appears on your machine's card. Click its name to open it again, or REMOVE to close it.

A machine card with RStudio and Jupyter links
A machine card with RStudio and Jupyter links

Other apps

To open another web app running on your machine, use the last two sections of the connect window:

  • Default links to commonly used apps: pick an app, such as TensorBoard or pgAdmin, and click LINK.
  • Link to a custom application: enter a Local port on your computer and the Remote port your app uses on the machine, then click LINK.

These links appear on the machine's card too.

Machine tools

  • MOUNT DRIVES lists the drives attached to your machine in RONIN. FORMAT & MOUNT sets up a blank drive, and MOUNT makes a drive that already has data available. Ephemeral drives are wiped when the machine stops, so don't keep anything important on them.
  • GPU DRIVERS installs the right NVIDIA driver for your machine type. RONIN LINK tells you if the machine needs a restart afterwards.
  • RESTART and STOP restart or shut down your machine without opening RONIN.
The Mount drives window
The Mount drives window
Restarting a machine, with the option to shut it down instead
Restarting a machine, with the option to shut it down instead

Monitoring

  • CPU MONITOR (new) opens btop, which shows your machine's CPU, memory, disk, network and processes.
  • GPU MONITOR (new) opens nvtop, which shows each NVIDIA GPU's use, memory and temperature. It's for machines with NVIDIA GPUs. If the GPU driver isn't installed yet, RONIN LINK offers to install it first.
  • NETDATA opens a detailed live dashboard in your browser.
  • GRAFANA opens your RONIN cluster's Grafana dashboards. It's available on clusters.

RONIN LINK installs btop, nvtop and Netdata the first time you use them. For more, see Monitoring your machine with btop and nvtop.

btop showing a machine's CPU, memory and processes
btop showing a machine's CPU, memory and processes
nvtop showing a GPU's use and memory
nvtop showing a GPU's use and memory

Settings

Click the gear icon at the top right to change your terminal's colours, font size and scrollback, and the DNS servers RONIN LINK uses. You can also import cards from an older version of RONIN LINK./

The Settings window
The Settings window

Having issues?

The icons at the top right are, from left to right: refresh all machines, help (this post), error log and settings.

The refresh, help, error log and settings icons
The refresh, help, error log and settings icons

If something goes wrong, click the warning triangle to open RONIN LINK's error log. Then send us a support request with the log attached and a screenshot of what you saw.

RONIN LINK uses the MIT Open Source Software license as detailed here