Troubleshoot Linux Environment Issues for AIQ CI

Use this article when AIQ executions or CI jobs fail because of Linux host, browser, display, dependency, permission, or environment configuration issues.

Validation workflow

1. Collect the CI job log, AIQ/Test Node log, browser log, and host package/runtime versions.
2. Check Linux display/headless configuration, permissions, dependencies, proxy/network access, and working directory paths.
3. Run a minimal scenario on the same host before changing the full CI pipeline.

Last updated: October 19, 2026