JBoss.orgCommunity Documentation

Chapter 11. Email

11.1. Email Server Config
11.1.1. Enable SSL or TLS
11.1.2. Authentication

Keycloak sends emails to users to verify their email address. Emails are also used to allow users to safely restore their username and passwords.

To enable Keycloak to send emails you need to provide Keycloak with your SMTP server settings. If you don't have a SMTP server you can use one of many hosted solutions (such as Sendgrid or smtp2go).

To configure your SMTP server, open the Keycloak Admin Console, select your realm from the drop-down box in the top left corner. Then click on Email in the menu at the top.

You are required to fill in the Host and Port for your SMTP server (the default port for SMTP is 25). You also have to specify the sender email address (From). The other options are optional.

The screenshot below shows a simple example where the SMTP server doesn't use SSL or TLS and doesn't require authentication.