Skip to content

Nexus Installation and Configuration

Overview

Purpose

Nexus Repository is used in our infrastructure as a centralized artifact repository to store, manage, and distribute build artifacts and dependencies.

Scope

Installtion of nexus centralized artifact repository.

Audience

CORE , DEV

Prerequisites

VM Hardware Requirements

Component Requirement
CPU 4 cores
RAM 8 GB
Disk Space OS & Nexus installation: 50 GB; /nexus-data volume: 2000 GB

Software Requirements

Component Version
Operating System Debian 12
Docker Engine 28.1.1

Access Requirements

  • User: qcuser for all installation steps.
  • Network access to internal DNS and SSL certificate authority.

This is the offical installtion guide https://help.sonatype.com/repomanager3/installation and here is explained how to handle the docker image: https://hub.docker.com/r/sonatype/nexus3/

Architecture Diagram

Configuration Details

Parameters & Endpoints

  • Hostname: e.g. nexus.quintessence.de.
  • Nginx reverse proxy terminates TLS → Nexus container.
  • Docker container exposes 8081 and mounts /home/qcuser/apps/nexus/nexus-data:/nexus-data.

Examples

# Nginx configuration
server {
  listen 80;
  server_name nexus.quintessence.de;
  return 301 https://$host$request_uri;
}

services:
  nexus:
    image: sonatype/nexus3:3.XX.0-java17-alpine
    container_name: nexus-server
    user: "1000:1000"
    ports:
      - "8081:8081"
    volumes:
      - /home/qcuser/apps/nexus/nexus-data:/nexus-data

Step-by-Step Setup

Request Host & Subdomain

  1. Request the host and subdomain.
  2. Configure DNS records.

Configure Nginx Reverse Proxy

  1. Install Nginx.
  2. Create /etc/nginx/sites-available/nexus.conf.
  3. Reload Nginx.

Install Nexus

  1. Adjust docker-compose.yml.
  2. Create mount point: mkdir -p /home/qcuser/apps/nexus/nexus-data.
  3. Start and verify container.

Validation & Testing

Open in your browser and access the gui via the configured redirect

Troubleshooting

  • Check Docker status: docker ps -a.
  • Review logs: docker logs nexus-server.
  • Fix permissions.
  • Check disk space.

Security Considerations

  • Change admin password.
  • Configure anonymous access.
  • Configure SMTP.
  • Configure proxies.
  • Set up backups.

⚠️ Missing according to template: Add firewall rules and access model.

Maintenance

Responsibility

Updates are managed by the Core Team.

Compatibility Considerations

Check compatibility with build tools, CI servers, scripts, and external services.

  • https://help.sonatype.com/repomanager3/installation
  • Current instance: https://qcnex-qcint.quintessence.de
  • Docker image repo: https://hub.docker.com/r/sonatype/nexus3/

Change Log

11.02.2026 DGERMANN

Changelog

Date Author Message
2026-03-06 aresnikowa qc-0: postediting
2026-02-25 aresnikowa Merge remote-tracking branch 'origin/master'