---
component: ROOT
version: "2026.1"
slug: ROOT/administration/email-server
canonical_url: "https://docs.gradle.com/develocity/2026.1/administration/system-configuration/email-server/"
title: "Email Server"
description: "Configure the Develocity email server to send system alerts and backup notifications."
keywords: []
status: current
---

<!-- llms-index: https://docs.gradle.com/develocity/llms.txt -->

# Email Server

<a id="preamble"></a>

<a id="email_notifications"></a>

Configure Develocity to send automated email alerts for system events, such as [low disk space warnings](https://docs.gradle.com/develocity/2026.1/administration/build-scan/build-scan-storage/#disk_space_management) or the completion of [scheduled backups](https://docs.gradle.com/develocity/2026.1/administration/data-management/database-backups/).

<a id="configure-via-the-user-interface"></a>

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

> [!IMPORTANT]
> Applying the configuration updates the system services and may take several minutes to complete.

![Email Server Configuration in Develocity UI](https://docs.gradle.com/develocity/2026.1/administration/system-configuration/email-server/../../_images/dv-ui-email-server.png)

Email Server Configuration in Develocity UI

<a id="configuration-fields"></a>

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

<a id="configure-via-unattended-configuration"></a>

## Configure via Unattended Configuration

If you are managing Develocity using a GitOps or automated workflow, you can define the global settings using [Unattended Configuration](https://docs.gradle.com/develocity/2026.1/administration/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.

```yaml
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.

<a id="deployment-templates"></a>

### 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](https://docs.gradle.com/develocity/legacy/helm-admin/2025.2) or the [2025.3 Administration Manual](https://docs.gradle.com/develocity/2025.3/administration/admin-manual/)._

<table><tbody><tr><td class="hdlist1"><strong>Cluster Deployment</strong></td><td class="hdlist2">Example template for cluster orchestration. gradle-enterprise-config-schema-15.yaml SHA256 ASC ASC SHA256</td></tr><tr><td class="hdlist1"><strong>Standalone Deployment</strong></td><td class="hdlist2">Example template for standalone setup. gradle-standalone-config-schema-15.yaml | SHA256 | ASC | ASC SHA256</td></tr></tbody></table>

> [!IMPORTANT]
> 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.

<a id="testing-the-configuration"></a>

## Testing the Configuration

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

```shell
develocityctl system test-notification
```