---
title: "Static IP Proxy Docs: Quickstart and Snippets"
description: "Static IP proxy quickstart: set FIXEDMARK_PROXY_URL, then copy snippets for cURL, Node, Python, Go, Ruby, PHP, Java, Deno, and Bun, plus SOCKS5 for databases."
canonical: https://fixedmark.com/docs
updated: 2026-11-03
source: Fixedmark (https://fixedmark.com), BitMask LLP
---

Start

# Static IP proxy quickstart

Set `FIXEDMARK_PROXY_URL` in your app's environment and pass it as the proxy for your HTTP client. Outbound requests then leave from your static IP pair. Use SOCKS5 or `fm tunnel` for databases.

Docs preview: Fixedmark is not live yet. Endpoints are issued at launch, and these pages describe planned launch behavior. Anything marked planned may change. [Join early access](https://fixedmark.com/early-access) to get yours first.

## Start building

- [Node.js Route Node.js requests through a static IP: undici ProxyAgent, EnvHttpProxyAgent, NODE_USE_ENV_PROXY, axios with an HTTPS proxy, and SOCKS5 agents.](https://fixedmark.com/docs/node)
- [Python Send Python requests through a static IP with an HTTPS proxy URL: requests, httpx, and aiohttp snippets, version notes, SOCKS5, and environment variables.](https://fixedmark.com/docs/python)
- [Go Route Go net/http requests through a static IP with http.Transport Proxy, an HTTPS proxy URL, or socks5h, plus a SOCKS5 dialer for database drivers.](https://fixedmark.com/docs/go)
- [Ruby Send Ruby requests through a static IP: Typhoeus with an HTTPS proxy URL, why Net::HTTP and Faraday fail through a TLS proxy today, and planned fallbacks.](https://fixedmark.com/docs/ruby)
- [PHP Route PHP requests through a static IP with an HTTPS proxy URL in Guzzle or the cURL extension. Check libcurl HTTPS proxy support and set timeouts.](https://fixedmark.com/docs/php)
- [Java Use a static IP proxy from Java: HttpClient with ProxySelector and Basic auth, why it cannot use an HTTPS proxy endpoint, and the plain port 8080 workaround.](https://fixedmark.com/docs/java)
- [Deno and Bun Proxy fetch through a static IP in Deno with Deno.createHttpClient and in Bun with the fetch proxy option, including SOCKS5 and environment variables.](https://fixedmark.com/docs/deno-and-bun)
- [Databases Connect Postgres, MySQL, MongoDB, and Redis to IP allowlists through a static IP with SOCKS5 dialers or fm tunnel, with TLS and pooling notes per driver.](https://fixedmark.com/docs/databases)

## How it works

Fixedmark runs an outbound proxy in each region. Your app connects to the proxy, over TLS with the HTTPS proxy URL, and asks it to connect to the destination. The proxy makes that connection from one of your two static IPv4 addresses. The destination sees your Fixedmark IP, not your platform's changing IP.

For HTTPS destinations the proxy only relays encrypted bytes. It never decrypts your traffic. Read [concepts](https://fixedmark.com/docs/concepts) for the details.

## 1. Set the environment variables

Add the proxy URLs to your platform's environment variables or secrets. Keep them out of source control. `APP_ID` and `TOKEN` come from the dashboard at launch.

**Environment**

```bash
FIXEDMARK_PROXY_URL=https://APP_ID:TOKEN@mum.egress.fixedmark.com:443
FIXEDMARK_SOCKS_URL=socks5h://APP_ID:TOKEN@mum.egress.fixedmark.com:1080
```

The HTTPS URL on port 443 encrypts the token in transit. The SOCKS URL on port 1080 is plain SOCKS5 and sends it in cleartext, so give that token a destination allowlist, or use `fm tunnel`, which always uses TLS. If the token contains `@`, `:`, or `/`, URL-encode it. Setting `HTTPS_PROXY` for the whole process also works with many clients. It sends every outbound request through the proxy, so every request counts against your plan. Prefer passing the URL only to the clients that need a static IP.

## 2. Send a request through the proxy

Each snippet sends one request through your static IPs. HTTPS stays encrypted end to end inside the CONNECT tunnel.

**cURL**

```bash
# curl 7.52+ supports an https:// proxy URL
curl --proxy "$FIXEDMARK_PROXY_URL" https://api.partner.example/v1/orders
```

**undici ProxyAgent**

```javascript
// npm install undici  (undici 8 needs Node.js 22.19+)
import { fetch, ProxyAgent } from "undici";

// Create one agent and reuse it. It keeps connections to the proxy open.
const proxy = new ProxyAgent(process.env.FIXEDMARK_PROXY_URL);

const res = await fetch("https://api.partner.example/v1/orders", { dispatcher: proxy });
console.log(res.status, await res.json());
```

**requests**

```python
# pip install requests  (needs urllib3 1.26+ for an https:// proxy URL)
import os
import requests

proxy = os.environ["FIXEDMARK_PROXY_URL"]

# Pass proxies per request. On a Session, HTTPS_PROXY in the
# environment overrides session.proxies.
proxies = {"http": proxy, "https": proxy}

res = requests.get("https://api.partner.example/v1/orders", proxies=proxies, timeout=15)
print(res.status_code, res.json())
```

**net/http**

```go
package main

import (
	"fmt"
	"log"
	"net/http"
	"net/url"
	"os"
	"time"
)

func main() {
	proxyURL, err := url.Parse(os.Getenv("FIXEDMARK_PROXY_URL"))
	if err != nil {
		log.Fatal(err)
	}
	// Build one client and reuse it so connections are pooled.
	client := &http.Client{
		Transport: &http.Transport{
			Proxy:               http.ProxyURL(proxyURL),
			MaxIdleConnsPerHost: 10,
			IdleConnTimeout:     90 * time.Second,
		},
		Timeout: 15 * time.Second,
	}
	res, err := client.Get("https://api.partner.example/v1/orders")
	if err != nil {
		log.Fatal(err)
	}
	defer res.Body.Close()
	fmt.Println(res.Status)
}
```

Full guides with version notes: [Node.js](https://fixedmark.com/docs/node), [Python](https://fixedmark.com/docs/python), [Go](https://fixedmark.com/docs/go), [Ruby](https://fixedmark.com/docs/ruby), [PHP](https://fixedmark.com/docs/php), [Java](https://fixedmark.com/docs/java), and [Deno and Bun](https://fixedmark.com/docs/deno-and-bun). Your client must support an `https://` proxy URL. Most current clients do. Java's built-in client and Ruby's Net::HTTP do not, and their guides explain the options.

## 3. Allowlist both IPs

Your plan includes a pair of IPv4 addresses. Add both to every allowlist: the partner API, the database firewall, or the broker portal. Traffic can leave from either IP, and failover moves traffic between them. If you allowlist only one, about half of your connections fail.

## 4. Verify the egress IP

Call the Fixedmark IP endpoint through the proxy. It returns the IP the destination sees, which should be one of your pair.

**HTTPS proxy**

```bash
# Plain text: prints the IP the destination sees.
curl --proxy "$FIXEDMARK_PROXY_URL" https://fixedmark.com/api/ip

# JSON: {"ip":"203.0.113.10","version":4}
curl --proxy "$FIXEDMARK_PROXY_URL" -H "Accept: application/json" https://fixedmark.com/api/ip
```

Without the proxy, `https://fixedmark.com/api/ip` shows your app's own egress IP. See [verify your egress IP](https://fixedmark.com/docs/verify-egress-ip) for checks from code and from the database side.

## Databases and other TCP

Database drivers do not speak HTTP CONNECT. Use the SOCKS5 URL when the driver can dial through SOCKS5. Otherwise run the planned `fm tunnel` CLI, which forwards a local port to the database through your static IPs. See [databases](https://fixedmark.com/docs/databases) and the [fm tunnel reference](https://fixedmark.com/docs/cli).

## More docs

- [Concepts How the Fixedmark static IP proxy works: IP pairs and failover, regions, tokens, the TLS proxy endpoint, CONNECT tunnels, and socks5 versus socks5h DNS.](https://fixedmark.com/docs/concepts)
- [Verify egress IP Check which IP a destination sees by calling fixedmark.com/api/ip through your proxy with curl, Node, or Python, and confirm the database sees your IP pair.](https://fixedmark.com/docs/verify-egress-ip)
- [fm CLI Reference for the fm CLI: fm tunnel port forwarding to databases through your static IPs, the config file, exit codes, fm routes for inbound, and fm connectors.](https://fixedmark.com/docs/cli)
- [Troubleshooting Fix static IP proxy errors: 407 auth failures, 403 destination not allowed, TLS errors to the proxy, timeouts, DNS leaks, connection resets, and quotas.](https://fixedmark.com/docs/troubleshooting)
- [Limits and security Planned limits for the proxy: bandwidth quotas with no request cap, soft limits, rate limits, idle timeouts, blocked ports, and how traffic is protected.](https://fixedmark.com/docs/limits)

Other references: [features](https://fixedmark.com/features), [security](https://fixedmark.com/security), [regions](https://fixedmark.com/regions), and [planned pricing](https://fixedmark.com/pricing).

## Get help

- [Support How to reach us and how fast we answer.](https://fixedmark.com/docs/support)
- [Status Service health at status.fixedmark.com.](https://status.fixedmark.com/)
- [REST API Every public operation and the action it needs.](https://fixedmark.com/docs/api)
- [Troubleshooting 407s, timeouts, resets, and requests that skip the proxy.](https://fixedmark.com/docs/troubleshooting)

## Platform guides

- [Vercel](https://fixedmark.com/integrations/vercel)
- [Railway](https://fixedmark.com/integrations/railway)
- [Render](https://fixedmark.com/integrations/render)
- [Supabase Edge Functions](https://fixedmark.com/integrations/supabase-edge-functions)
- [Fly.io](https://fixedmark.com/integrations/fly-io)
- [Heroku](https://fixedmark.com/integrations/heroku)
- [Netlify](https://fixedmark.com/integrations/netlify)
- [AWS Lambda](https://fixedmark.com/integrations/aws-lambda)
- [Cloudflare Workers](https://fixedmark.com/integrations/cloudflare-workers)
- [Google Cloud Run](https://fixedmark.com/integrations/google-cloud-run)
- [n8n](https://fixedmark.com/integrations/n8n)
- [GitHub Actions](https://fixedmark.com/integrations/github-actions)

## Frequently asked questions

### How do I route my app's traffic through a static IP?

Set FIXEDMARK_PROXY_URL in your app's environment, then pass it as the proxy for the HTTP client that calls the allowlisted API. Those requests then leave from your Fixedmark IP pair.

### Do I need to allowlist both IPs?

Yes. Each new connection can leave from either IP in the pair, and failover moves traffic between them. Add both IPs to every allowlist.

### Should I use the HTTPS proxy or SOCKS5?

Use the HTTPS proxy URL for HTTP APIs. Use SOCKS5 or the planned fm tunnel CLI for databases, SSH, SFTP, and other TCP protocols.

### Can I use Fixedmark from Cloudflare Workers?

Not at launch. The Workers fetch API has no proxy option. See the Cloudflare Workers integration page for the current status.

### Where do I get my proxy URL?

Proxy endpoints are issued at launch. Join early access to get yours first.
