2 Email Verification and Registration

1. After having your Bookstack running it is essential to create email verification for registration and allow users to receive emails for password resets. Email verification is not the only way or safest way but it will definitely get your starting quick. To set this up we need to enter the .env file that is located at (if you followed this guide)

 cd docker/bookstack/bookstack_app_data/www

2. After entering the folder we will nano into it with

nano .env

3. We then need to fill in the email information that sits at the bottom of the file

# Mail system to use
# Can be 'smtp' or 'sendmail'
MAIL_DRIVER=smtp

# Mail sender details
MAIL_FROM_NAME="Bookstack Name"
[email protected]

# SMTP mail options
# These settings can be checked using the "Send a Test Email"
# feature found in the "Settings > Maintenance" area of the system.
# For more detailed documentation on mail options, refer to:
# https://www.bookstackapp.com/docs/admin/email-webhooks/#email-configuration
MAIL_HOST=smtp.mailserver.com
MAIL_PORT="587"
MAIL_USERNAME="[email protected]"
MAIL_PASSWORD="passwordofyouremail"
MAIL_ENCRYPTION=tls

Note the " " for the Mail port, username and password. For some reason I did not get it working without the " ". So if you have the same problem please use " " for these values

4. Then restart your container for the changes to take effect

5. To check if your emails work enter your bookstack instance and go to Settings > Maintenance > Sent a Test Email. If you get a green confirmation message you are all set.

6. If you then want to allow registration by email verification you can set this up at Settings > Registration. 

Require email confirmation