# Set PersonaHub as default browser and configure default profile

> Configure PersonaHub as your system default web browser, route external HTTP and HTTPS links to a designated profile, and understand system settings and launch argument limits.

Source: https://console.getchrovia.com/en/docs/default-browser

## Default profile

In the PersonaHub desktop app, navigate to **My profiles**, open the **More** menu next to any profile, and select **Set as default profile**. To remove the assignment, click **Clear default profile**.

The default profile selection is stored locally and applies only to the currently signed-in account on this computer.

![Default profile menu](https://console.getchrovia.com/docs/screenshots/personahub-profile-more.webp)

## System default browser

Go to **Settings → Default browser** in the desktop client to view your current system default browser status and the selected default profile. Click **Open system settings** to jump directly to your operating system's default application settings:

![Default browser settings](https://console.getchrovia.com/docs/screenshots/personahub-settings.webp)

| Operating system | Setting path |
| --- | --- |
| macOS 13 or later | System Settings → Desktop & Dock → Default web browser → choose **PersonaHub** |
| macOS 12 (Monterey) | System Preferences → General → Default web browser → choose **PersonaHub** |
| Windows 10 / 11 | Settings → Apps → Default apps → choose **PersonaHub**, ensuring both HTTP and HTTPS associations point to the app |

![macOS default web browser control](https://console.getchrovia.com/docs/screenshots/macos-default-browser-control.webp)

## External link handling and limitations

When PersonaHub is set as your system default browser and a default profile is configured, clicking HTTP or HTTPS links in external applications (such as email clients, chat tools, or terminals) will automatically open them inside that profile's dedicated browser window. This behavior requires the desktop client to be installed and signed in.

Keep the following requirements and edge cases in mind:

- **Missing or inaccessible profile**: If no default profile has been selected, or if the chosen profile has been deleted or is inaccessible to the current account, PersonaHub displays an error prompt. It will not arbitrarily select another profile as a fallback.
- **Clearing default profile**: Clicking **Clear default profile** only removes the profile routing; it does not change or reset the operating system's default browser setting.
- **Account switching**: If you switch accounts in PersonaHub, links originating from external applications must be clicked again after signing in to the target account.
- **Incompatible launch arguments**: Launch arguments such as `--headless`, `--no-startup-window`, `--same-tab`, `--app`, and `--app-id` cause the client to reject the external-link launch and display an error.