Skip to content

Use the app

Settings, shortcuts and the command palette.

On this page

Open Settings in the sidebar, or press Cmd/Ctrl+,. The search box at the top finds a setting by name. Most changes wait for Save Settings; Discard changes drops them. Sections marked “Actions in this section apply immediately” need no save.

Settings

SectionWhat it controls
AppearanceTheme: Light, Dark, System, a Theme Preset, or Custom Colors. Interface sounds for buttons and switches.
LanguageThe interface language, or System Default.
Default BrowserSet as Default Browser: links from other apps open in the profile you pick. Not in the portable Windows build.
System PermissionsmacOS only. Microphone and camera access for the browsers Donut starts. Each site still asks.
IntegrationsOpen Integrations Settings opens the Integrations page (Cmd/Ctrl+I): the local API and remote MCP.
DNS BlocklistManage DNS Blocklists: the blocklist levels with their domain counts, Refresh All Lists, and your custom lists. See DNS blocklist.
Sync EncryptionThe password for end-to-end encrypted sync. See Sync and backup.
Commercial LicenseThe time left in the commercial trial, or your plan.
PrivacyBlock on fingerprint mismatch, Block launches without a proxy or VPN, VPN extension warning, Record visited sites, Clear all traffic history and Keep deleted profiles for (days in the trash, or Delete at once). See Leak protection.
AdvancedDisable App Auto Updates (browser updates continue), Keep Decrypted Profiles In RAM, Clear All Version Cache, Copy logs (a redacted bundle of recent logs, up to 5 MB) and Open log folder.

Redaction removes email addresses, IP addresses, web addresses and secrets, but it cannot find every kind of personal data. Read the logs before you share them.

To keep profiles, browsers and settings in another folder, start the app with the DONUTBROWSER_DATA_DIR environment variable set to that folder.

Settings page, Appearance section. Theme is set to Custom with the Theme Preset Tokyo Night, and a grid of Custom Colors swatches: background, foreground, card, popover, primary, secondary, muted, accent, destructive, success, warning, border and five chart colors. Below: an Interface sounds switch, and Discard changes and Save Settings buttons. Section tabs across the top: Appearance, Language, Default Browser, System Permissions, Integrations, DNS Blocklist, Sync Encryption, Commercial License, Privacy.
Pick Light, Dark, System or a custom theme from presets, then adjust any color.

Keyboard shortcuts

Mod is Cmd on macOS and Ctrl on Windows and Linux. More → Keyboard shortcuts (Mod+/) shows the same list, with a search box.

ShortcutAction
Mod+KOpen the command palette
Mod+/View keyboard shortcuts
Mod+PGo to Profiles
Mod+NGo to Network
Mod+EGo to Extensions
Mod+GGo to Groups
Mod+BGo to Cookie Bot
Mod+JGo to Agent
Mod+IGo to Integrations
Mod+Shift+AGo to Account
Mod+,Go to Settings
Mod+Shift+TGo to Trash
Mod+OImport profile
Mod+Shift+O2FA code from a key
Mod+Shift+HOpen tips
Mod+Shift+FSend feedback
Mod+1 to Mod+9Show one profile group

Command palette

Press Mod+K and type. The palette goes to any page, launches or stops a profile by name, opens a profile’s details, creates a profile, and switches the profile group.

Command palette open over the profile table, with a search field and navigation commands such as Go to Profiles, Go to Network, Go to Extensions and Go to Groups, each with its keyboard shortcut.
Press Cmd+K (Ctrl+K) to search commands and profiles.

Tips and feedback

More → Tips has short walkthroughs of features. More → Send feedback sends a message to the Donut team. Tick Include recent logs to attach the redacted logs; Preview logs shows them first.

Updates

The app checks for its own updates and shows a notice when one is ready. Wayfern updates download in the background. To find the version you run, open More → About Donut Browser.

Checked against the app on .