LinuxCommandLibrary

pueue-reset

Clear all tasks from the Pueue queue

TLDR

Kill all tasks and remove everything (logs, status, groups, task IDs)

$ pueue reset
copy

Kill all tasks, terminate their children, and reset everything
$ pueue reset --children
copy

Reset without asking for confirmation
$ pueue reset [[-f|--force]]
copy

SYNOPSIS

pueue reset [--force]

PARAMETERS

--force
    Bypass the confirmation prompt, executing the reset immediately.

DESCRIPTION

The pueue reset command is a powerful tool to completely clean the state of the pueue daemon. It removes all pending, running, and finished tasks. This includes the task history and any temporary files associated with the tasks. Be extremely cautious when using this command, as it results in permanent data loss of your pueue task information.

It essentially wipes the slate clean, allowing you to start with a fresh pueue instance, free of any previous job information. Use this when encountering severe issues with the pueue daemon or when a clean start is desired. If pueue daemon is running, command will stop it before process the reset operation.
It's generally used in development or debugging to handle unexpected server states.

CAVEATS

Using pueue reset is a destructive operation. All task data, including logs and any results produced by the tasks, will be irrevocably lost. Ensure this is the desired outcome before running the command.

CONFIRMATION

Without the --force flag, pueue reset will prompt for confirmation before executing. This helps prevent accidental data loss. Always consider the ramifications before confirming.

USE CASES

Common scenarios for using pueue reset include:
- Recovering from corrupted pueue database files.
- Starting a new project with a fresh queue.
- Completely removing all task data for privacy or security reasons.
- Resetting after debugging to ensure a clean slate before deployment.

SEE ALSO

pueue start(1), pueue stop(1), pueue clear(1), pueue remove(1)

Copied to clipboard