Email Server

Configure Develocity to send automated email alerts for system events, such as low disk space warnings or the completion of scheduled backups.

Configure via the User Interface

To enable and configure email alerts in the Develocity UI:

Log in to Develocity as a user with Administrator permissions.
Navigate to Administration Email server.
Check the Enable email configuration checkbox to reveal the SMTP settings.
Enter your SMTP Host, Port, and security preferences.
Provide the From Address (the sender) and the Administrator Address (the recipient of system alerts).
Click Save to store the settings, then click Apply and restart in the upper-right corner to activate them.

Applying the configuration updates the system services and may take several minutes to complete.

Email Server Configuration in Develocity UI

Configuration Fields

Setting Description

Setting	Description
From Address	The email address that will appear as the sender of system-generated notifications.
Administrator Address	The primary recipient for all system-generated notifications and alerts.
SMTP Server	The hostname or IP address of your SMTP server (e.g., `smtp.acme.org`).
Port	The port number used to connect to the SMTP server.
Authentication	If your server requires login, select the mode (Login, CRAM_MD5, or Plain) and enter the credentials. Select None if the server doesn’t require authentication.
SSL Protocol	Select the protocol required by your mail server: SMTP (no encryption), SMTP with StartTLS, or SMTP with implicit TLS. Secure connections are strongly recommended.

From Address

The email address that will appear as the sender of system-generated notifications.

Administrator Address

The primary recipient for all system-generated notifications and alerts.

SMTP Server

The hostname or IP address of your SMTP server (e.g., smtp.acme.org).

Port

The port number used to connect to the SMTP server.

Authentication

If your server requires login, select the mode (Login, CRAM_MD5, or Plain) and enter the credentials. Select None if the server doesn’t require authentication.

SSL Protocol

Select the protocol required by your mail server: SMTP (no encryption), SMTP with StartTLS, or SMTP with implicit TLS. Secure connections are strongly recommended.

We encourage you to back up your configuration settings regularly to prevent data loss.
You can export settings via the Administration menu by selecting Administration Import/Export Export.

Configure via Unattended Configuration

If you are managing Develocity using a GitOps or automated workflow, you can define the global settings using Unattended Configuration. Depending on your deployment strategy, you can provide these settings either as Integrated configuration within your values.yaml or as a Standalone configuration file.

Email notifications are configured with the top-level email section of the unattended configuration file. Including the section enables email notifications; there is no separate enabled property. To disable email notifications, omit the section.

version: 16
systemPassword: "«hashed-system-password»"
email:
  smtpServer: "smtp.acme.org:465" (1)
  administratorAddress: "[email protected]" (2)
  fromAddress: "[email protected]" (3)
  sslProtocol: "implicitTls" (4)
  authentication:
    type: "login" (5)
    username: "service-auth"
    password: "plain:«smtp-password»" (6)

1	Specify the SMTP server and port in the format `hostname:port`.
2	Provide the administrator email address that will receive system notifications.
3	Provide the email address that will appear as the sender of system-generated notification.
4	Options: `startTls` or `implicitTls`. Omit the property for an SMTP connection without encryption.
5	Options: `login`, `cramMd5`, or `plain`. Omit the `authentication` section if the server doesn’t require authentication.
6	Prefix a plain text password with `plain:`, or encrypt it as described in Encrypting Secret Values.

Deployment Templates

Download the appropriate YAML template to begin your infrastructure configuration.

For Develocity versions 2025.3 and prior, see the 2025.2 Administration Guide or the 2025.3 Administration Manual.

Cluster Deployment	Example template for cluster orchestration. gradle-enterprise-config-schema-16.yaml SHA256 ASC ASC SHA256
Standalone Deployment	Example template for standalone setup. gradle-standalone-config-schema-16.yaml \| SHA256 \| ASC \| ASC SHA256

Pre-deployment Checklist

Backup: Export your current settings via Administration Import/export before applying changes.
Deployment: After updating your values.yaml, re-deploy using Helm.
Impact: This triggers service restarts and may take several minutes to complete.

See Unattended Configuration for details.

Testing the Configuration

Once the settings have been applied, you can verify the connection by sending a test email via the Admin CLI:

develocityctl system test-notification