For AI agents: the complete documentation index is available at https://www.jumpserver.com/docs/llms.txt, the full documentation bundle is available at https://www.jumpserver.com/docs/llms-full.txt, and this page is available as Markdown at https://www.jumpserver.com/docs/features/system-settings/general/notifications.md.
🎉 JumpServer v5.1.1 is available. See what's new →
  • v5

    • Notifications

    Enterprise Edition

    Message templates and SMS notifications require JumpServer Enterprise Edition. Email and Subscription notifications are included in Community Edition.

    Request 14-day free trial

    Notifications controls how JumpServer talks to users outside the console. It covers the email account used for transactional messages, SMS delivery for verification codes and password recovery, and the subscription rules that decide who receives platform alerts.

    Overview

    The page has separate tabs for each delivery channel:

    TabPurpose
    EmailOutgoing mail server used for account, authorization, and security messages.
    Msg TemplateCustom message templates for email and in-site notifications.
    MessageSMS provider used for SMS verification codes and password recovery.
    SubscriptionMessage types, recipients, and delivery channels for platform monitoring alerts.

    Configure the email service

    Email is strongly recommended: account activation, password reset, authorization expiry, and security alerts all rely on it.

    1

    In the right area of the top navigation bar, click .

    image
    2

    In the left menu, click Notifications.

    3

    Open the Email tab and enter the mail server settings described in the field reference.

    4

    Enter a test address in Recipient, then run the email test to confirm that the server accepts the configuration.

    5

    Click Submit.

    Figure 1: Email settings

    Email field reference

    FieldDescription
    ServiceSMTP for a standard mail server, or Microsoft Exchange Server.
    HostHost name or address of the mail server.
    PortSMTP port, for example 465 for implicit TLS or 587 for STARTTLS.
    AccountUser name used to authenticate to the mail server.
    PasswordPassword for the account.
    SenderFrom address used in outgoing messages. Defaults to the account when empty.
    Use SSLNone, SSL, or TLS. Select the option that matches the server configuration.
    Certificate verificationWhether the server certificate is verified, and optionally a custom CA certificate to trust.
    Email templateSubject prefix and message content used for generated emails.
    RecipientTest mailbox used by the email test only.

    Configure SMS

    1

    Open the Message tab and enable SMS.

    2

    Select the provider: Alibaba Cloud, Tencent Cloud, Huawei Cloud, CMPP v2.0, or a custom integration.

    3

    Fill in the provider credentials and set the verification code length, then use the test button to send a message to your own number.

    4

    Click Submit.

    For SMS-based MFA, each user must first record a phone number in Profile and enable SMS as an MFA method. The global MFA policy is configured in Security.

    Configure subscriptions

    The Subscription tab decides which monitoring messages are delivered and through which channels. Inbox messages are always delivered; for each message type you can enable additional backends such as email, and use Edit recipient to choose the users who receive that type.

    Figure 2: Message subscription settings

    Note

    Submit the email configuration before testing. The email and SMS services are used by password recovery, so confirm the Site URL is correct as well.