Be part of JetBrains PHPverse 2026 on June 9 – a free online event bringing PHP devs worldwide together.

RoboRobok's avatar

Is there any Homestead up to date documetation?

There's new Homestead with Zend Z-Ray installed. It causes an error for me:

Zend Server Failed to communicate with Zend Server. See why...

Are Homestead changes documented somewhere else than in it's vague official documentation?

It's not the first time when something new appears there and there is nothing about it in the documentation. Previously, dynamic mapping stopped working without any warning or information.

So here's my 3 questions:

  • Which source do you guys use to get up to date with Homestead? Anything more than Github?
  • How to fix Zend Z-Ray problem or disable it entirely?
  • How to fix dynamic mapping? They used to accept dynamic tokens in "sites" section of Homestead.yaml, but now they don't, because they cause the invalid certificate to be created.
0 likes
8 replies
XenitXTD's avatar

So

I dont know if this helps anyone but here are two links I peeked into... I wanted mine disabled didnt want to get it working but this shows how its configured and also optionally how to disable

Tested it and working... I just ran the rm -rf /opt/zray

then just halt the vm and start it up again and the zray is removed.

https://laravel-news.com/installing-zend-z-ray-on-homestead https://www.joeferguson.me/homestead-welcomes-z-ray-by-zend/

Must say this was an irritating non optional enable that should have been optional.

crouchingHamster's avatar

Steps I used to remove ZRay:

Update Homestead => 7.0.1 to 7.1.2 Add zray: "false" in Homestead.yaml file:

sites:
    -
        map: site.localhost
        to: /home/vagrant/code/public
        zray: "false"

Destroyed vagrant box, then created to pick up updated yaml file.

zray: 'false' is a fix added in Homestead 7.1.2

source:

https://www.reddit.com/r/laravel/comments/7w0eqb/homestead_710_zray_getting_in_the_way/

https://www.joeferguson.me/homestead-welcomes-z-ray-by-zend/

Nash's avatar

Tip: sometimes checking out the Vagrant docs might help. After all, Homestead is just a pre-packaged Vagrant box.

https://www.vagrantup.com/docs/

@Cronix, @RoboRobok The current version of Homestead in Vagrant cloud appears to be 5.1.0: https://app.vagrantup.com/laravel/boxes/homestead

...BUT it seems like that might actually be the current version for laravel/settler and that the actual version for Homestead really is 7.1.2?

https://github.com/laravel/settler

https://github.com/laravel/homestead/releases

1 like
RoboRobok's avatar

@crouchingHamster

It's interesting, because I just reinstalled Homestead and the bar disappeared. Seems like false is the default, not sure why I had the bar visible before, as I've been using the newest version all the time.

daniloesser's avatar

I solved it!!

Here are the steps to make it work:

1 - add zray: 'true' in the site section, in Homestead.yaml file.

2 - edit /opt/zray/runtime/etc/zs_ui.ini file and change the zend_gui.defaultPort to 8000 as shown above:

[installation] zend_gui.defaultPort = 8000

Please or to participate in this conversation.