Skip to content

docs: update docker installation section to mention docker Hub image#2238

Open
pvbang wants to merge 1 commit into
asyncapi:masterfrom
pvbang:fix/docker-installation-docs
Open

docs: update docker installation section to mention docker Hub image#2238
pvbang wants to merge 1 commit into
asyncapi:masterfrom
pvbang:fix/docker-installation-docs

Conversation

@pvbang

@pvbang pvbang commented Jun 14, 2026

Copy link
Copy Markdown

Description

This PR updates the Docker installation documentation (docs/installation.md) to mention the official Docker Hub image availability.

Changes

The Docker section previously only mentioned building the image from source code. This update:

  1. Adds a "Using the official Docker Hub image" subsection (marked as recommended) with:

    • docker pull asyncapi/cli command for latest version
    • Command for pulling specific versions
    • Link to the Docker Hub tags page
    • Practical usage examples (validate, generate from template)
  2. Moves existing build-from-source instructions to a "Building from source" subsection as an alternative approach

Related Issue

Closes #1799

Motivation

The asyncapi/cli Docker image is already published on Docker Hub with 274+ tags, but the installation docs did not mention this. Users had to discover it on their own or build from source unnecessarily. This update makes the recommended Docker workflow more discoverable.

Checklist

  • Documentation updated
  • Follows existing doc structure and formatting conventions
  • Tested Docker Hub image availability (confirmed: latest tag exists)

The Docker installation docs previously only mentioned building from source.
This update adds information about the official Docker Hub image
(asyncapi/cli) which is the recommended approach for most users.

Changes:
- Add 'Using the official Docker Hub image' subsection (recommended)
- Include docker pull commands for latest and specific versions
- Add link to Docker Hub tags page
- Add practical usage examples (validate, generate)
- Move existing build-from-source instructions to a subsection

Closes asyncapi#1799
@changeset-bot

changeset-bot Bot commented Jun 14, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 4187a6c

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@sonarqubecloud

Copy link
Copy Markdown

@AayushSaini101 AayushSaini101 changed the title docs: update Docker installation section to mention Docker Hub image docs: update docker installation section to mention docker Hub image Jun 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: To Triage

Development

Successfully merging this pull request may close these issues.

[📑 Docs]: Docs for installation with docker not mention the docker repository image for cli.

1 participant