alldigital/PSA
2
0
Fork 0
Code Issues Pull Requests Actions 14 Packages Projects Releases Wiki Activity
PSA/docs/inbound-email/setup/imap.md
Hermes 284313f908
Some checks are pending
Bidi Control Character Guard / bidi-control-guard (push) Waiting to run
Details
Circular Dependency Check / Check for new circular dependencies (push) Waiting to run
Details
Citus Migration Smoke / Combined migrations on single-node Citus (push) Waiting to run
Details
E2E Fresh Install Tests / fresh-install-e2e (push) Waiting to run
Details
ext-v2 guardrails / Run ext-v2 guard and ESLint (push) Waiting to run
Details
Integration Tests / Check for relevant changes (push) Waiting to run
Details
Integration Tests / ${{ (github.event_name == 'schedule' || github.event.inputs.suite == 'full') && 'Full integration suite' || 'Tier-1 integration subset' }} (push) Blocked by required conditions
Details
Mobile checks / Mobile lint + typecheck (push) Waiting to run
Details
Mobile checks / Mobile unit tests (push) Waiting to run
Details
Mobile checks / Mobile dependency audit (report) (push) Waiting to run
Details
Mobile checks / Mobile reproducibility checks (push) Waiting to run
Details
Secrets guard (env backups) / Ensure no tracked env backup files (push) Waiting to run
Details
Temporal Readiness / fast-readiness (push) Waiting to run
Details
Temporal Readiness / docker-parity (push) Waiting to run
Details
TypeScript Type Check / Nx affected typecheck (push) Waiting to run
Details
Unit Tests / Skipped-test budget (push) Waiting to run
Details
Unit Tests / Nx affected unit tests (push) Waiting to run
Details
Unit Tests / Server unit coverage (informational) (push) Waiting to run
Details
Validate Tenant Management Schema / Check for relevant changes (push) Waiting to run
Details
Validate Tenant Management Schema / Validate Tenant Management Schema (push) Blocked by required conditions
Details
EE Workflows Build Guard / ee-workflows-build-guard (push) Waiting to run
Details
Initial import of AlgaPSA codebase from PSA server 
Excluded: .git, node_modules, secrets/, compose.env, assemblyscript tgz

Source: /opt/alga-psa on psa.joliet.tech
2026-06-22 16:12:17 -05:00

1.7 KiB
Raw Permalink Blame History

IMAP In-App Processing Flags

Use these environment variables to control IMAP webhook execution mode for inbound email processing.

Core in-app enablement

  • IMAP_INBOUND_EMAIL_IN_APP_PROCESSING_ENABLED=true
    • Enables IMAP webhook in-app processing for all tenants/providers.
  • IMAP_INBOUND_EMAIL_IN_APP_TENANT_IDS=<tenant-a,tenant-b>
    • Enables IMAP in-app mode for specific tenants.
  • IMAP_INBOUND_EMAIL_IN_APP_PROVIDER_IDS=<provider-a,provider-b>
    • Enables IMAP in-app mode for specific providers.

The IMAP-specific flags are OR-ed with the shared in-app flags:

  • INBOUND_EMAIL_IN_APP_PROCESSING_ENABLED
  • INBOUND_EMAIL_IN_APP_TENANT_IDS
  • INBOUND_EMAIL_IN_APP_PROVIDER_IDS

Unified pointer queue handoff

  • IMAP webhook ingestion now uses unified pointer queue handoff only (handoff: "unified_pointer_queue").
  • Legacy in-memory IMAP async queue controls were removed.
  • IMAP_WEBHOOK_SECRET must be set to the same non-empty random value for the server and email-service containers. The email-service sends it as x-imap-webhook-secret; the server rejects IMAP webhook requests when it is missing or mismatched.

Artifact concurrency bound

  • IMAP_INBOUND_EMAIL_IN_APP_ARTIFACT_CONCURRENCY=1..8
    • Bounds per-message attachment artifact processing concurrency.
  • INBOUND_EMAIL_IN_APP_ARTIFACT_CONCURRENCY=1..8
    • Shared fallback env used when IMAP-specific value is unset.

Ingress caps honored by webhook

  • IMAP_MAX_ATTACHMENT_BYTES
  • IMAP_MAX_TOTAL_ATTACHMENT_BYTES
  • IMAP_MAX_ATTACHMENT_COUNT
  • IMAP_MAX_RAW_MIME_BYTES

The IMAP webhook enforces these caps before in-app persistence and records structured ingressSkipReasons for over-limit artifacts.