---
sourceDocument: Australia Build or modify applications
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/application-development

 Release :

    - australia

ft:locale :

    - pt-BR

ft:publication_title :

    - Australia Build or modify applications

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# Headless Browser troubleshooting

# Headless Browser troubleshooting {#ariaid-title1}

* Versão de lançamento: Australia
* 
* Atualizado 12 de mar. de 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

These tips can help you troubleshoot your Linux or Microsoft
Windows setup of the ServiceNow® Headless Browser for Automated Test Framework.

There are three basic areas to examine when troubleshooting your Headless Browser setup.

## Docker container {#headless-browser-troubleshoot__section_an3_pxd_lpb}

Error logs: When the headless test completes, if there are errors they are generated in the
Docker container. Whether the operation fails or succeeds, the container's
stdout/stderr logs are placed in the
sn_atf_docker_service table.

Headless client test runner did not start in the time allotted message:
This message generally means an error occurred in the Docker container while it was
initializing or starting up. This may indicate something is incorrect in your Docker
container setup. Navigate to the sn_atf_docker_service table to read
the logs and see the error message.

## Instance {#headless-browser-troubleshoot__section_ey1_qxd_lpb}

Error caught running Docker flow when starting the ATF tests messages:
Follow the URL address to find the flow context, which contains the error logs. For example,
the above error message can display when the instance can't access the Docker host.

## Network errors {#headless-browser-troubleshoot__section_rkd_rxd_lpb}

Firewalls: Make sure your firewalls are set up so that the instance can access the host and
port and the server can access the instance.

## Headless Browser action flow diagram {#headless-browser-troubleshoot__section_bc4_1b2_lpb}

Figura 1. Example flow diagram