Skip to Content

Troubleshootingturno browser doctor

There is no display for a headed Chrome

What turno browser doctor means by "no display: a headed Chrome cannot open here", and the fix.

View source

This page is for when turno browser doctor reports the finding below: what it means and how to fix it.

What you see

  !  no display: a headed Chrome cannot open here
     manual: pass --headless to turno-browser-mcp, or run it inside a desktop session

It is a warning; warnings do not change the exit code.

Why it happens

turno-browser drives a headed Chrome, and this session has no display.

Fix

Pass --headless to turno-browser-mcp, or run it inside a desktop session.

No single command fixes this one, so doctor names the manual step.

Then run turno browser doctor again to see the row turn into ok.

The check lives in packages/browser/src/doctor.ts.

On this page