๐Ÿ‡
Speedtest Tracker
  • Introduction
  • Features
  • Changelog
  • ๐Ÿš€Getting Started
    • Installation
      • Using Docker Compose
      • Using Docker
      • Using Kubernetes
      • Using QNAP
      • Using Synology
      • Using Unraid
    • Environment Variables
    • Database Drivers
  • ๐Ÿ†˜Help
    • Error Messages
    • Frequently Asked Questions
  • ๐Ÿ”‘Security
    • Authentication
    • Authorization
    • Encryption
  • โš™๏ธSettings
    • Data Integrations
      • InfluxDB v2
    • Notifications
      • Database
      • Mail
      • Telegram
  • ๐Ÿ‘€Other
    • Speedtest Process
    • Proxies
      • Cloudflare Tunnel (Zero Trust)
      • Traefik
      • Tailscale
    • Caching
    • Commands
    • Data Dictionary
    • Embed Dashboard
    • Health Check
    • Community Projects
  • ๐Ÿ–ฅ๏ธAPI
    • v1
    • Latest Result (deprecated)
  • ๐ŸคนContributing
    • Development Environment
  • ๐Ÿ”—More
    • Source Code
    • Releases
    • Update the Docs
    • About Me
    • Donate
Powered by GitBook
On this page
  • Setting Up SMTP
  • Triggers
  • Recipients
Edit on GitHub
  1. Settings
  2. Notifications

Mail

PreviousDatabaseNextTelegram

Last updated 1 month ago

Notifications sent to the mail channel will be emailed to the list of recipients.

Setting Up SMTP

Speedtest Tracker uses SMTP mail protocol to send email messages, you can use any service that allows you to send emails via SMTP.

To configure the mail server settings you'll need to update the following variables in your .env file or add them to the environment variables passed into the container. When choosing mail scheme both ssl and tls protocols are supported and you'll want to check with your mail provider for which to use and which port.

Make sure these are not set in both your .env file or your docker-compose.yml file as that can cause issues.

MAIL_MAILER=smtp
MAIL_HOST=mailhog
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_FROM_ADDRESS="hello@example.com"
MAIL_FROM_NAME="Speedtest Tracker"
MAIL_SCHEME=null

GMAIL example:

Steps for creating an app password.

  • Select Security.

  • Under "How you sign in to Google," choose 2-Step Verification.

  • Click on App passwords.

  • Enter a name and generate a password.

  • Remember to copy the password before closing; otherwise, you'll need to create another one.

MAIL_MAILER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=465
MAIL_USERNAME=username@gmail.com
MAIL_PASSWORD="password"
MAIL_FROM_ADDRESS=username@gmail.com
MAIL_FROM_NAME="Speedtest Tracker"
MAIL_SCHEME=tls

Triggers

Name
Description

On completed speedtest

On each successful speedtest a notification will be send to the application.

On absolute threshold failure

On any absolute threshold failure a notification will be send to the application.

Recipients

A recipient is any valid email address, you can add one or many recipients that will receive notifications based on the triggers selected.

Go to your .

โš™๏ธ
Google Account
Mail settings