Skip to main content

Customizing the Nexus Repository 2 User Interface with Branding

Nexus Repository 2

Note

Only available in Sonatype Nexus Repository Pro. Interested in a free trial? Start here.

The branding plugin is part of Nexus Repository Manager Pro and allows you to customize your repository manager instance by replacing the default Nexus Repository Manager Pro logo in the top left-hand corner of the header with an image of your choice.

You can configure it by adding the Branding capability as documented in Accessing and Configuring Capabilities and enabling it. By default, the branding plugin will look for the new logo in a file called branding.png in your data directory’s conf folder. By default, the location is therefore sonatype-work/nexus/conf/branding.png. The new logo needs to be a PNG image. To blend in well in the UI, it is recommended that it is of 60 pixels height and has a transparent background.

If it fails to find a new logo, the plugin will fall back to using the default logo.

Prior to Nexus Repository Manager Pro 2.7, the branding plugin was an optional plugin and needed to be installed following the documentation in Managing Plugins. In this case you needed to add a branding.image.path property to the nexus.properties file in $NEXUS_HOME/conf/:

branding.image.path=/data/images/nexus_logo.png