Skip to content

Configuration

Glossia is configured at runtime using environment variables. Some configuration is required for Glossia to function, and they'll get checked at startup, failing if they're not present.

The following sections describe the configuration variables that are available organized by category.

Email

Glossia needs to send emails to users and therefore needs an SMTP server or a service to send them. To configure the SMTP server, you can set the following environment variables:

VariableDescriptionRequiredDefaultValid values
GLOSSIA_EMAIL_ADAPTERThe email adapter to use for sending emails (e.g., SMTP).Yessmtp
GLOSSIA_EMAIL_SMTP_RELAYThe SMTP server to relay emails through.Yes
GLOSSIA_EMAIL_SMTP_USERNAMEThe username for authenticating with the SMTP server.Yes
GLOSSIA_EMAIL_SMTP_PASSWORDThe password for authenticating with the SMTP server.Yes
GLOSSIA_EMAIL_SMTP_PORTThe port to connect to the SMTP server.Yes
GLOSSIA_EMAIL_SMTP_RETRIESThe number of retries for sending emails.No3
GLOSSIA_EMAIL_SMTP_NO_MX_LOOKUPSWhether to skip MX lookups when sending emails.Nofalsetrue, false
GLOSSIA_EMAIL_SMTP_AUTHThe authentication method to use with the SMTP server.Noif_availablealways, never, if_available
GLOSSIA_EMAIL_SMTP_SSLWhether to use SSL for the SMTP connection.Nofalsetrue, false
GLOSSIA_EMAIL_SMTP_TLSWhether to use TLS for the SMTP connection.Noif_availablealways, never, if_available

NOTE

If you'd like to use a service's API directly, we accept contributions adding support for any of the available adapters.