Troubleshooting
Logs
Valet's logs are in ~/.config/valet/Log. Nginx errors are written to ~/.config/valet/Log/nginx-error.log.
"You have missing Valet dependencies"
Valet checks for jq, xsel and certutil before privileged commands. Install the OS packages for your distribution.
"SELinux is in enforcing mode"
Set SELinux to permissive mode or run valet install --ignore-selinux. See Requirements → SELinux.
"Valet home directory is inside /root"
You ran Valet as root or with sudo. Run it as your regular (sudo-enabled) user.
The Valet 404 page
When Valet cannot serve a request it shows a 404 page explaining why:
| Reason | What it means | What to do |
|---|---|---|
| Site not found | The host is not linked or inside a parked directory | Run valet link inside the project, or valet park in its parent directory |
| No driver | The site exists, but no driver recognized the project | Check that the linked folder is correct and that the entry point (e.g. public/index.php) exists, or write a custom driver |
| Page not found | The site was served, but the requested URL does not exist | Check the URL and your application's routes |
Sites stopped resolving
valet restart
If it persists, run valet install again — it is safe and keeps your configuration.