Enterprise
Cursor Enterprise: Network Configuration
Cursor streams chat and agent traffic over HTTP/2, so the usual enterprise blockers are proxies that buffer streams and SSL inspection. Allowlist *.cursor.sh, *.cursor-cdn.com, *.cursorapi.com, the two cursorvm.com patterns and the sign-in hosts, and exclude Cursor's domains from SSL inspection. Where a proxy breaks HTTP/2 streaming, as Zscaler can, Cursor falls back to HTTP/1.1 Server-Sent Events.

On this page
- Why does Cursor break behind a corporate proxy?
- Which Cursor domains should skip SSL inspection?
- Which domains do we allowlist on the firewall?
- How does Cursor encrypt data in transit and at rest?
- Can Cursor reach our private repos and internal resources?
- How do we control where Cloud Agents send traffic?
- Should we self-host Cloud Agents in our own VPC?
- How do we test and troubleshoot Cursor connectivity?
Why does Cursor break behind a corporate proxy?
By default, Cursor carries real-time chat and agent work over bidirectional HTTP/2 streams. Some enterprise proxies mishandle HTTP/2 streaming, and Zscaler is the most widely used of them. When the stream fails, Cursor switches on its own to HTTP/1.1 Server-Sent Events (SSE), a mode Cursor designed for Zscaler and other proxies that buffer HTTP/2 streams or break them.
The other usual blocker is SSL inspection, which Cursor counts among the most frequent problems it sees in enterprise deployments. Many corporate proxies inspect encrypted traffic for security threats or data loss prevention (DLP) by swapping Cursor's SSL certificates for their own. When Cursor traffic passes through a secure web gateway, SSL inspection or DLP, Agent work often times out, slows down or fails.
If policy says every connection must be inspected, the proxy has to handle bidirectional HTTP/2 streaming (or let the HTTP/1.1 fallback work). It also has to pass Server-Sent Events through unbuffered, hold long-running connections open without forced timeouts, and skip response buffering for streaming content types.
Set up the exclusion before you touch the firewall list. Inspection in the path changes what later tests tell you, starting with the certificate check, which keeps naming your proxy's issuer however correct your firewall rules are. Cursor's hardening checklist puts allowlisting and the exclusion in one step, so finish the exclusion half first.
None of this reaches the security software on the laptop. Antivirus, EDR and endpoint DLP run on the machine, not in the network path, so they need their own exclusions. The two problems can look alike in a support ticket, which makes it easy to send one to the wrong team. The endpoint security page covers those exclusions.
This is covered hands-on in Teams and Enterprise Admin — 6 short Units, free to read.
Rather do it than read about it? Run 11 interactive Cursor walkthroughs in a simulated editor. Free, no account needed.
Which Cursor domains should skip SSL inspection?
Cursor's services are already encrypted end to end, so Cursor recommends turning off SSL inspection for these domains:
.cursor.shcursor-cdn.commarketplace.cursorapi.comauthenticate.cursor.shauthenticator.cursor.sh*.cursorvm.com*.*.cursorvm.comcursor.comand*.cursor.com, for the web dashboard, Cloud AgentsAgents that run in a Cursor-managed virtual machine, check out the repo, do the work and open a pull request, then shut down, with no load on your laptop. Press Enter for the full definition. atcursor.com/agentsand code review pages
Sign-in now also goes through accounts.spacex.ai, accounts.x.ai and related auth hosts, so exclude those too. authenticator.cursor.sh is the fallback sign-in page during the transition, and Cursor's sign-in help page says that fallback retires on October 30. Grok BotAn early AI teammate product from SpaceXAI and Cursor that works across apps on a persistent cloud computer and asks for approval on selected actions; launch materials describe it as beta, but Cursor says Beta Services terms do not apply. Press Enter for the full definition. needs both cursorvm.com patterns, because its hosted computers use nested hostnames that a single-level wildcard misses. Apply the exclusions to roaming and off-network proxy profiles as well as office locations.
A gateway that scans downloads needs one more change. The web app at cursor.com streams agent conversations and code review data as long-lived compressed responses. A gateway that treats them as files can hold each response until the connection closes, which can take over ten minutes. Cursor says Cloudflare Gateway does this when its HTTP policies inspect cursor.com, and that Zscaler and Netskope have equivalent settings.
Agents then stay on "Loading…" at cursor.com/agents while the desktop app opens the same agents normally. Exclude cursor.com and *.cursor.com from TLS inspection and from file scanning.
Which domains do we allowlist on the firewall?
Cursor recommends allowlisting domain patterns, not IP addresses, which can change. For most networks, allow traffic to *.cursor.sh, *.cursor-cdn.com, *.cursorapi.com, *.cursorvm.com and *.*.cursorvm.com. If your firewall requires granular subdomain entries without wildcards, Cursor's docs list each subdomain and what it handles.
- Subdomain
- api2.cursor.sh
- Used for
- Most API requests
- Subdomain
- api5.cursor.sh
- Used for
- Agent requests and network access layer (NAL) requests
- Subdomain
- api3.cursor.sh
- Used for
- Cursor TabCursor's original autocomplete: multi-line, edit-aware suggestions you accept with the Tab key. Press Enter for the full definition. requests (HTTP/2 only)
- Subdomain
- repo42.cursor.sh
- Used for
- Codebase search (HTTP/2 only)
- Subdomain
- api4.cursor.sh, us-asia.gcpp.cursor.sh, us-eu.gcpp.cursor.sh, us-only.gcpp.cursor.sh
- Used for
- Cursor TabCursor's original autocomplete: multi-line, edit-aware suggestions you accept with the Tab key. Press Enter for the full definition. requests depending on location (HTTP/2 only)
- Subdomain
- adminportal42.cursor.sh
- Used for
- SSOSingle Sign-On. One company login (usually via SAML or OIDC) instead of a separate password per tool. Press Enter for the full definition. configuration and domain verification
- Subdomain
- marketplace.cursorapi.com, cursor-cdn.com, downloads.cursor.com, anysphere-binaries.s3.us-east-1.amazonaws.com
- Used for
- Client updates and extension downloads
- Subdomain
- authenticate.cursor.sh, authenticator.cursor.sh, accounts.spacex.ai, accounts.x.ai
- Used for
- Sign-in: the authorization endpoint, the login webview (now the fallback sign-in page) and the new sign-in page
| Subdomain | Used for |
|---|---|
| api2.cursor.sh | Most API requests |
| api5.cursor.sh | Agent requests and network access layer (NAL) requests |
| api3.cursor.sh | Cursor TabCursor's original autocomplete: multi-line, edit-aware suggestions you accept with the Tab key. Press Enter for the full definition. requests (HTTP/2 only) |
| repo42.cursor.sh | Codebase search (HTTP/2 only) |
| api4.cursor.sh, us-asia.gcpp.cursor.sh, us-eu.gcpp.cursor.sh, us-only.gcpp.cursor.sh | Cursor TabCursor's original autocomplete: multi-line, edit-aware suggestions you accept with the Tab key. Press Enter for the full definition. requests depending on location (HTTP/2 only) |
| adminportal42.cursor.sh | SSOSingle Sign-On. One company login (usually via SAML or OIDC) instead of a separate password per tool. Press Enter for the full definition. configuration and domain verification |
| marketplace.cursorapi.com, cursor-cdn.com, downloads.cursor.com, anysphere-binaries.s3.us-east-1.amazonaws.com | Client updates and extension downloads |
| authenticate.cursor.sh, authenticator.cursor.sh, accounts.spacex.ai, accounts.x.ai | Sign-in: the authorization endpoint, the login webview (now the fallback sign-in page) and the new sign-in page |
Part of the granular subdomain list. Cursor's docs give the full set, including the six api5 NAL agent subdomains and the two token issuers.
The choice is five wildcard patterns against a granular list that runs past twenty hostnames, six of them api5 agent subdomains and two of them token issuers. The patterns give your network team a short change ticket to review. The granular list gives them an inventory, but it only pays off when the firewall can't take a wildcard, which is the case the docs reserve it for.
Sign-in needs entries of its own, because the five patterns don't cover the new sign-in page. Cursor's sign-in help page asks networks with a firewall or proxy allowlist to add accounts.spacex.ai, accounts.x.ai and related auth hosts, preferably as wildcards such as *.spacex.ai and *.x.ai. Once the fallback retires on October 30, a network that blocks them stops users from signing in. Our sign-in domains page lists every host.
How does Cursor encrypt data in transit and at rest?
Cursor encrypts data in transit and at rest. Security reviewers ask for exactly this when you request an SSL-inspection exclusion, so here is what to hand them.
- In transit
- TLS 1.2 or higher for all connections to Cursor services, TLS to third-party AI providers, and certificate pinning for critical services.
- At rest
- AES-256 for stored data, encrypted vector database storage, and encrypted code storage for Cloud AgentsAgents that run in a Cursor-managed virtual machine, check out the repo, do the work and open a pull request, then shut down, with no load on your laptop. Press Enter for the full definition. when enabled.
- Key management
- Cursor manages and rotates keys in secure key management systems. Enterprise customers can use Customer Managed Encryption Keys (CMEK).
Two at-rest items need a second look. Encrypted code storage belongs to Cloud AgentsAgents that run in a Cursor-managed virtual machine, check out the repo, do the work and open a pull request, then shut down, with no load on your laptop. Press Enter for the full definition., the only feature that requires Cursor to store code, and with CMEK on, Cloud Agent data is encrypted with your key. The network page doesn't say what the encrypted vector database holds. Cursor's search docs now say Cursor doesn't upload code to build a search index or store embeddings of your codebase for search, and the codebase indexing page covers how search works now.
The exclusion request is narrower than it sounds. Only the listed hosts leave the inspection path and stay encrypted end to end, and everything else your users reach is inspected as before. A reviewer who reads it as switching inspection off for a whole vendor is likely to refuse it, so list every entry in the ticket.
Can Cursor reach our private repos and internal resources?
It depends on where the agent runs. Agents in the editor or the CLI on a machine inside your VPC inherit that machine's network configuration: security groups, firewall rules, DNS, and VPN or private network access. They can reach the internal resources that machine can reach, under your existing controls.
Cursor-hosted Cloud AgentsAgents that run in a Cursor-managed virtual machine, check out the repo, do the work and open a pull request, then shut down, with no load on your laptop. Press Enter for the full definition. run on Cursor's infrastructure instead. Cursor's network page says they can reach public GitHub, GitHub Enterprise Cloud repositories you've granted access to, GitHub Enterprise Server, on-prem and cloud GitLab, Bitbucket Cloud and public package registries. It also says they can't reach resources behind your firewall, on-premises GitHub Enterprise Server or private registries without internet access. The page lists GitHub Enterprise Server on both sides, and Cursor's private connectivity page draws the line at whether a system is reachable from the public internet.
For systems that aren't, Enterprise teams can set up private connectivity through AWS PrivateLinkAn AWS connection Cursor uses for private Git provider and repository-origin traffic; it does not cover model-provider traffic. Press Enter for the full definition. or Cloudflare Tunnel. It covers Cloud AgentsAgents that run in a Cursor-managed virtual machine, check out the repo, do the work and open a pull request, then shut down, with no load on your laptop. Press Enter for the full definition., BugbotCursor's automated PR reviewer that posts inline findings and can push fix commits from isolated VMs. Press Enter for the full definition. and Cursor's backend services.
Cursor does not currently offer VPC peering or customer-facing Google Private Service Connect. For internal resources that Cloud AgentsAgents that run in a Cursor-managed virtual machine, check out the repo, do the work and open a pull request, then shut down, with no load on your laptop. Press Enter for the full definition. can't reach, Cursor's network page says to run Cursor in the editor on a machine inside your network. Cursor's Cloud Agent security and network page also describes running Tailscale or Cloudflare Tunnel inside the agent's environment.
How much of this is open to you is partly a procurement question. Private connectivity is an Enterprise capability, and setup runs through hi@cursor.com or a Cursor sales representative, not a settings page. A team of eight that needs an agent inside the network will get there sooner by installing Cursor on a machine that already has the VPN. Private connectivity covers the prerequisites and both traffic directions.
How do we control where Cloud Agents send traffic?
You control it in the Cloud AgentsAgents that run in a Cursor-managed virtual machine, check out the repo, do the work and open a pull request, then shut down, with no load on your laptop. Press Enter for the full definition. dashboard, not on your firewall.
Cursor-hosted Cloud AgentsAgents that run in a Cursor-managed virtual machine, check out the repo, do the work and open a pull request, then shut down, with no load on your laptop. Press Enter for the full definition. run on Cursor's infrastructure, so their outbound traffic doesn't leave through your network, and they have internet access by default. The dashboard offers three access modes: allow all network access, the default domains plus your own allowlist, or allowlist only. Users, saved environments and team admins can each set a mode. Only Enterprise admins can lock the team setting so members can't override it.
The team allowlist is the same list that sets the sandbox's default network allowlist for desktop agents, so one change affects both. Self-Hosted Machines sit outside all of this. They use the machine's own network, firewall and proxy, and a locked setting doesn't reach them.
Firewall rules and egress modes are separate jobs. The network team reviews firewall rules, while whoever administers Cursor sets the egress modes. Give each job a named owner instead of filing both under one network project. The modes and their precedence are on Cloud Agent security and network access.
Should we self-host Cloud Agents in our own VPC?
Usually not. Cursor points most teams to its managed Cloud AgentsAgents that run in a Cursor-managed virtual machine, check out the repo, do the work and open a pull request, then shut down, with no load on your laptop. Press Enter for the full definition.. Self-Hosted Machines move tool execution, not the agent: Cursor keeps running the agent loop, planning and inference in its cloud, while your machine runs file edits, terminal commands and local MCPModel Context Protocol. A standard that lets an AI agent pull in context from outside the repo, like Jira tickets or internal docs. Press Enter for the full definition. servers. They come as My Machines, for one user's machine, and Team Pools, a worker fleet for Enterprise teams.
- Dimension
- Where the agent runs
- Self-Hosted Machines
- Agent loop in Cursor's cloud; tool calls on your machine or worker
- Cursor-hosted
- Agent loop in Cursor's cloud; tool calls in an isolated Cursor-managed VM
- Dimension
- Where code lives during a run
- Self-Hosted Machines
- The checkout and credentials stay on your machine; the worker sends Cursor the file contents, output and diffs the agent needs
- Cursor-hosted
- Encrypted copies of the repository, stored on the agent's VM while it runs
- Dimension
- Retention
- Self-Hosted Machines
- You manage the machine and its state; the self-hosting docs don't say how long Cursor keeps the conversation
- Cursor-hosted
- Environment snapshots kept up to 30 days of inactivity; conversation history kept indefinitely by default
- Dimension
- Control
- Self-Hosted Machines
- You run the hosts, images, capacity and network access
- Cursor-hosted
- Cursor manages the host and environment after first-time setup
| Dimension | Self-Hosted Machines | Cursor-hosted |
|---|---|---|
| Where the agent runs | Agent loop in Cursor's cloud; tool calls on your machine or worker | Agent loop in Cursor's cloud; tool calls in an isolated Cursor-managed VM |
| Where code lives during a run | The checkout and credentials stay on your machine; the worker sends Cursor the file contents, output and diffs the agent needs | Encrypted copies of the repository, stored on the agent's VM while it runs |
| Retention | You manage the machine and its state; the self-hosting docs don't say how long Cursor keeps the conversation | Environment snapshots kept up to 30 days of inactivity; conversation history kept indefinitely by default |
| Control | You run the hosts, images, capacity and network access | Cursor manages the host and environment after first-time setup |
Self-hosting changes where tools run. Inference and the agent loop stay in Cursor's cloud either way.
Self-Hosted Machines keep the checkout on your hardware, but inference still happens in Cursor's cloud, and the worker sends Cursor the content the agent needs. With Privacy ModeCursor's setting that guarantees code data is not used for training by Cursor or its model providers, and that an admin can enforce org-wide; data-retention terms are a separate, contractual layer. Press Enter for the full definition. on, code sent from the worker isn't used for training by Cursor or model providers. For regional rules, look at Cursor's data residency program instead: US-only today, with EU and UK inference-only coverage on request.
Weigh Cursor-hosted retention against your policy before you choose. Snapshots are encrypted copies of the agent's VM disk, which is what lets an agent resume without recloning the repository. Each start or resume extends a snapshot's 30-day window, and snapshots can't be deleted on demand. Enterprise admins can cap conversation history at 90 days.
How do we test and troubleshoot Cursor connectivity?
Most connectivity issues come from proxies buffering streaming responses. Cursor's docs include curl tests that simulate the requests Cursor makes. To check for SSL inspection, run curl -v https://api2.cursor.sh |& grep -C1 issuer: and read the certificate issuer. Amazon RSA is the expected result, and your proxy provider's name, such as Zscaler, means SSL inspection is intercepting the connection.
The two streaming tests need care, because a failure looks like a pass. The HTTP/1.1 test should print line by line over five seconds. If everything appears at once when the five seconds end, the path buffered it. The HTTP/2 test should print once a second, and the same all-at-once ending means bidirectional streaming isn't getting through. Since only the timing differs, the buffering case often reaches you as a complaint about speed.
Work through Cursor's checklist in order. Each step isolates one layer, so by the end you know whether the problem is the firewall, SSL inspection, a scanning gateway or the proxy buffering streams.
- 1Test basic connectivity to
api2.cursor.sh. - 2Check whether SSL inspection is active, and consider excluding the Cursor domains above.
- 3If
cursor.com/agentsstays on "Loading…" while the desktop app works, check whether download scanning is holding the web app's streams. - 4Verify streaming with the HTTP/1.1 SSE and HTTP/2 bidirectional curl tests from the docs.
- 5Confirm firewall rules allow
*.cursor.shand related domains. - 6Review proxy logs for connection errors or timeouts.
- 7Test from a machine outside your network to isolate network-specific issues.
We'd move step seven up when teams disagree about whose problem this is. A test from outside the network settles that quickly, and the steps above it then tell you what to fix.
Some teams want to route LLM traffic through their own gateway. Cursor warns that custom gateways can add latency, rate limiting and compatibility issues, and recommends its built-in hooks for security controls instead. Cursor's Zero Data Retention policy doesn't apply when you use your own API keys, so your data handling then follows your chosen provider's privacy policy.
Frequently asked questions
Will Cursor work behind Zscaler?
Yes. Zscaler is the most widely used proxy that mishandles HTTP/2 streaming, and Cursor switches to HTTP/1.1 Server-Sent Events on its own when that happens, a mode designed for Zscaler and similar proxies. If you also run SSL inspection, exclude the Cursor domains the docs list to avoid timeouts.
Should we allowlist IP addresses or domains?
Domains. Cursor's IP addresses can change, so the docs recommend wildcard patterns for cursor.sh, cursor-cdn.com, cursorapi.com and cursorvm.com, plus a two-level wildcard for cursorvm.com. Sign-in also needs accounts.spacex.ai, accounts.x.ai and related auth hosts. Use the granular subdomain list only if your firewall can't accept wildcards.
Can Cloud Agents access our internal GitHub Enterprise Server?
Not if it's only reachable inside your network. Cursor's network page says Cloud Agents can't reach on-premises GitHub Enterprise Server or anything behind your firewall. Enterprise teams can connect it through private connectivity, with AWS PrivateLink as Cursor's preferred path for self-hosted GitHub Enterprise Server, or with Cloudflare Tunnel.
Why does cursor.com/agents stay on Loading behind our gateway?
A secure web gateway that scans downloads can hold the web app's long-lived streams until the connection closes, which can take over ten minutes, while the desktop app opens the same agents normally. Exclude cursor.com and *.cursor.com from TLS inspection and file scanning, including on roaming profiles.
Sources & last verified
- Cursor - Network Configuration
- Cursor - Private Connectivity
- Cursor - Endpoint Security
- Cursor - Cloud Agent Security & Network
- Cursor - Security and Privacy Hardening
- Cursor - Hooks
- Cursor - Privacy and Data Governance
- Cursor - Self-Hosted Machines
- Cursor - Choose where Cloud Agents run
- Cursor - Search
- Cursor Help - Which domains does Cursor sign-in need?
Cursor ships frequently. Last updated October 28, 2026.