Headless Browser setup for Microsoft Windows › Headless Browser for Automated Test Framework › Automated Test Framework \(ATF\) › Testing and debugging applications › Building applications

Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Configure Automated Test Framework (ATF) for Headless Browser in Microsoft Windows

Step 7 in the Microsoft Windows setup for the ServiceNow® Headless Browser for ATF: Configure ATF with properties.

Before you begin

Complete Step 6: Set up instance for Headless Browser in Microsoft Windows

Role required: admin on your ServiceNow instance and local administrator on the host machine.

Now that your connection and authentication are set up, you will configure ATF with several properties so that it can start containers successfully on the host machine.

Procedure

In your instance, navigate to ATF > Administration > Properties.
Enable the top two properties: Enable test/test suite execution and Enable scheduled test suite execution.
Scroll down to the Headless Runner Properties section.
Enable the top check box.
Enter the following values in the Headless Runner Properties form:

Form Label	Property Name	Value to Imput
The user account used to login from the headless Client Test Runner and begin the tests	sn\_atf.headless.username	Username of the integration user that you created in Add secrets to Docker for Headless Browser setup in Microsoft Windows
The Docker secret ID that has the password stored of the user account	sn\_atf.headless.secret\_id	Docker “secret ID” that you obtained earlier, as well as the Docker secret name that you created in Step 2 of the Add secrets to Docker for Headless Browser setup in Microsoft Windows procedure.
The Docker image that is used for headless Client Test Runner	sn\_atf.headless.docker\_image\_name	Image name with tag that you downloaded: `ghcr.io/servicenow/atf-headless-runner:` `Note: If you forgot the secret ID, go to Windows host and run the command docker secret list.` At the The absolute path of the secret file on a docker container field, enter: `C:\ProgramData\Docker\secrets\<YOUR SECRET NAME>` Leave the rest of the fields as they are. Select Save. Parent Topic:Headless Browser setup for Microsoft Windows Previous topic:Set up instance for Headless Browser in Microsoft Windows Next topic:Verify Headless Browser procedures for ATF in Microsoft Windows sndocs is an independent community mirror and is not affiliated with or endorsed by ServiceNow. ServiceNow, the ServiceNow logo, Now, and other ServiceNow marks are trademarks and/or registered trademarks of ServiceNow, Inc., in the United States and/or other countries. Other company and product names may be trademarks of the respective companies with which they are associated. © 2026 ServiceNow, Inc. All rights reserved. Documentation content is redistributed under the Apache License 2.0 from the ServiceNowDocs repository.