Mobile Setup

APXY can proxy traffic from iOS and Android devices on the same network. The mobile setup command provides step-by-step instructions and an optional QR code for quick configuration.

CLI


# Show setup instructions for all platforms
apxy setup mobile setup
 
# iOS-specific instructions
apxy setup mobile setup --platform ios
 
# Android-specific instructions
apxy setup mobile setup --platform android
 
# Display a QR code linking to the setup page
apxy setup mobile setup --qr

Flag	Default	Description
`--platform`	(all)	`ios` or `android`
`--port`	`8080`	Proxy port to configure on the device
`--qr`	`false`	Display a QR code for quick setup

iOS Setup

Connect your iPhone/iPad to the same Wi-Fi network as the machine running APXY
Go to Settings → Wi-Fi → tap your network → Configure Proxy → Manual
Set Server to your machine’s local IP address
Set Port to the APXY proxy port (default 8080)
Open Safari and navigate to the APXY certificate URL shown in the setup instructions
Install the CA certificate: Settings → General → VPN & Device Management → Install
Trust the certificate: Settings → General → About → Certificate Trust Settings → Enable

Android Setup

Connect your Android device to the same Wi-Fi network as the machine running APXY
Go to Settings → Wi-Fi → long press your network → Modify Network → Advanced → Proxy → Manual
Set Proxy hostname to your machine’s local IP address
Set Proxy port to the APXY proxy port (default 8080)
Open Chrome and navigate to the APXY certificate URL shown in the setup instructions
Install the CA certificate: Settings → Security → Encryption & Credentials → Install a certificate → CA certificate

Note: Android 7+ requires additional steps for user-installed CA certificates to be trusted by apps. Apps targeting API level 24+ ignore user certificates by default. You may need to modify the app’s network security config or use a rooted device.

QR Code Setup

For the fastest setup, use the --qr flag to display a QR code:


apxy setup mobile setup --qr

Scan the QR code from your mobile device to open the APXY setup page, which provides device-specific instructions and a one-tap certificate download.

Verifying the Connection

After setup, check that mobile traffic is appearing in APXY:


apxy traffic devices list --mobile

This shows connected mobile devices with their IP, platform, and request count.