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

ChrisF79's avatar

Laravel Herd only serves up "File not found." regardless of what I do.

I have Laravel Herd installed on my Mac. My sites are in the ~/code/ folder. Herd sees the sites and I can click on the location of the site in Herd's "Sites" panel and it takes me right to the right folder. No matter what I do, I still get "File not found" when I try to load the sites. They are 2 Wordpress sites by the way.

What I have tried

  • Uninstall Laravel Valet
  • Completely uninstall and reinstall Herd
  • Moved my sites over to the ~/Herd/ directory
  • Rebooted after reinstalling
  • Since they're Wordpress sites, they aren't in the public directory so I made a public directory and put the site files in there. It still doesn't work.
  • Changed the permission of the directory to 755.
  • Ran laravel new laraveltest and created that site. Went to laraveltest.test and it shows "File not found."

I have no idea what else I could do at this point but it is simply broken. Any ideas?

I appreciate everyone's help!

0 likes
5 replies
LaryAI's avatar
Level 58

It sounds like Laravel Herd’s Nginx/PHP setup isn’t able to find your site’s entry point, which is why you’re seeing "File not found." Here are some steps and checks to help you resolve this:

1. Check Directory Structure

For Laravel projects, Herd expects a public directory as the web root. For WordPress, the web root should be where your index.php and wp-config.php files are.

If you moved your WordPress files into a public directory, make sure:

  • All WordPress files (including index.php, wp-config.php, wp-content, etc.) are inside the public directory.
  • Herd is pointing to the correct directory as the web root.

2. Check Herd’s Site Configuration

Open Herd, go to the "Sites" panel, and ensure the path for each site is set to the directory containing your site’s entry point (public for Laravel, or wherever your index.php is for WordPress).

For WordPress:

  • If your site is at ~/code/mysite, and the files are in ~/code/mysite/public, Herd should point to ~/code/mysite/public.

For Laravel:

  • Herd should point to ~/code/laraveltest/public.

3. Permissions

Make sure your user has read permissions for all files and directories in your site folders.

chmod -R 755 ~/code/mysite

4. Restart Herd

After making changes, restart Herd to reload the configuration.

5. Check for .test Domain Resolution

Make sure .test domains are resolving to 127.0.0.1. You can check this by running:

ping mysite.test

If it doesn’t resolve, try running:

herd link

from your project directory to re-link the site.

6. Check Nginx/PHP Logs

Herd logs can provide clues. Open Herd, go to the "Logs" section, and look for errors related to your site.

7. Try a Simple index.php

To isolate the issue, create a simple index.php in your site’s web root:

<?php
phpinfo();

If this works, the problem is with your application files. If not, the problem is with Herd’s configuration or your system.


Summary Checklist

  • Herd’s site path points to the correct directory (where index.php is).
  • All site files are in the right place.
  • Permissions are correct.
  • .test domains resolve to 127.0.0.1.
  • Herd is restarted after changes.
  • Logs show no critical errors.

If you follow these steps and still get "File not found," please share:

  • The full path Herd is using for your site.
  • A screenshot of your directory structure.
  • Any relevant log output from Herd.

This will help further diagnose the issue!

ChrisF79's avatar

Thank you to the AI but none of that helped. Here is the directory structure:

Screenshot of my folder structure.

Here is the screenshot of my Sites panel in Herd:

Screenshot of my Herd sites panel.

And here is my http://crmceo.test:

Screenshot of chrome loading crmceo.test

Here is a screenshot of my ping successfully reaching crmceo.test

Screenshot of chrome loading crmceo.test

##HELP!##

Snapey's avatar

@ChrisF79 Can you find the nginx logs?

Look in ~/Library/Application Support/Herd/Log

Please or to participate in this conversation.