Unable to Install BookStack on Laravel Herd #5235

New Issue

OVERLORD · 2026-02-05T09:50:40+03:00

OVERLORD commented

2026-02-05 09:50:40 +03:00

Originally created by @bridgeyuwa on GitHub (Mar 25, 2025).

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

Originally created by @bridgeyuwa on GitHub (Mar 25, 2025). ### Describe the Bug I am trying to install [BookStack](https://www.bookstackapp.com/) 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

OVERLORD added the 🐕 Support label 2026-02-05 09:50:40 +03:00

OVERLORD closed this issue

2026-02-05 09:50:42 +03:00

OVERLORD commented

2026-02-05 09:50:45 +03:00

@ssddanbrown commented on GitHub (Mar 25, 2025):

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.

@ssddanbrown commented on GitHub (Mar 25, 2025): 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](https://herd.laravel.com/docs/windows/advanced-usage/directories-and-files#log), if access logs are provided, to see if your access-request/page-load is being logged.

OVERLORD commented

2026-02-05 09:50:46 +03:00

@gainlinejono commented on GitHub (Mar 30, 2025):

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.

@gainlinejono commented on GitHub (Mar 30, 2025): 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](https://www.bookstackapp.com/docs/admin/installation/) 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. ```php 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.

OVERLORD commented

2026-02-05 09:50:47 +03:00

@ssddanbrown commented on GitHub (Sep 3, 2025):

Since there's been no further follow-up I'm going to close this off.

Thanks @gainlinejono for attempting to help.

@ssddanbrown commented on GitHub (Sep 3, 2025): Since there's been no further follow-up I'm going to close this off. Thanks @gainlinejono for attempting to help.

Sign in to join this conversation.

Branches Tags

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: starred/BookStack#5235