Sonatype Nexus Repository 3是一款企业级仓库管理器,用于集中存储、管理和分发各类软件组件,支持Maven、npm、Docker、Helm等多种格式,可无缝整合CI/CD工具链,助力开发团队实现DevOps流程自动化,提升构建效率与组件交付速度,同时提供组件安全扫描与治理能力,是现代化软件开发中制品管理的核心解决方案。
Sonatype Nexus Repository
Sonatype Nexus Repository is the single source of truth for all your internal and third-party binaries, components, and packages. Integrate all your development tools into a centralized binary repository manager so that you can choose the best open source components, optimize your build performance, and ship code quickly while increasing visibility across your SDLC.
Announcing Nexus Repository Community Edition
As of version 3.77.0, the free edition of Nexus Repository is now called Sonatype Nexus Repository Community Edition.
Community Edition is designed to deliver robust repository management for individual users and small teams. Upgrading to 3.77.0 unlocks powerful new features, including access to previously Pro-only formats, seamless integration with containerized environments like Kubernetes, and more. Community Edition does also include some usage limitations. To learn more, see the Community Edition documentation.
- Contribution Guidlines
- Running
- Building the Sonatype Nexus Repository image
- Chef Solo for Runtime and Application
- Testing the Dockerfile
- Red Hat Certified Image
- Notes
- Persistent Data
- Getting Help
Contribution Guidelines
Go read https://github.com/sonatype/docker-nexus3/blob/main/.github/CONTRIBUTING.md to get a bit more familiar with how we would like things to flow.
Running
To run, binding the exposed port 8081 to the host, use:
docker run -d -p 8081:8081 --name nexus sonatype/nexus3
Note: As of version 3.91.0, the default sonatype/nexus3 image is based on Alpine Linux. See the Alpine Image section below for more details. A UBI-based variant is also available using the -ubi tag suffix.
When stopping, be sure to allow sufficient time for the databases to fully shut down.
docker stop --time=120 <CONTAINER_NAME>
To test:
curl http://localhost:8081/
Building the Sonatype Nexus Repository image
To build a docker image from the https://github.com/sonatype/docker-nexus3/blob/main/Dockerfile you can use this command:
docker build --rm=true --tag=sonatype/nexus3 .
The following optional variables can be used when building the image:
- NEXUS_VERSION: Version of the Sonatype Nexus Repository
- NEXUS_DOWNLOAD_URL: Download URL for Sonatype Nexus Repository, alternative to using
NEXUS_VERSIONto download from Sonatype - NEXUS_DOWNLOAD_SHA256_HASH: Sha256 checksum for the downloaded Sonatype Nexus Repository archive. Required if
NEXUS_VERSIONorNEXUS_DOWNLOAD_URLis provided
Chef Solo for Runtime and Application
Chef Solo is used to build out the runtime and application layers of the Docker image. The Chef cookbook being used is available on GitHub at https://github.com/sonatype/chef-nexus-repository-manager.
Testing the Dockerfile
We are using rspec as the test framework. serverspec provides a docker backend (see the method set in the test code)
to run the tests inside the docker container, and abstracts away the difference between distributions in the tests
(e.g. yum, apt,...).
rspec [--backtrace] spec/Dockerfile_spec.rb
Red Hat Certified Image
A Red Hat certified container image can be created using https://github.com/sonatype/docker-nexus3/blob/main/Dockerfile.rh.ubi.java21 which is built to be compliant with Red Hat certification. The image includes additional meta data to comform with Kubernetes and OpenShift standards, a directory with the licenses applicable to the software and a man file for help on how to use the software. It also uses an ENTRYPOINT script the ensure the running user has access to the appropriate permissions for OpenShift 'restricted' SCC.
The Red Hat certified container image is available from the Red Hat Container Catalog and qualified accounts can pull it from registry.connect.redhat.com.
Other Red Hat Images
In addition to the Universal Base Image, we can build images based on:
- Red Hat Enterprise Linux: https://github.com/sonatype/docker-nexus3/blob/main/Dockerfile.rh.el
- CentOS: https://github.com/sonatype/docker-nexus3/blob/main/Dockerfile.rh.centos
Alpine Image (Default)
As of version 3.91.0, the Alpine-based image is the default for Sonatype Nexus Repository.
The Alpine-based container image can be created using https://github.com/sonatype/docker-nexus3/blob/main/Dockerfile.alpine.java21. This Dockerfile is built to leverage the minimalistic and efficient nature of Alpine Linux, emphasizing fewer dependencies to achieve a cleaner SBOM (Software Bill of Materials) and a stronger security posture.
The Alpine-based container image includes minimal dependencies and uses an ENTRYPOINT script to ensure the application runs with the necessary permissions. It is optimized for rapid deployment and efficient resource usage.
The Alpine-based container image is available from Docker Hub and can be pulled using the following tags:
sonatype/nexus3:latest- Latest Alpine-based release (runs Java 21)sonatype/nexus3:3.XX.y- Specific version, Alpine-based (runs Java 21)sonatype/nexus3:3.XX.y-alpine- Explicit Alpine tag (runs Java 21)
UBI Image Variant
For users who prefer Red Hat Universal Base Image (UBI), a UBI-based variant is available using the -ubi tag suffix:
sonatype/nexus3:3.XX.y-ubi- Specific version, UBI-based (runs Java 21)
The UBI-based container image can be created using https://github.com/sonatype/docker-nexus3/blob/main/Dockerfile.java21.
Notes
-
Our system requirements should be taken into account when provisioning the Docker container.
-
Default user is
adminand the uniquely generated password can be found in theadmin.passwordfile inside the volume. See Persistent Data for information about the volume. -
It can take some time (2-3 minutes) for the service to launch in a new container. You can tail the log to determine once Nexus is ready:
docker logs -f nexus
-
Installation of Nexus is to
/opt/sonatype/nexus. -
A persistent directory,
/nexus-data, is used for configuration, logs, and storage. This directory needs to be writable by the Nexus process, which runs as UID 200. -
There is an environment variable that is being used to pass JVM arguments to the startup script
INSTALL4J_ADD_VM_PARAMS, passed to the Install4J startup script. Defaults to-Djava.util.prefs.userRoot=${NEXUS_DATA}/javaprefs.
This can be adjusted at runtime:
docker run -d -p 8081:8081 --name nexus -e INSTALL4J_ADD_VM_PARAMS="-Xms2703m -Xmx2703m -XX:MaxDirectMemorySize=2703m -Djava.util.prefs.userRoot=/some-other-dir" sonatype/nexus3Java Memory Configuration Parameters:
The example above demonstrates configuring Java memory parameters. Each parameter controls a specific aspect of memory allocation:
-Xms2703m: Sets the initial heap size to 2703 MB-Xmx2703m: Sets the maximum heap size to 2703 MB-XX:MaxDirectMemorySize=2703m: Sets the maximum direct memory size to 2703 MB
These values should be adjusted based on your memory requirements. Setting
-Xmsand-Xmxto the same value prevents heap resizing and provides more predictable performance.Of particular note,
-Djava.util.prefs.userRoot=/some-other-dircan be set to a persistent path, which will maintain the installed Sonatype Nexus Repository License if the container is restarted. -
Another environment variable can be used to control the Nexus Context Path
NEXUS_CONTEXT, defaults to /
This can be supplied at runtime:
docker run -d -p 8081:8081 --name nexus -e NEXUS_CONTEXT=nexus sonatype/nexus3
Persistent Data
There are two general approaches to handling persistent storage requirements with Docker. See https://docs.docker.com/engine/tutorials/dockervolumes/ for additional information.
- Use a docker volume. Since docker volumes are persistent, a volume can be created specifically for this purpose. This is the recommended approach.
docker volume create --name nexus-data docker run -d -p 8081:8081 --name nexus -v nexus-data:/nexus-data sonatype/nexus3
- Mount a host directory as the volume. This is not portable, as it relies on the directory existing with correct permissions on the host. However it can be useful in certain situations where this volume needs to be assigned to certain specific underlying storage.
mkdir /some/dir/nexus-data && chown -R 200 /some/dir/nexus-data docker run -d -p 8081:8081 --name nexus -v /some/dir/nexus-data:/nexus-data sonatype/nexus3
Getting In Touch
If you are using Nexus Repository Core or Community Edition and need to report an issue or request an enhancement, https://github.com/sonatype/nexus-public/issues.
For help with Nexus Repository Core or Community Edition, please join the Sonatype Community to get tips and tricks from other users.
To report a security vulnerability, please see [***]
Sonatype Nexus Repository Pro customers can contact our world-class support team at [***]
License Disclaimer
Sonatype Nexus Repository Core is distributed with Sencha Ext JS pursuant to a FLOSS Exception agreed upon between Sonatype, Inc. and Sencha Inc. Sencha Ext JS is licensed under GPL v3 and cannot be redistributed as part of a closed source work.
All use of and access to Sonatype Nexus Repository Community Edition is governed by these terms and conditions.
Copyright © 2008-present Sonatype, Inc.
sonatype 命名空间的其他可用镜像:
sonatype/nexus3 Related Documentation
(3 articles)镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务

