Orbit
Search ⌘K
Documentation

Settings

Control Orbit’s machine-level behavior.

Settings collects app preferences, local domain setup, service defaults, cleanup actions, and version context.

Settings

Use tabs for machine-level concerns.

Settings is divided into General, Local Domains, Services, and About. These tabs affect Orbit itself, not one project.

Orbit Settings screen
Settings groups app preferences, domains, service defaults, and version context.

Use this view when the decision affects Orbit itself. Project-specific behavior belongs in project detail, not machine-level settings.

General

Launch and notifications are operational controls.

Start at login keeps local domains available after a macOS login. Notifications surface project crashes and local TLS certificate expiry.

Orbit General settings
General settings cover launch behavior and desktop notifications.

These controls are operational, not cosmetic. They decide whether Orbit starts with macOS and how failures reach you.

Services

Service defaults affect new projects.

Service settings control automatic management, idle stop, which engines are enabled for new projects, service disk usage, first-run wizard reset, and destructive service data cleanup.

  • Clear data stops all services and deletes captured data such as mail and databases.
  • Installed binaries stay in place when service data is cleared.
  • Default engines are applied when a new project is added.
Orbit Services settings
Services settings define automatic management and defaults for new projects.

Use this tab to change what new projects inherit. Existing projects keep their own service selection unless you edit them.

Cleanup

Confirm destructive service cleanup before it runs.

Clear data stops services and removes captured service state such as local mail, databases, buckets, and cache files while leaving installed binaries in place.

  • Use cleanup only when captured service state is disposable.
  • Installed service binaries remain available after cleanup.
  • Start affected services again before using Mail, Database, or Storage.
Orbit clear service data confirmation
Clear data is confirmed before Orbit removes captured service state.

Use this dialog as a boundary before destructive cleanup. It removes captured service state, not the installed service binaries.

About

About confirms the installed desktop runtime.

About shows the Orbit icon, version, platform, domain suffix, proxy address, and project attribution.

Orbit About settings
About confirms the installed app version and domain boundary.

Use About when reporting version, platform, domain suffix, or proxy address. It gives support context without leaving the app.