Proxy Configuration

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

Configure via the User Interface

To configure the proxy settings in the Develocity UI:

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

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

Proxy Configuration in Develocity UI

Proxy Settings

Setting Description

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.

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.

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.

version: 15
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`).

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.

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.