---
title: "system.net.getRemoteServers"
description: "This function returns a List of Gateway Network servers that are visible from the local Gateway."
---

# system.net.getRemoteServers

> This function returns a List of Gateway Network servers that are visible from the local Gateway.

This function is used in **Python Scripting**.

## Description
This function returns a list of Gateway Network servers that are visible from the local Gateway.

## Client Permission Restrictions
This scripting function has no [Client Permission](../../../ignition-modules/vision/vision-project-properties/vision-project-properties.md#vision-permissions-properties) restrictions.

## Syntax
`system.net.getRemoteServers([runningOnly])`

### Parameters
Type | Parameter | Description 
------- | ------- | ------
Boolean | `runningOnly`| If set to true, only servers on the Gateway Network that are running will be returned. Servers that have lost contact with the Gateway Network will be filtered out. [optional]

### Returns

**List[String]** - A list of strings representing Gateway Network server IDs.

### Scope

Gateway, Vision Client, Perspective Session

## Code Examples
```python title="Code Snippet"
# The following will create a list of running servers on the Gateway Network, and show the list in a message box.
 
# Collect the list of running servers
runningServers = system.net.getRemoteServers(True)
  
# Initialize the start of the message
serverStatusText = "The following servers are running:\n "
# Add each running server to the message
for server in runningServers:
    serverStatusText += "%s \n" % server
  
# Show the message
system.vision.showMessage(serverStatusText)
```