Can't send e-mail #1473

New Issue

OVERLORD · 2026-02-05T01:00:19+03:00

OVERLORD commented

2026-02-05 01:00:19 +03:00

Originally created by @AlphaJack on GitHub (Dec 8, 2019).

I want BookStack to send e-mail for login verification and password reset requests. The credentials I'm using work on other services on my server, but on BS I can't get rid of this red error:

Email confirmation required but the system could not send the email. Contact the admin to ensure email is set up correctly.

My relevant .env settings look like

MAIL_DRIVER=smtp
MAIL_HOST=smtp.sendgrid.net
MAIL_PORT=587
MAIL_FROM=server@example.com
MAIL_FROM_NAME=Example-Server
MAIL_USERNAME=Username
MAIL_PASSWORD=Password
MAIL_ENCRYPTION=tls
#MAIL_ENCRYPTION=null
#MAIL_ENCRYPTION=ssl
#MAIL_ENCRYPTION=""

I've also added APP_DEBUG=true but I can't read anything on the log regarding stmp.
I've also tried php artisan config:clear and php artisan config:cache after every change, but without success.

Configuration:

Exact BookStack Version: BookStack v0.27.5
PHP Version: 7.4
Hosting Method: Nginx

Originally created by @AlphaJack on GitHub (Dec 8, 2019). I want BookStack to send e-mail for login verification and password reset requests. The credentials I'm using work on other services on my server, but on BS I can't get rid of this red error: ``` Email confirmation required but the system could not send the email. Contact the admin to ensure email is set up correctly. ``` My relevant .env settings look like ```ini MAIL_DRIVER=smtp MAIL_HOST=smtp.sendgrid.net MAIL_PORT=587 MAIL_FROM=server@example.com MAIL_FROM_NAME=Example-Server MAIL_USERNAME=Username MAIL_PASSWORD=Password MAIL_ENCRYPTION=tls #MAIL_ENCRYPTION=null #MAIL_ENCRYPTION=ssl #MAIL_ENCRYPTION="" ``` I've also added `APP_DEBUG=true` but I can't read anything on the log regarding stmp. I've also tried `php artisan config:clear` and `php artisan config:cache` after every change, but without success. Configuration: - Exact BookStack Version: BookStack v0.27.5 - PHP Version: 7.4 - Hosting Method: Nginx

OVERLORD closed this issue

2026-02-05 01:00:23 +03:00

OVERLORD commented

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

@John-OShea-Wordbank commented on GitHub (Jan 12, 2020):

I can't help with this error directly but can confirm we're able to send emails via SendGrid using an API key. Here's the BookStack config we're using:

MAIL_DRIVER=smtp
MAIL_FROM=mail@bookstack.wordbank.com
MAIL_FROM_NAME=BookStack

MAIL_HOST=smtp.sendgrid.net
MAIL_PORT=587
MAIL_USERNAME=apikey
MAIL_PASSWORD=SENDGRID_API_KEY_PASSWORD_HERE
MAIL_ENCRYPTION=tls

@John-OShea-Wordbank commented on GitHub (Jan 12, 2020): I can't help with this error directly but can confirm we're able to send emails via SendGrid using an API key. Here's the BookStack config we're using: ``` MAIL_DRIVER=smtp MAIL_FROM=mail@bookstack.wordbank.com MAIL_FROM_NAME=BookStack MAIL_HOST=smtp.sendgrid.net MAIL_PORT=587 MAIL_USERNAME=apikey MAIL_PASSWORD=SENDGRID_API_KEY_PASSWORD_HERE MAIL_ENCRYPTION=tls ```

OVERLORD commented

2026-02-05 01:00:32 +03:00

@AlphaJack commented on GitHub (Jan 20, 2020):

Thank you, I've tried to use the API but nothing changed. I ended up doing a clean install of BookStack and a full update of its dependencies.
It is working now, the problem wasn't about the MAIL fields.

@AlphaJack commented on GitHub (Jan 20, 2020): Thank you, I've tried to use the API but nothing changed. I ended up doing a clean install of BookStack and a full update of its dependencies. It is working now, the problem wasn't about the MAIL fields.

Sign in to join this conversation.

Branches Tags

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: starred/BookStack#1473