Skip to main content

Herd Directories and Files

You may find the following files and directories helpful while you are troubleshooting issues with Herd.

Main directory

The main directory contains all the following config files and directories and is a good start when troubleshooting issues with Herd. You may delete this folder if you plan to re-install Herd from scratch.

Binaries

You can find all binaries of Herd in this directory. This includes binaries like composer or expose that ship with Herd as well as downloaded binaries like the latest PHP versions.

Tools

Herd keeps the coding tools of Herd Studio, like opencode and the Herd Devtools helper, as well as the mail server in this directory. Herd updates the Herd Studio tools independently from the app.

Herd Studio

The Herd Studio interface and the data of your agent sessions live in these directories.

Config

All config files for all Herd services live in this directory. You can open it from the general settings via “Configuration Files”.
The herd.json file in this directory contains the settings that Herd shares between the app and the CLI.

nginx

The nginx directory contains a herd.conf and the nginx.conf. Herd uses both to decide which sites it serves and what happens to files. In case you see a Bad Gateway error, there could be an issue in one of these files.
Site-specific Nginx configuration files are located in the following directory:
The nginx configuration also includes the error pages that Herd shows when PHP-FPM doesn’t respond:

Workspaces

Herd keeps track of all workspaces in a workspaces.json file next to the site-specific nginx configuration files.

php

This directory contains all php.ini files for all PHP versions on your machine. If you use Herd Pro, it also contains debug.ini files that Xdebug uses when you enable it for a request. If you’re in debug mode, Herd loads the normal php.ini and applies the debug.ini on top.

Log

Herd stores all logs of nginx and php-fpm in this directory. It may also contain mail logs if you use Herd Pro.