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

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

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

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 Linux
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 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 the Docker host and run the command `docker secret list` Leave the rest of the fields as they are. Select Save. Parent Topic:Headless Browser setup for Linux Previous topic:Set up instance for Headless Browser in Linux Next topic:Verify Headless Browser procedures in Linux 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.