Skip to content

A desktop coding agent with free access to frontier models.

TypeScript
7.6 KB
Raw Blame
---
title: "Outbound network access"
description: "Customer IT allowlist guidance for OmniRush.ai desktop, Den, deployment artifacts, and opt-in providers."
---

OmniRush.ai works best when customer IT approves outbound access by component. The canonical machine-readable source is [`docs/enterprise/outbound-access.json`](https://github.com/omnirush-ai/omnirush-gui/blob/main/docs/enterprise/outbound-access.json). CI guards that file with `node scripts/check-outbound-access.mjs`; this page is the published human-readable summary.

## Minimum desktop allowlist

For a practical omnirush.ai desktop install, allow TCP 443 to these hosts:

```text
omnirush.ai
github.com
release-assets.githubusercontent.com
objects.githubusercontent.com
```

If the desktop connects to a self-hosted Den, also allow its web origin (and its API origin when that is separate). omnirush.ai does not run a hosted Den.

Common misses:

- GitHub release downloads redirect away from `github.com`. Allow `release-assets.githubusercontent.com`, which is the current verified GitHub release-asset host, and `objects.githubusercontent.com`, which is kept for older clients and rollback paths.
- The built-in UI-control MCP ships inside the desktop app and runs with the app's own binary, so it needs no npm registry access. `registry.npmjs.org` is only reached by MCP servers you configure yourself with an `npx` command.
- The desktop fetches no model catalog by default; the engine uses the model list bundled with it. Set `OPENCODE_MODELS_URL` to an approved internal mirror if you need fresher model metadata.

## Desktop and local runtime destinations

| Host | Requirement | Why it is reached | What breaks when blocked |
| --- | --- | --- | --- |
| `omnirush.ai` | Required | omnirush.ai account sign-in and the model gateway (`/omnirush/v1`) that serves the Astra and Sol models. | Sign-in fails and the Astra and Sol models are unavailable. |
| Your self-hosted Den web origin | Required for self-hosted desktop | The Den base URL the desktop is configured with; there is no hosted default. The desktop derives Den API/MCP calls from it through `/api/den/...` on the same origin. | The desktop cannot sign in to the Den or reach Den features. |
| Your separate Den API origin, if configured | Required only for that topology | Used by one-time install-link exchange and external MCP clients when `DEN_API_PUBLIC_URL` points at a separate origin. | Install-link handoff or external MCP clients cannot complete. |
| `github.com` | Required in practice unless mirrored | Installer/updater release URLs, GitHub issue links, and GitHub plugin source URLs. | Install/update downloads cannot start; GitHub links may not open. |
| `release-assets.githubusercontent.com` | Required in practice unless mirrored | Current GitHub release-asset redirect target. | Downloads start from `github.com` and fail partway through. |
| `objects.githubusercontent.com` | Required in practice for legacy/rollback | Legacy GitHub release-asset redirect target. | Older clients or rollback downloads can fail partway through. |
| `registry.npmjs.org` | Opt-in | `npx` package resolution for local MCP servers a user or administrator configures with an `npx` command. The built-in UI-control MCP is bundled with the app and never uses it. | User-configured `npx` MCP servers cannot download their packages. |
| Your model catalog mirror, if configured | Optional | Model catalog passed to the engine as `OPENCODE_MODELS_URL`. There is no default catalog. | The engine keeps the model list bundled with it. |
| `cdn.simpleicons.org` | Optional | Provider icons when no local icon exists. | Some icons are missing. |
| `www.google.com` | Optional | Favicon image service and embedded browser new-tab page. | Favicons or the browser panel new tab may not load. |
| `us.i.posthog.com` | Optional | Product analytics of the desktop app (release builds set `VITE_OMNIRUSH_POSTHOG_KEY`; a build without it sends nothing). | Analytics are dropped silently. |
| `discord.gg`, `ollama.com`, `opencode.ai`, `linear.app`, `mail.google.com` | Optional or link-only | Docs, feedback, community, provider help, local model links, sample links, and generated Gmail links. | Links do not open; core app behavior is unaffected. |

`code.claude.com` and `schemas.agentskills.io` appear in source or schema metadata. They are findable in the manifest, but OmniRush.ai does not fetch them for normal runtime behavior.

## Den runtime destinations

Approve Den separately from desktop clients. A self-hosted Den behind VPN or inside Kubernetes uses the server network, not the user's laptop network.

| Destination | Requirement | Why it is reached | What breaks when blocked |
| --- | --- | --- | --- |
| Your MySQL-compatible database host | Required | Den control-plane state. | Den cannot start, migrate, sign users in, or store organization state. |
| Your SMTP host or Resend | Optional | Transactional email when configured. | Invites, lifecycle, or notification email cannot send. |
| `api.github.com`, `raw.githubusercontent.com` | Opt-in | GitHub-hosted plugin import and sync. | Plugin import cannot inspect repos or download manifests, skills, commands, agents, or MCP configs. |
| Google Workspace hosts | Opt-in | Google OAuth and APIs. | Google sign-in or Workspace actions fail. |
| Provider and MCP hosts | Opt-in | Calls to enabled model providers, OAuth/token endpoints, and MCP servers. | Only the enabled provider or MCP connection fails. |

Google Workspace hostnames in the manifest are `accounts.google.com`, `oauth2.googleapis.com`, `www.googleapis.com`, `gmail.googleapis.com`, and `chat.googleapis.com`.

## Deployment and image-pull destinations

| Host | Requirement | Why it is reached | What breaks when blocked |
| --- | --- | --- | --- |
| `ghcr.io` | Required unless mirrored | OmniRush.ai Helm chart and container images. | Kubernetes cannot pull the chart or `omnirush-den-api`, `omnirush-den-web`, and optional `omnirush-inference` images. |
| Internal registry mirror | Required when public GHCR is blocked | Your mirrored chart and images. | Installs and upgrades fail until the mirror has the requested version. |

For fully isolated deployments, also mirror installer artifacts, npm packages used by `npx`, and the model catalog. See [Air-gapped deployment](/start-here/air-gapped-deployment) and [Installer delivery](/start-here/installer-delivery).

## Opt-in provider and connection hostnames

These hosts are only needed when the corresponding feature, provider, connection, or import path is enabled:

| Feature group | Hostnames | What breaks when blocked |
| --- | --- | --- |
| OpenAI direct features | `api.openai.com` | Direct OpenAI Realtime voice and image-generation features fail for users who configured OpenAI. |
| Google Workspace | `accounts.google.com`, `oauth2.googleapis.com`, `www.googleapis.com`, `gmail.googleapis.com`, `chat.googleapis.com`, `mail.google.com` | OAuth, profile, Calendar, Drive, Gmail, Chat, and generated Gmail links fail as applicable. |
| Built-in MCP presets | `mcp.notion.com`, `mcp.linear.app`, `mcp.sentry.dev`, `mcp.stripe.com`, `mcp.context7.com`, `mcp.slack.com` | That specific MCP preset cannot connect. |
| Example or custom MCP URLs | `api.githubcopilot.com` or the customer-configured MCP URL | Only the connection that points at that URL fails. |
| GitHub plugin import | `api.github.com`, `raw.githubusercontent.com`, and optionally `github.com` links | GitHub plugin import cannot preview or download plugin contents. |

The JSON manifest remains the ownership point for exact host metadata, requirement level, override name, and blocked effect. Use this page for review conversations and the JSON file for automation.