BookStack Logo

How to setup Bookstack Email.

Spread the love

This is how I setup the email on Bookstack. I used the SMTP method as I already have smtp setup on my domain so creating a new email address was quick and easy. My Bookstack environment is installed on a free AWS Ubuntu 20.04 Instance. For more options see the official guide HERE.

The email was setup as follows:

Find the .env file by searching on your server by running the following command:

find / -name *’env

My .env was a hidden file in /var/www/bookstack

How to setup Bookstack Email.- Find .env
How to setup Bookstack Email. 1

Find the file by running the following command:

ls -a

How to setup Bookstack Email.- Find File using Is- A
How to setup Bookstack Email. 2

Edit the .env file:

vim /var/www/bookstack/.env

This will display the .env file:

How to setup Bookstack Email.
How to setup Bookstack Email. 3

The section that need to be updated is the SMTP mail Options:

How to setup Bookstack Email.
How to setup Bookstack Email. 4

My settings were as follows (passwords redacted for security):

How to setup Bookstack Email.
How to setup Bookstack Email. 5

The settings were saved by typing esq plus :wq

The settings were then tested by logging into bookstack as an Admin user and opening Settings:

How to setup Bookstack Email.

And clicking on Maintainance:

How to setup Bookstack Email.
How to setup Bookstack Email. 6

The SEND TEST EMAIL was then pressed:

How to setup Bookstack Email.
How to setup Bookstack Email. 7

If there is an issue with the settings an error message will be shown:

How to setup Bookstack Email.
How to setup Bookstack Email. 8

I originally received this message as I had the MAIL_ENCRYPTION=null when it needed to be MAIL_ENCRYPTION=SSL.

If the settings are correct then you will recieve the following message in the top right of the page:

How to setup Bookstack Email.
How to setup Bookstack Email. 9

You will also receive and email in the logged in user’s inbox:

How to setup Bookstack Email.
How to setup Bookstack Email. 10
How to setup Bookstack Email.
How to setup Bookstack Email. 11

That is the email setup completed. For more Bookstack configuration take a look HERE.

Leave a Comment

Your email address will not be published. Required fields are marked *

Scroll to Top