BookStack Configuration

Environment Settings

Bookstack stores custom settings file .env within its active directory, /var/www/bookstack/ this is where you will go to modify most settings within your bookstack instance. Check the GitHub link below for a complete list of environment variables on the active release branch.


APP_URL environment variable must lead with http:// OR https:// and end with /
such as OR ttps://
Any form of the following will cause URL redirect issues: OR OR

Mail Setup

To allow BookStacks to send mail using Google's free mail server, ensure that your .env settings within your bookstack directory ( /var/www/bookstack/.env ) contains the below.

# The below url has to be set if using social auth options
# or if you are not using BookStack at the root path of your domain.


Test sending mail with the commands below - echo "This email confirms that Postfix is working" | mail -s "Testing Posfix"

If you have a firewall, be sure you open the port you enter on line 9 for MAIL_PORT

You must have a valid HTTPS certificate configured, if you are using DigitalOcean. See the link below.
DO - DNS Records
Knoats - NGINX SSL Configuration