---
component: ROOT
version: "2026.1"
slug: ROOT/administration/proxy
canonical_url: "https://docs.gradle.com/develocity/2026.1/administration/system-configuration/proxy/"
title: "Proxy Configuration"
description: "Configure Develocity to route outbound traffic through an HTTP or HTTPS proxy."
keywords: []
status: current
---

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

# Proxy Configuration

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

Configure the outbound network and proxy settings required for Develocity to communicate with external endpoints.

If your network environment requires an outbound proxy for internet access, you must define these settings to ensure Develocity can reach external services (such as license validation or external integrations).

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

## Configure via the User Interface

To configure the proxy settings in the Develocity UI:

1.  Log in to Develocity as a user with **Administrator** permissions.
    
2.  Navigate to **Administration**  **Network**.
    
3.  Select the **HTTP Proxy** tab.
    
4.  Toggle the **Enable Proxy** switch and enter your proxy details.
    
5.  Configure the required fields as described in the table below.
    
6.  Select **Save**, then click **Apply and restart** in the upper-right corner.
    

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

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

Proxy Configuration in Develocity UI

<a id="proxy-settings"></a>

### Proxy Settings

 
| Setting | Description |
| --- | --- |
| Proxy Protocol | Select whether your proxy uses HTTP or HTTPS. |
| Proxy host | The hostname or IP address of your proxy server. |
| Excluded hosts | A comma-separated list of hostnames or IP addresses that should bypass the proxy. |
| Proxy port | The port number used by your proxy (e.g., 80). |
| Enable proxy authentication | If your proxy requires credentials, provide the username and password here. |

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
version: 15
systemPassword: "«hashed-system-password»"
network:
  proxy:
    auth:
      password: plain:examplePa$$sorwD21& (1)
      username: acme (2)
    excludedHosts: []
    host: proxy.acme.org (3)
    port: 80 (4)
    protocol: http  (5)
```

1. The password for proxy authentication. Use plain: prefix for plaintext passwords.
2. The username for proxy authentication.
3. The hostname or IP address of your proxy server.
4. The port number used by your proxy server.
5. The protocol used by your proxy server (http or https).

<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="technical-notes"></a>

## Technical Notes

*   **Scope:** Once configured, Develocity routes all outbound HTTP and HTTPS requests through this proxy.
    
*   **Connectivity:** Ensure that the proxy server is reachable from the Develocity instance.