Skip to content

Docs: self-hosting compose generator missing worker-executions service (1.9.0)Β #3056

@scottgrobinson

Description

@scottgrobinson

πŸ’­ Description

Area: Self-hosting β†’ Docker Compose generator (src/lib/components/compose-generator/composeData.ts).

The generated self-hosting docker-compose.yml is missing the appwrite-worker-executions service introduced in Appwrite 1.9.0.

In 1.9.0, execution persistence moved to a dedicated executions worker (entrypoint worker-executions, Appwrite\Platform\Workers\Executions) that consumes the v1-executions queue and writes the execution document. The generated compose only includes the schedule-executions scheduler β€” there is no worker-executions service β€” so nothing drains v1-executions. On self-hosted installs this means:

  • Scheduled executions are never recorded.
  • Async executions get stuck in status: waiting forever.
  • Synchronous executions still work (the API persists them inline), which masks the problem.

The queue silently accumulates (~46k stranded jobs observed on an affected instance). Adding the worker drains the backlog and executions persist as completed.

Fix: add the appwrite-worker-executions service to the compose generator β€” PR #3055.

Note: the same omission exists in the main appwrite/appwrite compose template (app/views/install/compose.phtml), which likely needs a matching fix.

(Replaces #3054, opened with the wrong template.)

πŸ‘€ Have you spent some time to check if this issue has been raised before?

  • I checked and didn't find similar issue

🏒 Have you read the Code of Conduct?

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions