---
sourceDocument: Australia Build or modify applications
sourceDocumentLink: https://www.servicenow.com/docs/r/application-development

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Build or modify applications

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

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

# Configure Automated Test Framework (ATF) for Headless Browser in Microsoft
Windows {#ariaid-title1}

* Release version: Australia
* 
* Updated March 12, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

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](https://www.servicenow.com/docs/d0x1aUN1chyAJTKFKTdbMw "Step 6 in the Microsoft Windows setup for the ServiceNow Headless Browser for ATF: Set up your instance so it can support the Headless Browser.")

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

1. In your instance, navigate to ATFAdministrationProperties.
2. Enable the top two properties: Enable test/test suite execution and Enable scheduled test suite execution.
3. Scroll down to the Headless Runner Properties section.
4. Enable the top check box.
5. Enter the following values in the Headless Runner Properties form:  
   {#headless-browser-configure-atf-windows__table_xzf_wtf_mqb__entry__3}

   | 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](https://www.servicenow.com/docs/F_SoRtGP6P91uC7XYsTlPg "Create a Docker secret that stores the password of the ServiceNow user who will log into the instance to execute the tests. Docker Secrets is a feature of ServiceNow for securely storing the passwords that will be used in containers.") |
   | 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](https://www.servicenow.com/docs/F_SoRtGP6P91uC7XYsTlPg "Create a Docker secret that stores the password of the ServiceNow user who will log into the instance to execute the tests. Docker Secrets is a feature of ServiceNow for securely storing the passwords that will be used in containers.") 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:<tagname>` |
   [ ]

   {#headless-browser-configure-atf-windows__table_xzf_wtf_mqb}  
   Note:  
   If you forgot the secret ID, go to Windows host and run the command docker secret list.
6. At the The absolute path of the secret file on a docker container field, enter: `
   C:\ProgramData\Docker\secrets\<YOUR SECRET NAME> `
7. Leave the rest of the fields as they are.
8. Select Save.
{#headless-browser-configure-atf-windows__steps_xby_sff_jpb}
**Previous topic:** [Set up instance for Headless Browser in Microsoft Windows](https://www.servicenow.com/docs/d0x1aUN1chyAJTKFKTdbMw "Step 6 in the Microsoft Windows setup for the ServiceNow Headless Browser for ATF: Set up your instance so it can support the Headless Browser.")  
**Next topic:** [Verify Headless Browser procedures for ATF in Microsoft Windows](https://www.servicenow.com/docs/IhZDqB0XDyGC~ZOB4Sfamw "Verify that your Headless Browser setup procedures have been successful.")

*[\>]: and then