1
0
mirror of https://github.com/docker/docs.git synced 2026-10-23 18:09:02 +03:00
Commit Graph

173 Commits

Author SHA1 Message Date
Dean Chen
27694b540c docs: document HOST_IP:HOST_PORT:CONTAINER_PORT publish syntax
Get-started publishing page only covered host:container. Add the optional
bind address form and a Compose example so 127.0.0.1:… style mappings are
discoverable.

Fixes #22253

Signed-off-by: Dean Chen <862469039@qq.com>
2026-08-11 07:55:52 +05:00
David Karlsson
63ddb2912c Merge pull request #25710 from dvdksn/codex/migrate-rumdl
build: migrate Markdown tooling to rumdl
2026-08-05 09:16:24 +02:00
David Karlsson
406058190a Merge pull request #23911 from ssmf/patch-1
Update base image version in multi-stage Dockerfile build
2026-07-24 14:18:38 +02:00
Kristiyan Velkov
00124c06a0 Add Docker resource for React.js developers (#25444)
Added a new resource for Docker learning focused on React.js
development, including a discount code.

<!--Delete sections as needed -->

## Description

Added a new resource for Docker learning focused on React.js
development, including a discount code. My book Docker for React.js
developers.

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [x] Editorial review
- [ ] Product review

---------

Co-authored-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-07-03 20:53:50 +02:00
Devendra kushwah
01416dc32a Clarify volume mount wording in persist DB tutorial (#25405)
## Description

Clarifies the wording in the "Persist the DB" workshop tutorial.

The volume is already created and named (`todo-db`) in step 1 using
`docker volume create`. The previous wording in step 3 suggested that
the volume was being named there, while the command actually uses the
existing volume as the mount source.

This change updates the wording to make the workflow clearer and more
technically accurate.

## Related issues or tickets

Fixes #25404

## Reviews

* [x] Technical review
* [ ] Editorial review
* [ ] Product review
2026-06-22 14:31:14 -07:00
Rafael Coelho
dcfd3df3cb docs: fix assorted grammar errors
- Python/Ruby GitHub Actions CI guides: 'is runs' -> 'runs', 'of you' ->
    'of your', and 'Login to Docker Hub' link text -> 'Log in to Docker Hub'
  - configure-builder: 'of you workflow' -> 'of your workflow'
  - bind-mount page: remove stray article ('the a container' -> 'the container')
  - pre-seeding guide: 'let you access to' -> 'letting you access', 'define' -> 'defines'
2026-06-17 09:10:12 -03:00
Mohammad-Ali A'RÂBI
2c03c2dcd1 Add Docker and Kubernetes Security resource (#25177)
Added a new resource for Docker and Kubernetes security with a discount
code.
2026-06-10 14:15:55 -07:00
Kaflesagar0
934faffc71 Update Docker login command syntax
There was -u missing in the login command syntax, which would prompt to provide username and password, but never succeed the login attempt.
2026-06-02 11:16:23 +03:00
Allie Sadler
f0e4e47901 redirect tidy (#25115)
<!--Delete sections as needed -->

## Description

As per Craigs number-crunching, this PR removes some vvvvv old and
unused redirects 🧹

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2026-05-28 14:39:44 +01:00
David Karlsson
f425f09df7 get-started: render registry diagram with mermaid
Replaces the goat ASCII-art registry/repository/image diagram with a
mermaid flowchart that uses nested subgraphs to express the same
containment hierarchy. Also exercises the new mermaid codeblock hook
so the layouts ship with at least one consumer.
2026-05-27 12:17:24 +02:00
Craig Osterhout
0ed6c96eb6 guides: remove init (#25089)
<!--Delete sections as needed -->

## Description

Removing `docker init` workflow from guides. See ticket for more info.
Instead, have copy-paste codeblocks of the existing output. Added tip to
use Gordon.

## Related issues or tickets

ENGDOCS-3299

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Editorial review

---------

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2026-05-20 11:25:34 -07:00
Harsh Manvar
254f1d0835 Add 'Operational AI with Docker' to resources
Added a new book recommendation for Docker enthusiasts.

Operation AI with Docker 
- Introduce Docker-based AI development workflow
- Cover Docker Model Runner for local LLM execution
- Explain Docker offload capabilities for AI workloads
- Add KAGENS containers overview and usage patterns
- Describe running AI models inside isolated containers
- Include examples for local AI model deployment using Docker
- Demonstrate GPU/CPU acceleration setup for model inference
- Cover containerized environment setup for AI development
- Show practical use cases for AI experimentation locally
- Add developer-friendly workflows for reproducible AI systems
2026-05-19 13:48:12 +05:30
David Karlsson
ee71c80562 chore: migrate icons from Material Symbols to Heroicons
Replaces @material-symbols/svg-400 (5.5 MB) with heroicons (488 KB) — an
11x reduction in icon asset size. Heroicons uses a single consistent
distribution format (24px solid SVGs, fill="currentColor") eliminating
the need for the separate utils/svg.html partial, the icon-svg-stroke CSS
utility, and the dual-path resolution logic in icon.html.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-05-18 12:05:54 +02:00
John Haugabook
f97a5fa1f8 what-is-a-container.md: minor grammar fix (#24923)
## Description

Removed unnecessary 'to' in the explanation of container port exposure.
This reads much better.

## Related issues or tickets

None.

## Reviews

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2026-04-28 15:18:51 -07:00
David Karlsson
e4b70a5dbc Merge pull request #24140 from dvdksn/bind-create-src
engine: add bind-create-src mount option
2026-04-13 16:34:34 +02:00
alatos2
cd5615c3da docs: changed '/.' to './' in bind_mounts under the git bash tab
Signed-off-by: alatos2 <alabitosin60@gmail.com>
2026-03-28 19:31:51 +00:00
David Karlsson
adc8d38f53 Merge pull request #24413 from docker/agent/issue-24394
docs: address issue #24394
2026-03-19 10:44:25 +01:00
Rohan Santhosh Kumar
a09b94306d Fix typo in What's next page description (#24407)
## Description

Fixes a typo in the What's next page description by changing "hep" to
"help".

## Related issues or tickets

N/A

## Reviews

Docs-only, single-file change aligned with CONTRIBUTING.md general
guidelines.
Validation/testing: not run locally; no behavior change.

- [ ] Technical review
- [x] Editorial review
- [ ] Product review

Co-authored-by: rohan436 <rohan.santhoshkumar@googlemail.com>
2026-03-19 08:48:49 +00:00
dvdksn
3e21d7caaa docs: address issue #24394
This change was automatically generated by the documentation agent team
in response to issue #24394.

🤖 Generated with cagent
2026-03-19 08:24:01 +00:00
Tiara Johnson
e7e28c4386 Update pricing url with ref and refAction params [GRO-282] (#24339)
## Description
In order to better attribute upgrade sources, we are adding two params -
`ref` and `refAction` to the existing pricing url.
The `ref` will be "Docs" and the `refAction` will be the particular docs
page from where the pricing url click is originated.

## Related issues or tickets
https://docker.atlassian.net/browse/GRO-282

## Reviews
@akristen You should see the new url params when hovering over or
clicking any of the updated pricing urls

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review

---------

Co-authored-by: Alexa Kristensen <81787716+akristen@users.noreply.github.com>
2026-03-12 09:12:44 -05:00
David Karlsson
489c731815 engine: add bind-create-src mount option
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-03-05 14:02:10 +01:00
Guillaume Tardif
58df09f05f Update docs to rename cagent => docker agent
Signed-off-by: Guillaume Tardif <guillaume.tardif@gmail.com>
2026-03-04 16:36:11 +01:00
David Karlsson
c5b3cb60ad chore: fix links pointing to redirect targets
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-02-24 08:01:08 +01:00
David Karlsson
70d0c07c69 site: use content adapters for cli reference
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-02-24 08:01:05 +01:00
David Karlsson
33226cf897 site: simplify guides/series layouts
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-02-23 17:29:31 +01:00
Usha Mandya
6eb77d004b Update edu resources section
Signed-off-by: Usha Mandya <usha.mandya@docker.com>
2026-02-20 15:30:06 +00:00
David Karlsson
f4310aed2f fix: move /desktop/install alias to get-docker page
The /desktop/install alias was self-referential, but to a page that was never
rendered

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-02-19 16:09:14 +01:00
Achan Sai Pranay
88db8a35ad Docs: fix subject-verb agreement in Docker platform overview (#24127)
This pull request fixes a minor subject–verb agreement issue in the
Docker platform overview documentation to improve grammatical clarity
and readability.
2026-02-11 10:10:49 +00:00
shynur
64afacc22f ; fix typo 2026-02-05 11:37:27 +08:00
Ajeet Singh Raina, Docker Captain, ARM Innovator
ca0e85cf12 Replacing Yarn with npm in Docker Workshop (#24012)
- replace old Docker desktop screenshot with the new sidebar
- Remove all references to Yarn in the explanation for Part 1
- Show new project directory structure for getting-started-repo
- Remove PWD reference from Part 3
- Remove all occurances of Yarn in Part 7 and 8

<!--Delete sections as needed -->

## Description

<!-- Tell us what you did and why -->

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

This PR is heavily dependent upon
https://github.com/docker/getting-started-app/pull/98

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review

---------

Co-authored-by: Craig Osterhout <craig.osterhout@docker.com>
2026-01-28 07:58:31 -08:00
Alexa Kristensen
f61c34a1f6 Initial verification sweep for account sign ups (#24005)
This PR adds minor adjustments to sign up procedures in prerequisite
sections.

* Adding one word `verified` to instances of `Docker account` in
prerequisite sections is a subtle, unobtrusive change that returning,
verified users can gloss over, while still prompting new users to verify
their email if they haven't yet.
* Changes stick to specific instances in `## Prerequisite` sections and
does not add `verified` to every instance (which would be obtrusive).
* Edits to Create Account doc to remove redundant callouts, consolidate
steps for shorter procedures, and add context about verification.
* If an instance of `Docker account` links to /create-account and not
the sign up page, I did not add `verification`.
* **Note**: we may want to consider a direct link to a sign up page
rather than linking them to a create account page. This can be a
separate PR, however.
2026-01-23 09:09:37 -06:00
Ajeet Singh Raina, Docker Captain, ARM Innovator
fbcabd5b97 updated spring initializr with the new version (#23999)
<!--Delete sections as needed -->

## Description

This PR:

- Updates the old Spring Initializr screenshot page with the latest one
- Updates Spring Boot to 4.0.1 version


<!-- Tell us what you did and why -->

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2026-01-21 08:34:29 -08:00
Ajeet Singh Raina, Docker Captain, ARM Innovator
f482b78ec9 Update understanding-image-layers.md (#23996)
<!--Delete sections as needed -->

## Description

Updated the Docker image layer output with the correct and latest size.

<!-- Tell us what you did and why -->

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2026-01-20 14:59:50 -08:00
Ajeet Singh Raina, Docker Captain, ARM Innovator
d3bff5b489 Updated the screenshots with the latest node version (#23997)
<!--Delete sections as needed -->

## Description

This PR replaces old screenshots with the latest Node version.

<!-- Tell us what you did and why -->

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2026-01-20 14:58:30 -08:00
Ajeet Singh Raina, Docker Captain, ARM Innovator
eaff43affd Revamped the Running Containers pages (#23998)
<!--Delete sections as needed -->

## Description

This PR:
- Replaces old Docker Desktop sidebar screenshots
- Updates the Volume section with the latest menu
- Updates psql CLI with the right version
- Adds New UI for scheduling Exports and Containers in-use

<!-- Tell us what you did and why -->

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2026-01-20 14:57:56 -08:00
Ajeet Singh Raina, Docker Captain, ARM Innovator
aa3af370e7 get started: update guide (#23989)
<!--Delete sections as needed -->

## Description

This PR:

- Replaces `exec-into-container` image with the latest screenshot
- Replaces `inspecting-container` image with the latest screenshot
- Add DHI specific information to multiple pages
- Updates welcome-to-docker image details

<!-- Tell us what you did and why -->

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review

---------

Co-authored-by: Craig Osterhout <craig.osterhout@docker.com>
2026-01-16 11:51:17 -08:00
sproutness
6f8977d4fb Update base image version in multi-stage Dockerfile build
the previous version was not reflecting the docs contents
2026-01-09 22:36:04 +01:00
Sharjeel Faiq
546ade7ffa Update what-is-a-container.md (#23950)
Fixed grammar issue

OLD LINE
Since containers are run in isolation, they have minimal influence on
the host and other containers, increasing the security of your
applications.

NEW LINE
Since containers run in isolation, they have minimal influence on the
host and other containers, increasing the security of your applications.
2026-01-09 11:00:08 +00:00
Craig Osterhout
54ca9b78c4 get-started: add alias (#23942)
<!--Delete sections as needed -->

## Description

Added alias for old path.

## Related issues or tickets

Closes #23919

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Editorial review

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2026-01-08 07:36:33 +00:00
KundanGowda N
dc95063e4c Improve wording and punctuation in Docker overview documentation (#23845)
### Description
Improves wording and punctuation in the Docker overview documentation
for clarity and consistency.

### Related issue
N/A
2025-12-17 09:55:48 +00:00
David Karlsson
0220ef6745 chore: change mount path to work with postgres:18
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-12-04 11:08:14 +01:00
David Karlsson
5ec771e17c fix: update links to docker hub trusted content categories
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-11-03 15:39:36 +01:00
Andrew Hopp
9944982ec0 Add note about application startup delay in Docker Compose tutorial (#23621)
## Summary

Adds a note to the Docker Compose tutorial clarifying that the
application may take 10-15 seconds to fully start after running `docker
compose up -d --build`.

## Changes

Updated step 5 in the "Start the application" section to inform users
that the application may not be immediately accessible at
`localhost:3000` and that they should wait a moment and refresh if the
page doesn't load right away.

## Why this change is needed

When users run `docker compose up`, Docker reports containers as
"Started" once they're running, but the applications inside (Node.js app
and MySQL database) still need time to initialize and connect. This
causes confusion for beginners who expect immediate accessibility after
seeing "Container started" in the CLI output or within the GUI.

## Related Issue

Fixes #23500

Co-authored-by: Andrew Hopp <ahopp@Andrews-Laptop.local>
2025-10-29 07:54:00 +00:00
Allie Sadler
14acf49df4 ENGDOCS-3070 (#23594)
<!--Delete sections as needed -->

## Description

Fixes https://github.com/docker/docs/issues/23235

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-10-23 13:40:35 +01:00
Craig Osterhout
88ef79f840 get-started: update write a dockerfile (#23478)
<!--Delete sections as needed -->

## Description

Current issues:
 - There are several `package.json` files, so it's ambiguous.
- There is already a `Dockerfile`, so it must be deleted if asking the
user to create one. Also, the existing Dockerfile has a different image
version than the one the user is asked to create.

Fixes:
- Added step to explore the existing Dockerfile to have a smoother
transition into deleting it.
 - Added step to delete the Dockerfile.
- Updated step to specify the exact folder where to create the new
Dockerfile.



https://deploy-preview-23478--docsdocker.netlify.app/get-started/docker-concepts/building-images/writing-a-dockerfile/#creating-the-dockerfile

## Related issues or tickets

https://docker.slack.com/archives/C04BMTUC41E/p1759261212446019

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Editorial review

---------

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-10-01 08:02:00 -07:00
Craig Osterhout
c2f6f03da4 get-started: update node version (#23464)
<!--Delete sections as needed -->

## Description

Updated image to `node:lts-alpine` and tested in bind mounts,
multi-container, and compose topics.

`node:18-alpine` is no longer available.
The image was already updated to `node:lts-alpine` in the initial topics
of the workshop.
lts (version 22) should be good until April 2027

## Related issues or tickets

https://docker.slack.com/archives/C04BMTUC41E/p1758903149468219

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Editorial review

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-09-29 08:15:55 -07:00
Antonio Carvalho
36d02515dd Update dockerfile example port (#23448)
## Description

Mismatch between exposed port and port used by command.

## Reviews


<!-- List applicable reviews (optionally @tag reviewers) -->

- [x] Technical review
- [x] Editorial review
- [ ] Product review
2025-09-24 12:21:20 +01:00
JPBotelho
2c0d6fd792 fix: typos (#23435)
<!--Delete sections as needed -->

## Description

Fixed typos

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-09-19 16:05:53 -07:00
Craig Osterhout
336aab878b get-started: fix typo (#23406)
<!--Delete sections as needed -->

## Description

Fixed typo.

## Related issues or tickets

https://docker.slack.com/archives/C04BMTUC41E/p1757683181769229

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Editorial review

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-09-15 08:17:34 -07:00
Michael Irwin
19961dd50f Couple of freshness updates to the Docker Concepts pages (#23361)
## Description

Couple of small freshness updates to the concepts pages.

Note that I didn't update any screenshots, despite many of them being
old. Most screenshots are still valid, but on older designs. Can do
another PR for screenshot updates if desired.
2025-09-04 13:36:06 -07:00