--- title: "Docs ยท Donut Browser" description: "How to use Donut Browser: profiles and fingerprints, proxies and VPNs, cookies, sync, teams, AI agents over remote MCP, and the local REST API." url: "https://donutbrowser.com/docs/" --- # Donut Browser documentation Donut Browser is a desktop app for macOS, Windows and Linux that runs many isolated browser profiles. Each profile has its own fingerprint, cookies and proxy or VPN, so sites see each one as a different device. The app is open source, needs no account and sends no telemetry. Profiles stay on your disk unless you turn on sync. ## Get started - [Install and first profile](https://donutbrowser.com/docs/install): download, first start and your first profile. - [Import profiles](https://donutbrowser.com/docs/profile-import): bring Chrome, Edge, Brave and other Chromium profiles over, with their cookies and passwords. ## Use the app - [Profiles and fingerprints](https://donutbrowser.com/docs/profiles): the operating system a profile shows, fingerprint editing, templates, statuses, 2FA codes and the trash. - [Proxies and VPNs](https://donutbrowser.com/docs/proxies): proxy types, checks, IP rotation, WireGuard, DNS, blocklists and leak protection. - [Groups, tags and bookmarks](https://donutbrowser.com/docs/organize): keep many profiles in order. - [Extensions](https://donutbrowser.com/docs/extensions): add Chrome extensions and load them by group. - [Cookies](https://donutbrowser.com/docs/cookies): import, paste, export and copy cookies and storage state. - [Locked and ephemeral profiles](https://donutbrowser.com/docs/private-profiles): password encryption, memory-only profiles and clear-on-close. - [Synchronizer](https://donutbrowser.com/docs/synchronizer): repeat one profile's actions in many. - [Settings and shortcuts](https://donutbrowser.com/docs/settings): every setting, keyboard shortcut and the command palette. ## Cloud and teams - [Sync and backup](https://donutbrowser.com/docs/sync): cloud backup, end-to-end encryption and restore points. - [Self-hosted sync server](https://donutbrowser.com/docs/self-hosting): run the sync server yourself with Docker and any S3 storage. - [Team](https://donutbrowser.com/docs/team): roles, profile locks, access by group and the activity log. - [Cookie Bot](https://donutbrowser.com/docs/cookie-bot): warm profiles on a schedule while your computer is off. - [Remote browsers](https://donutbrowser.com/docs/remote-browsers): run a profile on a Windows, macOS or Linux machine in Donut's fleet. ## AI agents Donut contains no AI model. You connect the agent you use. - [AI agents](https://donutbrowser.com/docs/ai-agents): set up Claude Code, Cursor, Codex or OpenClaw, or keep the agent on your machine over CDP with a local model. One profile and one proxy per account. - [Agent page and recipes](https://donutbrowser.com/docs/agent): answer questions, take over profiles, record recipes and schedule them. - [MCP tools](https://donutbrowser.com/docs/mcp): what an agent can do, and which tools stay in the app. - [Remote MCP](https://donutbrowser.com/docs/remote-mcp): the endpoint, credentials, toolsets and what the relay sees. ## Local API - [API quickstart](https://donutbrowser.com/docs/quickstart): turn on the API on `127.0.0.1:10108` and make the first call. - [Authentication](https://donutbrowser.com/docs/authentication): the bearer token and error codes. - [API reference](https://donutbrowser.com/docs/rest-api): every endpoint, with examples in four languages. - [Wayfern and Playwright](https://donutbrowser.com/docs/wayfern): attach Playwright to a profile and humanize mouse, typing and scroll. - [OpenAPI spec](https://donutbrowser.com/docs/openapi): the machine-readable spec and client generation. ## Guides - [Step-by-step guides](https://donutbrowser.com/docs/guides): one task per page, from an authenticated SOCKS5 proxy or a WireGuard profile to bulk profiles, parallel Playwright runs and Selenium. ## What each plan includes | Feature | Free | Solo | Pro | Team | | --- | --- | --- | --- | --- | | Local profiles, proxies, VPNs, cookies, extensions | Unlimited | Unlimited | Unlimited | Unlimited | | Cloud profiles | None | 20 | 50 | 100 | | Fingerprint editing, other operating systems, Synchronizer | No | No | Yes | Yes | | Local API: manage profiles, proxies, groups | Yes | Yes | Yes | Yes | | Local API: launch and drive browsers | No | No | Yes | Yes | | Remote MCP | No | Without browser tools | Yes | Yes | | Cookie Bot and scheduled recipes | No | Yes | Yes | Yes | | Recipes on demand, remote sessions on demand | No | No | Yes | Yes | | Remote hours a month | None | 40, for Cookie Bot and scheduled recipes | 200 | 200 per paid seat, shared | | Team roles and profile locks | No | No | No | Yes | Prices are on the [pricing page](https://donutbrowser.com/pricing). Commercial use needs a paid plan after a 2-week trial. ## For AI agents Every docs page is also Markdown: add `.md` to its path, for example [/docs/quickstart.md](https://donutbrowser.com/docs/quickstart.md). All pages in one file are at [/llms-full.txt](https://donutbrowser.com/llms-full.txt), the site index is [/llms.txt](https://donutbrowser.com/llms.txt), and the REST API spec is [/openapi.json](https://donutbrowser.com/openapi.json).