Proxies

Manage proxy configurations for routing browser traffic. For background on proxy types and when to use each, see Proxies.

kernel proxies list

List available proxy configurations.

FlagDescription
--output json, -o jsonOutput raw JSON array.

kernel proxies get <id>

Show details for a proxy configuration.

FlagDescription
--output json, -o jsonOutput raw JSON object.

kernel proxies create

Create a new proxy configuration. Proxy quality for bot detection avoidance, best to worst: mobile > residential > ISP > datacenter.

FlagDescription
--type <type>datacenter, isp, residential, mobile, or custom. Required.
--name <name>Proxy configuration name.
--protocol <protocol>Protocol to use (http or https; default: https).
--country <code>ISO 3166 country code or EU.
--city <name>City name or provider alias. Residential and mobile; requires --country.
--state <code>State/region code. Residential, or US-only for mobile.
--zip <zip>ZIP/postal code. Residential only.
--asn <asn>Autonomous system number (e.g. AS15169). Residential only.
--os <os>Operating system (windows, macos, android). Residential only.
--host <host>Proxy host address or IP (custom type).
--port <port>Proxy port (custom type).
--username <username>Username for proxy authentication (custom type).
--password <password>Password for proxy authentication (custom type).
--bypass-host <hostname>Hostname(s) to bypass the proxy and connect directly (repeatable or comma-separated).
--output json, -o jsonOutput raw JSON object.
# Datacenter proxy in the US
kernel proxies create --type datacenter --country US --name "US Datacenter"

# Custom proxy server
kernel proxies create --type custom --host proxy.example.com --port 8080 --username myuser --password mypass

# Residential proxy with location
kernel proxies create --type residential --country US --city sanfrancisco --state CA

kernel proxies check <id>

Run a health check on a proxy to verify it's working and update its status.

FlagDescription
--output json, -o jsonOutput raw JSON object.

kernel proxies delete <id>

Delete a proxy configuration.

FlagDescription
--yes, -ySkip confirmation prompt.

On this page