Connectivity Issues

No traffic being captured

1. Check the proxy is running:

   curl -x http://localhost:8080 http://httpbin.org/get

2. Check recording is enabled:

   apxy recording status
   # If paused:
   apxy recording start

3. Check for filter rules blocking traffic:

   apxy traffic filter list

4. Run with verbose logging:

   apxy start --verbose

Terminal tools not routing through proxy

Many terminal tools (cURL, Node.js, Python) don’t respect macOS system proxy settings. Use apxy env to configure them:

# Inject proxy env vars into current shell
eval $(apxy env)
 
# Or open a new terminal with everything set up
apxy env --open
 
# Target a specific language
eval $(apxy env --lang node)

Linux: traffic not going through proxy

On Linux, APXY doesn’t configure the system proxy automatically. Set the environment variables:

export http_proxy=http://localhost:8080
export https_proxy=http://localhost:8080

Or use:

eval $(apxy env)

System proxy not restored after crash

If APXY crashes without cleaning up, the system proxy may still be set:

# Force stop and clean up
apxy stop

apxy stop sends SIGTERM to the process and directly disables the system proxy as a safety net.

Wrong network service detected

On macOS, APXY auto-detects your active network service. If it picks the wrong one:

apxy start --network-service "Wi-Fi"
# or
apxy start --network-service "Ethernet"