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

180 Commits

Author SHA1 Message Date
Allie Sadler
0b2b9a410c DD IA work (#26215)
<!--Delete sections as needed -->

## Description

As per IA plan, move enterprise content into Desktop area

## 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

---------

Signed-off-by: aevesdocker <allie.sadler@docker.com>
2026-09-29 13:24:41 +01:00
David Karlsson
3de2f99327 docs: cloud sandboxes CLI (#26158)
## Description

Add cloud Sandboxes documentation for sbx v0.45.0, covering credentials,
network policy, lifecycle, environment files, and transfers between
local and cloud sandboxes. Document named sandbox reuse and resume,
resource sizes and platform selection, custom secrets, move behavior,
and local UDP guidance.

Link to the canonical Docker Agentic Platform signup, billing, and
Console MCP instructions. Keep CLI sign-in, access checks, and cloud
credential setup in the Sandboxes guides.

This PR also vendors the CLI reference including `sbx move`, and aligns
timeout and move guidance with it. Kits v3 and API/SDK documentation are
handled separately.

Validation: scoped Markdown and Vale checks and a full Hugo build
passed. Cloud and Agentic Platform guides passed rendered internal link
and anchor checks, including the canonical signup page's discovery. The
earlier CLI import verified all 119 vendored files against upstream
byte-for-byte and checked 1,083 rendered CLI-reference links and
anchors. Behavior was checked against source; live cloud workflows and
checkout were not exercised.

@netlify /ai/sandboxes/cloud/

Generated by Codex
2026-09-24 18:13:01 +02:00
David Karlsson
35b5981250 Revert "docs: add cloud sandboxes documentation (#26030)"
This reverts commit 3d15caeca7.
2026-09-10 08:41:37 +02:00
David Karlsson
3d15caeca7 docs: add cloud sandboxes documentation (#26030)
## Summary

Adds a dedicated cloud sandboxes section for the first public `sbx
--cloud` release. Covers the cloud operating model, local differences,
usage, credentials, network policy, and filesystem transfers between
local and cloud sandboxes.

@netlify /ai/sandboxes/cloud/

## Preview

- [Cloud
sandboxes](https://deploy-preview-26030--docsdocker.netlify.app/ai/sandboxes/cloud/)
- [Local and cloud
differences](https://deploy-preview-26030--docsdocker.netlify.app/ai/sandboxes/cloud/local-vs-cloud/)
- [Use cloud
sandboxes](https://deploy-preview-26030--docsdocker.netlify.app/ai/sandboxes/cloud/usage/)
- [Authenticate cloud
agents](https://deploy-preview-26030--docsdocker.netlify.app/ai/sandboxes/cloud/credentials/)
- [Manage cloud network
policy](https://deploy-preview-26030--docsdocker.netlify.app/ai/sandboxes/cloud/network-policy/)
- [Move a
sandbox](https://deploy-preview-26030--docsdocker.netlify.app/ai/sandboxes/cloud/move/)

Generated by Codex
2026-09-09 10:12:23 +02:00
David Karlsson
b98c400647 docs: prototype new get started journeys (#25986)
## Summary

Prototypes a task-first Get started experience organized around three
short journeys:

- Containerization: run a container and application stack, build an
image, and share it.
- AI development: move an existing full-autonomy coding-agent workflow
into a disposable Docker Sandbox.
- Administration: invite a pilot user, apply a Docker Desktop policy,
and verify the managed experience.

The change replaces the existing Get started landing content with a
compact journey selector, adds direct installation paths for Docker and
Docker Sandboxes above the tutorials, adds the tutorials as a
collapsible sidebar group, and updates homepage and `llms.txt` discovery
paths. The container and sandbox tutorials include focused next steps
into relevant concept and manual pages.

The superseded Introduction series and its unused images are removed.
Its published routes and legacy aliases, including the workshop routes
consolidated on `main`, redirect to the replacement container tutorial
or the Get Docker page. Inbound documentation links point to the new
tutorial.

The existing Docker concepts content remains available while this
direction is evaluated.

@netlify /get-started/

## Deploy preview

- [Get started landing
page](https://deploy-preview-25986--docsdocker.netlify.app/get-started/)
- [Containerization
tutorial](https://deploy-preview-25986--docsdocker.netlify.app/get-started/tutorials/run-an-app/)
- [AI agent
tutorial](https://deploy-preview-25986--docsdocker.netlify.app/get-started/tutorials/run-an-agent/)
- [Administrator
tutorial](https://deploy-preview-25986--docsdocker.netlify.app/get-started/tutorials/admin-set-up/)

Generated by Codex

---------

Co-authored-by: Codex <noreply@openai.com>
2026-09-07 13:38:47 +02:00
Linus
e22ec2bc07 docs: fix accidental ordered-list rendering in develop-with-containers (#25974)
While reading this page, I noticed "1)" renders as a bullet point while
"2)" stays inline mid-sentence:

> This was made possible because
> 1. the processes running in each container are watching and responding
to
> file changes and 2) the files in your local project directory are
shared
>    ...

Checked the file history with `git log -L` — the original text used `1)`
and `2)` symmetrically as an inline parenthetical enumeration, all on
one line. A later commit addressing #24394 (clarifying where the files
are located) expanded the paragraph and reflowed it across multiple
lines, which put `1)` at the start of a line. Per the [CommonMark
spec](https://spec.commonmark.org/0.31.2/#ordered-list-marker), both `.`
and `)` after a digit at the start of a line are valid ordered-list
markers — so `1)` now renders as an actual list item, while `2)`, still
mid-line, stays as plain text. Inconsistent and presumably unintended.

This PR restores the sentence to a single paragraph (matching the
pre-#24394 formatting), keeping the additional clarifying text that
#24394 added. Verified in a local Markdown preview that it now renders
as plain prose with no stray list item.
2026-08-31 10:38:37 -07:00
Usha Mandya
cb6f394c0f Remove the outdated docker workshop section
Signed-off-by: Usha Mandya <usha.mandya@docker.com>
2026-08-28 12:13:05 +01:00
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