---
title: "Feature: #45039 - Command to clean up local processed files"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:feature-45039-1674297405"
source: "Changelog/12.3/Feature-45039-CommandToCleanUpLocalProcessedFiles.rst"
typo3-version: "12.3"
typo3-major: 12
type: "feature"
issue: 45039
forge: "https://forge.typo3.org/issues/45039"
tags: ["CLI", "PHP-API", "ext:lowlevel"]
rendered: "2026-10-08T12:25:00+00:00"
---

# Feature: #45039 - Command to clean up local processed files {#feature-45039-1674297405}

See [forge#45039](https://forge.typo3.org/issues/45039)

## Description {#description}

It is now possible to set up a recurring scheduler task or execute a CLI command
to clean up locally processed files and their database records.

## Impact {#impact}

The command will delete `sys_file_processedfile` records with references to
non-existing files. Also, files in the configured temporary directory
(typically `_processed_`) will be deleted if there are no references to them.

## Example {#example}

Delete files and records with confirmation:

```bash
./bin/typo3 cleanup:localprocessedfiles
```

Delete files and records:

```bash
./bin/typo3 cleanup:localprocessedfiles -f
```

Only show which files and records would be deleted:

```bash
./bin/typo3 cleanup:localprocessedfiles --dry-run -v
```

Please note that the command currently only works for local drivers.