---
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 ATF for Headless Browser in Linux

# Configure ATF for Headless Browser in Linux {#ariaid-title1}

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

Step 6 in the Linux setup for the ServiceNow®
Headless Browser for ATF: Configure ATF with properties.

## Before you begin

Complete Step 5: [Set up instance for Headless Browser in Linux](https://www.servicenow.com/docs/Ivk6qY14Kgb0jgKQyocMwQ "Step 5 in the Linux 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.

This task: Now that you've set up your connection and authentication, 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__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 Linux](https://www.servicenow.com/docs/M1U_YbVrKpZW6KVeteFpwA "Create a Docker secret, which 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 Linux](https://www.servicenow.com/docs/M1U_YbVrKpZW6KVeteFpwA "Create a Docker secret, which 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__table_xzf_wtf_mqb}  
   Note:  
   If you forgot the secret ID, go to the Docker host and run the command `docker secret list`
6. Leave the rest of the fields as they are.
7. Select Save.
**Previous topic:** [Set up instance for Headless Browser in Linux](https://www.servicenow.com/docs/Ivk6qY14Kgb0jgKQyocMwQ "Step 5 in the Linux 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 in Linux](https://www.servicenow.com/docs/EOQGIDEfXziKfjiPxdxRBQ "Step 7, the final step in the Linux setup for the ServiceNow Headless Browser for ATF: Verify that your Headless Browser setup procedures are successful.")

*[\>]: and then