# Windows

System-wide HTTP/HTTPS proxy — all apps that honor Windows proxy settings (Edge, Chrome by default, .NET apps, most CLI tools) will route through helodata.

## Settings UI (Windows 10/11)

1. **Settings → Network & Internet → Proxy → Manual proxy setup**.
2. Toggle **Use a proxy server** on.
3. Address: `gate.helodata.io` (or your ISP IP). Port: `7777`.
4. Click **Save**.
5. The next outbound request prompts for credentials:
   * Username: full proxy username (e.g. `helo_s1a2b3c4d5e-type-res-region-us`)
   * Password: sub-user password

The Settings UI does **not** persist proxy credentials — they're stored per app. For unattended use, prefer PowerShell or `netsh`.

\[screenshot: Windows 11 Proxy settings pane]

## PowerShell (programmatic)

```powershell
$proxy = "http://gate.helodata.io:7777"
Set-ItemProperty -Path 'HKCU:\Software\Microsoft\Windows\CurrentVersion\Internet Settings' `
                 -Name ProxyServer -Value $proxy
Set-ItemProperty -Path 'HKCU:\Software\Microsoft\Windows\CurrentVersion\Internet Settings' `
                 -Name ProxyEnable -Value 1
```

To remove:

```powershell
Set-ItemProperty -Path 'HKCU:\Software\Microsoft\Windows\CurrentVersion\Internet Settings' `
                 -Name ProxyEnable -Value 0
```

## CLI tools

curl on Windows reads `HTTP_PROXY` / `HTTPS_PROXY`:

```cmd
set HTTP_PROXY=http://helo_s1a2b3c4d5e-type-res-region-us:PASSWORD@gate.helodata.io:7777
set HTTPS_PROXY=%HTTP_PROXY%
curl https://ipv4.icanhazip.com
```

For permanent envvars use **System Properties → Environment Variables**.

## WinHTTP (system services, .NET)

For Windows services and .NET HttpClient (which uses WinHTTP, not the user proxy), set the system-level proxy:

```cmd
netsh winhttp set proxy "gate.helodata.io:7777"
netsh winhttp show proxy
```

To revert:

```cmd
netsh winhttp reset proxy
```

WinHTTP cannot embed credentials in the proxy URL — the calling app must supply them via `IWebProxy.Credentials`.

## Verify

```cmd
curl https://ipv4.icanhazip.com
```

Or browse to that URL in Edge.

## Common pitfalls

* **Two proxy systems** (WinINet for user apps vs WinHTTP for services) — you may need both.
* **VPN clients** often install themselves as a higher-priority proxy hook. Disconnect VPN to test.
* **`.local` and corporate suffixes** bypass automatically — useful but watch the bypass list.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.helodata.com/integrations/operating-systems/windows.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.