The Settings window

Change how Ringleader behaves on this machine: startup, ssh, the local runtime, your account, and diagnostics.

Settings is where you change how Ringleader behaves on this machine: whether it starts at login, whether plain ssh reaches your workstations, the state of your local container runtime, and which account you are signed in to. Open it from the Ringleader app.

The window is a sidebar of panes. This page covers what each one is for and the controls that matter; the Windows app groups the same options the same way.

General

App preferences for Ringleader.

  • Launch Ringleader at login starts the app automatically when you sign in, so the daemon and your local runtime are always ready. You can also set this during onboarding, or later in macOS System Settings → General → Login Items.
  • Reach workstations with plain ssh manages a one-line include in your ~/.ssh/config so ssh <workstation> works without Ringleader in the loop. The toggle reflects the real state of the file (installed, not installed, or installed in the wrong place), and a Re-apply action fixes the ordering when another tool has moved the include.

Local Container Workstation

A lightweight Linux box running dockerd, kind, and kubectl, wired into your shell so the bundled docker CLI talks to it. This pane shows its status (including whether the Docker socket is active) and lets you start, stop, and reset it. Reset rebuilds the runtime from scratch, so anything in it is lost.

Account & Local

Your control-plane sign-in and the local daemon on this machine.

  • Account shows whether you are signed in to a Ringleader control plane. When you are not, you are in local-only mode and your workstations live on this machine. Sign in or sign out from here.
  • Local shows the rl CLI version and the daemon’s state, with controls to stop or restart the background daemon.

Tools

The real upstream binaries Ringleader ships and links onto your PATH (Docker, kubectl, kind, Lima, and the rest), with the version of each so you can confirm what is actually installed.

Troubleshoot

Diagnostics and logs for when something is wrong: the same checks and log access described in Troubleshooting, including a one-click way to package a diagnostics bundle to send to the Ringleader team.

About

The app and daemon versions (useful when filing an issue), a link to the website and source, and license information for the bundled tools.

Where to go next