# sonatype/nexus-public architecture

> Architecture diagram of the GitHub repository sonatype/nexus-public, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sonatype/nexus-public
- Repository: https://github.com/sonatype/nexus-public

## Overview

Nexus Repository Core centralizes internal and third-party binaries and packages. The main user workflow is for development tools to publish to or retrieve from a format-specific repository; Nexus manages repository content in blob storage, while users can browse or search available components. Repository and blob-store administration support that core workflow. The README identifies Maven, raw, and APT formats and embedded H2, but sampled source chiefly shows browse and SQL search internals; links not visible in the excerpts are left unverified or omitted.

Main entry points: [`public/selfhosted/components/nexus-self-hosted/src/main/java/org/sonatype/nexus/self/hosted/repository/manager/RepositoryManagerImpl.java`](https://github.com/sonatype/nexus-public/blob/main/public/selfhosted/components/nexus-self-hosted/src/main/java/org/sonatype/nexus/self/hosted/repository/manager/RepositoryManagerImpl.java) (Repository manager), [`public/common/components/nexus-search-sql/src/main/java/org/sonatype/nexus/repository/search/sql/query/SqlSearchService.java`](https://github.com/sonatype/nexus-public/blob/main/public/common/components/nexus-search-sql/src/main/java/org/sonatype/nexus/repository/search/sql/query/SqlSearchService.java) (SQL search), [`public/common/components/nexus-repository-config/src/main/java/org/sonatype/nexus/repository/Repository.java`](https://github.com/sonatype/nexus-public/blob/main/public/common/components/nexus-repository-config/src/main/java/org/sonatype/nexus/repository/Repository.java) (Repository contract), [`public/common/components/nexus-repository-content/src/main/java/org/sonatype/nexus/repository/content/facet/ContentFacet.java`](https://github.com/sonatype/nexus-public/blob/main/public/common/components/nexus-repository-content/src/main/java/org/sonatype/nexus/repository/content/facet/ContentFacet.java) (Content access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_repositories["Repositories and formats"]
  node_repo_mgr["Repository manager"]
  node_format_support["Maven, raw, APT"]
  node_repo_contract["Repository contract<br/>[Repository.java]"]
end

subgraph group_content["Content and storage"]
  node_content_facet["Content access<br/>[ContentFacet.java]"]
  node_blob_api["Blob storage API<br/>[BlobStore.java]"]
  node_blob_manager["Blob-store manager"]
  node_entity_ids["Content identifiers<br/>[InternalIds.java]"]
end

subgraph group_discovery["Browse and search"]
  node_browse_api["Browse service"]
  node_browse_impl["Browse implementation"]
  node_search_api["Search service<br/>[SearchService.java]"]
  node_sql_search["SQL search"]
  node_search_index["Search indexing"]
  node_search_store[("Search store<br/>[SearchStore.java]")]
end

subgraph group_platform["Runtime and administration"]
  node_core_app["Core application"]
  node_freeze["Freeze service<br/>[FreezeService.java]"]
  node_keystore[("File keystore")]
end

node_tools(("Development tools"))

node_tools -->|"publish or retrieve"| node_repo_mgr
node_repo_mgr -.->|"serves formats"| node_format_support
node_repo_mgr -.->|"manages repositories"| node_repo_contract
node_repo_contract -.->|"exposes content"| node_content_facet
node_content_facet -.->|"stores blobs"| node_blob_api
node_repo_mgr -.->|"coordinates storage"| node_blob_manager
node_browse_api -.->|"implemented by"| node_browse_impl
node_browse_impl -->|"reads repository"| node_repo_contract
node_search_api -.->|"SQL implementation"| node_sql_search
node_sql_search -->|"queries assets"| node_search_store
node_sql_search -->|"converts identifiers"| node_entity_ids
node_search_index -->|"updates index"| node_search_store
node_core_app -.->|"starts runtime"| node_repo_mgr

click node_core_app "https://github.com/sonatype/nexus-public/blob/main/public/selfhosted/assemblies/nexus-repository-core/src/main/java/org/sonatype/nexus/bootstrap/entrypoint/core/NexusRepositoryCoreApplication.java"
click node_repo_mgr "https://github.com/sonatype/nexus-public/blob/main/public/selfhosted/components/nexus-self-hosted/src/main/java/org/sonatype/nexus/self/hosted/repository/manager/RepositoryManagerImpl.java"
click node_format_support "https://github.com/sonatype/nexus-public/tree/main/public/common/components/formats/nexus-repository-apt"
click node_repo_contract "https://github.com/sonatype/nexus-public/blob/main/public/common/components/nexus-repository-config/src/main/java/org/sonatype/nexus/repository/Repository.java"
click node_content_facet "https://github.com/sonatype/nexus-public/blob/main/public/common/components/nexus-repository-content/src/main/java/org/sonatype/nexus/repository/content/facet/ContentFacet.java"
click node_blob_api "https://github.com/sonatype/nexus-public/blob/main/public/common/components/nexus-blobstore-api/src/main/java/org/sonatype/nexus/blobstore/api/BlobStore.java"
click node_blob_manager "https://github.com/sonatype/nexus-public/blob/main/public/selfhosted/components/nexus-self-hosted/src/main/java/org/sonatype/nexus/self/hosted/blobstore/BlobStoreManagerImpl.java"
click node_browse_api "https://github.com/sonatype/nexus-public/blob/main/public/common/components/nexus-repository-services/src/main/java/org/sonatype/nexus/repository/browse/node/BrowseNodeQueryService.java"
click node_browse_impl "https://github.com/sonatype/nexus-public/blob/main/public/common/components/nexus-repository-content/src/main/java/org/sonatype/nexus/repository/content/browse/store/BrowseNodeQueryServiceImpl.java"
click node_search_api "https://github.com/sonatype/nexus-public/blob/main/public/common/components/nexus-repository-services/src/main/java/org/sonatype/nexus/repository/search/SearchService.java"
click node_sql_search "https://github.com/sonatype/nexus-public/blob/main/public/common/components/nexus-search-sql/src/main/java/org/sonatype/nexus/repository/search/sql/query/SqlSearchService.java"
click node_search_index "https://github.com/sonatype/nexus-public/blob/main/public/common/components/nexus-search-sql/src/main/java/org/sonatype/nexus/repository/search/sql/index/SqlSearchIndexService.java"
click node_search_store "https://github.com/sonatype/nexus-public/blob/main/public/common/components/nexus-search-sql/src/main/java/org/sonatype/nexus/repository/search/sql/store/SearchStore.java"
click node_freeze "https://github.com/sonatype/nexus-public/blob/main/public/common/components/nexus-common/src/main/java/org/sonatype/nexus/common/app/FreezeService.java"
click node_entity_ids "https://github.com/sonatype/nexus-public/blob/main/public/common/components/nexus-repository-content/src/main/java/org/sonatype/nexus/repository/content/store/InternalIds.java"
click node_keystore "https://github.com/sonatype/nexus-public/blob/main/public/selfhosted/components/nexus-self-hosted/src/main/java/org/sonatype/nexus/self/hosted/node/FileKeyStoreStorage.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_repo_mgr,node_format_support,node_repo_contract toneBlue
class node_content_facet,node_blob_api,node_blob_manager,node_entity_ids toneAmber
class node_browse_api,node_browse_impl,node_search_api,node_sql_search,node_search_index,node_search_store toneMint
class node_core_app,node_freeze,node_keystore toneRose
class node_tools toneIndigo
```

## Components

### Repositories and formats

- [Repository manager](https://github.com/sonatype/nexus-public/blob/main/public/selfhosted/components/nexus-self-hosted/src/main/java/org/sonatype/nexus/self/hosted/repository/manager/RepositoryManagerImpl.java): `public/selfhosted/components/nexus-self-hosted/src/main/java/org/sonatype/nexus/self/hosted/repository/manager/RepositoryManagerImpl.java`
- [Maven, raw, APT](https://github.com/sonatype/nexus-public/tree/main/public/common/components/formats/nexus-repository-apt): `public/common/components/formats/nexus-repository-apt`
- [Repository contract](https://github.com/sonatype/nexus-public/blob/main/public/common/components/nexus-repository-config/src/main/java/org/sonatype/nexus/repository/Repository.java): `public/common/components/nexus-repository-config/src/main/java/org/sonatype/nexus/repository/Repository.java`

### Content and storage

- [Content access](https://github.com/sonatype/nexus-public/blob/main/public/common/components/nexus-repository-content/src/main/java/org/sonatype/nexus/repository/content/facet/ContentFacet.java): `public/common/components/nexus-repository-content/src/main/java/org/sonatype/nexus/repository/content/facet/ContentFacet.java`
- [Blob storage API](https://github.com/sonatype/nexus-public/blob/main/public/common/components/nexus-blobstore-api/src/main/java/org/sonatype/nexus/blobstore/api/BlobStore.java): `public/common/components/nexus-blobstore-api/src/main/java/org/sonatype/nexus/blobstore/api/BlobStore.java`
- [Blob-store manager](https://github.com/sonatype/nexus-public/blob/main/public/selfhosted/components/nexus-self-hosted/src/main/java/org/sonatype/nexus/self/hosted/blobstore/BlobStoreManagerImpl.java): `public/selfhosted/components/nexus-self-hosted/src/main/java/org/sonatype/nexus/self/hosted/blobstore/BlobStoreManagerImpl.java`
- [Content identifiers](https://github.com/sonatype/nexus-public/blob/main/public/common/components/nexus-repository-content/src/main/java/org/sonatype/nexus/repository/content/store/InternalIds.java): `public/common/components/nexus-repository-content/src/main/java/org/sonatype/nexus/repository/content/store/InternalIds.java`

### Browse and search

- [Browse service](https://github.com/sonatype/nexus-public/blob/main/public/common/components/nexus-repository-services/src/main/java/org/sonatype/nexus/repository/browse/node/BrowseNodeQueryService.java): `public/common/components/nexus-repository-services/src/main/java/org/sonatype/nexus/repository/browse/node/BrowseNodeQueryService.java`
- [Browse implementation](https://github.com/sonatype/nexus-public/blob/main/public/common/components/nexus-repository-content/src/main/java/org/sonatype/nexus/repository/content/browse/store/BrowseNodeQueryServiceImpl.java): `public/common/components/nexus-repository-content/src/main/java/org/sonatype/nexus/repository/content/browse/store/BrowseNodeQueryServiceImpl.java`
- [Search service](https://github.com/sonatype/nexus-public/blob/main/public/common/components/nexus-repository-services/src/main/java/org/sonatype/nexus/repository/search/SearchService.java): `public/common/components/nexus-repository-services/src/main/java/org/sonatype/nexus/repository/search/SearchService.java`
- [SQL search](https://github.com/sonatype/nexus-public/blob/main/public/common/components/nexus-search-sql/src/main/java/org/sonatype/nexus/repository/search/sql/query/SqlSearchService.java): `public/common/components/nexus-search-sql/src/main/java/org/sonatype/nexus/repository/search/sql/query/SqlSearchService.java`
- [Search indexing](https://github.com/sonatype/nexus-public/blob/main/public/common/components/nexus-search-sql/src/main/java/org/sonatype/nexus/repository/search/sql/index/SqlSearchIndexService.java): `public/common/components/nexus-search-sql/src/main/java/org/sonatype/nexus/repository/search/sql/index/SqlSearchIndexService.java`
- [Search store](https://github.com/sonatype/nexus-public/blob/main/public/common/components/nexus-search-sql/src/main/java/org/sonatype/nexus/repository/search/sql/store/SearchStore.java): `public/common/components/nexus-search-sql/src/main/java/org/sonatype/nexus/repository/search/sql/store/SearchStore.java`

### Runtime and administration

- [Core application](https://github.com/sonatype/nexus-public/blob/main/public/selfhosted/assemblies/nexus-repository-core/src/main/java/org/sonatype/nexus/bootstrap/entrypoint/core/NexusRepositoryCoreApplication.java): `public/selfhosted/assemblies/nexus-repository-core/src/main/java/org/sonatype/nexus/bootstrap/entrypoint/core/NexusRepositoryCoreApplication.java`
- [Freeze service](https://github.com/sonatype/nexus-public/blob/main/public/common/components/nexus-common/src/main/java/org/sonatype/nexus/common/app/FreezeService.java): `public/common/components/nexus-common/src/main/java/org/sonatype/nexus/common/app/FreezeService.java`
- [File keystore](https://github.com/sonatype/nexus-public/blob/main/public/selfhosted/components/nexus-self-hosted/src/main/java/org/sonatype/nexus/self/hosted/node/FileKeyStoreStorage.java): `public/selfhosted/components/nexus-self-hosted/src/main/java/org/sonatype/nexus/self/hosted/node/FileKeyStoreStorage.java`

### Other components

- **Development tools**

## Connections

- Development tools → Repository manager: publish or retrieve
- Repository manager → Maven, raw, APT: serves formats
- Repository manager → Repository contract: manages repositories (evidence: `public/selfhosted/components/nexus-self-hosted/src/main/java/org/sonatype/nexus/self/hosted/repository/manager/RepositoryManagerImpl.java`)
- Repository contract → Content access: exposes content
- Content access → Blob storage API: stores blobs
- Repository manager → Blob-store manager: coordinates storage
- Browse service → Browse implementation: implemented by (evidence: `public/common/components/nexus-repository-content/src/main/java/org/sonatype/nexus/repository/content/browse/store/BrowseNodeQueryServiceImpl.java`)
- Browse implementation → Repository contract: reads repository (evidence: `public/common/components/nexus-repository-content/src/main/java/org/sonatype/nexus/repository/content/browse/store/BrowseNodeQueryServiceImpl.java`)
- Search service → SQL search: SQL implementation (evidence: `public/common/components/nexus-search-sql/src/main/java/org/sonatype/nexus/repository/search/sql/query/SqlSearchService.java`)
- SQL search → Search store: queries assets (evidence: `public/common/components/nexus-search-sql/src/main/java/org/sonatype/nexus/repository/search/sql/query/SqlSearchService.java`)
- SQL search → Content identifiers: converts identifiers (evidence: `public/common/components/nexus-search-sql/src/main/java/org/sonatype/nexus/repository/search/sql/query/SqlSearchService.java`)
- Search indexing → Search store: updates index (evidence: `public/common/components/nexus-search-sql/src/main/java/org/sonatype/nexus/repository/search/sql/index/SqlSearchIndexService.java`)
- Core application → Repository manager: starts runtime
