PSA/docs/email/email_settings_access.md
Hermes 284313f908
Some checks are pending
Bidi Control Character Guard / bidi-control-guard (push) Waiting to run
Circular Dependency Check / Check for new circular dependencies (push) Waiting to run
Citus Migration Smoke / Combined migrations on single-node Citus (push) Waiting to run
E2E Fresh Install Tests / fresh-install-e2e (push) Waiting to run
ext-v2 guardrails / Run ext-v2 guard and ESLint (push) Waiting to run
Integration Tests / Check for relevant changes (push) Waiting to run
Integration Tests / ${{ (github.event_name == 'schedule' || github.event.inputs.suite == 'full') && 'Full integration suite' || 'Tier-1 integration subset' }} (push) Blocked by required conditions
Mobile checks / Mobile lint + typecheck (push) Waiting to run
Mobile checks / Mobile unit tests (push) Waiting to run
Mobile checks / Mobile dependency audit (report) (push) Waiting to run
Mobile checks / Mobile reproducibility checks (push) Waiting to run
Secrets guard (env backups) / Ensure no tracked env backup files (push) Waiting to run
Temporal Readiness / fast-readiness (push) Waiting to run
Temporal Readiness / docker-parity (push) Waiting to run
TypeScript Type Check / Nx affected typecheck (push) Waiting to run
Unit Tests / Skipped-test budget (push) Waiting to run
Unit Tests / Nx affected unit tests (push) Waiting to run
Unit Tests / Server unit coverage (informational) (push) Waiting to run
Validate Tenant Management Schema / Check for relevant changes (push) Waiting to run
Validate Tenant Management Schema / Validate Tenant Management Schema (push) Blocked by required conditions
EE Workflows Build Guard / ee-workflows-build-guard (push) Waiting to run
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

63 lines
2.2 KiB
Markdown

# 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.