Kavita provides an email functionality out of the box to invite users, send reset password links, and more. We currently use a Google account which sends the emails and auto deletes them. However, not all users want to put trust in another party and for this, Kavita offers KavitaEmail microService, so you can use your own SMTP service.
To get started, head over to the KavitaEmail Github and download a release, or use our docker container.
docker run --name kavita-email -p 5003:5003 -e SMTP_HOST="" -e SMTP_PORT="" -e SMTP_USER="" -e SMTP_PASS="" -e SEND_ADDR="" -e DISP_NAME="" -d kizaing/kavitaemail:latest
version: '3'
services:
email:
image: kizaing/kavitaemail:latest
container_name: kavita-email
environment:
- SMTP_HOST=<your smtp hostname here>
- SMTP_PORT=<smtp port>
- SMTP_USER=<smtp username>
- SMTP_PASS=<smtp password>
- SEND_ADDR=<address you are sending emails from>
- DISP_NAME=<display name to use>
ports:
- "5003:5003"
restart: unless-stopped
Once you have setup your KavitaEmail service, you can now link your Kavita instance with KavitaEmail service. Navigate to Server Settings and under Email, you can change the url to your local service (and port if needed). Press Test to ensure it works.