Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 16 additions & 14 deletions docs/manual/01_install/02_macOSX.md
Original file line number Diff line number Diff line change
Expand Up @@ -135,47 +135,49 @@ Navigate to the [application's URL](https://localhost:3000/location/default) in

### Step 4: Accept the certificates

<!-- Start of partial: AcceptCertificates -->
When accessing the iR Engine for the first time, browsers block access due to **self-signed certificates**. This prevents you from accessing the Admin panel and the Editor. To bypass this, manually accept the certificates:

::::workflow-block
:::workflow-block-item
**Open Developer Tools**

- **Chrome/Edge:** Click the three-dot menu → *More tools* → *Developer tools*
- **Shortcut:** Press `Ctrl+Shift+I` or `F12`
- Navigate to the **Console** tab.
:::

:::workflow-block-item
**Identify certificate-related errors**
- Check for network request errors related to:
**Identify certificate-related errors**

Check for network request errors related to:

- **WebSocket connections** (`wss://` URLs)
- **HTTPS requests to localhost**
- **WebSocket connections** (`wss://` URLs)
- **HTTPS requests to localhost**

- The following addresses require certificate approval:
The following addresses require certificate approval:

- `https://localhost:3030` – API server
- `https://localhost:8642` – File server
- `https://localhost:3030` – API server
- `https://localhost:8642` – File server
:::

:::workflow-block-item
**Bypass the security warning**
**Bypass the security warning**

1. Open these URLs directly in your browser:
- [https://localhost:3030](https://localhost:3030/)
- [https://localhost:8642](https://localhost:8642/)
1. [https://localhost:3030](https://localhost:3030/)
2. [https://localhost:8642](https://localhost:8642/)
2. A **"Your connection is not private"** warning appears.
3. Click **Advanced** → **Proceed to localhost (unsafe)**.
4. Reload the engine’s website.
:::
::::

::::hint{type="success"}
:::hint{type="success"}
Once completed, the iR Engine’s admin panel and editor will be fully accessible. 🚀
::::
:::

:::hint{type="info"}
** Why bypassing security warnings?**
Browsers block connections to self-signed certificates by default to protect users from potentially unsafe sites. For local development, it's safe to bypass these warnings, but only if you trust the source—like your own machine or your team's local environment.
:::
<!-- End of partial: AcceptCertificates -->