1 Mail Preview
StefanSA edited this page 2026-07-03 10:48:48 +02:00

Mail Preview

Overview

Vaultwarden-Plus includes preview-only mail notifications for trusted-device and auth-request lifecycle events. These notifications are intended for beta/operator observability and are not a general notification framework.

Requirements

  • Working SMTP, sendmail, or SES mail transport.
  • Trusted-device/auth-request preview behavior explicitly enabled where applicable.
  • Awareness that the trusted-device/auth-request server slice is hardened and runtime-validated, but full official-client end-to-end challenge/redemption is not confirmed.

Configuration

Documented setting:

TRUSTED_DEVICE_PREVIEW_EMAIL_NOTIFICATIONS=false

Mail preview events require normal mail transport configuration. See SMTP Configuration.

Examples

Use preview notifications to observe trusted-device and auth-request lifecycle behavior during operator validation. Keep the feature disabled unless the deployment has a clear validation need.

Troubleshooting

  • If preview mail does not send, verify the mail transport first.
  • Preview notifications are not a durable audit log and are not a general notification framework.
  • Do not include tokens, encrypted keys, auth codes, or other sensitive material in notification payloads or troubleshooting notes.

Canonical Documentation