Email notifications are GLPI's most critical communication channel with users. An email that doesn't arrive means an ignored ticket. This guide resolves the most common configuration issues.
Basic configuration: SMTP
Go to Configuration > Notifications > Email configuration:
- Sending mode: SMTP
- SMTP server: address of your email server
- Port: 587 (STARTTLS) or 465 (SSL)
- Authentication: Login + Password or OAuth
- Sender email: glpi@suaempresa.com
Gmail (OAuth 2.0)
- Go to Google Cloud Console > APIs & Services > Credentials
- Create an OAuth 2.0 Client ID (type: Web Application)
- Add the GLPI redirect URI
- In GLPI, configure the OAuth provider with Client ID and Client Secret
- Authorize access by clicking the authorization button
Important: App Passwords still work, but OAuth is the recommended and more secure method.
Office 365 / Microsoft 365
- In the Azure Portal, register an application (App Registrations)
- Grant the
Mail.Sendpermission (delegated or application) - Create a Client Secret
- In GLPI, configure SMTP:
smtp.office365.com, port 587, OAuth - Enter Tenant ID, Client ID and Client Secret
Notification templates
Customize emails at Configuration > Notifications > Notification templates:
- New ticket: notifies the requester that the ticket has been registered
- Assignment: notifies the assigned technician
- Follow-up: notifies all parties when there is an update
- Resolution: notifies the requester with the solution
- Satisfaction: sends a satisfaction survey after closure
Use variables such as ##ticket.title##, ##ticket.description##, ##ticket.url## in templates.
Troubleshooting
Emails not arriving
- Check the email queue: Administration > Email queue
- Check that the GLPI cron is running (
front/cron.php) - Test sending directly: send a test email from the interface
- Check GLPI and SMTP server logs
- Check the recipient's spam/junk folder
Authentication error
Gmail and Office 365 block basic authentication (login + password). Use OAuth 2.0 or App Passwords.
Beyond email
For real-time notifications, consider the Smart Notify module (bell in the navbar) or sending via WhatsApp and Telegram.
