The Settings window

A tour of the macOS app's Settings window: the General, Local Container Workstation, Account & Local, Tools, Troubleshoot, and About panes.

Choose Settings from the menu-bar app to configure Ringleader. 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

The product-owned local container runtime: a lightweight Linux box running dockerd, kind, and kubectl, wired into your shell so the bundled docker CLI just works. This pane shows its status (including whether the Docker socket is active) and lets you start, stop, and reset it. Reset is destructive, since it rebuilds the runtime from scratch.

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 Mac. 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