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: |
-
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
--- title: Configure ATF for Headless Browser in Linux description: Step 6 in the Linux setup for the ServiceNow Headless Browser for ATF: Configure ATF with properties. locale: en-US canonical_url: https://www.servicenow.com/docs/r/australia/application-development/automated-test-framework-atf/headless-browser-configure-atf.html release: australia product: Automated Test Framework \(ATF\) classification: automated-test-framework-atf topic_type: task last_updated: "2026-09-10" reading_time_minutes: 2 breadcrumb: [Headless Browser setup for Linux, Headless Browser for Automated Test Framework, Automated Test Framework \(ATF\), Testing and debugging applications, Classic app development, Building applications] --- # 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](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/automated-test-framework-atf/headless-browser-instance-setup.md) 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 **ATF** > **Administration** > **Properties**. 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: <table id="table_xzf_wtf_mqb"><thead><tr><th> Form Label </th><th> Property Name </th><th> Value to Imput </th></tr></thead><tbody><tr><td> The user account used to login from the headless client test runner and begin the tests </td><td> sn\_atf.headless.username </td><td> Username of the integration user that you created in [Add secrets to Docker for Headless Browser setup in Linux](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/automated-test-framework-atf/headless-browser-add-secrets-docker.md) </td></tr><tr><td> The Docker secret ID that has the password stored of the user account </td><td> sn\_atf.headless.secret\_id </td><td> 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://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/automated-test-framework-atf/headless-browser-add-secrets-docker.md) procedure. </td></tr><tr><td> The Docker image that is used for headless Client Test Runner </td><td> sn\_atf.headless.docker\_image\_name </td><td> Image name with tag that you downloaded: `ghcr.io/servicenow/atf-headless-runner:<tagname>` </td></tr></tbody> </table> **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**. **Parent Topic:**[Headless Browser setup for Linux](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/automated-test-framework-atf/headless-browser-procedure-linux.md) **Previous topic:**[Set up instance for Headless Browser in Linux](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/automated-test-framework-atf/headless-browser-instance-setup.md) **Next topic:**[Verify Headless Browser procedures in Linux](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/automated-test-framework-atf/headless-browser-verify-tests.md)
This file has no frontmatter.