NebulaNebula
Desktop

Desktop settings

Settings that belong to this computer — its name in Nebula, Computer Control, which workspaces it serves, the Capsule, and your keyboard shortcuts.

The desktop app has its own settings window, separate from the Nebula settings you'd find on the web. It holds the things that belong to this computer rather than to your account.

It's an ordinary resizable window, so you can leave it open beside Nebula while you change things. Everything lives in one scrolling page, and every entry point can drop you straight onto the section you want.

Settings → Open Settings… opens the window at the top. The same submenu lists all five sections, so you can jump directly to one.

, on macOS, the same as any Mac app. There's no equivalent hotkey on Windows or Linux — use the tray.

The gear icon on the Capsule opens this window on the Capsule section. The Capsule no longer keeps settings of its own.

Desktop app settings, at the bottom of the settings nav under This computer. It only appears when you're running the desktop app — in a browser there's nothing to open, so it's hidden.

What's in it

Computer name — how this machine appears in Nebula. Leave it blank and it uses your computer's own hostname. Worth setting if you run Nebula on more than one machine and "MacBook-Pro-3" isn't telling you much.

Appearance — Auto, Light, or Dark. Auto follows your operating system.

Share anonymous usage data — on by default. Turning it off stops the desktop app and the Nebula app inside it from sending usage data.

Three choices for how much access agents get: Allow using my computer (works even when Nebula is closed), Allow only while Nebula is open, or Don't allow. Pick either of the first two and you also get AccessWorking folder only or Whole system — and a Primary folder to point them at.

This section also reports the helper's status and your Device ID, and View logs tails what it's been doing. See Computer Control for what each choice unlocks.

Which of your workspaces this computer serves, one toggle each. It only appears once you've allowed agents to use the computer, since there's nothing to serve otherwise.

Everything about the Capsule — whether it shows at all, which corner it sits in, its size, which threads it follows, and per-workspace muting. Its gear icon brings you here rather than opening a menu of its own.

The three global hotkeys — Summon Nebula, Quick send, and Mute microphone. Click one and press the combination you want. See Shortcuts & tray.

The folder agents work out of goes by two names. This window calls the row Primary folder but labels the narrow access mode Working folder only, and the command-line tool calls it Working folder throughout. It's one setting whichever name you meet it under.

Where the rest of your settings live

Anything tied to you rather than to this machine stays in Nebula itself and follows you to every device and the web.

Desktop settingsNebula settings
ScopeThis computer onlyYour account, everywhere
HoldsComputer name, Computer Control, workspaces served, Capsule, hotkeysProfile, model, notifications, approvals, connections
Open withTray menu, ⌘ , on Mac, or Desktop app settings in the web navYour avatar in the Nebula header

Signing in on desktop also signs in the Nebula command-line tool on this machine — they share one credential. Signing out of one signs out the other.

On this page