General¶

Port¶

The TCP port for Salut’s HTTP control plane. Default: 7258.

All peers on your network should use the same port so they can communicate. If you change this, other peers won’t be able to reach you until they’re configured to use the same port.

You can also set this via the SALUT_PORT environment variable.

Display Name¶

A human-readable name shown to other peers on the network. If left blank, Salut uses your computer’s hostname.

This name appears in other peers’ menu bars and in the Peers tab, making it easier to identify machines in your cluster.

Set via SALUT_DISPLAY_NAME environment variable.

Log Level¶

Controls the verbosity of Salut’s internal logging. Options:

• Error — only errors

• Warning — errors and warnings

• Info (default) — normal operational messages

• Debug — detailed diagnostic output

Set to Debug when troubleshooting connectivity or inference issues. The logs appear in Console.app under the Salut process.

Set via SALUT_LOG_LEVEL environment variable.

API Key¶

An optional API key that clients must include in the Authorization header to use Salut’s API. When set, requests without a valid key receive a 401 response.

Leave blank to allow unauthenticated access from your local network. This is safe when you trust all devices on your network.

curl http://localhost:7258/v1/models \
  -H "Authorization: Bearer your-api-key"

Set via SALUT_API_KEY environment variable.

Color Menu Bar Icon¶

When enabled, the menu bar icon uses a color version of the waving hand instead of the standard monochrome template image.

The monochrome icon automatically adapts to light and dark mode (macOS uses the alpha channel). The color icon always shows the yellow hand regardless of appearance.

Start at Login¶

When enabled, Salut launches automatically when you log in to your Mac. Uses macOS’s native SMAppService to register as a login item — no separate launch agent or plist needed.

You can also manage this from System Settings → General → Login Items.