Nothing shows after installing BookStack #1567

New Issue

OVERLORD · 2026-02-05T01:17:16+03:00

OVERLORD commented

2026-02-05 01:17:16 +03:00

Originally created by @jfha73 on GitHub (Mar 4, 2020).

Hey guys,

I just installed BookStack onto the root of a LAMP box using the instructions from your website, but after running composer install and editing .env with my settings when I browse using a web browser what it shows me is the page from Apache when /var/www/html is empty (the Apache Test Page), I also don't see an index.php file, what can I be missing?

Thanks.

Originally created by @jfha73 on GitHub (Mar 4, 2020). Hey guys, I just installed BookStack onto the root of a LAMP box using the instructions from your website, but after running composer install and editing .env with my settings when I browse using a web browser what it shows me is the page from Apache when /var/www/html is empty (the Apache Test Page), I also don't see an index.php file, what can I be missing? Thanks.

OVERLORD closed this issue

2026-02-05 01:17:18 +03:00

OVERLORD commented

2026-02-05 01:17:20 +03:00

@ssddanbrown commented on GitHub (Mar 4, 2020):

Hi @jfha73,
Where are the files on your system? Did you install BookStack directly into /var/www/html or elsewhere?

@ssddanbrown commented on GitHub (Mar 4, 2020): Hi @jfha73, Where are the files on your system? Did you install BookStack directly into /var/www/html or elsewhere?

OVERLORD commented

2026-02-05 01:17:26 +03:00

@amo13 commented on GitHub (Mar 12, 2020):

unfortunately, same for me...
I am on archlinux with nginx, though. Installed to /srv/BookStack with php-tidy loaded and the following nginx config:

server {
    root /srv/BookStack/public;
    listen       8081;
    server_name  localhost;

    index index.php;

    client_max_body_size 100M;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        # default fastcgi_params
        include fastcgi_params;

        # fastcgi settings
        fastcgi_pass			unix:/run/php-fpm/php-fpm.sock;
        fastcgi_index			index.php;
    }
}

The database was created and migrated successfully. The folder containing BookStore is recursively owned by the http user.

Unfortunately, neither nginx nor php-fpm show anything in the logs...

I can tell that it should be running correctly because even though I get a blank page, the favicon shows up correctly in the browser. If I change favicon.ico to favicon.ico.bak and reload the page in the browser, the favicon disappears.

Tested with php 7.3 and 7.4

I also feel like I am just missing something easy, but I am running out of ideas...

@amo13 commented on GitHub (Mar 12, 2020): unfortunately, same for me... I am on archlinux with nginx, though. Installed to /srv/BookStack with php-tidy loaded and the following nginx config: ``` server { root /srv/BookStack/public; listen 8081; server_name localhost; index index.php; client_max_body_size 100M; location / { try_files $uri $uri/ /index.php?$query_string; } location ~ \.php$ { # default fastcgi_params include fastcgi_params; # fastcgi settings fastcgi_pass unix:/run/php-fpm/php-fpm.sock; fastcgi_index index.php; } } ``` The database was created and migrated successfully. The folder containing BookStore is recursively owned by the http user. Unfortunately, neither nginx nor php-fpm show anything in the logs... I can tell that it should be running correctly because even though I get a blank page, the favicon shows up correctly in the browser. If I change favicon.ico to favicon.ico.bak and reload the page in the browser, the favicon disappears. Tested with php 7.3 and 7.4 I also feel like I am just missing something easy, but I am running out of ideas...

OVERLORD commented

2026-02-05 01:17:30 +03:00

@homotechsual commented on GitHub (Mar 12, 2020):

Your PHP unix socket path looks wrong. This is usually /var/run/php/phpVER-fpm.sock; or /run/php/phpVER-fpm.sock

So I'd double check where your PHP sock file actually lives.

@homotechsual commented on GitHub (Mar 12, 2020): Your PHP unix socket path looks wrong. This is usually `/var/run/php/phpVER-fpm.sock;` or `/run/php/phpVER-fpm.sock` So I'd double check where your PHP sock file actually lives.

OVERLORD commented

2026-02-05 01:17:34 +03:00

@amo13 commented on GitHub (Mar 12, 2020):

just double-checked and it definitely is correct. On archlinux /var/run is a symlink to /run and the command ls -l /run/php-fpm/ confirms the result srw-rw---- 1 http http 0 12. Mär 10:42 php-fpm.sock. Besides, if the socket path was wrong, I a pretty sure nginx would throw an error in the logs.

@amo13 commented on GitHub (Mar 12, 2020): just double-checked and it definitely is correct. On archlinux /var/run is a symlink to /run and the command `ls -l /run/php-fpm/` confirms the result `srw-rw---- 1 http http 0 12. Mär 10:42 php-fpm.sock`. Besides, if the socket path was wrong, I a pretty sure nginx would throw an error in the logs.

OVERLORD commented

2026-02-05 01:17:35 +03:00

@homotechsual commented on GitHub (Mar 12, 2020):

Have you got other PHP-FPM applications running on this server? Also what version of PHP-FPM do you have installed?

@homotechsual commented on GitHub (Mar 12, 2020): Have you got other PHP-FPM applications running on this server? Also what version of PHP-FPM do you have installed?

OVERLORD commented

2026-02-05 01:17:37 +03:00

@amo13 commented on GitHub (Mar 12, 2020):

yes, other php applications run just fine. I have both 7.4 and 7.3 installed but neither works. I tested 7.3 by changing the path to the 7.3 sock (/run/php73-fpm/php-fpm.sock)

@amo13 commented on GitHub (Mar 12, 2020): yes, other php applications run just fine. I have both 7.4 and 7.3 installed but neither works. I tested 7.3 by changing the path to the 7.3 sock (`/run/php73-fpm/php-fpm.sock`)

OVERLORD commented

2026-02-05 01:17:43 +03:00

@amo13 commented on GitHub (Mar 12, 2020):

Dang it, I got it. Sorry for the irritation =/
Solution for me was to include the following additional lines to the nginx config:

server {
    root /srv/BookStack/public;
    listen       8081;
    server_name  localhost;

    index index.php;

    client_max_body_size 100M;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        # default fastcgi_params
        include fastcgi_params;

        # fastcgi settings
        fastcgi_pass			unix:/run/php-fpm/php-fpm.sock;
        fastcgi_index			index.php;
        
        fastcgi_buffers			8 16k;
        fastcgi_buffer_size		32k;

        # fastcgi params
        fastcgi_param DOCUMENT_ROOT	$realpath_root;
        fastcgi_param SCRIPT_FILENAME	$realpath_root$fastcgi_script_name;
    }
}

I don't know why these params are necessary, but I will create a quick pull request to include this into the installation guide...
Thank you for your help still!

@amo13 commented on GitHub (Mar 12, 2020): Dang it, I got it. Sorry for the irritation =/ Solution for me was to include the following additional lines to the nginx config: ``` server { root /srv/BookStack/public; listen 8081; server_name localhost; index index.php; client_max_body_size 100M; location / { try_files $uri $uri/ /index.php?$query_string; } location ~ \.php$ { # default fastcgi_params include fastcgi_params; # fastcgi settings fastcgi_pass unix:/run/php-fpm/php-fpm.sock; fastcgi_index index.php; fastcgi_buffers 8 16k; fastcgi_buffer_size 32k; # fastcgi params fastcgi_param DOCUMENT_ROOT $realpath_root; fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name; } } ``` I don't know why these params are necessary, but I will create a quick pull request to include this into the installation guide... Thank you for your help still!

OVERLORD commented

2026-02-05 01:17:46 +03:00

@homotechsual commented on GitHub (Mar 12, 2020):

Those don't go in the installation guide - they should be in your fastcgi_params file in a php-fpm installation.

@homotechsual commented on GitHub (Mar 12, 2020): Those don't go in the installation guide - they should be in your fastcgi_params file in a php-fpm installation.

OVERLORD commented

2026-02-05 01:17:51 +03:00

@amo13 commented on GitHub (Mar 12, 2020):

ok, that's where I'll put the params.
Then no pull request coming ;)
Thank you!

@amo13 commented on GitHub (Mar 12, 2020): ok, that's where I'll put the params. Then no pull request coming ;) Thank you!

OVERLORD commented

2026-02-05 01:17:54 +03:00

@ssddanbrown commented on GitHub (Apr 1, 2020):

Due to the lack of response from the original issue author I will close this.

If this issue remains please feel free to open a new issue, referencing this one.

@ssddanbrown commented on GitHub (Apr 1, 2020): Due to the lack of response from the original issue author I will close this. If this issue remains please feel free to open a new issue, referencing this one.

Sign in to join this conversation.

Branches Tags

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: starred/BookStack#1567