First page is failed to open properly - 404 was caught when bookstack in subfolder #3581

New Issue

OVERLORD · 2026-02-05T07:05:14+03:00

OVERLORD commented

2026-02-05 07:05:14 +03:00

Originally created by @to-blue-sky on GitHub (Mar 8, 2023).

Describe the Bug

ENV:
xampp : php 8.2 + maria 10.4 + apache 2
os : windows server 2019
composer get module and artisan initial db both correct , no mistake.

Findings:
no need to define anything at apache vhost conf, as bookstack/public/.htaccess has already included everything in manual, means manual does not provide any help .
[https://www.bookstackapp.com/docs/admin/subdirectory-setup/](official link)

#documentroot must be existed, can lead to first page, otherwise 403 or 500

vhost.conf
<VirtualHost *:80>

    #ServerName 192.168.0.88/bookstack

    DocumentRoot "/SERVER/WEB-XAMPP/htdocs/bookstack/public"

    <Directory "/SERVER/WEB-XAMPP/htdocs/bookstack/public">

    </Directory>

</VirtualHost>

server name is not a must element, even ### this , no impact

remark : nothing need to fill in directory block

http://192.168.0.88/bookstack - list folder
http://192.168.0.88/bookstack/public - auto jump into login, cannot load css + res**

for good side ,most 403 500 problems are solved in this way.
but the problem left is app.js 404 , no css or any res can be captured .

refer stackof + laravel official + tons of web pages..., most are pointing to uri problem, but no clear instruction to guide.

By guess , since laravel 404 is such usual problem to all users , lots app are facing in many many boards... to be fair - not only bookstack.

should any suggestion ...

Steps to Reproduce

<Directory "/SERVER/WEB-XAMPP/htdocs/bookstack/public">

#nothing need

this step cannot skip,

seems .htaccess is almost the killer...

Expected Behaviour

in docker , bookstack is placed on the root, everything is fine.
but sick in /www or /htdocs

Screenshots or Additional Context

no need

Browser Details

firefox + edge +chrome all up to date

Exact BookStack Version

"GET /bookstack/dist/app.js?version=v23.02.1 HTTP/1.1" 404 8013

PHP Version

8.2

Hosting Environment

winsrv 2019 + xampp
php 8.2 + maria +10.4 + apache 2 + ntfs
apache httpd.conf / overwrite all + grant all /
bookstakc folder / overwrite all + grant all / everything in bookstack folder is listed in web page
443 is no need , ssl conf is nothing, all mods turn on,
normal php apps are working properly like piwigo , phpmyadmin, crm tiki ....

Originally created by @to-blue-sky on GitHub (Mar 8, 2023). ### Describe the Bug ENV: xampp : php 8.2 + maria 10.4 + apache 2 os : windows server 2019 composer get module and artisan initial db both correct , no mistake. Findings: no need to define anything at apache vhost conf, as bookstack/public/.htaccess has already included everything in manual, means manual does not provide any help . [https://www.bookstackapp.com/docs/admin/subdirectory-setup/](official link) **#documentroot must be existed, can lead to first page, otherwise 403 or 500** ``` vhost.conf <VirtualHost *:80> #ServerName 192.168.0.88/bookstack DocumentRoot "/SERVER/WEB-XAMPP/htdocs/bookstack/public" <Directory "/SERVER/WEB-XAMPP/htdocs/bookstack/public"> </Directory> </VirtualHost> ``` server name is not a must element, even ### this , no impact remark : nothing need to fill in directory block http://192.168.0.88/bookstack - list folder http://192.168.0.88/bookstack/public - auto jump into login, cannot load css + res** for good side ,most 403 500 problems are solved in this way. **but the problem left is app.js 404 , no css or any res can be captured .** refer stackof + laravel official + tons of web pages..., most are pointing to uri problem, but no clear instruction to guide. By guess , since laravel 404 is such usual problem to all users , lots app are facing in many many boards... to be fair - not only bookstack. should any suggestion ... ### Steps to Reproduce <Directory "/SERVER/WEB-XAMPP/htdocs/bookstack/public"> #nothing need </Directory> this step cannot skip, seems .htaccess is almost the killer... ### Expected Behaviour in docker , bookstack is placed on the root, everything is fine. but sick in /www or /htdocs ### Screenshots or Additional Context no need ### Browser Details firefox + edge +chrome all up to date ### Exact BookStack Version "GET /bookstack/dist/app.js?version=v23.02.1 HTTP/1.1" 404 8013 ### PHP Version 8.2 ### Hosting Environment winsrv 2019 + xampp php 8.2 + maria +10.4 + apache 2 + ntfs apache httpd.conf / overwrite all + grant all / bookstakc folder / overwrite all + grant all / everything in bookstack folder is listed in web page 443 is no need , ssl conf is nothing, all mods turn on, normal php apps are working properly like piwigo , phpmyadmin, crm tiki ....

OVERLORD added the 🐛 Bug label 2026-02-05 07:05:14 +03:00

OVERLORD closed this issue

2026-02-05 07:05:18 +03:00

Sign in to join this conversation.

Branches Tags

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: starred/BookStack#3581