---
title: "Running the scheduler: typo3 scheduler:run"
manual: "Scheduler"
version: "13.4"
permalink: "https://docs.typo3.org/permalink/typo3/cms-scheduler:scheduler-shell-script@13.4"
source: "Administration/ConsoleTools/Running.rst"
rendered: "2026-10-03T08:24:46+00:00"
---

# Running the scheduler: typo3 scheduler:run {#scheduler-shell-script}

The scheduler provides a PHP shell script designed to be run using
TYPO3's command-line dispatcher. To try and run that script a first
time, type the following command.

**Composer-based installation**

```bash
vendor/bin/typo3 scheduler:run
```

**Classic installation**

```bash
typo3/sysext/core/bin/typo3 scheduler:run
```

See also [TYPO3 Explained: Run a command from the command line](https://docs.typo3.org/m/typo3/reference-coreapi/13.4/en-us/ApiOverview/CommandControllers/Index.html#symfony-console-commands-cli).

**Table of contents**

-   [Show help](https://docs.typo3.org/permalink/typo3/cms-scheduler:show-help@13.4)
-   [Providing options to the shell script](https://docs.typo3.org/permalink/typo3/cms-scheduler:providing-options-to-the-shell-script@13.4)

## Show help {#scheduler-shell-script-help}

In order to show help:

**Composer-based installation**

```bash
vendor/bin/typo3 scheduler:run --help
```

**Classic installation**

```bash
typo3/sysext/core/bin/typo3 scheduler:run --help
```

## Providing options to the shell script {#scheduler-shell-script-options}

The shell scripts accepts a number of options which can be provided in any
order.

### `--task (-i)` {#scheduler-shell-script-options-i}

To run a specific scheduler task you need to provide the uid of the task:

**Composer-based installation**

```bash
# Run task with uid 42
vendor/bin/typo3 scheduler:run --task=42

# Run tasks with uid 3 and 14
vendor/bin/typo3 scheduler:run --task=3 --task=14
```

**Classic installation**

```bash
# Run task with uid 42
typo3/sysext/core/bin/typo3 scheduler:run --task=42

# Run tasks with uid 3 and 14
typo3/sysext/core/bin/typo3 scheduler:run --task=3 --task=14
```

The tasks will be executed in the order in which the parameters are provided.

### `--force (-f)` {#scheduler-shell-script-options-f}

To run a task even if it is disabled (or not scheduled to be run yet),
you need to provide the force option:

**Composer-based installation**

```bash
# Run task with uid 42, even if disabled
vendor/bin/typo3 scheduler:run --task=42 --force
```

**Classic installation**

```bash
# Run task with uid 42, even if disabled
typo3/sysext/core/bin/typo3 scheduler:run --task=42 --force
```

This will also run the task with uid 42 if it is disabled.

### `--verbose (-v)` {#scheduler-shell-script-options-v}

A single `-v` flag will output errors only. Two `-vv` flags will also output
additional information:

**Composer-based installation**

```bash
# Run task with uid 42, with detailed stack traces
vendor/bin/typo3 scheduler:run --task=42 -vv
```

**Classic installation**

```bash
# Run task with uid 42, with detailed stack traces
typo3/sysext/core/bin/typo3 scheduler:run --task=42 -vv
```