Run Browser tests in headed mode when using Sail

[backstageel]

I use Laravel Sail in my development environment and I am wondering if there is any way to run Pest Browser tests in headed mode(view the browser interactions) on that setup.

My tests run using "sail artisan test" without problem, even the browser tests. But since I am using Sail, I cant just run "./vendor/bin/pest test --debug" because it can't find the database connection. Running "sail artisan test --debug" complains about not having a Xserver.

Is there any way to make it work? Like redirect sail to open the browser from the host?

[antero111]

Has someone been able to get this fixed? Still having the same issues.

[edgarandrade-ib]

Hello! I was able to get the headed display to work on sail based on this blog post: https://www.istogram.com/blog/pest-browser-testing-with-laravel-sail-on-wsl2

I added this on my docker-compose.yml:

environment: DISPLAY: ':0' volumes: - /tmp/.X11-unix:/tmp/.X11-unix:rw

Afterward I ran this command in the terminal: xhost +local:docker

Hope it helps!

Edit: I'm on a native Ubuntu machine

[0x346e3730]

Hello! I was able to get the headed display to work on sail based on this blog post: https://www.istogram.com/blog/pest-browser-testing-with-laravel-sail-on-wsl2

I added this on my docker-compose.yml:

environment: DISPLAY: ':0' volumes: - /tmp/.X11-unix:/tmp/.X11-unix:rw

Afterward I ran this command in the terminal: xhost +local:docker

Hope it helps!

Edit: I'm on a native Ubuntu machine

I've tried this but got no luck, nothing happens, Ubuntu 25.10 (I'm not running sail but a "custom" Docker setup too)