The fastdotcom integration uses the web service to measure network bandwidth performance.

Currently, the integration only supports measuring download bandwidth. If you want to measure bandwidth metrics other then download such as ping and upload, utilize the integration.

Enabling this integration will automatically create the Sensor.

By default, a speed test will be run every hour. The user can change the update frequency in the configuration by defining the scan_interval for a speed test to run.


To add to your installation, add the following to your configuration.yaml file:

Once per hour, on the hour (default):


Every half hour of every day:

      minutes: 30

Configuration Variables

scan_interval time (Optional, default: 60 minutes)

Minimum time interval between updates. Supported formats: scan_interval: 'HH:MM:SS', scan_interval: 'HH:MM' and Time period dictionary (see example below).

manual boolean (Optional, default: false)

Turn manual mode on or off. Manual mode will disable scheduled speedtests.

Time period dictionary example

  # At least one of these must be specified:
  days: 0
  hours: 0
  minutes: 3
  seconds: 30
  milliseconds: 0


Once loaded, the fastdotcom integration will expose a service (fastdotcom.speedtest) that can be called to run a speed test on demand. This service takes no parameters. This can be useful if you have enabled manual mode.

  service: fastdotcom.speedtest


  • When running on Raspberry Pi 3 or older, the maximum speed is limited by its 100 Mbit/s LAN adapter.
  • The sensor will return the maximum measured speed during a 15-second test.
  • Speed tests consume data depending on your internet speed, make sure to consider this if your internet connection has limited bandwidth.