Troubleshoot Linux Environment Issues for AIQ CI

Last reviewed: September 30, 2026

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

What changed in this article

• Fixed the duplicated title “Issues with Linux Environments Issues with Linux Environments.”
• Reframed the content around AIQ CI and Linux execution-host troubleshooting.
• Added checks for browser dependencies, display/headless settings, filesystem permissions, environment variables, network/proxy configuration, and logs.

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.

Review note: This page now removes duplicate title noise and gives a concrete Linux troubleshooting path.

Last updated: September 30, 2026

If you have feedback on this topic, contact documentation@appvance.ai.