Skip to main content

Capabilities

Nexus Repository features are configured as capabilities under SettingsSystemCapabilities.

The nx-capabilities privilege is required to manage capabilities.

Capability / Type

Description / Properties

Audit

audit

Enable audit of system changes. Created automatically on initial startup.

Base URL

baseurl

Specify the reverse proxy base URL for your instance to be used in email notifications.

url 

See Base URL Capability

Crowd

crowd

Enables use of Atlassian Crowd for user authentication.

"httpTimeout": "{seconds}",
"useTrustStore": "true",
"crowdServerUrl": "{url_string}",
"applicationName": "{string}",
"applicationPassword": "{password_string}"

See Atlassian Crowd Support

Custom S3 Region

customs3regions

Enable to enter a comma-delimited list of custom S3 regions that should be made available when configuring a blob store. If not added or enabled, only the standard AWS regions will be listed as options when creating an S3 blob store.

regions: "us-east"

See Configuring Blob Stores

Default Role

defaultrole

Automatically apply a role to any authenticated users.

role: "global_permissions"

See Default Role

Firewall Audit and Quarantine

firewall.audit

Enable Repository Firewall on a proxy repository.

quarantine: "true"
repository: "{repository name}"
Health Check: Configuration

healthcheck

Enable Repository Health Check on proxy repositories.

            

configuredForAll: "true"

License Expiry Notification

license-expiration

Enable a notification to be sent a specific number of days before the Nexus Repository Pro license is set to expire.

daysBeforeExpiration: "30"
notificationEmails: "[email protected]"
Node: Identity

node.identity

Provides the unique identity for the Nexus Repository server on the initial startup. This capability is configured once and never changed.

NXRM2 style URLs

LegacyUrlCapability

Provides support for Nexus Repository 2-style URLs.

See Upgrading from Nexus Repository 2

Outreach: Management

OutreachManagementCapability

Manages outreach on the front landing page and updating notifications settings. Created automatically on initial startup.

baseUrl: "https://links.sonatype.com/products/nexus/outreach"
alwaysRemote: "true"
overrideUrl: ""

Repository: Browse Trim

Controls automatic trimming of empty browse nodes (folders) in repository browse trees after component deletion. Trim is always enabled for H2 databases and disabled by default for PostgreSQL due to performance considerations, but can be enabled. Optional batch processing reduces database contention by batching trim operations every 2 seconds or 100 events, which may delay trimming by up to 2 seconds.

Rut Auth

rutauth

Configure the HTTP header used for remote user token authentication.

httpHeader: "example"

See Authentication via Remote User Token

Scheduler

scheduling.scheduler

Configures scheduler details. Created automatically on initial startup.

See Tasks

Search Configuration

nexus.search.configuration

The search configuration limited the number of database queries to produce a page of search results. This capability was added in Nexus Repository 3.72.0 however it was later removed in the 3.80.0 release to globally set the default configuration of High Availability (HA) deployments. The limit is set to 10 trips to the database.

This impacts search performance and can result in empty data sets in some cases.

Storage Settings

StorageSettings

Configures storage settings.

lastDownloadedInterval: "12"
UI: Branding

rapture.branding

Insert customized messaging into the header and/or footer of your user interface.

footerHtml": "{html_string}"
headerHtml": "{html_string}"
headerEnabled": "true"
footerEnabled": "true"

See Branding Capability

UI: Settings

rapture.setting

Customize some user interface settings. Created automatically on initial startup.

debugAllowed: ""
longRequestTimeout: "180"
requestTimeout: "60"
searchRequestTimeout: "0"
sessionTimeout: "30"
statusIntervalAnonymous: "60"
statusIntervalAuthenticated: "5"
title: "Sonatype Nexus Repository"

See UI Settings Capability

Webhook: Global

webhook.global

Send HTTP POST requests for global events.

names: "audit,repository"
secret: "{secret-key}"
url: "{url-string}"

See Enabling A Global Webhook Capability

Webhook: Repository

webhook.repository

Send HTTP POST requests for repository events.

names: "asset,component"
secret: "{secret-key}"
repository: "{repository-name}"
url: "{url-string}"

See Enabling A Repository Webhook Capability

Creating a Capability

  1. Select Create capability and the type of capability to create.

  2. Enter the required configuration information; then, select Create capability.

Disabling a Capability

  1. Select the capability to disable.

  2. Select Disable.

Enable a capability at any time by selecting the Enable button on this same screen