# Running Wildnet as a Utility

Last updated on : 10 Jan 2026

## Overview

Wildnet enables Pcloudy users to test local or private sites on any Android/iOS device available on the Pcloudy platform. This feature supports both manual and automation testing.

Private servers have no public access and are typically internal to your network or staging environments. Wildnet bridges this gap by allowing you to test these private servers on real devices hosted on Pcloudy.

## Prerequisites

- Active Pcloudy account registration
- Downloaded Pcloudy Desktop Assistant for your OS (refer to Install PDA documentation)

## Download Executables

- Linux
- Windows
- OSX

> **Note:** If you encounter installation issues, set the appropriate permissions:

```java
sudo chmod 777 <filename>
```

### Example:

```java
sudo chmod 777 ./pCloudyWildNetMac_v2.2
```

## Manual Testing with Wildnet

### Step 1: Start the Wildnet Service

Run the appropriate command for your operating system (refer to Quick Actions tab for email and API Key):

Windows:

```bash title="Windows"
.<filename> -i <email> -k <api_access_key> -u <cloud_URL>
```

Mac:

```bash title="Mac"
./<filename> -i <email> -k <api_access_key> -u <cloud_URL>
```

Linux:

```bash title="Linux"
./<filename> -i <email> -k <api_access_key> -u <cloud_URL>
```

Example:

```bash title="Example"
./pCloudyWildNetWindows_v1 -i sample@test.com -k pass123 -u https://device.pcloudy.com
```

### Cloud URLs

Use the appropriate URL for your cloud instance:

| Cloud Type | URL |
|------------|-----|
| Public (India) | https://device.pcloudy.com |
| Public (US) | https://us.pcloudy.com |
| Private | https://&lt;private-cloud&gt;.pcloudy.com |

> **Note:** Once authenticated, you can connect multiple devices simultaneously.

### Step 2: Enable Wildnet on Pcloudy Platform

1. Navigate to the Start page on the Pcloudy platform
2. Connect to your desired device
3. Click on Enable Local Testing
4. Open your local URL/App and begin testing

## Automation Testing with Wildnet

### Step 1: Start the Wildnet Service

Run the executable command for your operating system:

Windows:

```bash title="Windows"
.pCloudyWildNetWindows -i <email> -k <access_key> -u
```

Mac:

```bash title="Mac"
./pCloudyWildNetOSX -i <email> -k <access_key> -u
```

Linux:

```bash title="Linux"
./pCloudyWildNetLinux -i <email> -k <access_key> -u
```

### Step 2: Add Wildnet Capability to Your Script

Once successfully authenticated, add the following capability to your Appium automation script:

```java title="Java"
capabilities.setCapability("pCloudy_WildNet", true);
```

### Step 3: Execute Your Tests

After adding the capability, you're ready to test your internal server. You can monitor execution on the live view page.

## Stopping the Wildnet Service

### Method 1: Terminal Interruption

Press `Ctrl + C` in the terminal window where the Wildnet service is running.

### Method 2: Process Termination

Windows:
1. Open Task Manager (`Ctrl + Shift + Esc`)
2. Find the Wildnet process
3. Right-click and select "End Task"

Mac/Linux:

```bash title="Bash"
## Find the process ID:
ps aux | grep pCloudyWildNet

## Kill the process:
kill <process_id>
```

## Troubleshooting

If you encounter any issues:

1. Verify your email and API access key are correct
2. Ensure you're using the correct cloud URL for your instance
3. Check that the executable has proper permissions
4. Confirm your firewall allows the connection

For additional support, contact Pcloudy support team.