# The scheduler

Starting with RPort 0.7.0 a centralized cron-like scheduler has been introduced.

### Prerequisites

Both, the server and the clients must **run at least version 0.7.0** of Rport to use the scheduler. Updating all your clients is not necessary as long as you don't want to run scheduled scripts on them.

{% hint style="info" %}
The scheduler runs only on the RPort server. Jobs are dispatched when due to the clients as regular script or command execution. All [security filters](https://github.com/cloudradar-monitoring/rport/blob/0.6.0/rport.example.conf#L139-L184) are applied.\
**If a client is disconnected, a job will not be caught up.**
{% endhint %}

### For a single client

#### Create a schedule

Click on the `Commands` or `Scripts` tab of a client. Enter the script or command that you want to execute. You can execute it right away to verify it's doing what is it supposed to do. To execute the command or script at a given time, click the gray `Schedule` button. Using cron syntax, you can then specify the execution interval. Cron syntax is used for Windows, Linux and macOS. 

![Create a script or command first](https://1142160776-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MekeI9EovpQqbUTQSdM%2Fuploads%2F5uA9hWxSk2q9DSnKUJaw%2Fschedule-create.png?alt=media\&token=1c691c5c-0e6c-4419-a0f8-80b895572925) ![Schedule a command or script](https://1142160776-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MekeI9EovpQqbUTQSdM%2Fuploads%2Fr7WpVAR13hBhryhLjUg6%2Fschedule-cron.png?alt=media\&token=59869294-8b73-47e3-a6e9-75a6be44c2a7)

#### Supervise schedules

From the "Schedules" tab, you get access to the reports. You can verify the success of all schedules jobs. 

![List of schedules and their status](https://1142160776-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MekeI9EovpQqbUTQSdM%2Fuploads%2Fas9qPbMXseGx0QPTuLJl%2Fschedule-report.png?alt=media\&token=6d2fe84d-eb64-4b13-8997-9f5bf4a53a54) ![Detailed report](https://1142160776-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MekeI9EovpQqbUTQSdM%2Fuploads%2FnToy6zZPfmWSRU0zBDMH%2Fschedule-report-details.png?alt=media\&token=f7329482-010f-4ad5-bcfa-7108fbc3369d)

### For multiple clients

#### Create a schedule

Scheduling a script are command for multiple clients works similar to executing scripts are commands. Click on the global `Command` or `Scripts` icon on the main menu on the left side. 

Select on which clients a script or command should be executed. Instead of executing right away, klick on `Schedule`.

![Schedule a script for multiple clients](https://1142160776-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MekeI9EovpQqbUTQSdM%2Fuploads%2F8XWhmkW398boeARWlV1u%2Fmulti-schedule-create.png?alt=media\&token=9d9bcf15-012b-46e2-92f5-563a66d46ed2)

#### Supervise schedules

Using the global `Schedules` section accessed from the main menu on the left side, you can supervise all schedules. Those created for a single client and those created for multiple clients.

![Supervise schedules on a global level.](https://1142160776-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MekeI9EovpQqbUTQSdM%2Fuploads%2FVNQtGJX93ZHmqxjl9PlM%2Fmulti-schedule-reports.png?alt=media\&token=8ef5baf2-5da5-403a-9313-f947bd61f40d)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kb.openrport.io/digging-deeper/the-scheduler.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.