# Chrovia

> Chrovia provides a Chromium-based browser platform, PersonaHub for isolated browser profiles, and Chrovia SDK for browser integration and automation.

PersonaHub prepares local profiles. Chrovia SDK exposes licensed browser capabilities. Chrovia License controls authorization; Extended Preferences stores browser configuration.

Documentation is available in English and Simplified Chinese. The links below provide Markdown versions of the public documentation, generated from the same source as the website.

## Products

- [PersonaHub — English](https://console.getchrovia.com/en/products/persona-hub): Browser profile management, features, and pricing.
- [PersonaHub — 中文](https://console.getchrovia.com/zh/products/persona-hub): 身份管理、功能和定价。
- [Chrovia SDK — English](https://console.getchrovia.com/en/products/sdk): Browser integration and licensed capabilities.
- [Chrovia SDK — 中文](https://console.getchrovia.com/zh/products/sdk): 浏览器集成与授权能力。

## English — Overview

- [Getting started with Chrovia](https://console.getchrovia.com/en/docs/getting-started/index.md): Start with PersonaHub profiles or integrate Chrovia SDK, then find the guides for credentials, automation, licensing, and browser capabilities.

## English — PersonaHub

- [How to create a profile in PersonaHub](https://console.getchrovia.com/en/docs/create-profile/index.md): Choose a name and appearance, optionally set up a node, then create and launch an independent browser profile.
- [How to launch a profile browser](https://console.getchrovia.com/en/docs/launch-profile/index.md): Launch a PersonaHub profile in its own browser window, identify it by its appearance badge, and return to the same profile with separate browser data.
- [How to manage website passwords](https://console.getchrovia.com/en/docs/password-management/index.md): Save website passwords in a PersonaHub profile browser, then view, add, edit, or delete them in Password management.
- [How to use TOTP authentication](https://console.getchrovia.com/en/docs/totp/index.md): Scan a website's authenticator QR code in a PersonaHub profile browser, save the TOTP entry, and copy rotating codes from the extension or management page.
- [How to Use Passkeys in PersonaHub](https://console.getchrovia.com/en/docs/passkeys/index.md): Register a passkey with PersonaHub Passkeys in a profile browser, then view or delete the saved credential in PersonaHub.
- [How to enable CDP when launching a browser](https://console.getchrovia.com/en/docs/enable-cdp/index.md): Enable CDP through profile launch arguments in PersonaHub so debugging or automation tools can connect to a running profile browser.
- [PersonaHub Automation API](https://console.getchrovia.com/en/docs/automation-api/index.md): Use PersonaHub's local HTTP API to manage profiles, proxies, fingerprints, and website credentials, then launch browsers and connect over CDP for web automation.
- [Connect PersonaHub to AI Clients via MCP](https://console.getchrovia.com/en/docs/connect-mcp/index.md): Enable PersonaHub's local service and connect it to Codex or another AI client to list, create, and launch browser profiles.
- [How to earn Bright Data credit and redeem it for Pro](https://console.getchrovia.com/en/docs/partner-rewards/index.md): Sign up for Bright Data through PersonaHub's referral link, earn 25% of your spend as credit, and redeem $5 for one month of Pro.

## English — Proxy integrations

- [Thordata proxy integration](https://console.getchrovia.com/en/docs/thordata/index.md): Buy a static ISP proxy from Thordata, copy its connection details, then fill in and check the node to create a profile in PersonaHub.
- [IPRoyal proxy integration](https://console.getchrovia.com/en/docs/iproyal/index.md): Buy a static ISP proxy from IPRoyal, copy its connection details, then fill in and check the node to create a profile in PersonaHub.

## English — Chrovia SDK

- [SDK documentation and capability index](https://console.getchrovia.com/en/docs/sdk-capabilities/index.md): Find the SDK setup guides and individual references for all 20 licensed Chrovia kernel capabilities.
- [SDK developer quickstart](https://console.getchrovia.com/en/docs/sdk-getting-started/index.md): Launch an isolated Chrovia browser instance, create a Provision extension, and call your first kernel JavaScript API.
- [Install Windows or macOS fonts on Linux](https://console.getchrovia.com/en/docs/sdk-linux-fonts/index.md): Install and switch between Windows or macOS fonts on Linux, and restore system fonts.
- [How to download and install a trial License](https://console.getchrovia.com/en/docs/trial-license/index.md): Create a trial license in Chrovia Console, download the Chrovia browser, install the License, and verify that the License is working from a bundled extension.
- [License installation and lifecycle](https://console.getchrovia.com/en/docs/sdk-license/index.md): Choose SDK capabilities, install an issued Chrovia License, inspect its state, and replace or revoke authorization correctly.
- [Online leases and renewal](https://console.getchrovia.com/en/docs/sdk-leases/index.md): Understand Infra-managed lease claims, quota accounting, authorization deadlines, and the chrovia.license API.
- [SDK Extended Preferences](https://console.getchrovia.com/en/docs/sdk-extended-preferences/index.md): Configure browser instances, read and write application data, and understand the License and signature rules for Extended Preferences.
- [Provision directory and packaging](https://console.getchrovia.com/en/docs/sdk-provision/index.md): Lay out the browser customization package, distribute default files and plugins, and distinguish installation data from instance data.
- [Install and develop built-in plugins](https://console.getchrovia.com/en/docs/sdk-plugins/index.md): Install a built extension into Provision, verify its Service Worker, add a toolbar popup, and update or remove plugins safely.
- [SDK JavaScript API overview](https://console.getchrovia.com/en/docs/sdk-javascript-api/index.md): Choose the correct execution context, identify API domains and return types, and open each capability's full reference.
- [Commercial license billing and hour quota](https://console.getchrovia.com/en/docs/commercial-license-billing/index.md): How commercial Chrovia License purchases are priced, when monthly quota resets, and how browser instances consume hours through online leases.

## English — SDK capabilities

- [Automation](https://console.getchrovia.com/en/docs/sdk-automation/index.md): Use Window-only DOM helpers, inspect closed shadow roots, and dispatch trusted events with the automation capability.
- [Declarative Net Request](https://console.getchrovia.com/en/docs/sdk-declarative-net-request/index.md): Install fixed block, redirect, and allow rules through Extended Preferences or the Provision rules file.
- [Disable DevTools](https://console.getchrovia.com/en/docs/sdk-disable-devtools/index.md): Disable developer tools and remote inspection using a License capability plus an explicit EP switch.
- [Injected credentials](https://console.getchrovia.com/en/docs/sdk-injected-credentials/index.md): Provide website credentials for autofill through Extended Preferences without adding ordinary saved passwords.
- [Instance appearance](https://console.getchrovia.com/en/docs/sdk-instance-appearance/index.md): Set browser-instance labels and badge colors with Chrovia SDK Extended Preferences. Includes configuration examples and Windows and macOS appearance support.
- [Instance metadata](https://console.getchrovia.com/en/docs/sdk-instance-metadata/index.md): Read runtime host and process metadata, Provision version information, and your own public instance fields.
- [Messaging and browser startup](https://console.getchrovia.com/en/docs/sdk-messaging/index.md): Use process-wide channels, register Service Worker listeners, and coordinate the optional browser-window startup gate.
- [Native dialogs](https://console.getchrovia.com/en/docs/sdk-native-dialog/index.md): Use chrovia.ui to show native alerts, confirmations, and non-modal notifications. Learn the API methods, required entitlement, and browser-window requirements.
- [Navigation redirect](https://console.getchrovia.com/en/docs/sdk-navigation-redirect/index.md): Route top-level navigations and the new-tab page using EP URL mappings, including built-in plugin pages.
- [Network interception](https://console.getchrovia.com/en/docs/sdk-network-intercept/index.md): Register URL-based request callbacks, inspect parsed bodies, cancel requests, and handle Service Worker restarts and timeouts.
- [Password reveal block](https://console.getchrovia.com/en/docs/sdk-password-reveal-block/index.md): Prevent supported password reveal controls and password-field type changes without confusing UI restrictions with secret isolation.
- [Saved-password store](https://console.getchrovia.com/en/docs/sdk-passwords/index.md): Manage Chromium Profile passwords with Chrovia SDK: list and add credentials, observe changes, and understand the limits of clearing and importing saved passwords.
- [Process management](https://console.getchrovia.com/en/docs/sdk-process-management/index.md): Use chrovia.process.exit in a Provision extension to request graceful browser shutdown. Learn the required entitlement, execution context, and API limits.
- [Signed Extended Preferences](https://console.getchrovia.com/en/docs/sdk-signed-extended-prefs/index.md): Install and update signed browser configuration, keep application data editable, and resolve invalid or expired preferences.
- [Software authenticator](https://console.getchrovia.com/en/docs/sdk-software-authenticator/index.md): Configure software WebAuthn credentials, handle registration save callbacks, and manage local or external signature counters.
- [Supervisor process and presence file](https://console.getchrovia.com/en/docs/sdk-supervisor-process/index.md): Tie browser lifetime to a launcher process or a local presence file, or receive a notification instead of exiting.
- [System proxy override](https://console.getchrovia.com/en/docs/sdk-system-proxy-override/index.md): Configure a fixed proxy or two-hop proxy chain per browser instance with Chrovia SDK, including credentials, bypass rules, and Extended Preferences examples.
- [Unrestricted API](https://console.getchrovia.com/en/docs/sdk-unrestricted-api/index.md): Understand how unrestrictedApi broadens JavaScript exposure without granting capabilities or exposing passwords to pages.

## 中文 — 概览

- [Chrovia 入门指南](https://console.getchrovia.com/zh/docs/getting-started/index.md): 从使用 PersonaHub 身份或集成 Chrovia SDK 开始，查找凭证管理、自动化、授权与浏览器能力的操作指南。

## 中文 — PersonaHub

- [如何在 PersonaHub 中创建 Profile](https://console.getchrovia.com/zh/docs/create-profile/index.md): 填写名称和外观，按需配置节点，再创建并启动独立的浏览器身份。
- [如何启动 Profile 浏览器](https://console.getchrovia.com/zh/docs/launch-profile/index.md): 在 PersonaHub 中找到已创建的身份，点击启动，打开它自己的浏览器窗口。
- [如何管理网站密码](https://console.getchrovia.com/zh/docs/password-management/index.md): 在 PersonaHub 的身份浏览器中保存网站密码，并在密码管理页面查看、添加、编辑和删除记录。
- [如何使用 TOTP 两步验证](https://console.getchrovia.com/zh/docs/totp/index.md): 在 PersonaHub 身份浏览器中扫描网站的两步验证二维码，保存 TOTP，并在扩展或管理页面复制动态验证码。
- [如何在 PersonaHub 中使用通行密钥](https://console.getchrovia.com/zh/docs/passkeys/index.md): 在 PersonaHub 身份浏览器中选择 PersonaHub Passkeys 注册通行密钥，并在管理页面查看和删除记录。
- [如何在启动浏览器时启用 CDP](https://console.getchrovia.com/zh/docs/enable-cdp/index.md): 在 PersonaHub 的身份启动参数中启用 CDP，让调试或自动化工具连接已启动的 Profile 浏览器。
- [PersonaHub 自动化 API](https://console.getchrovia.com/zh/docs/automation-api/index.md): 通过 PersonaHub 本地 HTTP API 管理 Profile、代理、指纹及网站凭据，启动浏览器并连接 CDP 完成网页自动化。
- [通过 MCP 将 PersonaHub 接入 AI 客户端](https://console.getchrovia.com/zh/docs/connect-mcp/index.md): 开启 PersonaHub 本地服务，将 MCP 接入 Codex 等 AI 客户端，让 AI 查询、创建和启动浏览器身份。
- [如何通过 Bright Data 消费获得抵扣金并兑换 Pro](https://console.getchrovia.com/zh/docs/partner-rewards/index.md): 通过 PersonaHub 专属链接注册 Bright Data，消费返还 25% 抵扣金，每 5 美元抵扣金兑换一个月 Pro。

## 中文 — 代理商集成

- [Thordata 代理集成](https://console.getchrovia.com/zh/docs/thordata/index.md): 从注册 Thordata、购买静态 ISP 代理到复制连接信息，在 PersonaHub 中填入、检测节点并创建身份的图文教程。
- [IPRoyal 代理集成](https://console.getchrovia.com/zh/docs/iproyal/index.md): 从注册 IPRoyal、购买静态 ISP 代理到复制连接信息，在 PersonaHub 中填入、检测节点并创建身份的图文教程。

## 中文 — Chrovia SDK

- [SDK 文档与能力索引](https://console.getchrovia.com/zh/docs/sdk-capabilities/index.md): 查找 SDK 接入指南，以及全部 20 项已授权 Chrovia 内核能力的独立参考文档。
- [SDK 开发入门](https://console.getchrovia.com/zh/docs/sdk-getting-started/index.md): 启动独立的 Chrovia 浏览器实例，创建 Provision 扩展，并调用第一个内核 JavaScript API。
- [在 Linux 上安装 Windows 或 macOS 字体库](https://console.getchrovia.com/zh/docs/sdk-linux-fonts/index.md): 在 Linux 上安装、切换 Windows 或 macOS 字体，以及恢复系统字体。
- [如何下载和安装试用 License](https://console.getchrovia.com/zh/docs/trial-license/index.md): 在 Chrovia Console 创建试用许可证，下载 Chrovia 浏览器，安装 License，并通过内置扩展验证 License 是否生效。
- [License 安装与生命周期](https://console.getchrovia.com/zh/docs/sdk-license/index.md): 选择 SDK 能力、安装已签发的 Chrovia License、检查状态，并正确替换或撤销授权。
- [在线租约与续租](https://console.getchrovia.com/zh/docs/sdk-leases/index.md): 了解 Infra 管理的租约申请、配额计算、授权期限，以及 chrovia.license API。
- [SDK Extended Preferences](https://console.getchrovia.com/zh/docs/sdk-extended-preferences/index.md): 配置浏览器实例，读写应用数据，并了解 Extended Preferences 的 License 与签名规则。
- [Provision 目录与打包](https://console.getchrovia.com/zh/docs/sdk-provision/index.md): 组织浏览器定制包，分发默认文件和插件，并区分安装目录数据与实例数据。
- [内置插件安装与开发](https://console.getchrovia.com/zh/docs/sdk-plugins/index.md): 将构建后的扩展安装到 Provision，检查 Service Worker，添加工具栏弹出窗口，并更新或移除插件。
- [SDK JavaScript API 总览](https://console.getchrovia.com/zh/docs/sdk-javascript-api/index.md): 选择正确的执行上下文，了解 API 域和返回类型，并查阅各项能力的完整参考。
- [商业许可证计费与小时配额](https://console.getchrovia.com/zh/docs/commercial-license-billing/index.md): 了解商业 Chrovia License 的购买价格、每月配额重置时间，以及浏览器实例如何通过在线租约消耗小时配额。

## 中文 — SDK 能力参考

- [自动化](https://console.getchrovia.com/zh/docs/sdk-automation/index.md): 使用仅限 Window 的 DOM 工具、访问 closed Shadow Root，并通过 automation 能力派发可信事件。
- [声明式网络请求规则](https://console.getchrovia.com/zh/docs/sdk-declarative-net-request/index.md): 通过 Extended Preferences 或 Provision 规则文件安装固定的阻止、重定向和允许规则。
- [禁用开发者工具](https://console.getchrovia.com/zh/docs/sdk-disable-devtools/index.md): 通过 License 能力和明确的 EP 开关禁用开发者工具及远程检查。
- [注入凭据](https://console.getchrovia.com/zh/docs/sdk-injected-credentials/index.md): 通过 Extended Preferences 提供网站自动填充凭据，不添加普通已保存密码。
- [实例外观](https://console.getchrovia.com/zh/docs/sdk-instance-appearance/index.md): 通过 Extended Preferences 为浏览器实例设置易识别的标签和徽标颜色。
- [实例元数据](https://console.getchrovia.com/zh/docs/sdk-instance-metadata/index.md): 读取运行机器与进程元数据、Provision 版本信息，以及自定义公开实例字段。
- [消息通信与浏览器启动](https://console.getchrovia.com/zh/docs/sdk-messaging/index.md): 使用进程级消息通道、注册 Service Worker 监听，并协调可选的浏览器启动窗口等待流程。
- [原生对话框](https://console.getchrovia.com/zh/docs/sdk-native-dialog/index.md): 通过 chrovia.ui 显示浏览器原生提示、确认框和非模态通知。
- [导航重定向](https://console.getchrovia.com/zh/docs/sdk-navigation-redirect/index.md): 通过 EP URL 映射控制顶层导航和新标签页，并指向内置插件页面。
- [网络请求拦截](https://console.getchrovia.com/zh/docs/sdk-network-intercept/index.md): 按 URL 注册请求回调、检查解析后的请求体、取消请求，并处理 Service Worker 重启和超时。
- [密码显示限制](https://console.getchrovia.com/zh/docs/sdk-password-reveal-block/index.md): 限制受支持的密码显示控件和密码字段类型变更，并区分界面限制与秘密隔离。
- [已保存的密码存储](https://console.getchrovia.com/zh/docs/sdk-passwords/index.md): 从 Provision Service Worker 读取、添加、清空和观察 Chromium Profile 密码。
- [进程管理](https://console.getchrovia.com/zh/docs/sdk-process-management/index.md): 通过特权插件的 chrovia.process.exit 请求正常退出整个浏览器实例。
- [Extended Preferences 签名验证](https://console.getchrovia.com/zh/docs/sdk-signed-extended-prefs/index.md): 安装和更新已签名的浏览器配置，保留可修改的应用数据，并处理无效或已到期的偏好文件。
- [软件认证器](https://console.getchrovia.com/zh/docs/sdk-software-authenticator/index.md): 配置软件 WebAuthn 凭据、处理注册保存回调，并管理本地或外部签名计数器。
- [监督进程与 Presence 文件](https://console.getchrovia.com/zh/docs/sdk-supervisor-process/index.md): 让浏览器生命周期跟随启动器进程或本地 presence 文件，也可改为通知而不退出。
- [系统代理覆盖](https://console.getchrovia.com/zh/docs/sdk-system-proxy-override/index.md): 通过 Extended Preferences 设置实例固定代理基线或两跳代理链。
- [不受扩展身份限制的 API](https://console.getchrovia.com/zh/docs/sdk-unrestricted-api/index.md): 了解 unrestrictedApi 如何扩大 JavaScript 开放范围，以及为何它不会授予能力或向页面开放密码 API。

## Optional

- [Downloads (en)](https://console.getchrovia.com/en/download): Browser and desktop app downloads.
- [Blog (en)](https://console.getchrovia.com/en/blog): Articles and product updates.
- [Privacy (en)](https://console.getchrovia.com/en/privacy): Privacy policy.
- [Terms (en)](https://console.getchrovia.com/en/terms): Terms of service.
- [Downloads (zh)](https://console.getchrovia.com/zh/download): Browser and desktop app downloads.
- [Blog (zh)](https://console.getchrovia.com/zh/blog): Articles and product updates.
- [Privacy (zh)](https://console.getchrovia.com/zh/privacy): Privacy policy.
- [Terms (zh)](https://console.getchrovia.com/zh/terms): Terms of service.