Skip to content

How to Run Extractor Workers Locally

Last verified: 2026-07-26 against dev at f0388abb.

Use this guide to run SDP with extractor function apps in local Docker Compose.

Standard Commands

Set up extractor app environment:

make setup-extractor-apps-env

Run one extractor plus required services:

make run-<name>-extractor

Accepted names documented by the repo include dummy, docling, adi, excel, and docx.

Run all configured extractors:

make run-extractor-apps

Local Services

The extractor-app local stack can include:

  • Frontend.
  • Backend.
  • SQL database.
  • Service Bus emulator.
  • Blob storage.
  • Function apps.

Boot-Order Caveat

Function apps can pause if Service Bus is not ready when they start. If this happens, restart the function app service or upload a document to trigger queue activity. The first uploaded document after this condition may not process correctly; retry with a second document.

Verification

  • Function app logs show queue subscription.
  • Uploading a document sends a Service Bus message.
  • A batch run reaches completed or a useful failed state.
  • Extracted items appear for the document.

For full details, read extractor_apps/README.md.