Troubleshooting Valet on macOS Sierra

troubleshooting.md

Troubleshooting Valet on Sierra

Common Problems

Problem: I just see "It works!"

Apache is running on port 80 and interfering with Valet.

1. Stop Apache: sudo /usr/sbin/apachectl stop
2. Restart Valet: valet restart

Problem: Valet randomly dies once in a while.

You are probably still on Valet <= 1.1.19, we recommend pinning to ^1.1.22.

1. Edit ~/.composer/composer.json to point to ^1.1.22:

   - "laravel/valet": "^1.1.19",
   + "laravel/valet": "^1.1.22",

2. Run composer global update

3. Restart Valet: valet restart

Problem: Every time I refresh I see a totally random file!

You are running Caddy 0.9.2, which has a known bug related to fastcgi connections.

1. Edit ~/.composer/composer.json to point to ^1.1.22:

   - "laravel/valet": "^1.1.19",
   + "laravel/valet": "^1.1.22",

2. Run composer global update

3. Ensure you are now running Caddy 0.9.1: ~/.composer/vendor/laravel/valet/bin/caddy -version

4. Restart Valet: valet restart

Problem: I'm getting a 502 Bad Gateway error.

Usually this means something is fucked with PHP FPM.

1. Confirm that FPM is not running:

   ps aux | grep fpm

   You should see at least two processes there if PHP FPM is running (one is grep, ignore that one.)

   Chances are PHP FPM is not running.

2. Check the PHP FPM error log to find out why it's not running:

   cat /usr/local/opt/php70/var/log/php-fpm.log

3. Try to resolve any errors you see. Here's a few common ones:

   • /var/run/valet/fpm.socket does not exist
   • Failed to open configuration file /usr/local/etc/php/7.0/php-fpm.conf

Problem: /var/run/valet/fpm.socket does not exist!

If you see an error similar to:

Unable to bind listening socket for address '/var/run/valet/fpm.socket': No such file or directory

...in /usr/local/opt/php70/var/log/php-fpm.log, you were probably running dev-master and have now switched back to tagged releases.

Valet 1.1.22 attempts to automate fixing this issue by explicitly configuring where PHP FPM should listen.

1. Make sure ~/.composer/composer.json points to ^1.1.22:

   - "laravel/valet": "^1.1.19",
   + "laravel/valet": "^1.1.22",

2. Run composer global update

3. Run valet install

Problem: php-fpm.conf is missing!

Something went wrong when installing PHP through Homebrew. This seems to happen on fresh non-upgrade installations of macOS Sierra.

1. Uninstall PHP 7: brew uninstall php70
2. Reinstall PHP 7 from source: brew install php70 --build-from-source
3. Re-run valet install

Where to Look for Errors

If you are still running into problems and are a capable adult, here's a list of log files to check:

• Caddy start log:

  /tmp/com.laravel.valetServer.err

• PHP FPM error log:

  /usr/local/opt/php70/var/log/php-fpm.log

• Caddy error log:

  ~/.valet/Log/error.log

@mnedoszytko Here is the method I used to get everything working:

1. Deleted the ~/.valet directory
2. brew unlink nginx && brew remove nginx
3. brew unlink php56 && brew remove php56 && brew uninstall --ignore-dependencies php56
4. brew unlink php71 && brew remove php71
5. brew unlink dnsmasq && brew remove dnsmasq

After running those steps I did brew update and followed instructions on doing a fresh install. Another caveat, I had my folders already name project.dev so I had to rename them to just project. Hope this helps.

On new macOS Sierra, we were getting no response running ping foobar.dev after installation.

1. rm -rf ~/.valet
2. valet install

Like @RichardStyles mentioned above.

What about something like this, but for Valet 2.0 @adamwathan?

I always got a dns error when I wanted to access the page.
I tried a lot of things, reinstalling, reconfiguring dnsmasq and valet, etc.

What finally worked was simply to change the TLD to .test and it worked!

If anyone is having trouble with "It Works!" and stopping Apache does not solve your issue, something else is running on port 80.

Open Acitvity Monitor>Memory and look for port 80. Unless it's something important, stop it by opening up that process and clicking Stop. Mine was running awdd (Apple/Wireless/Diagnostic/Data). Stopping it solved it for me.

i am having the same problem on mac. installed valet 2.0 and done all the processes to setup valet. but i get 502 bad gateway and all the help above doesnt work

@Maxcutex me too :*( I just bought a new MacBook Pro on Sunday and have been trying to get this rolling for three days now. Crazy, isn't it? Will let u know if I figure out what the issue is (and pls feel free to do the same). Cheers.

Mine also has this issue and I installed a brand new copy of macOS "not" beta at all on it.

Just want to add that before Valet started working for me I had to restart my whole system.

I'm running El Capitan and got the 502 Bad Gateway error. Here's what I did to fix it.

After running this brew list | grep php I saw that I had 4 different versions of PHP installed:

• php
• php71-xdebug
• php72
• [email protected]

So I did the following though I'm not exactly sure which step fixed the 502 error.

brew upgrade nginx - Upgraded Nginx from 1.12.2_1 to 1.15.2

Then, as per this article, ran the following command:

brew list | grep php | while read x; do brew uninstall --force $x;
done

That left me with the following installs of PHP:

• php
• php72

Next, I ran brew upgrade php which upgraded PHP from php 7.2.3_1 to 7.2.9.

Finally, I ran valet install for good measure.

This fixed the 502 Bad Gateway on Mac El Capitan encountered when trying to run Valet.

@EricBusch your solution worked perfectly for me. Thank you!

@EricBusch thanks! For me all I needed to do was upgrade nginx via brew and run valet install. It seemed to be okay with my variety of PHP installs

If anyone has problems with connecting to MySQL, getting Can't read dir of '/usr/local/etc/my.cnf.d' (Errcode: 2 "No such file or directory") or Can't connect to MySQL server on '127.0.0.1' (61), try running the following:

mkdir /usr/local/etc/my.cnf.d.

Brew seems to sometimes prune this folder as specified here: Homebrew/legacy-homebrew#31760.

I had this issue "dyld: Library not loaded: /usr/local/opt/icu4c/lib/libicui18n.62.dylib error" and PHP wasn't being found. Running brew upgrade and brew cleanup fixed it.

Looks like valet is running smoothly and then the next page refresh I just receive ERR_CONNECTION_CLOSED. I tried already restarting, upgrading, etc. I may switch back to manual setup/docker. So sad. The idea behind valet is so nice.