Skip to main content
Configure speedtest providers and set up automated testing schedules in Zepeed.

​
Overview

Zepeed supports multiple speedtest providers to give you flexibility in how you test your internet connection. After enabling providers, you can schedule automatic tests to run at regular intervals and track performance trends over time. Supported providers include:
  • Speedtest Ookla
  • LibreSpeed
  • Cloudflare
  • Netflix (Fast.com)

​
Requirements

  • Zepeed application is installed and running
  • Admin or user access to the dashboard
  • Internet connectivity for running speedtests
  • Configured cron job for automated scheduler (see Scheduling section)

​
Enable a Provider

Zepeed supports multiple speedtest providers out of the box. Follow these steps to enable a provider.
1

Navigate to Settings

From the dashboard, click your profile menu in the top right corner and select Settings.
2

Go to Providers

In the Settings sidebar, click Providers to view available speedtest providers.
3

Enable a provider

Click the Enable button next to the provider you want to use. The button will change to show the provider is now active.
4

Test the provider

Go back to the dashboard and click Run Test. Select the provider you just enabled to verify it works correctly. Wait for the test to complete and check the results show download/upload speeds and ping information.
Make sure your system has internet connectivity and your firewall allows outbound connections to the speedtest provider’s servers.

​
Scheduling

Configure automated speedtests to run on a schedule.

​
Understanding schedules

Zepeed uses cron expressions to define when tests run. A cron expression has five fields: 
┌───────────── minute (0 - 59)
│ ┌───────────── hour (0 - 23)
│ │ ┌───────────── day of month (1 - 31)
│ │ │ ┌───────────── month (1 - 12)
│ │ │ │ ┌───────────── day of week (0 - 7) (Sunday = 0 or 7)
│ │ │ │ │
│ │ │ │ │
* * * * *

​
Create a schedule

1

Navigate to Schedules

From Settings, click Schedules in the sidebar.
2

Click New Schedule

Click the Create Schedule or New Schedule button.
3

Fill in details

Enter the following information:
  • Name: A descriptive name (e.g., “Hourly Test”)
  • Provider: Select which provider to use
  • Cron Expression: Enter the cron pattern for when tests run
  • Description (optional): Notes about this schedule
4

Save

Click Save to create the schedule.

​
Common schedule examples

*/30 * * * *
Runs tests every 30 minutes throughout the day.

​
Enable the scheduler

cron job is already configured in the docker image

​
Manage schedules

​
View active schedules

In the Schedules section, you’ll see a list of all configured schedules with:
  • Schedule name
  • Associated provider
  • Cron expression
  • Next run time
  • Status (enabled/disabled)

​
Edit a schedule

1

Locate the schedule

Find the schedule you want to modify in the Schedules list.
2

Click Edit

Click the Edit button or schedule name.
3

Update details

Modify the name, provider, cron expression, or description.
4

Save changes

Click Save to apply your changes.

​
Disable a schedule

1

Open the schedule

Click on the schedule you want to disable.
2

Toggle status

Click the Disable button or toggle the status switch to off.
3

Confirm

The schedule will stop running, but the configuration is saved for later re-enabling.

​
Delete a schedule

1

Open the schedule

Click on the schedule you want to delete.
2

Click Delete

Click the Delete button.
3

Confirm deletion

Confirm that you want to delete the schedule. This action cannot be undone.

​
Best practices

Stagger test times

Space out scheduled tests to avoid network congestion. Instead of all tests running at the top of the hour, use different minutes (e.g., 5, 25, 45).

Avoid peak hours

Schedule tests during off-peak times when possible to get more accurate baseline speeds. Avoid testing during busy work hours.

Test during consistent conditions

For meaningful comparisons, keep test conditions consistent. Run tests with similar network load and at regular intervals.

Monitor cron logs

Regularly check cron execution logs to ensure schedules are running as expected and catch issues early.

Use multiple providers

Enable multiple providers to get comprehensive data. Different providers may have different server locations and give you varied insights.

Review regularly

Check your dashboard frequently to spot performance trends, anomalies, or issues with specific providers.