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:

  1. Log in to Develocity as a user with Administrator permissions.

  2. Navigate to Administration  Email server.

  3. Check the Enable email configuration checkbox to reveal the SMTP settings.

  4. Enter your SMTP Host, Port, and security preferences.

  5. Provide the From Address (the sender) and the Administrator Address (the recipient of system alerts).

  6. 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
Email Server Configuration in Develocity UI

Configuration Fields

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 method (e.g., plain, login) and enter the credentials.

SSL Protocol

Select the encryption method required by your mail server (startTls, implicitTLS, or none). 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.

develocity:
  systemConfiguration:
    email:
      enabled: true
      smtpServer: "smtp.acme.org:465" (1)
      administratorAddress: "devops@acme.org" (2)
      fromAddress: "develocity@acme.org" (3)
      sslProtocol: "implicitTLS" (4)
      authentication:
        method: "login"
        username: "service-auth"
        password: "${SMTP_PASSWORD}" (5)
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, implicitTLS, or none.
5 We recommend using secret injection or environment variables for passwords.

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-15.yaml SHA256 ASC ASC SHA256
Standalone Deployment

Example template for standalone setup.
gradle-standalone-config-schema-15.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