BookStacks 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.

https://github.com/BookStackApp/BookStack/blob/release/.env.example.complete

App URL

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

Mail Setup

To ~~setup~~allow ~~mailing~~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.

~~APP_URL~~ ~~environment~~ ~~variable~~ ~~must~~ ~~lead with~~ ~~http://~~ OR ~~https://~~ ~~and end with~~ /
~~such as~~ ~~http://website.com/~~ OR ~~https://website.com/~~
~~Any form of the following will cause URL redirect issues:~~
~~www.website.com~~ OR ~~website.com~~ OR ~~subdomain.website.com~~

# 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.
APP_URL=https://knoats.com/

#Mailsettings
MAIL_DRIVER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_USERNAME=email@gmail.com
MAIL_PASSWORD=password
MAIL_ENCRYPTION=tls
MAIL_FROM=email@gmail.com

Test sending mail with the commands below -

echo "This email confirms that Postfix is working" | mail -s "Testing Posfix" emailuser@example.com

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

You must have HTTPS certificate and loadbalancer configured, if you are using DigitalOcean. See the links below.
~~https://www.digitalocean.com/docs/networking/load-balancers/how-to/lets-encrypt/~~DO - Load Balancers
~~https://www.digitalocean.com/docs/networking/dns/how-to/manage-records/~~DO - DNS Records