Configure the Mac mini host for network payload capture

Learn how to configure your local Cloud or Standalone Kobiton Mac mini host so you and your team can use network payload capture during a manual session or automation session.

Before you start

You’ll need to:

  • Access the Mac mini host as the deviceconnect user for all the operations below.

  • Make sure the Mac mini is connected to a network that satisfies the network requirements for Network Payload Capture before proceeding.

Install Rosetta (for Mac mini with Apple Silicon)

This section is only required for Mac mini host with Apple Silicon.

Open Terminal on the Mac mini host.

Run the below command to install Rosetta:

softwareupdate --install-rosetta --agree-to-license

Modify the dc.ini file

Edit the dc.ini file from the location /usr/local/deviceconnect/ using any text editor (Create a backup of the dc.ini file prior to making updates).

Check if the below content exists in the file. Otherwise, append the content to the end of the file.

Make sure the below is under the [set] tag, not [config]. 
# Payload Capture
DeviceNetworkCapture.NetworkCaptureProxyHost=[deviceConnect IP address]
DeviceNetworkCapture.NetworkCaptureProxyIsLocal=true
DeviceNetworkCapture.NetworkCaptureProxyControlPort=8225
DeviceNetworkCapture.NetworkCaptureProxyHttpListenPort=8080
DeviceNetworkCapture.TimeoutConnectSeconds=10
DeviceNetworkCapture.Trace=true
DeviceNetworkCapture.ExternalDebugLog=false

Replace [deviceConnect IP address] with the local IP address of the Mac mini host. You can retrieve the local IP address of the Mac mini by either:

  • Navigating to Settings > Network > Ethernet or Wi-Fi and copying the IP address value. For Wi-Fi, click the Details… button next to the connected network to view the IP.

  • Opening Terminal, then entering the ifconfig command. The IP address is usually under the e `en0 entry (for Etheret) or en1 entry (for Wi-Fi), next to inet.

    example of ifconfig command
    en0: flags=8863<UP,BROADCAST,SMART,RUNNING,SIMPLEX,MULTICAST> mtu 1500
	options=50b<RXCSUM,TXCSUM,VLAN_HWTAGGING,AV,CHANNEL_IO>
	ether **:**:**:**:ad:a1
	inet6 fe80::140b:b7b:e8a0:c90f%en0 prefixlen 64 secured scopeid 0x4
	inet 192.168.50.86 netmask 0xffffff00 broadcast 192.168.50.255

en1: flags=8863<UP,BROADCAST,SMART,RUNNING,SIMPLEX,MULTICAST> mtu 1500
	options=6460<TSO4,TSO6,CHANNEL_IO,PARTIAL_CSUM,ZEROINVERT_CSUM>
	ether **:**:**:**:**:19
	inet6 fe80::1834:8865:82ea:2b5c%en1 prefixlen 64 secured scopeid 0x7
	inet 192.168.50.118 netmask 0xffffff00 broadcast 192.168.50.255
If the Mac mini is connected to more than 1 network at the same time (for example, both Ethernet and Wi-Fi), make sure [deviceconnect IP address] is the IP address obtained from the interface that is connected to the same network as the mobile devices.

Save the file, then restart services on the Mac mini host to apply the changes.

Next steps

Configure the Android and iOS devices for network payload capture.