px.ini

[proxy]

; NTLM server(s) to connect through. IP:port, hostname:port
;   Multiple proxies can be specified comma separated. Px will iterate through
;   and use the one that works
server =

; PAC file to use to connect
;   Use in place of --server if PAC file should be loaded from a URL or local
;   file. Relative paths will be relative to the Px script or binary
pac =

; IP interface to listen on - default: 127.0.0.1
listen = 127.0.0.1

; Port to run this proxy on - default: 3128
port = 3128

; Allow remote machines to use proxy. 0 or 1, default: 0
;   Overrides 'listen' and binds to all interfaces
gateway = 0

; Allow only local interfaces to use proxy. 0 or 1, default: 0
;   Px allows all IP addresses assigned to local interfaces to use the service.
;   This allows local apps as well as VM or container apps to use Px when in a
;   NAT config. Px does this by listening on all interfaces and overriding the
;   allow list.
hostonly = 0

; Allow connection from specific subnets. Comma separated, default: *.*.*.*
;   Whitelist which IPs can use the proxy. --hostonly overrides any definitions
;   unless --gateway mode is also specified
;   127.0.0.1 - specific ip
;   192.168.0.* - wildcards
;   192.168.0.1-192.168.0.255 - ranges
;   192.168.0.1/24 - CIDR
allow = *.*.*.*

; Direct connect to specific subnets like a regular proxy. Comma separated
;   Skip the NTLM proxy for connections to these subnets
;   127.0.0.1 - specific ip
;   192.168.0.* - wildcards
;   192.168.0.1-192.168.0.255 - ranges
;   192.168.0.1/24 - CIDR
noproxy =

; Override or send User-Agent header on client's behalf
useragent =

; Authentication to use when SSPI is unavailable. Format is domain\\username
; Service name "Px" and this username are used to retrieve the password using
; Python keyring. Px only retrieves credentials and storage should be done
; directly in the keyring backend.
;   On Windows, Credential Manager is the recommended backed and can be accessed
;   from Control Panel > User Accounts > Credential Manager > Windows Credentials.
;   Create a generic credential with Px as the network address, this username
;   and corresponding password.
;   On Linux, Gnome Keyring or KWallet can be used to store passwords. For headless
;   systems, the keyring_jeepney package might be needed.
username =

; Force instead of discovering upstream proxy type
;   By default, Px will attempt to discover the upstream proxy type. This
;   option can be used to force either NTLM, KERBEROS, DIGEST, BASIC or the
;   other libcurl supported upstream proxy types. See:
;     https://curl.se/libcurl/c/CURLOPT_HTTPAUTH.html
;   To control which methods are available during proxy detection:
;     Prefix NO to avoid method - e.g. NONTLM => ANY - NTLM
;     Prefix SAFENO to avoid method - e.g. SAFENONTLM => ANYSAFE - NTLM
;     Prefix ONLY to support only that method - e.g ONLYNTLM => ONLY + NTLM
auth =

[settings]

; Number of parallel workers (processes). Valid integer, default: 2
workers = 2

; Number of parallel threads per worker (process). Valid integer, default: 5
threads = 5

; Idle timeout in seconds for HTTP connect sessions. Valid integer, default: 30
idle = 30

; Timeout in seconds for connections before giving up. Valid float, default: 20
socktimeout = 20.0

; Time interval in seconds before refreshing proxy info. Valid int, default: 60
;   Proxy info reloaded from manual proxy info defined in Internet Options
proxyreload = 60

; Run in foreground when frozen or with pythonw.exe. 0 or 1, default: 0
;   Px will attach to the console and write to it even though the prompt is
;   available for further commands. CTRL-C in the console will exit Px
foreground = 0

; Enable debug logging. default: 0
;   Logs are written to working directory and over-written on startup
;   A log is automatically created if Px crashes for some reason
log = 0