Unable to Install BookStack on Laravel Herd

[bridgeyuwa]

Describe the Bug

I am trying to install BookStack on Laravel Herd but encountering issues. Despite following the installation steps, I am unable to get it running properly.

Steps to Reproduce

Installed Laravel Herd and ensured PHP and MySQL are properly set up.

Cloned the BookStack repository and ran composer install.

Configured .env with the correct database credentials.

Ran php artisan migrate

Attempted to start the application.

Expected Behaviour

BookStack should install successfully and be accessible via the configured local domain. (eg bookstack.test)

The application does not load at all.

Screenshots or Additional Context

No response

Browser Details

Chrome on Windows 11

Exact BookStack Version

v25.02

[ssddanbrown]

Hi @bridgeyuwa, I'm not really familiar with Laravel herd, so I've also never tested using it.

• What exactly do you see in the browser upon attempted access?
• Do you get redirected at all? (Check URL bar for any changes on access)

Maybe check the nginx logs, if access logs are provided, to see if your access-request/page-load is being logged.

[gainlinejono]

Hi @bridgeyuwa

In Laravel Herd it's quite simple to set up BookStack. By default you need to ensure that you have a parked directory, this means that any site within this host directly is automatically picked up by Herd and then served from the <directory_name>.test domain.

In this instance, i have a Herd directory, i then cloned the repository into the Herd folder as a subdirectory named BookStack, in Herd, if you refresh the sites list, you'll then see bookstack.test listed.

After this, run cp .env.example .env and make the necessary configuration changes, i followed the instructions provided.

If you're using Herd Pro, you'll likely have a MySQL instance, use 127.0.0.1 for the host, root for the user and a blank password, ensure you've created your database in the MySQL instance and that this as the database name.

Next you'll want to run the following commands in this order.

composer install
php artisan key:generate
php artisan migrate
npm install
npm run build

Once all these have been completed, visit the bookstack.test URL and you'll everything working as expected.