Test connectivity to the ServiceNow instance
Test network connectivity from a device to your ServiceNow instance to confirm that the device can download the agent installation script for DEX.
Before you begin
-
On Windows, download the curl utility with the latest binaries to support mutual Transport Layer Security (mTLS) authentication.
-
From https://curl.se/windows/, download the latest curl zip file and extract it to your local drive.
-
Open a command prompt and set the path to the downloaded curl binary.
For example,
SET PATH=C:\curl-8.12.1_1-win64-mingw\bin;%PATH%.
Note: The curl utility downloaded from the website doesn't replace the existing utility version on your local machine. The new version is applicable to the current CMD session only.
-
-
On macOS, use the curl utility version already installed.
Role required: agent_client_collector_admin
Procedure
-
From the command line, download the
install_script.shby running one of the following curl commands:- Without a proxy:
curl –verbose -L https://<servicenow instance>/api/sn_agent/agents/install_agent -o install_script.sh - With a proxy:
curl --verbose –-proxy <HOST_NAME>:<PORT> -L https://<servicenow instance>/api/sn_agent/agents/install_agent -o install_script.shThe command downloads a script written intoinstall_script.sh.
- Without a proxy:
-
From the All menu, navigate to the Agent scripts [sn_agent_script] table.
-
Select the install_script record and confirm that its content matches the content of the
install_script.shfile.
Result
The match confirms that the connection is established with the ServiceNow instance.
If there’s no match, fix your network connection issues.
---
title: Test connectivity to the ServiceNow instance
description: Test network connectivity from a device to your ServiceNow instance to confirm that the device can download the agent installation script for DEX.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/it-operations-management/digital-end-user-experience-dex/test-connectivity-to-instance.html
release: australia
product: Digital End-User Experience \(DEX\)
classification: digital-end-user-experience-dex
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
keywords: [test instance connectivity, network connectivity, curl test, mtls, mutual transport layer security \(mtls\), test connection to instance]
breadcrumb: [Installing DEX on your local machine, Configure, Digital End-User Experience, IT Operations Management]
---
# Test connectivity to the ServiceNow instance
Test network connectivity from a device to your ServiceNow instance to confirm that the device can download the agent installation script for DEX.
## Before you begin
- On Windows, download the curl utility with the latest binaries to support mutual Transport Layer Security \(mTLS\) authentication.
1. From [https://curl.se/windows/](https://curl.se/windows/), download the latest curl zip file and extract it to your local drive.
2. Open a command prompt and set the path to the downloaded curl binary.
For example, `SET PATH=C:\curl-8.12.1_1-win64-mingw\bin;%PATH%`.
**Note:** The curl utility downloaded from the website doesn't replace the existing utility version on your local machine. The new version is applicable to the current CMD session only.
- On macOS, use the curl utility version already installed.
Role required: agent\_client\_collector\_admin
## Procedure
1. From the command line, download the `install_script.sh` by running one of the following curl commands:
- Without a proxy: `curl –verbose -L https://<servicenow instance>/api/sn_agent/agents/install_agent -o install_script.sh`
- With a proxy: `curl --verbose –-proxy <HOST_NAME>:<PORT> -L https://<servicenow instance>/api/sn_agent/agents/install_agent -o install_script.sh`
The command downloads a script written into `install_script.sh`.
2. From the All menu, navigate to the Agent scripts \[sn\_agent\_script\] table.
3. Select the install\_script record and confirm that its content matches the content of the `install_script.sh` file.
## Result
The match confirms that the connection is established with the ServiceNow instance.
If there’s no match, fix your network connection issues.
| title | Test connectivity to the ServiceNow instance |
| description | Test network connectivity from a device to your ServiceNow instance to confirm that the device can download the agent installation script for DEX. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/australia/it-operations-management/digital-end-user-experience-dex/test-connectivity-to-instance.html |
| release | australia |
| product | Digital End-User Experience \(DEX\) |
| classification | digital-end-user-experience-dex |
| topic_type | task |
| last_updated | 2026-09-10 |
| reading_time_minutes | 1 |
| keywords | test instance connectivitynetwork connectivitycurl testmtlsmutual transport layer security \(mtls\)test connection to instance |
| breadcrumb | Installing DEX on your local machineConfigureDigital End-User ExperienceIT Operations Management |