mirror of
https://github.com/BookStackApp/BookStack.git
synced 2026-02-10 19:06:16 +03:00
Email setup on Ubuntu 20.04- Over my head! #1960
Closed
opened 2026-02-05 02:19:59 +03:00 by OVERLORD
·
3 comments
No Branch/Tag Specified
development
l10n_development
release
llm_only
vectors
v25-11
docker_env
drawio_rendering
user_permissions
ldap_host_failover
svg_image
prosemirror
captcha_example
fix/video-export
v25.12.3
v25.12.2
v25.12.1
v25.12
v25.11.6
v25.11.5
v25.11.4
v24.11.4
v25.11.3
v25.11.2
v25.11.1
v25.11
v25.07.3
v25.07.2
v25.07.1
v25.07
v25.05.2
v25.05.1
v25.05
v25.02.5
v25.02.4
v25.02.3
v25.02.2
v25.02.1
v25.02
v24.12.1
v24.12
v24.10.3
v24.10.2
v24.10.1
v24.10
v24.05.4
v24.05.3
v24.05.2
v24.05.1
v24.05
v24.02.3
v24.02.2
v24.02.1
v24.02
v23.12.3
v23.12.2
v23.12.1
v23.12
v23.10.4
v23.10.3
v23.10.2
v23.10.1
v23.10
v23.08.3
v23.08.2
v23.08.1
v23.08
v23.06.2
v23.06.1
v23.06
v23.05.2
v23.05.1
v23.05
v23.02.3
v23.02.2
v23.02.1
v23.02
v23.01.1
v23.01
v22.11.1
v22.11
v22.10.2
v22.10.1
v22.10
v22.09.1
v22.09
v22.07.3
v22.07.2
v22.07.1
v22.07
v22.06.2
v22.06.1
v22.06
v22.04.2
v22.04.1
v22.04
v22.03.1
v22.03
v22.02.3
v22.02.2
v22.02.1
v22.02
v21.12.5
v21.12.4
v21.12.3
v21.12.2
v21.12.1
v21.12
v21.11.3
v21.11.2
v21.11.1
v21.11
v21.10.3
v21.10.2
v21.10.1
v21.10
v21.08.6
v21.08.5
v21.08.4
v21.08.3
v21.08.2
v21.08.1
v21.08
v21.05.4
v21.05.3
v21.05.2
v21.05.1
v21.05
v21.04.6
v21.04.5
v21.04.4
v21.04.3
v21.04.2
v21.04.1
v21.04
v0.31.8
v0.31.7
v0.31.6
v0.31.5
v0.31.4
v0.31.3
v0.31.2
v0.31.1
v0.31.0
v0.30.7
v0.30.6
v0.30.5
v0.30.4
v0.30.3
v0.30.2
v0.30.1
v0.30.0
v0.29.3
v0.29.2
v0.29.1
v0.29.0
v0.28.3
v0.28.2
v0.28.1
v0.28.0
v0.27.5
v0.27.4
v0.27.3
v0.27.2
v0.27.1
v0.27
v0.26.4
v0.26.3
v0.26.2
v0.26.1
v0.26.0
v0.25.5
v0.25.4
v0.25.3
v0.25.2
v0.25.1
v0.25.0
v0.24.3
v0.24.2
v0.24.1
v0.24.0
v0.23.2
v0.23.1
v0.23.0
v0.22.0
v0.21.0
v0.20.3
v0.20.2
v0.20.1
v0.20.0
v0.19.0
v0.18.5
v0.18.4
v0.18.3
v0.18.2
v0.18.1
v0.18.0
v0.17.4
v0.17.3
v0.17.2
v0.17.1
v0.17.0
v0.16.3
v0.16.2
v0.16.1
v0.16.0
v0.15.3
v0.15.2
v0.15.1
v0.15.0
v0.14.3
v0.14.2
v0.14.1
v0.14.0
v0.13.1
v0.13.0
v0.12.2
v0.12.1
v0.12.0
v0.11.2
v0.11.1
v0.11.0
v0.10.0
v0.9.3
v0.9.2
v0.9.1
v0.9.0
v0.8.2
v0.8.1
v0.8.0
v0.7.6
v0.7.5
v0.7.4
v0.7.3
0.7.2
v.0.7.1
v0.7.0
v0.6.3
v0.6.2
v0.6.1
v0.6.0
v0.5.0
Labels
Clear labels
🎨 Design
📖 Docs Update
🐛 Bug
🐛 Bug
:cat2:🐈 Possible duplicate
💿 Database
☕ Open to discussion
💻 Front-End
🐕 Support
🚪 Authentication
🌍 Translations
🔌 API Task
🏭 Back-End
⛲ Upstream
🔨 Feature Request
🛠️ Enhancement
🛠️ Enhancement
🛠️ Enhancement
❤️ Happy feedback
🔒 Security
🔍 Pending Validation
💆 UX
📝 WYSIWYG Editor
🌔 Out of scope
🔩 API Request
:octocat: Admin/Meta
🖌️ View Customization
❓ Question
🚀 Priority
🛡️ Blocked
🚚 Export System
♿ A11y
🔧 Maintenance
> Markdown Editor
pull-request
Mirrored from GitHub Pull Request
No Label
🐕 Support
Milestone
No items
No Milestone
Projects
Clear projects
No project
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: starred/BookStack#1960
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Originally created by @mtnyaeger on GitHub (Dec 9, 2020).
I am currently trying out bookstack on a droplet with Ubuntu 20.04 install. This was a blank state before I ran the script to install Bookstack from Github. Install went fine and the product works except for email. When I test email I receive the following error.
"Error thrown when sending a test email: Connection could not be established with host localhost :stream_socket_client(): unable to connect to localhost:1025 (Connection refused)"
I realized that I had provided no setup[ for a smtp server. Now I am lost everything seems to be for a different platform. I finally worked out how to edit the .env file through FTP on the root level. it was blank so I added
MAIL_DRIVER=smtp
Host, Port & Encryption mechanism to use (has a pound sign before it)
MAIL_HOST=smtp.office365.com
MAIL_PORT=465
MAIL_ENCRYPTION=tls
Authentication details for your SMTP service (has a pound sign before it)
MAIL_USERNAME=Joe@smurfs.com
MAIL_PASSWORD=1234
MAIL_DRIVER=sendmail
The "from" email address for outgoing email (has a pound sign before it)
MAIL_FROM=Joe@smurfs.com
The "from" name used for outgoing email (has a pound sign before it)
MAIL_FROM_NAME=BookStack
Code to it and overwrote the file that existed. Rebooted the droplet and nothing changed. What do I not know? Do I need to install a mail service of some type or am I editing the wrong file? I am okay at programming but am not trained and this is the first droplet Linux server I have ever dealt with. Thanks
@ssddanbrown commented on GitHub (Dec 10, 2020):
Hi @mtnyaeger,
If that file was blank or missing then you're likely not editing the correct file in the right place. After an install using the Ubuntu 20.04 install script you'll find the
.envfile at the location/var/www/bookstack/. You should see lots of other files and folders there also. If you cannot see a.envfile there please check your FTP software for an option to view hidden files. Files starting with a dot are often hidden in the world of linux.When you edit that file you should not need to reboot the server, Should be able to just change the mail settings then re-click the "Send Test Email" button in BookStack.
Make sure you only set one
MAIL_DRIVERoption when editing that file. Usingsmtpwill then use the details of theMAIL_HOST,MAIL_PORTandMAIL_ENCRYPTION.That's okay, We've all been there. Entering the world of linux, and the weeds of web hosting setups, can be a steep hill to climb but will be very handy for future endeavours, especially if handy with programming.
@KieranFJ commented on GitHub (Dec 10, 2020):
The MAIL_PORT= i believe should also be 587 as i recently set up our installation with a office365 mail account. Works a treat.
@mtnyaeger commented on GitHub (Dec 10, 2020):
@ssddanbrown Thank you this was a huge help.
I had FTP connected to root thinking I was at the top of the hierarchy. However, since you listed the path I needed tried going up a level and found what I needed. I correct the proper .env file and changed the port to 587 which I had tried originally but could not get to work.
@KieranFJ Thank you as well