hub: add image library section (#21485)

<!--Delete sections as needed -->

## Description

- Added "Container image library" section in Docker Hub manual and
started adding concepts.
  - Added section about search and all the filters
  - Added section about catalogs
  - Moved mirroring topic inside
- Updated Hub landing page
- Moved "Trusted content" into Repositories>Manage (for publishers) and
Library (for consumers).


https://deploy-preview-21485--docsdocker.netlify.app/docker-hub/

https://deploy-preview-21485--docsdocker.netlify.app/docker-hub/image-library/

https://deploy-preview-21485--docsdocker.netlify.app/docker-hub/image-library/search/

https://deploy-preview-21485--docsdocker.netlify.app/docker-hub/image-library/catalogs/

https://deploy-preview-21485--docsdocker.netlify.app/docker-hub/image-library/trusted-content/


https://deploy-preview-21485--docsdocker.netlify.app/docker-hub/repos/manage/trusted-content/

## Related issues or tickets

ENGDOCS-2352

## Reviews

- [ ] Editorial review
- [ ] Product review

---------

Signed-off-by: Craig <craig.osterhout@docker.com>
This commit is contained in:
Craig Osterhout 2024-12-16 08:50:11 -08:00 committed by GitHub
parent 948b9cac9b
commit 44cce4906f
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
44 changed files with 454 additions and 186 deletions

View File

@ -9,6 +9,7 @@ second: '(?:\b[A-Z][a-z]+ )+\(([A-Z]{2,5})\)'
# ... with the exception of these:
exceptions:
- AGPL
- AI
- API
- ARM
- ASP
@ -54,6 +55,7 @@ exceptions:
- HTTP
- HTTPS
- IAM
- IBM
- ID
- IDE
- IP

View File

@ -110,6 +110,7 @@ Zsh
[Ii]nfosec
[Kk]eyrings?
[Ll]oopback
[Mm]emcached
[Mm]oby
[Nn]amespace
[Oo]nboarding

View File

@ -80,17 +80,6 @@ grid:
url: "/scout/quickstart/"
- text: "Image analysis"
url: "/scout/image-analysis/"
- title: Trusted content
icon: verified
description: |
High-quality, secure images from Docker and verified partners.
links:
- text: "Overview"
url: "/trusted-content/"
- text: "Official images"
url: "/trusted-content/official-images/"
- text: "Verified publisher program"
url: "/trusted-content/dvp-program/"
- title: Subscription
icon: card_membership
description: |

View File

@ -188,10 +188,7 @@ In this walkthrough, you searched and pulled a Docker image. In addition to pull
The following resources will help you learn more about exploring, finding, and building images:
- [Docker Trusted Content](/manuals/trusted-content/_index.md)
- [Docker Official Images docs](/manuals/trusted-content/official-images/_index.md)
- [Docker Verified Publisher docs](/manuals/trusted-content/dvp-program.md)
- [Docker-Sponsored Open Source Program docs](/manuals/trusted-content/dsos-program.md)
- [Docker trusted content](/manuals/docker-hub/image-library/trusted-content.md)
- [Explore the Image view in Docker Desktop](/manuals/desktop/use-desktop/images.md)
- [Docker Build overview](/manuals/build/concepts/overview.md)
- [Docker Hub](https://hub.docker.com)

View File

@ -33,7 +33,7 @@ If youre new to container images, think of them as a standardized package tha
To share your Docker images, you need a place to store them. This is where registries come in. While there are many registries, Docker Hub is the default and go-to registry for images. Docker Hub provides both a place for you to store your own images and to find images from others to either run or use as the bases for your own images.
In [Develop with containers](develop-with-containers.md), you used the following images that came from Docker Hub, each of which are [Docker Official Images](/trusted-content/official-images/):
In [Develop with containers](develop-with-containers.md), you used the following images that came from Docker Hub, each of which are [Docker Official Images](/manuals/docker-hub/image-library/trusted-content.md#docker-official-images):
- [node](https://hub.docker.com/_/node) - provides a Node environment and is used as the base of your development efforts. This image is also used as the base for the final application image.
- [mysql](https://hub.docker.com/_/mysql) - provides a MySQL database to store the to-do list items

View File

@ -0,0 +1,34 @@
The categories include:
- **API Management**: Tools for creating, publishing, analyzing, and securing
APIs.
- **Content Management System:** Software applications to create and manage
digital content through templates, procedures, and standard formats.
- **Data Science:** Tools and software to support analyzing data and generating
actionable insights.
- **Databases & Storage:** Systems for storing, retrieving, and managing data.
- **Languages & Frameworks:** Programming language runtimes and frameworks.
- **Integrations & Delivery:** Tools for Continuous Integration (CI) and
Continuous Delivery (CD).
- **Internet of Things:** Tools supporting Internet of Things (IoT)
applications.
- **Machine Learning & AI:** Tools and frameworks optimized for artificial
intelligence and machine learning projects, such as pre-installed libraries
and frameworks for data analysis, model training, and deployment.
- **Message Queues:** Message queuing systems optimized for reliable, scalable,
and efficient message handling.
- **Monitoring & Observability:** Tools to track software and system performance
through metrics, logs, and traces, as well as observability to explore the
systems state and diagnose issues.
- **Networking:** Repositories that support data exchange and connecting
computers and other devices to share resources.
- **Operating Systems:** Software that manages all other programs on a computer
and serves as an intermediary between users and the computer hardware, while
overseeing applications and system resources.
- **Security:** Tools to protect a computer system or network from theft,
unauthorized access, or damage to their hardware, software, or electronic
data, as well as from service disruption.
- **Web Servers:** Software to serve web pages, HTML files, and other assets to
users or other systems.
- **Web Analytics:** Tools to collect, measure, analyze, and report on web data
and website visitor engagement.

View File

@ -76,10 +76,6 @@ params:
description: Commercial use licenses for Docker products.
icon: card_membership
link: /subscription/
- title: Trusted content
description: Curated, high-quality content from trusted sources.
icon: verified
link: /trusted-content/
---
This section contains user guides on how to install, set up, configure, and use

View File

@ -20,10 +20,12 @@ FROM debian
For most cases, you don't need to create your own base image. Docker Hub
contains a vast library of Docker images that are suitable for use as a base
image in your build. [Docker Official Images](../../trusted-content/official-images/_index.md)
image in your build. [Docker Official
Images](../../docker-hub/image-library/trusted-content.md#docker-official-images)
are specifically designed as a set of hardened, battle-tested images that
support a wide variety of platforms, languages, and frameworks. There are also
[Docker Verified Publisher](https://hub.docker.com/search?q=&image_filter=store)
[Docker Verified
Publisher](../../docker-hub/image-library/trusted-content.md#verified-publisher-images)
images, created by trusted publishing partners, verified by Docker.
## Create a base image
@ -123,4 +125,4 @@ For more information about building images and writing Dockerfiles, see:
* [Dockerfile reference](/reference/dockerfile.md)
* [Dockerfile best practices](/manuals/build/building/best-practices.md)
* [Docker Official Images](../../trusted-content/official-images/_index.md)
* [Docker Official Images](../../docker-hub/image-library/trusted-content.md#docker-official-images)

View File

@ -57,7 +57,7 @@ it small.
- [Docker-Sponsored Open Source](https://hub.docker.com/search?image_filter=open_source)
are published and maintained by open source projects sponsored by Docker
through an [open source program](../../trusted-content/dsos-program).
through an [open source program](../../docker-hub/image-library/trusted-content.md#docker-sponsored-open-source-software-images).
When you pick your base image, look out for the badges indicating that the
image is part of these programs.

View File

@ -11,6 +11,10 @@ grid:
description: Step-by-step instructions on getting started on Docker Hub.
icon: explore
link: /docker-hub/quickstart
- title: Library
description: Explore the content library, featuring millions of images for operating systems, frameworks, databases, and more.
icon: book
link: /docker-hub/image-library/
- title: Repositories
description: Create a repository to share your images with your team, customers,
or the Docker community.

View File

@ -0,0 +1,22 @@
---
description: Learn about Docker Hub's library of images, extensions, and plugins.
keywords: Docker Hub, Hub, content library
title: Content library
linkTitle: Library
weight: 20
---
Docker Hub's content library is the world's largest collection of
container images, extensions, and plugins. It provides a central location to
discover pre-built images and tools designed to streamline your container
workflows, making it easier to share and collaborate.
In this section, learn about:
- [Search](./search.md): Discover how to browse and search Docker Hub's extensive resources.
- [Trusted content](./trusted-content.md): Dive into Docker Official Images,
Verified Publisher content, and Sponsored Open Source images, all vetted for
security and reliability to streamline your workflows.
- [Catalogs](./catalogs.md): Explore specialized collections like the generative AI catalog.
- [Mirroring](./mirror.md): Learn how to create a mirror of Docker Hub's
container image library as a pull-through cache.

View File

@ -0,0 +1,59 @@
---
description: Explore specialized Docker Hub collections like the Generative AI catalog.
keywords: Docker Hub, Hub, catalog
title: Docker Hub catalogs
linkTitle: Catalogs
weight: 60
---
Docker Hub catalogs are your go-to collections of trusted, ready-to-use
container images and resources, tailored to meet specific development needs.
They make it easier to find high-quality, pre-verified content so you can
quickly build, deploy, and manage your applications with confidence. Catalogs in
Docker Hub:
- Simplify content discovery: Organized and curated content makes it easy to
discover tools and resources tailored to your specific domain or technology.
- Reduce complexity: Trusted resources, vetted by Docker and its partners,
ensure security, reliability, and adherence to best practices.
- Accelerate development: Quickly integrate advanced capabilities into your
applications without the hassle of extensive research or setup.
The generative AI catalog is the first catalog in Docker Hub, offering
specialized content for AI development.
## Generative AI catalog
The [generative AI catalog](https://hub.docker.com/catalogs/gen-ai) makes it
easy to explore and add AI capabilities to your applications. With trusted,
ready-to-use content and comprehensive documentation, you can skip the hassle of
sorting through countless tools and configurations. Instead, focus your time and
energy on creating innovative AI-powered applications.
The generative AI catalog provides a wide range of trusted content, organized
into key areas to support diverse AI development needs:
- Demos: Ready-to-deploy examples showcasing generative AI capabilities. These
demos provide a hands-on way to explore AI tools and frameworks, making it
easier to understand how they can be integrated into real-world applications.
- Models: Pre-trained AI models for tasks like text generation,
Natural Language Processing (NLP), and conversational AI. These models
provide a foundation for
AI applications without requiring developers to train models from scratch.
- Applications and end-to-end platforms: Comprehensive platforms and tools that
simplify AI application development, including low-code solutions and
frameworks for building multi-agent and Retrieval-Augmented Generation (RAG)
applications.
- Model deployment and serving: Tools and frameworks that enable developers to
efficiently deploy and serve AI models in production environments. These
resources include pre-configured stacks for GPUs and other specialized
hardware, ensuring performance at scale.
- Orchestration: Solutions for managing complex AI workflows, such as workflow
engines, Large Language Model (LLM) application frameworks, and lifecycle management
tools, to help streamline development and operations.
- Machine learning frameworks: Popular frameworks like TensorFlow and PyTorch
that provide the building blocks for creating, training, and fine-tuning
machine learning models.
- Databases: Databases optimized for AI workloads, including vector databases
for similarity search, time-series databases for analytics, and NoSQL
solutions for handling unstructured data.

View File

@ -2,12 +2,13 @@
description: Setting-up a local mirror for Docker Hub images
keywords: registry, on-prem, images, tags, repository, distribution, mirror, Hub,
recipe, advanced
title: Registry as a pull through cache
linkTitle: Mirroring
title: Mirror the Docker Hub library
linkTitle: Mirror
weight: 80
aliases:
- /engine/admin/registry_mirror/
- /registry/recipes/mirror/
- /docker-hub/mirror/
---
## Use-case
@ -37,7 +38,7 @@ Hub can be mirrored.
> [!NOTE]
>
> Mirrors of Docker Hub are still subject to Docker's [fair use policy](./download-rate-limit.md#fair-use).
> Mirrors of Docker Hub are still subject to Docker's [fair use policy](/manuals/docker-hub/download-rate-limit.md#fair-use).
### Solution

View File

@ -0,0 +1,167 @@
---
description: Discover how to browse and search Docker Hub's extensive resources.
keywords: Docker Hub, Hub, explore, search, image library
title: Docker Hub search
linkTitle: Search
weight: 10
---
The [Docker Hub search interface](https://hub.docker.com/search) lets you
explore millions of resources. To help you find exactly what you need, it offers
a variety of filters that let you narrow your results or discover different
types of content.
## Filters
The search functionality includes filters to narrow down
results based on your requirements, such as products, categories, and trusted
content. This ensures that you can quickly find and access the resources best
suited to your project.
### Products
Docker Hub's content library features three products, each designed to meet
specific needs of developers and organizations. These products include images,
plugins, and extensions.
#### Images
Docker Hub hosts millions of container images, making it the go-to repository
for containerized applications and solutions. These images include:
- Operating system images: Foundational images for Linux distributions like
Ubuntu, Debian, and Alpine, or Windows Server images.
- Database and storage images: Pre-configured databases such as MySQL,
PostgreSQL, and MongoDB to simplify application development.
- Languages and frameworks-based images: Popular images for Java, Python,
Node.js, Ruby, .NET, and more, offering pre-built environments for faster
development.
Images in Docker Hub simplify the development process by providing pre-built,
reusable building blocks, reducing the need to start from scratch. Whether
you're a beginner building your first container or an enterprise managing
complex architectures, Docker Hub images provide a reliable foundation.
#### Plugins
Plugins in Docker Hub let you extend and customize Docker Engine to suit
specialized requirements. Plugins integrate directly with the Docker Engine and
provide capabilities such as:
- Network plugins: Enhance networking functionality, enabling integration with
complex network infrastructures.
- Volume plugins: Provide advanced storage options, supporting persistent and
distributed storage across various backends.
- Authorization plugins: Offer fine-grained access control to secure Docker
environments.
By leveraging Docker plugins, teams can tailor Docker Engine to meet their
specific operational needs, ensuring compatibility with existing infrastructures
and workflows.
To learn more about plugins, see [Docker Engine managed plugin
system](/manuals/engine/extend/_index.md).
#### Extensions
Docker Hub offers extensions for Docker Desktop, which enhance its core
functionality. These extensions are purpose-built to streamline the software
development lifecycle. Extensions provide tools for:
- System optimization and monitoring: Manage resources and optimize Docker
Desktops performance.
- Container management: Simplify container deployment and monitoring.
- Database management: Facilitate efficient database operations within
containers.
- Kubernetes and cloud integration: Bridge local environments with cloud-native
and Kubernetes workflows.
- Visualization tools: Gain insights into container resource usage through
graphical representations.
Extensions help developers and teams create a more efficient and unified
workflow by reducing context switching and bringing essential tools into Docker
Desktop's interface.
To learn more about extensions, see [Docker
Extensions](/manuals/extensions/_index.md).
### Trusted content
Docker Hub's trusted content provides a curated selection of high-quality,
secure images designed to give developers confidence in the reliability and
security of the resources they use. These images are stable, regularly updated,
and adhere to industry best practices, making them a strong foundation for
building and deploying applications. Docker Hub's trusted content includes,
Docker Official Images, Verified Publisher images, and Docker-Sponsored Open
Source Software images.
For more details, see [Trusted content](./trusted-content.md).
### Categories
Docker Hub makes it easy to find and explore container images with categories.
Categories group images based on their primary use case, helping you quickly
locate the tools and resources you need to build, deploy, and run your
applications.
{{< include "hub-categories.md" >}}
### Operating systems
The **Operating systems** filter lets you narrow your search to container
images compatible with specific host operating systems. This filter ensures that
the images you use align with your target environment, whether you're developing
for Linux-based systems, Windows, or both.
- **Linux**: Access a wide range of images tailored for Linux environments.
These images provide foundational environments for building and running
Linux-based applications in containers.
- **Windows**: Explore Windows container images.
> [!NOTE]
>
> The **Operating systems** filter is only available for images. If you select
> the **Extensions** or **Plugins** filter, then the **Operating systems**
> filter isn't available.
### Architectures
The **Architectures** filter lets you find images built to support specific CPU
architectures. This ensures compatibility with your hardware environment, from
development machines to production servers.
- **ARM**: Select images compatible with ARM processors, commonly used in IoT
devices and embedded systems.
- **ARM 64**: Locate 64-bit ARM-compatible images for modern ARM processors,
such as those in AWS Graviton or Apple Silicon.
- **IBM POWER**: Find images optimized for IBM Power Systems, offering
performance and reliability for enterprise workloads.
- **PowerPC 64 LE**: Access images designed for the little-endian PowerPC 64-bit
architecture.
- **IBM Z**: Discover images tailored for IBM Z mainframes, ensuring
compatibility with enterprise-grade hardware.
- **x86**: Choose images compatible with 32-bit x86 architectures, suitable for
older systems or lightweight environments.
- **x86-64**: Filter images for modern 64-bit x86 systems, widely used in
desktops, servers, and cloud infrastructures.
> [!NOTE]
>
> The **Architectures** filter is only available for images. If you select the
> **Extensions** or **Plugins** filter, then the **Architectures** filter isn't
> available.
### Reviewed by Docker
The **Reviewed by Docker** filter provides an extra layer of assurance when
selecting extensions. This filter helps you identify whether a Docker Desktop
extension has been reviewed by Docker for quality and reliability.
- **Reviewed**: Extensions that have undergone Docker's review process, ensuring
they meet high standards.
- **Not Reviewed**: Extensions that have not been reviewed by Docker.
> [!NOTE]
>
> The **Reviewed by Docker** filter is only available for extensions. To make
> the filter available, you must select only the **Extensions** filter in **Products**.

View File

@ -1,18 +1,62 @@
---
title: Using Docker Official Images
description: |
Learn about building applications with Docker Official images
and how to interpret the tag names they use.
keywords: docker official images, doi, tags, slim, feedback, troubleshooting
weight: 10
description: Learn about Docker Hub's trusted content.
keywords: Docker Hub, Hub, trusted content
title: Trusted content
weight: 15
aliases:
- /trusted-content/official-images/using/
- /trusted-content/official-images/
---
Docker recommends you use the Docker Official Images in your projects.
These images have clear documentation, promote best practices, and are regularly updated.
Docker Official Images support most common use cases, making them perfect for new Docker users.
Advanced users can benefit from more specialized image variants as well as review Docker Official Images as part of your `Dockerfile` learning process.
Docker Hub's trusted content provides a curated selection of high-quality,
secure images designed to give developers confidence in the reliability and
security of the resources they use. These images are stable, regularly updated,
and adhere to industry best practices, making them a strong foundation for
building and deploying applications. Docker Hub's trusted content includes,
Docker Official Images, Verified Publisher images, and Docker-Sponsored Open
Source Software images.
## Tags
## Docker Official Images
The Docker Official Images are a curated set of Docker repositories hosted on
Docker Hub.
Docker recommends you use the Docker Official Images in your projects. These
images have clear documentation, promote best practices, and are regularly
updated. Docker Official Images support most common use cases, making them
perfect for new Docker users. Advanced users can benefit from more specialized
image variants as well as review Docker Official Images as part of your
`Dockerfile` learning process.
> [!NOTE]
>
> Use of Docker Official Images is subject to [Docker's Terms of Service](https://www.docker.com/legal/docker-terms-service/).
These images provide essential base repositories that serve as the starting
point for the majority of users.
These include operating systems such as
[Ubuntu](https://hub.docker.com/_/ubuntu/) and
[Alpine](https://hub.docker.com/_/alpine/), programming language runtimes such as
[Python](https://hub.docker.com/_/python) and
[Node](https://hub.docker.com/_/node), and other essential tools such as
[memcached](https://hub.docker.com/_/memcached) and
[MySQL](https://hub.docker.com/_/mysql).
The images are some of the [most secure images](https://www.docker.com/blog/enhancing-security-and-transparency-with-docker-official-images/)
on Docker Hub. This is particularly important as Docker Official Images are
some of the most popular on Docker Hub. Typically, Docker Official images have
few or no packages containing CVEs.
The images exemplify [Dockerfile best practices](/manuals/build/building/best-practices.md)
and provide clear documentation to serve as a reference for other Dockerfile authors.
Images that are part of this program have a special badge on Docker Hub making
it easier for you to identify projects that are part of Docker Official Images.
![Docker official image badge](../images/official-image-badge-iso.png)
### Supported tags and respective Dockerfile links
The repository description for each Docker Official Image contains a
**Supported tags and respective Dockerfile links** section that lists all the
@ -34,7 +78,7 @@ use or are unfamiliar with the underlying software, you should probably start wi
the `latest` image. As your understanding of the software and image variants advances,
you may find other image variants better suit your needs.
## Slim images
### Slim images
A number of language stacks such as
[Node.js](https://hub.docker.com/_/node/),
@ -62,7 +106,7 @@ COPY --from=build /app /app
CMD ["node", "app.js"]
```
## Alpine images
### Alpine images
Many Docker Official Images repositories also offer `alpine` variants. These
images are built on top of the [Alpine Linux](https://www.alpinelinux.org/)
@ -90,7 +134,7 @@ to make your program compatible with Alpine Linux and musl:
Refer to the `alpine` image [description](https://hub.docker.com/_/alpine) on
Docker Hub for examples on how to install packages if you are unfamiliar.
## Codenames
### Codenames
Tags with words that look like Toy Story characters (for example, `bookworm`,
`bullseye`, and `trixie`) or adjectives (such as `focal`, `jammy`, and
@ -103,11 +147,37 @@ Linux distribution indicators are helpful because many Docker Official Images
provide variants built upon multiple underlying distribution versions (for
example, `postgres:bookworm` and `postgres:bullseye`).
## Other tags
### Other tags
Docker Official Images tags may contain other hints to the purpose of
their image variant in addition to those described here. Often these
tag variants are explained in the Docker Official Images repository
documentation. Reading through the “How to use this image” and
“Image Variants” sections will help you to understand how to use these
documentation. Reading through the "How to use this image" and
"Image Variants" sections will help you to understand how to use these
variants.
## Verified Publisher images
The Docker Verified Publisher program provides high-quality images from
commercial publishers verified by Docker.
These images help development teams build secure software supply chains,
minimizing exposure to malicious content early in the process to save time and
money later.
Images that are part of this program have a special badge on Docker Hub making
it easier for users to identify projects that Docker has verified as
high-quality commercial publishers.
![Docker-Sponsored Open Source badge](../images/verified-publisher-badge-iso.png)
## Docker-Sponsored Open Source Software images
The Docker-Sponsored Open Source Software (OSS) program provides images that are
published and maintained by open-source projects sponsored by Docker.
Images that are part of this program have a special badge on Docker Hub making
it easier for users to identify projects that Docker has verified as trusted,
secure, and active open-source projects.
![Docker-Sponsored Open Source badge](../images/sponsored-badge-iso.png)

View File

Before

Width:  |  Height:  |  Size: 30 KiB

After

Width:  |  Height:  |  Size: 30 KiB

View File

Before

Width:  |  Height:  |  Size: 240 KiB

After

Width:  |  Height:  |  Size: 240 KiB

View File

Before

Width:  |  Height:  |  Size: 1.5 KiB

After

Width:  |  Height:  |  Size: 1.5 KiB

View File

Before

Width:  |  Height:  |  Size: 2.4 KiB

After

Width:  |  Height:  |  Size: 2.4 KiB

View File

Before

Width:  |  Height:  |  Size: 134 KiB

After

Width:  |  Height:  |  Size: 134 KiB

View File

Before

Width:  |  Height:  |  Size: 8.2 KiB

After

Width:  |  Height:  |  Size: 8.2 KiB

View File

Before

Width:  |  Height:  |  Size: 176 KiB

After

Width:  |  Height:  |  Size: 176 KiB

View File

Before

Width:  |  Height:  |  Size: 6.6 KiB

After

Width:  |  Height:  |  Size: 6.6 KiB

View File

Before

Width:  |  Height:  |  Size: 69 KiB

After

Width:  |  Height:  |  Size: 69 KiB

View File

Before

Width:  |  Height:  |  Size: 24 KiB

After

Width:  |  Height:  |  Size: 24 KiB

View File

Before

Width:  |  Height:  |  Size: 1.6 KiB

After

Width:  |  Height:  |  Size: 1.6 KiB

View File

Before

Width:  |  Height:  |  Size: 8.0 KiB

After

Width:  |  Height:  |  Size: 8.0 KiB

View File

Before

Width:  |  Height:  |  Size: 37 KiB

After

Width:  |  Height:  |  Size: 37 KiB

View File

@ -47,6 +47,11 @@ In this section, learn how to:
Bitbucket for automated builds. Every code change triggers an image
rebuild, supporting continuous integration and delivery.
- [Trusted content](./manage/trusted-content/_index.md): Contribute to Docker
Official Images or manage repositories in the Verified Publisher and
Sponsored Open Source programs, including tasks like setting logos,
accessing analytics, and enabling vulnerability scanning.
- [Archive](./archive.md) an outdated or unsupported repository.
- [Delete](./delete.md) a repository.
- [Manage personal settings](./settings.md): For your account, you can set personal

View File

@ -113,40 +113,8 @@ explore content for the problem domain that they're interested in.
### Available categories
The Docker Hub content team maintains a curated list of categories.
The available categories are:
- **API Management**: Tools for creating, publishing, analyzing, and securing
APIs.
- **Content Management System:** Software applications to create and manage
digital content through templates, procedures, and standard formats.
- **Data Science:** Tools and software to support analyzing data and generating
actionable insights.
- **Databases & Storage:** Systems for storing, retrieving, and managing data.
- **Languages & Frameworks:** Programming language runtimes and frameworks.
- **Integrations & Delivery:** Tools for Continuous Integration (CI) and
Continuous Delivery (CD).
- **Internet of Things:** Tools supporting Internet of Things (IoT)
applications.
- **Machine Learning & AI:** Tools and frameworks optimized for artificial
intelligence and machine learning projects, such as pre-installed libraries
and frameworks for data analysis, model training, and deployment.
- **Message Queues:** Message queuing systems optimized for reliable, scalable,
and efficient message handling.
- **Monitoring & Observability:** Tools to track software and system performance
through metrics, logs, and traces, as well as observability to explore the
systems state and diagnose issues.
- **Networking:** Repositories that support data exchange and connecting
computers and other devices to share resources.
- **Operating Systems:** Software that manages all other programs on a computer
and serves as an intermediary between users and the computer hardware, while
overseeing applications and system resources.
- **Security:** Tools to protect a computer system or network from theft,
unauthorized access, or damage to their hardware, software, or electronic
data, as well as from service disruption.
- **Web Servers:** Software to serve web pages, HTML files, and other assets to
users or other systems.
- **Web Analytics:** Tools to collect, measure, analyze, and report on web data
and website visitor engagement.
{{< include "hub-categories.md" >}}
### Auto-generated categories

View File

@ -0,0 +1,30 @@
---
description: Learn how to manage and contribute to trusted content.
keywords: Docker Hub, Hub, trusted content
title: Trusted content
weight: 100
---
Docker's trusted content programs ensure that container images meet the highest
standards for security, quality, and reliability. These programs provide
opportunities for publishers and contributors to share their images with
millions of developers worldwide while gaining valuable insights into their
content's usage. By participating, you can enhance your content's visibility,
build credibility, and access tools to optimize its impact within the container
ecosystem.
In this section, learn about:
- [Docker Official Images](./official-images.md): Learn how to contribute,
propose, and maintain Docker Official Images to serve as reliable foundations
for containerized applications.
- [Docker-Sponsored Open Source (DSOS) Program](dsos-program.md): Discover how
open source projects can gain perks like verified badges, insights, and access
to Docker Scout, enhancing visibility and trust on Docker Hub.
- [Docker Verified Publisher (DVP) Program](./dvp-program.md): Explore how to
join the DVP program to showcase trusted, high-quality images with a verified
badge, gain priority in search results, access insights, and enhance security
through vulnerability analysis.
- [Insights and analytics](./insights-analytics.md): Access detailed metrics on
image and extension usage, including pull counts, geolocation, and client
data, to understand user behavior and optimize your content.

View File

@ -4,15 +4,14 @@ title: Docker-Sponsored Open Source Program
keywords: docker hub, hub, insights, analytics, open source, Docker sponsored, program
aliases:
- /docker-hub/dsos-program/
- /trusted-content/dsos-program/
---
[Docker Sponsored Open Source images](https://hub.docker.com/search?q=&image_filter=open_source) are published and maintained by open-source projects sponsored by Docker through the program.
[Docker-Sponsored Open Source images](https://hub.docker.com/search?q=&image_filter=open_source) are published and maintained by open-source projects sponsored by Docker through the program.
Images that are part of this program have a special badge on Docker Hub making it easier for users to identify projects that Docker has verified as trusted, secure, and active open-source projects.
![Docker-Sponsored Open Source badge](images/sponsored-badge-iso.png)
## For content publishers
![Docker-Sponsored Open Source badge](../../../images/sponsored-badge-iso.png)
The Docker-Sponsored Open Source (DSOS) Program provides several features and benefits to non-commercial open source developers.
@ -47,25 +46,25 @@ over the repository can change the repository logo.
1. Sign in to [Docker Hub](https://hub.docker.com).
2. Go to the page of the repository that you want to change the logo for.
3. Select the upload logo button, represented by a camera icon
({{< inline-image src="images/upload_logo_sm.png" alt="camera icon" >}})
({{< inline-image src="../../../images/upload_logo_sm.png" alt="camera icon" >}})
overlaying the current repository logo.
4. In the dialog that opens, select the PNG image that you want to upload to
set it as the logo for the repository.
#### Remove the logo
Select the **Clear** button ({{< inline-image src="images/clear_logo_sm.png"
Select the **Clear** button ({{< inline-image src="../../../images/clear_logo_sm.png"
alt="clear button" >}}) to remove a logo.
Removing the logo makes the repository default to using the organization logo, if set, or the following default logo if not.
![Default logo which is a 3D grey cube](images/default_logo_sm.png)
![Default logo which is a 3D grey cube](../../../images/default_logo_sm.png)
### Verified Docker-Sponsored Open Source badge
Docker verifies that developers can trust images with this badge on Docker Hub as an active open source project.
![Fluent org with a Docker-Sponsored Open Source badge](images/sponsored-badge.png)
![Fluent org with a Docker-Sponsored Open Source badge](../../../images/sponsored-badge.png)
### Insights and analytics
@ -75,8 +74,6 @@ the community uses Docker images, granting insight into user behavior.
The usage metrics show the number of image pulls by tag or by digest, and breakdowns by
geolocation, cloud provider, client, and more.
![The insights and analytics tab on the Docker Hub website](images/insights-and-analytics-tab.png)
You can select the time span for which you want to view analytics data. You can also export the data in either a summary or raw format.
### Docker Scout

View File

@ -13,6 +13,7 @@ aliases:
- /docker-hub/publish/
- /docker-hub/publish/repository-logos/
- /docker-hub/dvp-program/
- /trusted-content/dvp-program/
---
[The Docker Verified Publisher Program](https://hub.docker.com/search?q=&image_filter=store) provides high-quality images from commercial publishers verified by Docker.
@ -21,9 +22,7 @@ These images help development teams build secure software supply chains, minimiz
Images that are part of this program have a special badge on Docker Hub making it easier for users to identify projects that Docker has verified as high-quality commercial publishers.
![Docker-Sponsored Open Source badge](./images/verified-publisher-badge-iso.png)
## For content publishers
![Docker-Sponsored Open Source badge](../../../images/verified-publisher-badge-iso.png)
The Docker Verified Publisher Program (DVP) provides several features and benefits to Docker
Hub publishers. The program grants the following perks based on participation tier:
@ -57,37 +56,35 @@ over the repository can change the repository logo.
1. Sign in to [Docker Hub](https://hub.docker.com).
2. Go to the page of the repository that you want to change the logo for.
3. Select the upload logo button, represented by a camera icon ({{< inline-image
src="./images/upload_logo_sm.png" alt="camera icon" >}}) overlaying the
src="../../../images/upload_logo_sm.png" alt="camera icon" >}}) overlaying the
current repository logo.
4. In the dialog that opens, select the PNG image that you want to upload to
set it as the logo for the repository.
#### Remove the logo
Select the **Clear** button ({{< inline-image src="images/clear_logo_sm.png"
Select the **Clear** button ({{< inline-image src="../../../images/clear_logo_sm.png"
alt="clear button" >}}) to remove a logo.
Removing the logo makes the repository default to using the organization logo, if set, or the following default logo if not.
![Default logo which is a 3D grey cube](images/default_logo_sm.png)
![Default logo which is a 3D grey cube](../../../images/default_logo_sm.png)
### Verified publisher badge
Images that are part of this program have a badge on Docker Hub making it easier for developers
to identify projects that Docker has verified as high quality publishers and with content they can trust.
![Docker, Inc. org with a verified publisher badge](./images/verified-publisher-badge.png)
![Docker, Inc. org with a verified publisher badge](../../../images/verified-publisher-badge.png)
### Insights and analytics
The [insights and analytics](/docker-hub/publish/insights-analytics) service provides usage metrics for how
The [insights and analytics](./insights-analytics.md) service provides usage metrics for how
the community uses Docker images, granting insight into user behavior.
The usage metrics show the number of image pulls by tag or by digest, and breakdowns by
geolocation, cloud provider, client, and more.
![The insights and analytics tab on the Docker Hub website](./images/insights-and-analytics-tab.png)
You can select the time span for which you want to view analytics data. You can also export the data in either a summary or raw format.
### Vulnerability analysis

View File

@ -5,6 +5,7 @@ keywords: docker hub, hub, insights, analytics, api, verified publisher
aliases:
- /docker-hub/publish/insights-analytics/
- /docker-hub/insights-analytics/
- /trusted-content/insights-analytics/
---
Insights and analytics provides usage analytics for Docker Verified
@ -31,7 +32,7 @@ To view data in the chart:
- Select the time interval: 3, 6, or 12 months
- Select one or more repositories in the list
![Insights and analytics chart visualization](./images/chart.png)
![Insights and analytics chart visualization](../../../images/chart.png)
<!-- prettier-ignore -->
> [!TIP]
@ -44,7 +45,7 @@ To view data in the chart:
You can share the visualization with others using the **Share** icon above the chart.
This is a convenient way to share statistics with others in your organization.
![Chart share icon](./images/chart-share-icon.png)
![Chart share icon](../../../images/chart-share-icon.png)
Selecting the icon generates a link that's copied to your clipboard. The link
preserves the display selections you made. When someone follows the link, the
@ -75,14 +76,14 @@ Export usage data for your organization's images using the Docker Hub website by
2. Choose your organization and select **Insights and analytics**.
![Organization overview page, with the Insights and Analytics tab](./images/organization-tabs.png)
![Organization overview page, with the Insights and Analytics tab](../../../images/organization-tabs.png)
3. Set the time span for which you want to export analytics data.
The downloadable CSV files for summary and raw data appear on the right-hand
side.
![Filtering options and download links for analytics data](./images/download-analytics-data.png)
![Filtering options and download links for analytics data](../../../images/download-analytics-data.png)
### Export data using the API

View File

@ -1,9 +1,13 @@
---
title: Contributing to Docker Official Images
title: Docker Official Images
description: |
This article describes how Docker Official Images are created,
and how you can contribute or leave feedback.
keywords: docker official images, doi, contributing, upstream, open source
aliases:
- /trusted-content/official-images/contributing/
- /docker-hub/official_repos/
- /docker-hub/official_images/
---
Docker, Inc. sponsors a dedicated team that's responsible for reviewing and

View File

@ -32,4 +32,4 @@ Refer to the following table for details on the Enhanced Service Account add-ons
| 4 | 50,000-100,000 |
| 5 | 100,000+ |
<sub>*The service account may exceed Pulls by up to 25% for up to 20 days during the year without incurring additional fees. Reports on consumption are available upon request.<sub>
<sub>*The service account may exceed Pulls by up to 25% for up to 20 days during the year without incurring additional fees. Reports on consumption are available upon request.<sub>

View File

@ -59,7 +59,7 @@ If you are using affected versions of runc, BuildKit, Moby, or Docker Desktop, m
If you are unable to update to an unaffected version promptly, follow these best practices to mitigate risk:
* Only use trusted Docker images (such as [Docker Official Images](../trusted-content/official-images/_index.md)).
* Only use trusted Docker images (such as [Docker Official Images](../docker-hub/image-library/trusted-content.md#docker-official-images)).
* Dont build Docker images from untrusted sources or untrusted Dockerfiles.
* If you are a Docker Business customer using Docker Desktop and unable to update to v4.27.1, make sure to enable [Hardened Docker Desktop](/manuals/security/for-admins/hardened-desktop/_index.md) features such as:
* [Enhanced Container Isolation](/manuals/security/for-admins/hardened-desktop/enhanced-container-isolation/_index.md), which mitigates the impact of CVE-2024-21626 in the case of running containers from malicious images.
@ -149,7 +149,7 @@ the Text4Shell CVE in the vulnerability report. For detailed instructions, see [
### Docker Official Images impacted by CVE-2022-42889
A number of [Docker Official Images](../trusted-content/official-images/_index.md) contain the vulnerable versions of
A number of [Docker Official Images](../docker-hub/image-library/trusted-content.md#docker-official-images) contain the vulnerable versions of
Apache Commons Text. The following lists Docker Official Images that
may contain the vulnerable versions of Apache Commons Text:
@ -201,7 +201,7 @@ Log4j 2 CVE in the vulnerability report. For detailed instructions, see [Scan im
_Last updated December 2021_
A number of [Docker Official Images](../trusted-content/official-images/_index.md) contain the vulnerable versions of
A number of [Docker Official Images](../docker-hub/image-library/trusted-content.md#docker-official-images) contain the vulnerable versions of
Log4j 2 CVE-2021-44228. The following table lists Docker Official Images that
may contained the vulnerable versions of Log4j 2. We updated Log4j 2 in these images to the latest version. Some of these images may not be
vulnerable for other reasons. We recommend that you also review the guidelines published on the upstream websites.

View File

@ -24,7 +24,7 @@ Contact the [Docker Sales Team](https://www.docker.com/company/contact).
### What ways can I contribute to Docker content?
Docker offers two programs:
- [Docker-Sponsored Open Source Program (DSOS)](../trusted-content/dsos-program.md)
- [Docker Verified Publisher (DVP)](../trusted-content/dvp-program.md)
- [Docker-Sponsored Open Source Program (DSOS)](../docker-hub/repos/manage/trusted-content/dsos-program.md)
- [Docker Verified Publisher (DVP)](../docker-hub/repos/manage/trusted-content/dvp-program.md)
You can also join the [Developer Preview Program](https://www.docker.com/community/get-involved/developer-preview/) or sign up for early access programs for specific products to participate in research and try out new features.

View File

@ -1,28 +0,0 @@
---
title: Trusted content
description: Optimize your development workflow with secure base images from our selection of trusted content
keywords: doi, dvp, dsos, open source, security, base images
params:
sidebar:
group: Platform
grid:
- title: Docker Official Images
description: A curated set of Docker repositories hosted on Docker Hub.
icon: /trusted-content/images/doi-icon.svg
link: /trusted-content/official-images/
- title: Docker Verified Publisher
description: High-quality images from verified vendors.
icon: /trusted-content/images/dvp-icon.svg
link: /trusted-content/dvp-program/
- title: Docker-Sponsored Open Source
description: High-quality images from non-commercial open source projects.
icon: /trusted-content/images/dsos-icon.svg
link: /trusted-content/dsos-program/
---
Trusted content is a selection of high-quality, secure images, curated by
Docker and verified publishing partners. These images are stable, up-to-date,
and follow industry best-practices. They provide a strong foundation for
developing applications.
{{< grid >}}

View File

@ -1,2 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<svg xmlns="http://www.w3.org/2000/svg" width="71" height="70" viewBox="0 0 71 70" fill="none"><mask id="mask0_4917_14425" style="mask-type:alpha" maskUnits="userSpaceOnUse" x="0" y="0" width="71" height="70"><g clip-path="url(#clip0_4917_14425)"><path d="M32.3498 37.1875L35.4998 34.7959L38.6207 37.1584C39.7582 38.0042 41.304 36.925 40.8957 35.5542L39.6707 31.5875L43.1707 28.8167C44.2498 28 43.6373 26.25 42.2373 26.25H38.154L36.8998 22.3417C36.4623 21 34.5665 21 34.129 22.3417L32.8457 26.25H28.7332C27.3623 26.25 26.7498 28 27.829 28.8459L31.2998 31.6167L30.0748 35.5834C29.6665 36.9542 31.2123 38.0334 32.3498 37.1875ZM17.9998 63.0292C17.9998 65.0125 19.954 66.4125 21.8498 65.8L35.4998 61.25L49.1498 65.8C51.0457 66.4417 52.9998 65.0417 52.9998 63.0292V44.5667C56.6165 40.4542 58.8332 35.0875 58.8332 29.1667C58.8332 16.275 48.3915 5.83337 35.4998 5.83337C22.6082 5.83337 12.1665 16.275 12.1665 29.1667C12.1665 35.0875 14.3832 40.4542 17.9998 44.5667V63.0292ZM35.4998 11.6667C45.154 11.6667 52.9998 19.5125 52.9998 29.1667C52.9998 38.8209 45.154 46.6667 35.4998 46.6667C25.8457 46.6667 17.9998 38.8209 17.9998 29.1667C17.9998 19.5125 25.8457 11.6667 35.4998 11.6667Z" fill="black"/></g></mask><g mask="url(#mask0_4917_14425)"><rect x="0.5" width="70" height="70" fill="#2E7F74"/></g><defs><clipPath id="clip0_4917_14425"><rect width="70" height="70" fill="white" transform="translate(0.5)"/></clipPath></defs></svg>

Before

Width:  |  Height:  |  Size: 1.4 KiB

View File

@ -1,2 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<svg xmlns="http://www.w3.org/2000/svg" width="71" height="70" viewBox="0 0 71 70" fill="none"><mask id="mask0_4917_14435" style="mask-type:alpha" maskUnits="userSpaceOnUse" x="0" y="0" width="71" height="70"><g clip-path="url(#clip0_4917_14435)"><path d="M12.1672 26.2501C12.9255 27.0085 13.1588 28.0876 12.8963 29.1085C11.8755 33.0751 11.8463 37.4793 13.188 41.8835C15.7547 50.371 23.2213 56.7585 31.9713 58.071C48.0713 60.4335 61.6922 46.2293 58.3088 30.0127C56.413 20.8835 48.888 13.6501 39.7297 12.046C36.2005 11.4335 32.788 11.6085 29.638 12.4251C28.6172 12.6876 27.5088 12.4251 26.7797 11.696C25.1463 10.0626 25.963 7.35015 28.1505 6.76682C32.438 5.65848 37.0755 5.48348 41.8588 6.50432C53.4672 9.01265 62.538 18.696 64.3172 30.421C67.3505 50.2835 50.2588 67.1127 30.3672 63.7293C18.6713 61.7168 9.19218 52.471 6.91718 40.8335C6.01301 36.196 6.21718 31.7335 7.26718 27.621C7.85051 25.4335 10.563 24.646 12.1672 26.2501ZM18.0005 35.0002C18.0005 25.346 25.8463 17.5001 35.5005 17.5001C45.1547 17.5001 53.0005 25.346 53.0005 35.0002C53.0005 44.6543 45.1547 52.5001 35.5005 52.5001C25.8463 52.5001 18.0005 44.6543 18.0005 35.0002ZM20.9172 16.0418C20.9172 18.4626 18.963 20.4168 16.5422 20.4168C14.1213 20.4168 12.1672 18.4626 12.1672 16.0418C12.1672 13.621 14.1213 11.6668 16.5422 11.6668C18.963 11.6668 20.9172 13.621 20.9172 16.0418Z" fill="black"/></g></mask><g mask="url(#mask0_4917_14435)"><rect x="0.5" width="70" height="70" fill="#7D2EFF"/></g><defs><clipPath id="clip0_4917_14435"><rect width="70" height="70" fill="white" transform="translate(0.5)"/></clipPath></defs></svg>

Before

Width:  |  Height:  |  Size: 1.6 KiB

View File

@ -1,2 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<svg xmlns="http://www.w3.org/2000/svg" width="71" height="70" viewBox="0 0 71 70" fill="none"><mask id="mask0_4917_14411" style="mask-type:alpha" maskUnits="userSpaceOnUse" x="0" y="0" width="71" height="70"><g clip-path="url(#clip0_4917_14411)"><path d="M67.5832 35L60.4665 26.8625L61.4582 16.1L50.929 13.7083L45.4165 4.375L35.4998 8.63333L25.5832 4.375L20.0707 13.6792L9.5415 16.0417L10.5332 26.8333L3.4165 35L10.5332 43.1375L9.5415 53.9292L20.0707 56.3208L25.5832 65.625L35.4998 61.3375L45.4165 65.5958L50.929 56.2917L61.4582 53.9L60.4665 43.1375L67.5832 35ZM27.8582 46.6958L20.9165 39.6958C19.779 38.5583 19.779 36.7208 20.9165 35.5833L21.1207 35.3792C22.2582 34.2417 24.1248 34.2417 25.2623 35.3792L29.9582 40.1042L44.979 25.0542C46.1165 23.9167 47.9832 23.9167 49.1207 25.0542L49.3248 25.2583C50.4623 26.3958 50.4623 28.2333 49.3248 29.3708L32.0582 46.6958C30.8623 47.8333 29.0248 47.8333 27.8582 46.6958Z" fill="black"/></g></mask><g mask="url(#mask0_4917_14411)"><rect x="0.5" width="70" height="70" fill="#086DD7"/></g><defs><clipPath id="clip0_4917_14411"><rect width="70" height="70" fill="white" transform="translate(0.5)"/></clipPath></defs></svg>

Before

Width:  |  Height:  |  Size: 1.2 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 194 KiB

View File

@ -1,44 +0,0 @@
---
description: Get an overview on Docker Official Images, what they are, and how they differ from other images available on Docker Hub
keywords: Docker, docker, registry, accounts, plans, Dockerfile, Docker Hub, docs,
official,image, documentation
title: Docker Official Images
aliases:
- /docker-hub/official_repos/
- /docker-hub/official_images/
---
The [Docker Official Images](https://hub.docker.com/search?q=&type=image&image_filter=official)
are a curated set of Docker repositories hosted on Docker Hub.
> [!NOTE]
>
> Use of Docker Official Images is subject to [Docker's Terms of Service](https://www.docker.com/legal/docker-terms-service/).
These images provide essential base repositories that serve as the starting
point for the majority of users.
These include operating systems such as
[Ubuntu](https://hub.docker.com/_/ubuntu/) and
[Alpine](https://hub.docker.com/_/alpine/), programming language runtimes such as
[Python](https://hub.docker.com/_/python) and
[Node](https://hub.docker.com/_/node), and other essential tools such as
[memcached](https://hub.docker.com/_/memcached) and
[MySQL](https://hub.docker.com/_/mysql).
The images are some of the [most secure images](https://www.docker.com/blog/enhancing-security-and-transparency-with-docker-official-images/)
on Docker Hub. This is particularly important as Docker Official Images are
some of the most popular on Docker Hub. Typically, Docker Official images have
few or no packages containing CVEs.
The images exemplify [`Dockerfile` best practices](/manuals/build/building/best-practices.md)
and provide clear documentation to serve as a reference for other `Dockerfile` authors.
Images that are part of this program have a special badge on Docker Hub making
it easier for you to identify projects that are part of Docker Official Images.
![Docker official image badge](../images/official-image-badge-iso.png)
## In this section
{{% sectionlinks %}}