alldigital/PSA
2
0
Fork 0
Code Issues Pull Requests Actions 13 Packages Projects Releases Wiki Activity
PSA/docs/email/email_settings_access.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

2.2 KiB
Raw Permalink Blame History

Email Settings Access Guide

Overview

The Email Settings component allows administrators to configure email providers, manage custom domains, and set up email delivery preferences for the tenant.

Accessing Email Settings

The Email Settings interface is now available in the main Settings page:

  1. Navigate to Settings from the bottom menu
  2. Click on the Email tab

Alternatively, you can directly access it via:

  • URL: /msp/settings?tab=email

Features Available

1. Email Providers Configuration

  • Configure SMTP settings (host, port, username, password)
  • Set up Resend API integration
  • Enable/disable providers
  • Set provider priorities for failover

2. Custom Domains

  • Add custom email domains
  • View DNS configuration requirements
  • Verify domain ownership
  • Monitor domain verification status

3. General Settings

  • Choose default email provider (SMTP, Resend, or Hybrid)
  • Enable/disable provider fallback
  • Enable/disable email tracking
  • Set daily email limits

Required Permissions

Users need appropriate permissions to access and modify email settings. The component uses server actions that automatically check user authentication and tenant context.

Technical Implementation

The Email Settings component is located at:

  • Component: /server/src/components/admin/EmailSettings.tsx
  • Server Actions: /server/src/lib/actions/email-actions/
    • emailSettingsActions.ts - Main settings management
    • emailDomainActions.ts - Domain management
    • emailActions.ts - Email sending functionality

The component is integrated into the main Settings page (/server/src/components/settings/general/SettingsPage.tsx) as a new tab.

Database Tables

The following tables store email configuration:

  • tenant_email_settings - Tenant-wide email configuration
  • email_domains - Custom domain management
  • email_sending_logs - Email delivery tracking
  • email_provider_health - Provider health monitoring
  • email_templates - Customizable email templates

Workflow Integration

Domain verification is handled through the workflow system. When a new domain is added, a verification workflow is automatically triggered to handle DNS verification and provider setup.