Skip to content
Ra1nify edited this page Oct 31, 2026 · 1 revision

Proxy

Proxy settings apply to instance processes. Configuration lives in data/proxy_config.json.

Modes

One of three.

Mode Behavior
Direct No proxy; instances connect directly
System Reads the Windows system proxy and passes it to instances
Manual Uses the host and port below

Manual fields

Field Type Notes
Protocol Dropdown HTTP / SOCKS5
Host Text IPv4, IPv6, or hostname
Port Number 1–65535
Username Text Optional
Password Password Optional
Bypass list Text Semicolon-separated; default localhost;127.0.0.1;<local>

Buttons

Button Behavior
Test Opens one connection with the current values; reports elapsed time and result
Save Writes proxy_config.json and applies to instances launched afterwards

Saving does not affect running instances. Each instance reads the config once at launch.

Injection

At launch these environment variables are set for the instance:

HTTP_PROXY=http://<host>:<port>
HTTPS_PROXY=http://<host>:<port>
ALL_PROXY=...
NO_PROXY=<bypass list>

With credentials the form is scheme://user:pass@host:port.

Related files

File Role
data/proxy_config.json Proxy settings
src/Gravityless.Core/Services/InstanceService.cs Sets environment variables at launch
src/Gravityless.App/Resources/Languages/*.xaml Text keys Proxy_*

Clone this wiki locally