Providers and schedule

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

Every 30 minutes

*/30 * * * *

Runs tests every 30 minutes throughout the day.

Every hour

0 * * * *

Runs at the top of every hour (9:00, 10:00, 11:00, etc.).

Twice daily

0 8,20 * * *

Runs at 8:00 AM and 8:00 PM daily.

Every 4 hours

0 */4 * * *

Runs at midnight, 4 AM, 8 AM, noon, 4 PM, and 8 PM.

Business hours

0 9-17 * * 1-5

Runs hourly from 9 AM to 5 PM, Monday through Friday.

Daily at 2 AM

0 2 * * *

Runs once daily at 2:00 AM (good for low-traffic times).

Weekly on Monday

0 8 * * 1

Runs every Monday at 8:00 AM.

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.

Related pages

• Webhooks - Push results to external systems
• Email notifications - Get alerts for speed drops
• API reference - Programmatic access to test data