# The debusine-worker command

The `debusine-worker` command starts a Worker. It is provided by the `debusine-worker` package.

`debusine-worker` has few options, described in `--help`:

    $ debusine-worker --help
    usage: debusine-worker [-h] [--log-level {DEBUG,INFO,WARNING,ERROR,CRITICAL}]

    Start Debusine worker process: ...

`debusine-worker` is normally run automatically through a systemd unit.

`debusine-worker` expects `sbin` dirs in its `PATH`, which is normally the case when run from systemd.

See also:

> - Set up a Debusine worker

> - Configure and manage a worker

## Command output

`debusine-worker` is meant to be run as a daemon and normally doesn’t directly produce any output. Logs are written to stderr and captured by the systemd journal.

## Return values

Return values of the `debusine-worker` command:

Return value | Meaning
--- | ---
0 | Success
1 | Error: unhandled exception. Please report the error
2 | Error: wrong arguments and options
3 | Error: any other type of error such as invalid configuration file, etc.

## Hooks

It is possible to run a command after the worker completes a task, by adding it to `/etc/debusine/worker/hooks/after-work-request.d`. No information about the task is available to the hook.