# 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>.