diff --git a/content/build/ci/github-actions/build-summary.md b/content/build/ci/github-actions/build-summary.md
index 0a598a7a28..53504a26e4 100644
--- a/content/build/ci/github-actions/build-summary.md
+++ b/content/build/ci/github-actions/build-summary.md
@@ -45,7 +45,7 @@ the [Docker Desktop **Builds** view](../../../desktop/use-desktop/builds.md).
To import the build record archive into Docker Desktop:
-1. Download and install [Docker Desktop](../../../get-docker.md).
+1. Download and install [Docker Desktop](/get-started/get-docker.md).
2. Download the build record archive from the job summary in GitHub Actions.
diff --git a/content/build/guide/intro.md b/content/build/guide/intro.md
index 10892aa0d5..c65ccb8c6c 100644
--- a/content/build/guide/intro.md
+++ b/content/build/guide/intro.md
@@ -12,7 +12,7 @@ you can improve how you build the application with Docker.
To follow this guide:
-1. Install [Docker Desktop or Docker Engine](../../get-docker.md)
+1. Install [Docker Desktop or Docker Engine](/get-started/get-docker.md)
2. Clone or create a new repository from the
[application example on GitHub](https://github.com/dockersamples/buildme)
diff --git a/content/desktop/install/archlinux.md b/content/desktop/install/archlinux.md
index 7ef6c43f83..3dd862f36a 100644
--- a/content/desktop/install/archlinux.md
+++ b/content/desktop/install/archlinux.md
@@ -52,7 +52,7 @@ $ sudo pacman -S gnome-terminal
## Next steps
- Explore [Docker's core subscriptions](https://www.docker.com/pricing/) to see what Docker can offer you.
-- Take a look at the [Docker workshop](../../guides/workshop/_index.md) to learn how to build an image and run it as a containerized application.
+- Take a look at the [Docker workshop](/get-started/workshop/_index.md) to learn how to build an image and run it as a containerized application.
- [Explore Docker Desktop](../use-desktop/index.md) and all its features.
- [Troubleshooting](../troubleshoot/overview.md) describes common problems, workarounds, how to run and submit diagnostics, and submit issues.
- [FAQs](../faqs/general.md) provide answers to frequently asked questions.
diff --git a/content/desktop/install/debian.md b/content/desktop/install/debian.md
index 62a00ae7f9..264bdd5cd1 100644
--- a/content/desktop/install/debian.md
+++ b/content/desktop/install/debian.md
@@ -85,7 +85,7 @@ Don't forget to substitute `` with the architecture you want.
## Next steps
- Explore [Docker's core subscriptions](https://www.docker.com/pricing/) to see what Docker can offer you.
-- Take a look at the [Docker workshop](../../guides/workshop/_index.md) to learn how to build an image and run it as a containerized application.
+- Take a look at the [Docker workshop](/get-started/workshop/_index.md) to learn how to build an image and run it as a containerized application.
- [Explore Docker Desktop](../use-desktop/index.md) and all its features.
- [Troubleshooting](../troubleshoot/overview.md) describes common problems, workarounds, how to run and submit diagnostics, and submit issues.
- [FAQs](../faqs/general.md) provide answers to frequently asked questions.
diff --git a/content/desktop/install/fedora.md b/content/desktop/install/fedora.md
index 52fbc290d1..358a7641bd 100644
--- a/content/desktop/install/fedora.md
+++ b/content/desktop/install/fedora.md
@@ -77,7 +77,7 @@ Don't forget to substitute `` with the architecture you want.
## Next steps
- Explore [Docker's core subscriptions](https://www.docker.com/pricing/) to see what Docker can offer you.
-- Take a look at the [Docker workshop](../../guides/workshop/_index.md) to learn how to build an image and run it as a containerized application.
+- Take a look at the [Docker workshop](/get-started/workshop/_index.md) to learn how to build an image and run it as a containerized application.
- [Explore Docker Desktop](../use-desktop/index.md) and all its features.
- [Troubleshooting](../troubleshoot/overview.md) describes common problems, workarounds, how to run and submit diagnostics, and submit issues.
- [FAQs](../faqs/general.md) provide answers to frequently asked questions.
diff --git a/content/desktop/install/mac-install.md b/content/desktop/install/mac-install.md
index b4d4796c95..51893f7509 100644
--- a/content/desktop/install/mac-install.md
+++ b/content/desktop/install/mac-install.md
@@ -125,7 +125,7 @@ The `install` command accepts the following flags:
## Where to go next
- Explore [Docker's core subscriptions](https://www.docker.com/pricing/) to see what Docker can offer you.
-- [Get started with Docker](../../guides/getting-started/_index.md).
+- [Get started with Docker](/get-started/introduction/_index.md).
- [Explore Docker Desktop](../use-desktop/index.md) and all its features.
- [Troubleshooting](../troubleshoot/overview.md) describes common problems, workarounds, how
to run and submit diagnostics, and submit issues.
diff --git a/content/desktop/install/rhel.md b/content/desktop/install/rhel.md
index aa7a5825a2..3daeed64eb 100644
--- a/content/desktop/install/rhel.md
+++ b/content/desktop/install/rhel.md
@@ -135,7 +135,7 @@ $ sudo dnf install ./docker-desktop--rhel.rpm
## Next steps
- Explore [Docker's core subscriptions](https://www.docker.com/pricing/) to see what Docker can offer you.
-- Take a look at the [Docker workshop](../../guides/workshop/_index.md) to learn how to build an image and run it as a containerized application.
+- Take a look at the [Docker workshop](/get-started/workshop/_index.md) to learn how to build an image and run it as a containerized application.
- [Explore Docker Desktop](../use-desktop/index.md) and all its features.
- [Troubleshooting](../troubleshoot/overview.md) describes common problems, workarounds, how to run and submit diagnostics, and submit issues.
- [FAQs](../faqs/general.md) provide answers to frequently asked questions.
diff --git a/content/desktop/install/ubuntu.md b/content/desktop/install/ubuntu.md
index bc1cb07177..28cb706d01 100644
--- a/content/desktop/install/ubuntu.md
+++ b/content/desktop/install/ubuntu.md
@@ -90,7 +90,7 @@ Don't forget to substitute `` with the architecture you want.
## Next steps
- Explore [Docker's core subscriptions](https://www.docker.com/pricing/) to see what Docker can offer you.
-- Take a look at the [Docker workshop](../../guides/workshop/_index.md) to learn how to build an image and run it as a containerized application.
+- Take a look at the [Docker workshop](/get-started/workshop/_index.md) to learn how to build an image and run it as a containerized application.
- [Explore Docker Desktop](../use-desktop/index.md) and all its features.
- [Troubleshooting](../troubleshoot/overview.md) describes common problems, workarounds, how to run and submit diagnostics, and submit issues.
- [FAQs](../faqs/general.md) provide answers to frequently asked questions.
diff --git a/content/desktop/install/windows-install.md b/content/desktop/install/windows-install.md
index 7295a7327a..15258fad62 100644
--- a/content/desktop/install/windows-install.md
+++ b/content/desktop/install/windows-install.md
@@ -275,7 +275,7 @@ Docker Desktop does not start automatically after installation. To start Docker
## Where to go next
- Explore [Docker's core subscriptions](https://www.docker.com/pricing/) to see what Docker can offer you.
-- [Get started with Docker](../../guides/getting-started/_index.md).
+- [Get started with Docker](/get-started/introduction/_index.md).
- [Explore Docker Desktop](../use-desktop/index.md) and all its features.
- [Troubleshooting](../troubleshoot/overview.md) describes common problems, workarounds, and
how to get support.
diff --git a/content/desktop/use-desktop/_index.md b/content/desktop/use-desktop/_index.md
index 8b44ac26c2..ef66559c80 100644
--- a/content/desktop/use-desktop/_index.md
+++ b/content/desktop/use-desktop/_index.md
@@ -26,7 +26,7 @@ In addition, the Docker Dashboard allows you to:
- Be notified of new releases, installation progress updates, and more in the **Notifications center**. Select the bell icon in the bottom-right corner of the Docker Dashboard to access the notification center.
- Access the **Learning center** from the Dashboard header. It helps you get started with quick in-app walkthroughs and provides other resources for learning about Docker.
- For a more detailed guide about getting started, see [Get started](../../guides/getting-started/_index.md).
+ For a more detailed guide about getting started, see [Get started](/get-started/introduction/_index.md).
- Get to the [Docker Scout](../../scout/_index.md) dashboard.
- Check the status of Docker services.
diff --git a/content/desktop/use-desktop/container.md b/content/desktop/use-desktop/container.md
index d8dee2d75e..8abd3a39d4 100644
--- a/content/desktop/use-desktop/container.md
+++ b/content/desktop/use-desktop/container.md
@@ -122,5 +122,5 @@ can also:
## Additional resources
-- [What is a container](../../guides/docker-concepts/the-basics/what-is-a-container.md)
-- [Run multi-container applications](../../guides/docker-concepts/running-containers/multi-container-applications.md)
+- [What is a container](/get-started/docker-concepts/the-basics/what-is-a-container.md)
+- [Run multi-container applications](/get-started/docker-concepts/running-containers/multi-container-applications.md)
diff --git a/content/desktop/use-desktop/images.md b/content/desktop/use-desktop/images.md
index af8d0a5d38..0ae5547aee 100644
--- a/content/desktop/use-desktop/images.md
+++ b/content/desktop/use-desktop/images.md
@@ -102,4 +102,4 @@ Hovering over an image tag reveals two options:
## Additional resources
-- [What is an image?](../../guides/docker-concepts/the-basics/what-is-an-image.md)
+- [What is an image?](/get-started/docker-concepts/the-basics/what-is-an-image.md)
diff --git a/content/desktop/use-desktop/volumes.md b/content/desktop/use-desktop/volumes.md
index b053e4690b..69121e1e96 100644
--- a/content/desktop/use-desktop/volumes.md
+++ b/content/desktop/use-desktop/volumes.md
@@ -244,5 +244,5 @@ To import a volume:
## Additional resources
-- [Persisting container data](../../guides/docker-concepts/running-containers/persisting-container-data.md)
+- [Persisting container data](/get-started/docker-concepts/running-containers/persisting-container-data.md)
- [Use volumes](/engine/storage/volumes.md)
diff --git a/content/docker-hub/vulnerability-scanning.md b/content/docker-hub/vulnerability-scanning.md
index 7056a9bd95..79ba5fddb2 100644
--- a/content/docker-hub/vulnerability-scanning.md
+++ b/content/docker-hub/vulnerability-scanning.md
@@ -81,7 +81,7 @@ To enable static vulnerability scanning:
To scan an image for vulnerabilities, push the image to Docker Hub, to the
repository for which you have turned on scanning:
-1. Ensure you have installed Docker locally. See [Get Docker](../get-docker.md)
+1. Ensure you have installed Docker locally. See [Get Docker](/get-started/get-docker.md)
to download and install Docker on your local machine.
2. Use the command line to log into your Docker account. See
[`docker login`](../reference/cli/docker/login.md) for more
diff --git a/content/engine/_index.md b/content/engine/_index.md
index d89ff9099e..b65ebff251 100644
--- a/content/engine/_index.md
+++ b/content/engine/_index.md
@@ -64,7 +64,7 @@ use the underlying API and CLI. The daemon creates and manages Docker objects,
such as images, containers, networks, and volumes.
For more details, see
-[Docker Architecture](../guides/docker-overview.md#docker-architecture).
+[Docker Architecture](/get-started/docker-overview.md#docker-architecture).
{{< grid >}}
diff --git a/content/engine/api/sdk/examples.md b/content/engine/api/sdk/examples.md
index d1e863b09c..76f802c912 100644
--- a/content/engine/api/sdk/examples.md
+++ b/content/engine/api/sdk/examples.md
@@ -12,7 +12,7 @@ aliases:
---
After you
-[install Docker](../../../get-docker.md), you can
+[install Docker](/get-started/get-docker.md), you can
[install the Go or Python SDK](index.md#install-the-sdks) and
also try out the Docker Engine API.
diff --git a/content/engine/install/_index.md b/content/engine/install/_index.md
index d6c102badb..d2819f861c 100644
--- a/content/engine/install/_index.md
+++ b/content/engine/install/_index.md
@@ -123,4 +123,4 @@ Security reports are greatly appreciated, and Docker will publicly thank you for
## Get started
After setting up Docker, you can learn the basics with
-[Getting started with Docker](../../guides/getting-started/_index.md).
+[Getting started with Docker](/get-started/introduction/_index.md).
diff --git a/content/engine/install/linux-postinstall.md b/content/engine/install/linux-postinstall.md
index cfb413586e..927b7f7bad 100644
--- a/content/engine/install/linux-postinstall.md
+++ b/content/engine/install/linux-postinstall.md
@@ -139,4 +139,4 @@ options:
## Next steps
-- Take a look at the [Docker workshop](/guides/workshop/_index.md) to learn how to build an image and run it as a containerized application.
+- Take a look at the [Docker workshop](/get-started/workshop/_index.md) to learn how to build an image and run it as a containerized application.
diff --git a/content/engine/release-notes/18.06.md b/content/engine/release-notes/18.06.md
index ed29b976da..49611cc410 100644
--- a/content/engine/release-notes/18.06.md
+++ b/content/engine/release-notes/18.06.md
@@ -51,7 +51,7 @@ toc_max: 2
### Important notes about this release
-- Docker 18.06 CE will be the last release with a 4-month maintenance lifecycle. The planned Docker 18.09 CE release will be supported for 7 months with Docker 19.03 CE being the next release in line. More details about the release process can be found [here](../../get-docker.md).
+- Docker 18.06 CE will be the last release with a 4-month maintenance lifecycle. The planned Docker 18.09 CE release will be supported for 7 months with Docker 19.03 CE being the next release in line. More details about the release process can be found [here](/get-started/get-docker.md).
### Builder
diff --git a/content/engine/tutorials/_index.md b/content/engine/tutorials/_index.md
index fb48e5b573..98671e9839 100644
--- a/content/engine/tutorials/_index.md
+++ b/content/engine/tutorials/_index.md
@@ -12,4 +12,4 @@ Learn by example:
* [Network containers](networkingcontainers.md)
* [Manage data in containers](/engine/storage/volumes.md)
* [Samples](../../samples/index.md)
-* [Get Started](../../guides/getting-started/_index.md)
+* [Get Started](/get-started/introduction/_index.md)
diff --git a/content/get-started/_index.md b/content/get-started/_index.md
new file mode 100644
index 0000000000..99c1b75d42
--- /dev/null
+++ b/content/get-started/_index.md
@@ -0,0 +1,32 @@
+---
+title: Get started
+keywords: Docker, get started
+description: Get started with Docker
+notoc: true
+
+get-started:
+- title: Docker overview
+ description: Learn about the Docker platform.
+ link: /get-started/docker-overview/
+ icon: summarize
+- title: Introduction
+ description: Get started with the basics and the benefits of containerizing your applications.
+ link: /get-started/introduction/
+ icon: rocket
+- title: Docker concepts
+ description: Gain a better understanding of foundational Docker concepts.
+ link: /get-started/docker-concepts/the-basics/what-is-a-container/
+ icon: foundation
+- title: Docker workshop
+ description: Get guided through a 45-minute workshop to learn about Docker.
+ link: /get-started/workshop/
+ icon: desk
+---
+
+This section contains guides to help you get started and learn how Docker can optimize your development workflows. For more advanced concepts and scenarios in Docker, see [Guides](/guides/).
+
+## Foundations of Docker
+
+Get started learning the foundational concepts and workflows of Docker.
+
+{{< grid items="get-started" >}}
\ No newline at end of file
diff --git a/content/guides/docker-concepts/building-images/_index.md b/content/get-started/docker-concepts/building-images/_index.md
similarity index 100%
rename from content/guides/docker-concepts/building-images/_index.md
rename to content/get-started/docker-concepts/building-images/_index.md
diff --git a/content/guides/docker-concepts/building-images/build-tag-and-publish-an-image.md b/content/get-started/docker-concepts/building-images/build-tag-and-publish-an-image.md
similarity index 98%
rename from content/guides/docker-concepts/building-images/build-tag-and-publish-an-image.md
rename to content/get-started/docker-concepts/building-images/build-tag-and-publish-an-image.md
index 7ba76e71cf..edb3ac776c 100644
--- a/content/guides/docker-concepts/building-images/build-tag-and-publish-an-image.md
+++ b/content/get-started/docker-concepts/building-images/build-tag-and-publish-an-image.md
@@ -7,6 +7,8 @@ summary: |
containerization workflow. In this guide, you’ll learn how to create Docker
images, how to tag those images with a unique identifier, and how to publish
your image to a public registry.
+aliases:
+ - /guides/docker-concepts/building-images/build-tag-and-publish-an-image/
---
{{< youtube-embed chiiGLlYRlY >}}
@@ -221,7 +223,7 @@ To learn more about building, tagging, and publishing images, visit the followin
* [docker build reference](/engine/reference/commandline/image_build/)
* [docker image tag reference](/engine/reference/commandline/image_tag/)
* [docker push reference](/engine/reference/commandline/image_push/)
-* [What is a registry?](/guides/docker-concepts/the-basics/what-is-a-registry/)
+* [What is a registry?](/get-started/docker-concepts/the-basics/what-is-a-registry/)
## Next steps
diff --git a/content/guides/docker-concepts/building-images/images/container_image_layer_reuse.webp b/content/get-started/docker-concepts/building-images/images/container_image_layer_reuse.webp
similarity index 100%
rename from content/guides/docker-concepts/building-images/images/container_image_layer_reuse.webp
rename to content/get-started/docker-concepts/building-images/images/container_image_layer_reuse.webp
diff --git a/content/guides/docker-concepts/building-images/images/container_image_layers.webp b/content/get-started/docker-concepts/building-images/images/container_image_layers.webp
similarity index 100%
rename from content/guides/docker-concepts/building-images/images/container_image_layers.webp
rename to content/get-started/docker-concepts/building-images/images/container_image_layers.webp
diff --git a/content/guides/docker-concepts/building-images/images/image_layers.webp b/content/get-started/docker-concepts/building-images/images/image_layers.webp
similarity index 100%
rename from content/guides/docker-concepts/building-images/images/image_layers.webp
rename to content/get-started/docker-concepts/building-images/images/image_layers.webp
diff --git a/content/guides/docker-concepts/building-images/images/spring-initializr.webp b/content/get-started/docker-concepts/building-images/images/spring-initializr.webp
similarity index 100%
rename from content/guides/docker-concepts/building-images/images/spring-initializr.webp
rename to content/get-started/docker-concepts/building-images/images/spring-initializr.webp
diff --git a/content/guides/docker-concepts/building-images/multi-stage-builds.md b/content/get-started/docker-concepts/building-images/multi-stage-builds.md
similarity index 99%
rename from content/guides/docker-concepts/building-images/multi-stage-builds.md
rename to content/get-started/docker-concepts/building-images/multi-stage-builds.md
index e4172a4427..38f8f08253 100644
--- a/content/guides/docker-concepts/building-images/multi-stage-builds.md
+++ b/content/get-started/docker-concepts/building-images/multi-stage-builds.md
@@ -8,6 +8,8 @@ summary: |
you'll unlock the power of multi-stage builds to create lean and efficient
Docker images, essential for minimizing overhead and enhancing deployment in
production environments.
+aliases:
+ - /guides/docker-concepts/building-images/multi-stage-builds/
---
{{< youtube-embed vR185cjwxZ8 >}}
diff --git a/content/guides/docker-concepts/building-images/understanding-image-layers.md b/content/get-started/docker-concepts/building-images/understanding-image-layers.md
similarity index 99%
rename from content/guides/docker-concepts/building-images/understanding-image-layers.md
rename to content/get-started/docker-concepts/building-images/understanding-image-layers.md
index a255b4bbd1..03596c1247 100644
--- a/content/guides/docker-concepts/building-images/understanding-image-layers.md
+++ b/content/get-started/docker-concepts/building-images/understanding-image-layers.md
@@ -7,6 +7,8 @@ summary: |
understand image layers - the fundamental building blocks of container
images. You'll gain a comprehensive understanding of how layers are created,
stacked, and utilized to ensure efficient and optimized containers.
+aliases:
+ - /guides/docker-concepts/building-images/understanding-image-layers/
---
{{< youtube-embed wJwqtAkmtQA >}}
diff --git a/content/guides/docker-concepts/building-images/using-the-build-cache.md b/content/get-started/docker-concepts/building-images/using-the-build-cache.md
similarity index 99%
rename from content/guides/docker-concepts/building-images/using-the-build-cache.md
rename to content/get-started/docker-concepts/building-images/using-the-build-cache.md
index d36b6f5997..be45d0250e 100644
--- a/content/guides/docker-concepts/building-images/using-the-build-cache.md
+++ b/content/get-started/docker-concepts/building-images/using-the-build-cache.md
@@ -9,6 +9,8 @@ summary: |
rebuilds, it's crucial to understand how cache invalidation works. In this
guide, you’ll learn how to use the Docker build cache efficiently for
streamlined Docker image development and continuous integration workflows.
+aliases:
+ - /guides/docker-concepts/building-images/using-the-build-cache/
---
{{< youtube-embed Ri6jMknjprY >}}
diff --git a/content/guides/docker-concepts/building-images/writing-a-dockerfile.md b/content/get-started/docker-concepts/building-images/writing-a-dockerfile.md
similarity index 98%
rename from content/guides/docker-concepts/building-images/writing-a-dockerfile.md
rename to content/get-started/docker-concepts/building-images/writing-a-dockerfile.md
index 6cef69e5cb..a1985d61c1 100644
--- a/content/guides/docker-concepts/building-images/writing-a-dockerfile.md
+++ b/content/get-started/docker-concepts/building-images/writing-a-dockerfile.md
@@ -8,6 +8,8 @@ summary: |
CI/CD methodologies. In this guide, you’ll learn how to write a Dockerfile,
how to define a base image and setup instructions, including software
installation and copying necessary files.
+aliases:
+ - /guides/docker-concepts/building-images/writing-a-dockerfile/
---
{{< youtube-embed Jx8zoIhiP4c >}}
diff --git a/content/guides/docker-concepts/running-containers/images/access-the-frontend.webp b/content/get-started/docker-concepts/running-containers/images/access-the-frontend.webp
similarity index 100%
rename from content/guides/docker-concepts/running-containers/images/access-the-frontend.webp
rename to content/get-started/docker-concepts/running-containers/images/access-the-frontend.webp
diff --git a/content/guides/docker-concepts/running-containers/images/delete-containers.webp b/content/get-started/docker-concepts/running-containers/images/delete-containers.webp
similarity index 100%
rename from content/guides/docker-concepts/running-containers/images/delete-containers.webp
rename to content/get-started/docker-concepts/running-containers/images/delete-containers.webp
diff --git a/content/guides/docker-concepts/running-containers/images/delete-httpd-container.webp b/content/get-started/docker-concepts/running-containers/images/delete-httpd-container.webp
similarity index 100%
rename from content/guides/docker-concepts/running-containers/images/delete-httpd-container.webp
rename to content/get-started/docker-concepts/running-containers/images/delete-httpd-container.webp
diff --git a/content/guides/docker-concepts/running-containers/images/delete-multi-container-apps.webp b/content/get-started/docker-concepts/running-containers/images/delete-multi-container-apps.webp
similarity index 100%
rename from content/guides/docker-concepts/running-containers/images/delete-multi-container-apps.webp
rename to content/get-started/docker-concepts/running-containers/images/delete-multi-container-apps.webp
diff --git a/content/guides/docker-concepts/running-containers/images/delete-the-container.webp b/content/get-started/docker-concepts/running-containers/images/delete-the-container.webp
similarity index 100%
rename from content/guides/docker-concepts/running-containers/images/delete-the-container.webp
rename to content/get-started/docker-concepts/running-containers/images/delete-the-container.webp
diff --git a/content/guides/docker-concepts/running-containers/images/deleted-files.webp b/content/get-started/docker-concepts/running-containers/images/deleted-files.webp
similarity index 100%
rename from content/guides/docker-concepts/running-containers/images/deleted-files.webp
rename to content/get-started/docker-concepts/running-containers/images/deleted-files.webp
diff --git a/content/guides/docker-concepts/running-containers/images/exec-into-postgres-container.webp b/content/get-started/docker-concepts/running-containers/images/exec-into-postgres-container.webp
similarity index 100%
rename from content/guides/docker-concepts/running-containers/images/exec-into-postgres-container.webp
rename to content/get-started/docker-concepts/running-containers/images/exec-into-postgres-container.webp
diff --git a/content/guides/docker-concepts/running-containers/images/list-containers.webp b/content/get-started/docker-concepts/running-containers/images/list-containers.webp
similarity index 100%
rename from content/guides/docker-concepts/running-containers/images/list-containers.webp
rename to content/get-started/docker-concepts/running-containers/images/list-containers.webp
diff --git a/content/guides/docker-concepts/running-containers/images/mounted-files.webp b/content/get-started/docker-concepts/running-containers/images/mounted-files.webp
similarity index 100%
rename from content/guides/docker-concepts/running-containers/images/mounted-files.webp
rename to content/get-started/docker-concepts/running-containers/images/mounted-files.webp
diff --git a/content/guides/docker-concepts/running-containers/images/multi-container-apps.webp b/content/get-started/docker-concepts/running-containers/images/multi-container-apps.webp
similarity index 100%
rename from content/guides/docker-concepts/running-containers/images/multi-container-apps.webp
rename to content/get-started/docker-concepts/running-containers/images/multi-container-apps.webp
diff --git a/content/guides/docker-concepts/running-containers/images/published-ports.webp b/content/get-started/docker-concepts/running-containers/images/published-ports.webp
similarity index 100%
rename from content/guides/docker-concepts/running-containers/images/published-ports.webp
rename to content/get-started/docker-concepts/running-containers/images/published-ports.webp
diff --git a/content/guides/docker-concepts/running-containers/images/running-postgres-containers.webp b/content/get-started/docker-concepts/running-containers/images/running-postgres-containers.webp
similarity index 100%
rename from content/guides/docker-concepts/running-containers/images/running-postgres-containers.webp
rename to content/get-started/docker-concepts/running-containers/images/running-postgres-containers.webp
diff --git a/content/guides/docker-concepts/running-containers/multi-container-applications.md b/content/get-started/docker-concepts/running-containers/multi-container-applications.md
similarity index 97%
rename from content/guides/docker-concepts/running-containers/multi-container-applications.md
rename to content/get-started/docker-concepts/running-containers/multi-container-applications.md
index 66a30defbb..00647c4d2d 100644
--- a/content/guides/docker-concepts/running-containers/multi-container-applications.md
+++ b/content/get-started/docker-concepts/running-containers/multi-container-applications.md
@@ -2,6 +2,8 @@
title: Multi-container applications
keywords: concepts, build, images, container, docker desktop
description: This concept page will teach you the significance of multi-container application and how it is different from single-container application
+aliases:
+ - /guides/docker-concepts/running-containers/multi-container-applications/
---
{{< youtube-embed 1jUwR6F9hvM >}}
@@ -83,7 +85,7 @@ In this hands-on guide, you'll first see how to build and run a counter web appl
{{< /tabs >}}
-2. [Download and install](/get-docker/) Docker Desktop.
+2. [Download and install](/get-started/get-docker.md) Docker Desktop.
### Build the images
@@ -216,5 +218,5 @@ In this guide, you learned how easy it is to use Docker Compose to start and sto
## Additional resources
* [`docker container run` CLI reference](reference/cli/docker/container/run/)
-* [What is Docker Compose](/guides/docker-concepts/the-basics/what-is-docker-compose/)
+* [What is Docker Compose](/get-started/docker-concepts/the-basics/what-is-docker-compose/)
diff --git a/content/guides/docker-concepts/running-containers/overriding-container-defaults.md b/content/get-started/docker-concepts/running-containers/overriding-container-defaults.md
similarity index 97%
rename from content/guides/docker-concepts/running-containers/overriding-container-defaults.md
rename to content/get-started/docker-concepts/running-containers/overriding-container-defaults.md
index 54448baf3b..6a80769e49 100644
--- a/content/guides/docker-concepts/running-containers/overriding-container-defaults.md
+++ b/content/get-started/docker-concepts/running-containers/overriding-container-defaults.md
@@ -2,6 +2,8 @@
title: Overriding container defaults
keywords: concepts, build, images, container, docker desktop
description: This concept page will teach you how to override the container defaults using the `docker run` command.
+aliases:
+ - /guides/docker-concepts/running-containers/overriding-container-defaults/
---
{{< youtube-embed PFszWK3BB8I >}}
@@ -66,7 +68,7 @@ By effectively using these `docker run` flags, you can tailor your containerized
In this hands-on guide, you'll see how to use the `docker run` command to override the container defaults.
-1. [Download and install](/get-docker/) Docker Desktop.
+1. [Download and install](/get-started/get-docker/) Docker Desktop.
### Run multiple instance of the Postgres database
@@ -196,7 +198,7 @@ This command runs a Postgres container, sets an environment variable for passwor
## Additional resources
* [Ways to set environment variables with Compose](/compose/environment-variables/set-environment-variables/)
-* [What is a container](/guides/docker-concepts/the-basics/what-is-a-container/)
+* [What is a container](/get-started/docker-concepts/the-basics/what-is-a-container/)
## Next steps
diff --git a/content/guides/docker-concepts/running-containers/persisting-container-data.md b/content/get-started/docker-concepts/running-containers/persisting-container-data.md
similarity index 97%
rename from content/guides/docker-concepts/running-containers/persisting-container-data.md
rename to content/get-started/docker-concepts/running-containers/persisting-container-data.md
index 80df123163..36bd8d16a9 100644
--- a/content/guides/docker-concepts/running-containers/persisting-container-data.md
+++ b/content/get-started/docker-concepts/running-containers/persisting-container-data.md
@@ -3,7 +3,8 @@ title: Persisting container data
keywords: concepts, build, images, container, docker desktop
description: This concept page will teach you the significance of data persistence in Docker
aliases:
-- /guides/walkthroughs/persist-data/
+ - /guides/walkthroughs/persist-data/
+ - /guides/docker-concepts/running-containers/persisting-container-data/
---
{{< youtube-embed 10_2BjqB_Ls >}}
@@ -55,7 +56,7 @@ In this guide, you’ll practice creating and using volumes to persist data crea
### Use volumes
-1. [Download and install](/get-docker/) Docker Desktop.
+1. [Download and install](/get-started/get-docker/) Docker Desktop.
2. Start a container using the [Postgres image](https://hub.docker.com/_/postgres) with the following command:
diff --git a/content/guides/docker-concepts/running-containers/publishing-ports.md b/content/get-started/docker-concepts/running-containers/publishing-ports.md
similarity index 95%
rename from content/guides/docker-concepts/running-containers/publishing-ports.md
rename to content/get-started/docker-concepts/running-containers/publishing-ports.md
index 6b488d584d..fe0708980c 100644
--- a/content/guides/docker-concepts/running-containers/publishing-ports.md
+++ b/content/get-started/docker-concepts/running-containers/publishing-ports.md
@@ -2,6 +2,8 @@
title: Publishing and exposing ports
keywords: concepts, build, images, container, docker desktop
description: This concept page will teach you the significance of publishing and exposing ports in Docker
+aliases:
+ - /guides/docker-concepts/running-containers/publishing-ports/
---
{{< youtube-embed 9JnqOmJ96ds >}}
@@ -75,7 +77,7 @@ In this hands-on guide, you'll learn how to publish container ports using both t
In this step, you will run a container and publish its port using the Docker CLI.
-1. [Download and install](/get-docker/) Docker Desktop.
+1. [Download and install](/get-started/get-docker/) Docker Desktop.
2. In a terminal, run the following command to start a new container:
@@ -91,7 +93,7 @@ In this step, you will run a container and publish its port using the Docker CLI
4. Open the website by either selecting the link in the **Port(s)** column of your container or visiting [http://localhost:8080](http://localhost:8080) in your browser.
- 
+ 
### Use Docker Compose
diff --git a/content/guides/docker-concepts/running-containers/sharing-local-files.md b/content/get-started/docker-concepts/running-containers/sharing-local-files.md
similarity index 95%
rename from content/guides/docker-concepts/running-containers/sharing-local-files.md
rename to content/get-started/docker-concepts/running-containers/sharing-local-files.md
index 9e2d4561cb..0381fb2669 100644
--- a/content/guides/docker-concepts/running-containers/sharing-local-files.md
+++ b/content/get-started/docker-concepts/running-containers/sharing-local-files.md
@@ -2,6 +2,8 @@
title: Sharing local files with containers
keywords: concepts, images, container, docker desktop
description: This concept page will teach you the various storage options available in Docker and their common usage.
+aliases:
+ - /guides/docker-concepts/running-containers/sharing-local-files/
---
{{< youtube-embed 2dAzsVg3Dek >}}
@@ -17,7 +19,7 @@ Docker offers two primary storage options for persisting data and sharing files
### Volume versus bind mounts
-If you want to ensure that data generated or modified inside the container persists even after the container stops running, you would opt for a volume. See [Persisting container data](/guides/docker-concepts/running-containers/persisting-container-data/) to learn more about volumes and their use cases.
+If you want to ensure that data generated or modified inside the container persists even after the container stops running, you would opt for a volume. See [Persisting container data](/get-started/docker-concepts/running-containers/persisting-container-data/) to learn more about volumes and their use cases.
If you have specific files or directories on your host system that you want to directly share with your container, like configuration files or development code, then you would use a bind mount. It's like opening a direct portal between your host and container for sharing. Bind mounts are ideal for development environments where real-time file access and sharing between the host and container are crucial.
@@ -66,7 +68,7 @@ In this hands-on guide, you’ll practice how to create and use a bind mount to
### Run a container
-1. [Download and install](/get-docker/) Docker Desktop.
+1. [Download and install](/get-started/get-docker/) Docker Desktop.
2. Start a container using the [httpd](https://hub.docker.com/_/httpd) image with the following command:
@@ -197,7 +199,7 @@ The following resources will help you learn more about bind mounts:
* [Bind mounts](/storage/bind-mounts/)
* [Running containers](/reference/run/)
* [Troubleshoot storage errors](/storage/troubleshooting_volume_errors/)
-* [Persisting container data](/guides/docker-concepts/running-containers/persisting-container-data/)
+* [Persisting container data](/get-started/docker-concepts/running-containers/persisting-container-data/)
## Next steps
diff --git a/content/guides/docker-concepts/the-basics/images/access-the-frontend.webp b/content/get-started/docker-concepts/the-basics/images/access-the-frontend.webp
similarity index 100%
rename from content/guides/docker-concepts/the-basics/images/access-the-frontend.webp
rename to content/get-started/docker-concepts/the-basics/images/access-the-frontend.webp
diff --git a/content/guides/docker-concepts/the-basics/images/click-image.webp b/content/get-started/docker-concepts/the-basics/images/click-image.webp
similarity index 100%
rename from content/guides/docker-concepts/the-basics/images/click-image.webp
rename to content/get-started/docker-concepts/the-basics/images/click-image.webp
diff --git a/content/guides/docker-concepts/the-basics/images/create-hub-repository.webp b/content/get-started/docker-concepts/the-basics/images/create-hub-repository.webp
similarity index 100%
rename from content/guides/docker-concepts/the-basics/images/create-hub-repository.webp
rename to content/get-started/docker-concepts/the-basics/images/create-hub-repository.webp
diff --git a/content/guides/docker-concepts/the-basics/images/dockerhub-signup.webp b/content/get-started/docker-concepts/the-basics/images/dockerhub-signup.webp
similarity index 100%
rename from content/guides/docker-concepts/the-basics/images/dockerhub-signup.webp
rename to content/get-started/docker-concepts/the-basics/images/dockerhub-signup.webp
diff --git a/content/guides/docker-concepts/the-basics/images/dockerhub-tags.webp b/content/get-started/docker-concepts/the-basics/images/dockerhub-tags.webp
similarity index 100%
rename from content/guides/docker-concepts/the-basics/images/dockerhub-tags.webp
rename to content/get-started/docker-concepts/the-basics/images/dockerhub-tags.webp
diff --git a/content/guides/docker-concepts/the-basics/images/explore-your-container.webp b/content/get-started/docker-concepts/the-basics/images/explore-your-container.webp
similarity index 100%
rename from content/guides/docker-concepts/the-basics/images/explore-your-container.webp
rename to content/get-started/docker-concepts/the-basics/images/explore-your-container.webp
diff --git a/content/guides/docker-concepts/the-basics/images/image-layers.webp b/content/get-started/docker-concepts/the-basics/images/image-layers.webp
similarity index 100%
rename from content/guides/docker-concepts/the-basics/images/image-layers.webp
rename to content/get-started/docker-concepts/the-basics/images/image-layers.webp
diff --git a/content/guides/docker-concepts/the-basics/images/pulled-image.webp b/content/get-started/docker-concepts/the-basics/images/pulled-image.webp
similarity index 100%
rename from content/guides/docker-concepts/the-basics/images/pulled-image.webp
rename to content/get-started/docker-concepts/the-basics/images/pulled-image.webp
diff --git a/content/guides/docker-concepts/the-basics/images/run-a-new-container.webp b/content/get-started/docker-concepts/the-basics/images/run-a-new-container.webp
similarity index 100%
rename from content/guides/docker-concepts/the-basics/images/run-a-new-container.webp
rename to content/get-started/docker-concepts/the-basics/images/run-a-new-container.webp
diff --git a/content/guides/docker-concepts/the-basics/images/search-image.webp b/content/get-started/docker-concepts/the-basics/images/search-image.webp
similarity index 100%
rename from content/guides/docker-concepts/the-basics/images/search-image.webp
rename to content/get-started/docker-concepts/the-basics/images/search-image.webp
diff --git a/content/guides/docker-concepts/the-basics/images/search-the-docker-image.webp b/content/get-started/docker-concepts/the-basics/images/search-the-docker-image.webp
similarity index 100%
rename from content/guides/docker-concepts/the-basics/images/search-the-docker-image.webp
rename to content/get-started/docker-concepts/the-basics/images/search-the-docker-image.webp
diff --git a/content/guides/docker-concepts/the-basics/images/select-image.webp b/content/get-started/docker-concepts/the-basics/images/select-image.webp
similarity index 100%
rename from content/guides/docker-concepts/the-basics/images/select-image.webp
rename to content/get-started/docker-concepts/the-basics/images/select-image.webp
diff --git a/content/guides/docker-concepts/the-basics/images/stop-your-container.webp b/content/get-started/docker-concepts/the-basics/images/stop-your-container.webp
similarity index 100%
rename from content/guides/docker-concepts/the-basics/images/stop-your-container.webp
rename to content/get-started/docker-concepts/the-basics/images/stop-your-container.webp
diff --git a/content/guides/docker-concepts/the-basics/images/todo-list-app.webp b/content/get-started/docker-concepts/the-basics/images/todo-list-app.webp
similarity index 100%
rename from content/guides/docker-concepts/the-basics/images/todo-list-app.webp
rename to content/get-started/docker-concepts/the-basics/images/todo-list-app.webp
diff --git a/content/guides/docker-concepts/the-basics/images/todo-list-containers.webp b/content/get-started/docker-concepts/the-basics/images/todo-list-containers.webp
similarity index 100%
rename from content/guides/docker-concepts/the-basics/images/todo-list-containers.webp
rename to content/get-started/docker-concepts/the-basics/images/todo-list-containers.webp
diff --git a/content/guides/docker-concepts/the-basics/images/todo-list-delete.webp b/content/get-started/docker-concepts/the-basics/images/todo-list-delete.webp
similarity index 100%
rename from content/guides/docker-concepts/the-basics/images/todo-list-delete.webp
rename to content/get-started/docker-concepts/the-basics/images/todo-list-delete.webp
diff --git a/content/guides/docker-concepts/the-basics/images/view-your-containers.webp b/content/get-started/docker-concepts/the-basics/images/view-your-containers.webp
similarity index 100%
rename from content/guides/docker-concepts/the-basics/images/view-your-containers.webp
rename to content/get-started/docker-concepts/the-basics/images/view-your-containers.webp
diff --git a/content/guides/docker-concepts/the-basics/what-is-a-container.md b/content/get-started/docker-concepts/the-basics/what-is-a-container.md
similarity index 99%
rename from content/guides/docker-concepts/the-basics/what-is-a-container.md
rename to content/get-started/docker-concepts/the-basics/what-is-a-container.md
index 1d0436bdee..51310283aa 100644
--- a/content/guides/docker-concepts/the-basics/what-is-a-container.md
+++ b/content/get-started/docker-concepts/the-basics/what-is-a-container.md
@@ -7,6 +7,7 @@ aliases:
- /guides/walkthroughs/run-a-container/
- /guides/walkthroughs/
- /get-started/run-your-own-container/
+- /guides/docker-concepts/the-basics/what-is-a-container/
---
{{< youtube-embed W1kWqFkiu7k >}}
diff --git a/content/guides/docker-concepts/the-basics/what-is-a-registry.md b/content/get-started/docker-concepts/the-basics/what-is-a-registry.md
similarity index 99%
rename from content/guides/docker-concepts/the-basics/what-is-a-registry.md
rename to content/get-started/docker-concepts/the-basics/what-is-a-registry.md
index 04fba8bd81..6b837c6dc0 100644
--- a/content/guides/docker-concepts/the-basics/what-is-a-registry.md
+++ b/content/get-started/docker-concepts/the-basics/what-is-a-registry.md
@@ -5,6 +5,7 @@ description: What is a registry? This Docker Concept will explain what a registr
aliases:
- /guides/walkthroughs/run-hub-images/
- /guides/walkthroughs/publish-your-image/
+- /guides/docker-concepts/the-basics/what-is-a-registry/
---
{{< youtube-embed 2WDl10Wv5rs >}}
diff --git a/content/guides/docker-concepts/the-basics/what-is-an-image.md b/content/get-started/docker-concepts/the-basics/what-is-an-image.md
similarity index 99%
rename from content/guides/docker-concepts/the-basics/what-is-an-image.md
rename to content/get-started/docker-concepts/the-basics/what-is-an-image.md
index 536ac4b6a2..831ee96188 100644
--- a/content/guides/docker-concepts/the-basics/what-is-an-image.md
+++ b/content/get-started/docker-concepts/the-basics/what-is-an-image.md
@@ -2,6 +2,8 @@
title: What is an image?
keywords: concepts, build, images, container, docker desktop
description: What is an image
+aliases:
+ - /guides/docker-concepts/the-basics/what-is-an-image/
---
{{< youtube-embed NyvT9REqLe4 >}}
diff --git a/content/guides/docker-concepts/the-basics/what-is-docker-compose.md b/content/get-started/docker-concepts/the-basics/what-is-docker-compose.md
similarity index 98%
rename from content/guides/docker-concepts/the-basics/what-is-docker-compose.md
rename to content/get-started/docker-concepts/the-basics/what-is-docker-compose.md
index 841ac8d242..b5903ee83d 100644
--- a/content/guides/docker-concepts/the-basics/what-is-docker-compose.md
+++ b/content/get-started/docker-concepts/the-basics/what-is-docker-compose.md
@@ -3,7 +3,8 @@ title: What is Docker Compose?
keywords: concepts, build, images, container, docker desktop
description: What is Docker Compose?
aliases:
-- /guides/walkthroughs/multi-container-apps/
+ - /guides/walkthroughs/multi-container-apps/
+ - /guides/docker-concepts/the-basics/what-is-docker-compose/
---
{{< youtube-embed xhcUIK4fGtY >}}
diff --git a/content/guides/docker-overview.md b/content/get-started/docker-overview.md
similarity index 97%
rename from content/guides/docker-overview.md
rename to content/get-started/docker-overview.md
index 5d20b1a69a..5120f73d53 100644
--- a/content/guides/docker-overview.md
+++ b/content/get-started/docker-overview.md
@@ -12,6 +12,7 @@ aliases:
- /engine/understanding-docker/
- /engine/docker-overview/
- /get-started/overview/
+- /get-started/docker-overview/
---
Docker is an open platform for developing, shipping, and running applications.
@@ -105,7 +106,7 @@ Docker API. The Docker client can communicate with more than one daemon.
### Docker Desktop
-Docker Desktop is an easy-to-install application for your Mac, Windows or Linux environment that enables you to build and share containerized applications and microservices. Docker Desktop includes the Docker daemon (`dockerd`), the Docker client (`docker`), Docker Compose, Docker Content Trust, Kubernetes, and Credential Helper. For more information, see [Docker Desktop](../desktop/index.md).
+Docker Desktop is an easy-to-install application for your Mac, Windows or Linux environment that enables you to build and share containerized applications and microservices. Docker Desktop includes the Docker daemon (`dockerd`), the Docker client (`docker`), Docker Compose, Docker Content Trust, Kubernetes, and Credential Helper. For more information, see [Docker Desktop](/desktop/index.md).
### Docker registries
@@ -202,5 +203,5 @@ in a separate namespace and its access is limited to that namespace.
## Next steps
-- [Install Docker](../get-docker.md)
-- [Get started with Docker](index.md)
+- [Install Docker](/get-started/get-docker.md)
+- [Get started with Docker](/get-started/introduction/_index.md)
diff --git a/content/get-docker.md b/content/get-started/get-docker.md
similarity index 96%
rename from content/get-docker.md
rename to content/get-started/get-docker.md
index 974bb23449..d65f096925 100644
--- a/content/get-docker.md
+++ b/content/get-started/get-docker.md
@@ -5,9 +5,10 @@ keywords: install docker, docker download, download docker, docker installation,
to install docker, get docker, docker locally
title: Get Docker
aliases:
-- /install/
-- /install/overview/
-- /installation/
+ - /install/
+ - /install/overview/
+ - /installation/
+ - /get-docker/
---
Docker is an open platform for developing, shipping, and running applications.
diff --git a/content/guides/getting-started/_index.md b/content/get-started/introduction/_index.md
similarity index 96%
rename from content/guides/getting-started/_index.md
rename to content/get-started/introduction/_index.md
index 71f18df4a4..0eed6d8435 100644
--- a/content/guides/getting-started/_index.md
+++ b/content/get-started/introduction/_index.md
@@ -1,5 +1,5 @@
---
-title: Getting started
+title: Introduction
keywords: get started, getting started, how to get started
description: |
Get started with Docker. You'll learn about Docker Desktop, developing with
@@ -9,13 +9,14 @@ summary: |
containerization, beginning with foundational concepts and installation
procedures. Progress through hands-on exercises that cover essential Docker
commands, image creation, and container orchestration.
-aliases:
- - /get-started/
layout: series
params:
skill: Beginner
time: 15 minutes
prereq: None
+aliases:
+ - /get-started/
+ - /guides/getting-started/
---
## About this series
diff --git a/content/guides/getting-started/build-and-push-first-image.md b/content/get-started/introduction/build-and-push-first-image.md
similarity index 99%
rename from content/guides/getting-started/build-and-push-first-image.md
rename to content/get-started/introduction/build-and-push-first-image.md
index 362ac3ecce..ce507efa71 100644
--- a/content/guides/getting-started/build-and-push-first-image.md
+++ b/content/get-started/introduction/build-and-push-first-image.md
@@ -8,6 +8,8 @@ summary: |
repository and building and pushing your image to Docker Hub. This enables
you to share your image easily within your team.
weight: 3
+aliases:
+ - /guides/getting-started/build-and-push-first-image/
---
{{< youtube-embed 7ge1s5nAa34 >}}
diff --git a/content/guides/getting-started/develop-with-containers.md b/content/get-started/introduction/develop-with-containers.md
similarity index 99%
rename from content/guides/getting-started/develop-with-containers.md
rename to content/get-started/introduction/develop-with-containers.md
index d41083e1d7..e535c52bab 100644
--- a/content/guides/getting-started/develop-with-containers.md
+++ b/content/get-started/introduction/develop-with-containers.md
@@ -8,6 +8,8 @@ summary: |
backend and frontend code within the containerized environment, ensuring
seamless integration and testing.
weight: 2
+aliases:
+ - /guides/getting-started/develop-with-containers/
---
{{< youtube-embed D0SDBrS3t9I >}}
diff --git a/content/guides/getting-started/get-docker-desktop.md b/content/get-started/introduction/get-docker-desktop.md
similarity index 98%
rename from content/guides/getting-started/get-docker-desktop.md
rename to content/get-started/introduction/get-docker-desktop.md
index 2ead79ce5b..1f599a9818 100644
--- a/content/guides/getting-started/get-docker-desktop.md
+++ b/content/get-started/introduction/get-docker-desktop.md
@@ -9,6 +9,8 @@ summary: |
simplifies the process of building, sharing, and running applications in
containers, ensuring consistency across different environments.
weight: 1
+aliases:
+ - /getting-started/get-docker-desktop/
---
{{< youtube-embed C2bPVhiNU-0 >}}
diff --git a/content/guides/getting-started/images/build-vscode-menu-item.webp b/content/get-started/introduction/images/build-vscode-menu-item.webp
similarity index 100%
rename from content/guides/getting-started/images/build-vscode-menu-item.webp
rename to content/get-started/introduction/images/build-vscode-menu-item.webp
diff --git a/content/guides/getting-started/images/build-vscode-push-image.webp b/content/get-started/introduction/images/build-vscode-push-image.webp
similarity index 100%
rename from content/guides/getting-started/images/build-vscode-push-image.webp
rename to content/get-started/introduction/images/build-vscode-push-image.webp
diff --git a/content/guides/getting-started/images/clone-the-repo.webp b/content/get-started/introduction/images/clone-the-repo.webp
similarity index 100%
rename from content/guides/getting-started/images/clone-the-repo.webp
rename to content/get-started/introduction/images/clone-the-repo.webp
diff --git a/content/guides/getting-started/images/develop-app-with-greetings.webp b/content/get-started/introduction/images/develop-app-with-greetings.webp
similarity index 100%
rename from content/guides/getting-started/images/develop-app-with-greetings.webp
rename to content/get-started/introduction/images/develop-app-with-greetings.webp
diff --git a/content/guides/getting-started/images/develop-app-with-updated-client.webp b/content/get-started/introduction/images/develop-app-with-updated-client.webp
similarity index 100%
rename from content/guides/getting-started/images/develop-app-with-updated-client.webp
rename to content/get-started/introduction/images/develop-app-with-updated-client.webp
diff --git a/content/guides/getting-started/images/develop-app-with-updated-placeholder.webp b/content/get-started/introduction/images/develop-app-with-updated-placeholder.webp
similarity index 100%
rename from content/guides/getting-started/images/develop-app-with-updated-placeholder.webp
rename to content/get-started/introduction/images/develop-app-with-updated-placeholder.webp
diff --git a/content/guides/getting-started/images/develop-getting-started-app-first-launch.webp b/content/get-started/introduction/images/develop-getting-started-app-first-launch.webp
similarity index 100%
rename from content/guides/getting-started/images/develop-getting-started-app-first-launch.webp
rename to content/get-started/introduction/images/develop-getting-started-app-first-launch.webp
diff --git a/content/guides/getting-started/images/exec-into-docker-container.webp b/content/get-started/introduction/images/exec-into-docker-container.webp
similarity index 100%
rename from content/guides/getting-started/images/exec-into-docker-container.webp
rename to content/get-started/introduction/images/exec-into-docker-container.webp
diff --git a/content/guides/getting-started/images/inspecting-container.webp b/content/get-started/introduction/images/inspecting-container.webp
similarity index 100%
rename from content/guides/getting-started/images/inspecting-container.webp
rename to content/get-started/introduction/images/inspecting-container.webp
diff --git a/content/guides/getting-started/whats-next.md b/content/get-started/introduction/whats-next.md
similarity index 71%
rename from content/guides/getting-started/whats-next.md
rename to content/get-started/introduction/whats-next.md
index 835100554e..5948ca3a03 100644
--- a/content/guides/getting-started/whats-next.md
+++ b/content/get-started/introduction/whats-next.md
@@ -2,6 +2,8 @@
title: What's next
keywords: concepts, build, images, container, docker desktop
description: Explore step-by-step guides to hep you understand core Docker concepts, building images, and running containers.
+aliases:
+ - /guides/getting-started/whats-next/
summary: |
Now that you have set up Docker Desktop, developed with containers, and built
and pushed your first image, you are ready to take the next step and dive
@@ -12,50 +14,50 @@ weight: 4
the-basics:
- title: What is a container?
description: Learn how to run your first container.
- link: /guides/docker-concepts/the-basics/what-is-a-container/
+ link: /get-started/docker-concepts/the-basics/what-is-a-container/
- title: What is an image?
description: Learn the basics of image layers.
- link: /guides/docker-concepts/the-basics/what-is-an-image/
+ link: /get-started/docker-concepts/the-basics/what-is-an-image/
- title: What is a registry?
description: Learn about container registries, explore their interoperability, and interact with registries.
- link: /guides/docker-concepts/the-basics/what-is-a-registry/
+ link: /get-started/docker-concepts/the-basics/what-is-a-registry/
- title: What is Docker Compose?
description: Gain a better understanding of Docker Compose.
- link: /guides/docker-concepts/the-basics/what-is-docker-compose/
+ link: /get-started/docker-concepts/the-basics/what-is-docker-compose/
building-images:
- title: Understanding image layers
description: Learn about the layers of container images.
- link: /guides/docker-concepts/building-images/understanding-image-layers/
+ link: /get-started/docker-concepts/building-images/understanding-image-layers/
- title: Writing a Dockerfile
description: Learn how to create an image using a Dockerfile.
- link: /guides/docker-concepts/building-images/writing-a-dockerfile/
+ link: /get-started/docker-concepts/building-images/writing-a-dockerfile/
- title: Build, tag and publish an image
description: Learn how to build, tag, and publish an image to Docker Hub or any other registry.
- link: /guides/docker-concepts/building-images/build-tag-and-publish-an-image/
+ link: /get-started/docker-concepts/building-images/build-tag-and-publish-an-image/
- title: Using the build cache
description: Learn about the build cache, what changes invalidate the cache, and how to effectively use the build cache.
- link: /guides/docker-concepts/building-images/using-the-build-cache/
+ link: /get-started/docker-concepts/building-images/using-the-build-cache/
- title: Multi-stage builds
description: Get a better understanding of multi-stage builds and their benefits.
- link: /guides/docker-concepts/building-images/multi-stage-builds/
+ link: /get-started/docker-concepts/building-images/multi-stage-builds/
running-containers:
- title: Publishing ports
description: Understand the significance of publishing and exposing ports in Docker.
- link: /guides/docker-concepts/running-containers/publishing-ports/
+ link: /get-started/docker-concepts/running-containers/publishing-ports/
- title: Overriding container defaults
description: Learn how to override the container defaults using the `docker run` command.
- link: /guides/docker-concepts/running-containers/overriding-container-defaults/
+ link: /get-started/docker-concepts/running-containers/overriding-container-defaults/
- title: Persisting container data
description: Learn the significance of data persistence in Docker.
- link: /guides/docker-concepts/running-containers/persisting-container-data/
+ link: /get-started/docker-concepts/running-containers/persisting-container-data/
- title: Sharing local files with containers
description: Explore the various storage options available in Docker and their common usage.
- link: /guides/docker-concepts/running-containers/sharing-local-files/
+ link: /get-started/docker-concepts/running-containers/sharing-local-files/
- title: Multi-container applications
description: Learn the significance of multi-container applications and how they're different from single-container applications.
- link: /guides/docker-concepts/running-containers/multi-container-applications/
+ link: /get-started/docker-concepts/running-containers/multi-container-applications/
---
The following sections provide step-by-step guides to help you understand core Docker concepts, building images, and running containers.
diff --git a/content/guides/workshop/02_our_app.md b/content/get-started/workshop/02_our_app.md
similarity index 97%
rename from content/guides/workshop/02_our_app.md
rename to content/get-started/workshop/02_our_app.md
index e071665dcf..c29d4d4d19 100644
--- a/content/guides/workshop/02_our_app.md
+++ b/content/get-started/workshop/02_our_app.md
@@ -6,8 +6,9 @@ keywords: dockerfile example, Containerize an application, run docker file, runn
description: Follow this step-by-step guide to learn how to create and run a containerized
application using Docker
aliases:
-- /get-started/part2/
-- /get-started/02_our_app/
+ - /get-started/part2/
+ - /get-started/02_our_app/
+ - /guides/workshop/02_our_app/
---
For the rest of this guide, you'll be working with a simple todo
@@ -16,7 +17,7 @@ don't worry. This guide doesn't require any prior experience with JavaScript.
## Prerequisites
-- You have installed the latest version of [Docker Desktop](../../get-docker.md).
+- You have installed the latest version of [Docker Desktop](/get-started/get-docker.md).
- You have installed a [Git client](https://git-scm.com/downloads).
- You have an IDE or a text editor to edit files. Docker recommends using [Visual Studio Code](https://code.visualstudio.com/).
@@ -203,7 +204,7 @@ Related information:
- [Dockerfile reference](/reference/dockerfile/)
- [docker CLI reference](/reference/cli/docker/)
- - [Build with Docker guide](../../build/guide/_index.md)
+ - [Build with Docker guide](/build/guide/_index.md)
## Next steps
diff --git a/content/guides/workshop/03_updating_app.md b/content/get-started/workshop/03_updating_app.md
similarity index 98%
rename from content/guides/workshop/03_updating_app.md
rename to content/get-started/workshop/03_updating_app.md
index 8e911aa700..b9e8ee0eec 100644
--- a/content/guides/workshop/03_updating_app.md
+++ b/content/get-started/workshop/03_updating_app.md
@@ -4,7 +4,8 @@ keywords: get started, setup, orientation, quickstart, intro, concepts, containe
docker desktop
description: Making changes to your application
aliases:
-- /get-started/03_updating_app/
+ - /get-started/03_updating_app/
+ - /guides/workshop/03_updating_app/
---
In [part 2](./02_our_app.md), you containerized a todo application. In this part, you'll update the application and image. You'll also learn how to stop and remove a container.
diff --git a/content/guides/workshop/04_sharing_app.md b/content/get-started/workshop/04_sharing_app.md
similarity index 95%
rename from content/guides/workshop/04_sharing_app.md
rename to content/get-started/workshop/04_sharing_app.md
index f1b0a536cf..4e65fcaece 100644
--- a/content/guides/workshop/04_sharing_app.md
+++ b/content/get-started/workshop/04_sharing_app.md
@@ -5,8 +5,9 @@ keywords: get started, setup, orientation, quickstart, intro, concepts, containe
description: Sharing your image you built for your example application so you can
run it else where and other developers can use it
aliases:
-- /get-started/part3/
-- /get-started/04_sharing_app/
+ - /get-started/part3/
+ - /get-started/04_sharing_app/
+ - /guides/workshop/04_sharing_app/
---
Now that you've built an image, you can share it. To share Docker images, you have to use a Docker
@@ -79,7 +80,7 @@ new instance that has never seen this container image. To do this, you will use
> $ docker build --platform linux/amd64 -t YOUR-USER-NAME/getting-started .
> ```
>
-> Docker buildx also supports building multi-platform images. To learn more, see [Multi-platform images](../../build/building/multi-platform.md).
+> Docker buildx also supports building multi-platform images. To learn more, see [Multi-platform images](/build/building/multi-platform.md).
1. Open your browser to [Play with Docker](https://labs.play-with-docker.com/).
@@ -128,8 +129,8 @@ can use the latest version of the image.
Related information:
- [docker CLI reference](/reference/cli/docker/)
- - [Multi-platform images](../../build/building/multi-platform.md)
- - [Docker Hub overview](../../docker-hub/_index.md)
+ - [Multi-platform images](/build/building/multi-platform.md)
+ - [Docker Hub overview](/docker-hub/_index.md)
## Next steps
diff --git a/content/guides/workshop/05_persisting_data.md b/content/get-started/workshop/05_persisting_data.md
similarity index 98%
rename from content/guides/workshop/05_persisting_data.md
rename to content/get-started/workshop/05_persisting_data.md
index 3171c5706c..151ec06bc6 100644
--- a/content/guides/workshop/05_persisting_data.md
+++ b/content/get-started/workshop/05_persisting_data.md
@@ -4,7 +4,8 @@ keywords: get started, setup, orientation, quickstart, intro, concepts, containe
docker desktop
description: Making your DB persistent in your application
aliases:
-- /get-started/05_persisting_data/
+ - /get-started/05_persisting_data/
+ - /guides/workshop/05_persisting_data/
---
In case you didn't notice, your todo list is empty every single time
diff --git a/content/guides/workshop/06_bind_mounts.md b/content/get-started/workshop/06_bind_mounts.md
similarity index 98%
rename from content/guides/workshop/06_bind_mounts.md
rename to content/get-started/workshop/06_bind_mounts.md
index a2a7040fd9..b376526473 100644
--- a/content/guides/workshop/06_bind_mounts.md
+++ b/content/get-started/workshop/06_bind_mounts.md
@@ -3,8 +3,9 @@ title: Use bind mounts
keywords: 'get started, setup, orientation, quickstart, intro, concepts, containers, docker desktop'
description: Using bind mounts in our application
aliases:
-- /guides/walkthroughs/access-local-folder/
-- /get-started/06_bind_mounts/
+ - /guides/walkthroughs/access-local-folder/
+ - /get-started/06_bind_mounts/
+ - /guides/workshop/06_bind_mounts/
---
In [part 5](./05_persisting_data.md), you used a volume mount to persist the
@@ -48,9 +49,9 @@ work.
1. Verify that your `getting-started-app` directory is in a directory defined in
Docker Desktop's file sharing setting. This setting defines which parts of your
filesystem you can share with containers. For details about accessing the
-setting, see the topic for [Mac](../../desktop/settings/mac.md/#file-sharing),
-[Windows](../../desktop/settings/windows.md/#file-sharing), or
-[Linux](../../desktop/settings/linux.md/#file-sharing).
+setting, see the topic for [Mac](/desktop/settings/mac.md#file-sharing),
+[Windows](/desktop/settings/windows.md#file-sharing), or
+[Linux](/desktop/settings/linux.md#file-sharing).
2. Open a terminal and change directory to the `getting-started-app`
directory.
diff --git a/content/guides/workshop/07_multi_container.md b/content/get-started/workshop/07_multi_container.md
similarity index 99%
rename from content/guides/workshop/07_multi_container.md
rename to content/get-started/workshop/07_multi_container.md
index 3f991e66c0..7f680a257d 100644
--- a/content/guides/workshop/07_multi_container.md
+++ b/content/get-started/workshop/07_multi_container.md
@@ -4,7 +4,8 @@ keywords: get started, setup, orientation, quickstart, intro, concepts, containe
docker desktop
description: Using more than one container in your application
aliases:
-- /get-started/07_multi_container/
+ - /get-started/07_multi_container/
+ - /guides/workshop/07_multi_container/
---
Up to this point, you've been working with single container apps. But, now you will add MySQL to the
diff --git a/content/guides/workshop/08_using_compose.md b/content/get-started/workshop/08_using_compose.md
similarity index 97%
rename from content/guides/workshop/08_using_compose.md
rename to content/get-started/workshop/08_using_compose.md
index 9a8db091ca..5042fdd290 100644
--- a/content/guides/workshop/08_using_compose.md
+++ b/content/get-started/workshop/08_using_compose.md
@@ -4,10 +4,11 @@ keywords: get started, setup, orientation, quickstart, intro, concepts, containe
docker desktop
description: Using Docker Compose for multi-container applications
aliases:
-- /get-started/08_using_compose/
+ - /get-started/08_using_compose/
+ - /guides/workshop/08_using_compose/
---
-[Docker Compose](../../compose/_index.md) is a tool that helps you define and
+[Docker Compose](/compose/_index.md) is a tool that helps you define and
share multi-container applications. With Compose, you can create a YAML file to define the services
and with a single command, you can spin everything up or tear it all down.
@@ -278,9 +279,9 @@ In this section, you learned about Docker Compose and how it helps you simplify
the way you define and share multi-service applications.
Related information:
- - [Compose overview](../../compose/_index.md)
+ - [Compose overview](/compose/_index.md)
- [Compose file reference](/reference/compose-file/_index.md)
- - [Compose CLI reference](../../compose/reference/_index.md)
+ - [Compose CLI reference](/compose/reference/_index.md)
## Next steps
diff --git a/content/guides/workshop/09_image_best.md b/content/get-started/workshop/09_image_best.md
similarity index 97%
rename from content/guides/workshop/09_image_best.md
rename to content/get-started/workshop/09_image_best.md
index d8c5bd32b4..49a27c56e4 100644
--- a/content/guides/workshop/09_image_best.md
+++ b/content/get-started/workshop/09_image_best.md
@@ -4,7 +4,8 @@ keywords: get started, setup, orientation, quickstart, intro, concepts, containe
docker desktop
description: Tips for building images for your application
aliases:
-- /get-started/09_image_best/
+ - /get-started/09_image_best/
+ - /guides/workshop/09_image_best/
---
## Image layering
@@ -200,8 +201,8 @@ In this section, you learned a few image building best practices, including laye
Related information:
- [Dockerfile reference](/reference/dockerfile/)
- - [Build with Docker guide](../../build/guide/_index.md)
- - [Dockerfile best practices](../../build/building/best-practices.md)
+ - [Build with Docker guide](/build/guide/_index.md)
+ - [Dockerfile best practices](/build/building/best-practices.md)
## Next steps
diff --git a/content/guides/workshop/10_what_next.md b/content/get-started/workshop/10_what_next.md
similarity index 97%
rename from content/guides/workshop/10_what_next.md
rename to content/get-started/workshop/10_what_next.md
index 8b3df79db2..b1175f82bb 100644
--- a/content/guides/workshop/10_what_next.md
+++ b/content/get-started/workshop/10_what_next.md
@@ -4,7 +4,8 @@ keywords: get started, setup, orientation, quickstart, intro, concepts, containe
docker desktop
description: Making sure you have more ideas of what you could do next with your application
aliases:
-- /get-started/11_what_next/
+ - /get-started/11_what_next/
+ - /guides/workshop/10_what_next/
---
Although you're done with the workshop, there's still a lot more to learn about containers.
@@ -51,4 +52,4 @@ If you'd like to see how containers are built from scratch, Liz Rice from Aqua S
## Language-specific guides
-If you are looking for information on how to containerize an application using your favorite language, see the [Language-specific guides](../../language/_index.md).
+If you are looking for information on how to containerize an application using your favorite language, see the [Language-specific guides](/language/_index.md).
diff --git a/content/guides/workshop/_index.md b/content/get-started/workshop/_index.md
similarity index 63%
rename from content/guides/workshop/_index.md
rename to content/get-started/workshop/_index.md
index 21826279a2..89e590331a 100644
--- a/content/guides/workshop/_index.md
+++ b/content/get-started/workshop/_index.md
@@ -6,60 +6,9 @@ keywords: docker basics, how to start a docker container, container settings, se
description: Get started with the Docker basics in this workshop, You'll
learn about containers, images, and how to containerize your first application.
aliases:
-- /engine/getstarted-voting-app/
-- /engine/getstarted-voting-app/cleanup/
-- /engine/getstarted-voting-app/create-swarm/
-- /engine/getstarted-voting-app/customize-app/
-- /engine/getstarted-voting-app/deploy-app/
-- /engine/getstarted-voting-app/node-setup/
-- /engine/getstarted-voting-app/test-drive/
-- /engine/getstarted/
-- /engine/getstarted/last_page/
-- /engine/getstarted/step_five/
-- /engine/getstarted/step_four/
-- /engine/getstarted/step_one/
-- /engine/getstarted/step_six/
-- /engine/getstarted/step_three/
-- /engine/getstarted/step_two/
-- /engine/quickstart/
-- /engine/tutorials/
-- /engine/tutorials/dockerimages/
-- /engine/tutorials/dockerizing/
-- /engine/tutorials/usingdocker/
-- /engine/userguide/containers/dockerimages/
-- /engine/userguide/dockerimages/
-- /engine/userguide/intro/
-- /get-started/part1/
-- /get-started/part5/
-- /get-started/part6/
-- /getstarted/
-- /getting-started/
-- /learn/
-- /linux/last_page/
-- /linux/started/
-- /linux/step_four/
-- /linux/step_one/
-- /linux/step_six/
-- /linux/step_three/
-- /linux/step_two/
-- /mac/last_page/
-- /mac/started/
-- /mac/step_four/
-- /mac/step_one/
-- /mac/step_six/
-- /mac/step_three/
-- /mac/step_two/
-- /userguide/dockerimages/
-- /userguide/dockerrepos/
-- /windows/last_page/
-- /windows/started/
-- /windows/step_four/
-- /windows/step_one/
-- /windows/step_six/
-- /windows/step_three/
-- /windows/step_two/
- /guides/get-started/
- /get-started/hands-on-overview/
+- /guides/workshop/
---
This 45-minute workshop contains step-by-step instructions on how to get started with Docker. This workshop shows you how to:
@@ -72,7 +21,7 @@ This 45-minute workshop contains step-by-step instructions on how to get started
> [!NOTE]
>
> For a quick introduction to Docker and the benefits of containerizing your
-> applications, see [Getting started](../getting-started/_index.md).
+> applications, see [Getting started](/get-started/introduction/_index.md).
## What is a container?
diff --git a/content/guides/workshop/images/dashboard-two-containers.webp b/content/get-started/workshop/images/dashboard-two-containers.webp
similarity index 100%
rename from content/guides/workshop/images/dashboard-two-containers.webp
rename to content/get-started/workshop/images/dashboard-two-containers.webp
diff --git a/content/guides/workshop/images/items-added.webp b/content/get-started/workshop/images/items-added.webp
similarity index 100%
rename from content/guides/workshop/images/items-added.webp
rename to content/get-started/workshop/images/items-added.webp
diff --git a/content/guides/workshop/images/multi-container.webp b/content/get-started/workshop/images/multi-container.webp
similarity index 100%
rename from content/guides/workshop/images/multi-container.webp
rename to content/get-started/workshop/images/multi-container.webp
diff --git a/content/guides/workshop/images/push-command.webp b/content/get-started/workshop/images/push-command.webp
similarity index 100%
rename from content/guides/workshop/images/push-command.webp
rename to content/get-started/workshop/images/push-command.webp
diff --git a/content/guides/workshop/images/pwd-add-new-instance.webp b/content/get-started/workshop/images/pwd-add-new-instance.webp
similarity index 100%
rename from content/guides/workshop/images/pwd-add-new-instance.webp
rename to content/get-started/workshop/images/pwd-add-new-instance.webp
diff --git a/content/guides/workshop/images/todo-list-empty.webp b/content/get-started/workshop/images/todo-list-empty.webp
similarity index 100%
rename from content/guides/workshop/images/todo-list-empty.webp
rename to content/get-started/workshop/images/todo-list-empty.webp
diff --git a/content/guides/workshop/images/updated-add-button.webp b/content/get-started/workshop/images/updated-add-button.webp
similarity index 100%
rename from content/guides/workshop/images/updated-add-button.webp
rename to content/get-started/workshop/images/updated-add-button.webp
diff --git a/content/guides/_index.md b/content/guides/_index.md
index 84132bd837..78007e12b8 100644
--- a/content/guides/_index.md
+++ b/content/guides/_index.md
@@ -4,20 +4,6 @@ keywords: Docker guides
description: Explore the Docker guides
notoc: true
-get-started:
-- title: Docker overview
- description: Learn about the Docker platform.
- link: /guides/docker-overview/
- icon: summarize
-- title: Get started
- description: Get started with the basics and the benefits of containerizing your applications.
- link: /guides/getting-started/
- icon: rocket
-- title: Docker concepts
- description: Gain a better understanding of foundational Docker concepts.
- link: /guides/docker-concepts/the-basics/what-is-a-container/
- icon: foundation
-
dive-deeper:
- title: Language-specific guides
description: Learn how to containerize, develop, and test language-specific apps using Docker.
@@ -35,10 +21,6 @@ dive-deeper:
description: Deploy and manage Docker containers at scale.
link: /guides/deployment-orchestration/orchestration/
icon: workspaces
-- title: Docker workshop
- description: Get guided through a 45-minute workshop to learn about Docker.
- link: /guides/workshop/
- icon: desk
resources:
- title: Educational resources
@@ -53,12 +35,6 @@ resources:
This section contains guides to help you get started and learn how Docker can optimize your development workflows.
-## Foundations of Docker
-
-Get started learning the foundational concepts and workflows of Docker.
-
-{{< grid items="get-started" >}}
-
## Advancing with Docker
Explore more advanced concepts and scenarios in Docker.
diff --git a/content/guides/deployment-orchestration/kube-deploy.md b/content/guides/deployment-orchestration/kube-deploy.md
index 527a186303..ea69d29ce0 100644
--- a/content/guides/deployment-orchestration/kube-deploy.md
+++ b/content/guides/deployment-orchestration/kube-deploy.md
@@ -8,7 +8,7 @@ aliases:
## Prerequisites
-- Download and install Docker Desktop as described in [Get Docker](../../get-docker.md).
+- Download and install Docker Desktop as described in [Get Docker](/get-started/get-docker.md).
- Work through containerizing an application in [Part 2](02_our_app.md).
- Make sure that Kubernetes is turned on in Docker Desktop:
If Kubernetes isn't running, follow the instructions in [Orchestration](orchestration.md) to finish setting it up.
diff --git a/content/guides/deployment-orchestration/swarm-deploy.md b/content/guides/deployment-orchestration/swarm-deploy.md
index 42acdf19a0..d464ab8fc0 100644
--- a/content/guides/deployment-orchestration/swarm-deploy.md
+++ b/content/guides/deployment-orchestration/swarm-deploy.md
@@ -11,8 +11,8 @@ aliases:
## Prerequisites
-- Download and install Docker Desktop as described in [Get Docker](../../get-docker.md).
-- Work through containerizing an application in [Docker workshop part 2](../../guides/workshop/02_our_app.md)
+- Download and install Docker Desktop as described in [Get Docker](/get-started/get-docker.md).
+- Work through containerizing an application in [Docker workshop part 2](/get-started/workshop/02_our_app.md)
- Make sure that Swarm is enabled on your Docker Desktop by typing `docker system info`, and looking for a message `Swarm: active` (you might have to scroll up a little).
If Swarm isn't running, simply type `docker swarm init` in a shell prompt to set it up.
@@ -103,8 +103,8 @@ In addition to deploying to Swarm, you've also described your application as a s
Further documentation for all new Swarm objects and CLI commands used in this article are available here:
- - [Swarm Mode](../../engine/swarm/_index.md)
- - [Swarm Mode Services](../../engine/swarm/how-swarm-mode-works/services.md)
- - [Swarm Stacks](../../engine/swarm/stack-deploy.md)
+ - [Swarm Mode](/engine/swarm/_index.md)
+ - [Swarm Mode Services](/engine/swarm/how-swarm-mode-works/services.md)
+ - [Swarm Stacks](/engine/swarm/stack-deploy.md)
- [`docker stack *`](/reference/cli/docker/stack/)
- [`docker service *`](/reference/cli/docker/service/)
diff --git a/content/guides/use-case/databases.md b/content/guides/use-case/databases.md
index 0c8699f8b4..c2951a8f47 100644
--- a/content/guides/use-case/databases.md
+++ b/content/guides/use-case/databases.md
@@ -24,7 +24,7 @@ This guide uses the MySQL image for examples, but the concepts can be applied to
## Prerequisites
-To follow along with this guide, you must have Docker installed. To install Docker, see [Get Docker](../../get-docker.md).
+To follow along with this guide, you must have Docker installed. To install Docker, see [Get Docker](/get-started/get-docker.md).
## Run a local containerized database
diff --git a/content/guides/use-case/genai-pdf-bot/containerize.md b/content/guides/use-case/genai-pdf-bot/containerize.md
index 8717295f25..1d6797efab 100644
--- a/content/guides/use-case/genai-pdf-bot/containerize.md
+++ b/content/guides/use-case/genai-pdf-bot/containerize.md
@@ -10,7 +10,7 @@ description: Learn how to containerize a generative AI (GenAI) application.
>
> GenAI applications can often benefit from GPU acceleration. Currently Docker Desktop supports GPU acceleration only on [Windows with the WSL2 backend](../../../desktop/gpu.md#using-nvidia-gpus-with-wsl2). Linux users can also access GPU acceleration using a native installation of the [Docker Engine](../../../engine/install/_index.md).
-* You have installed the latest version of [Docker Desktop](../../../get-docker.md) or, if you are a Linux user and are planning to use GPU acceleration, [Docker Engine](../../../engine/install/_index.md). Docker adds new features regularly and some parts of this guide may work only with the latest version of Docker Desktop.
+* You have installed the latest version of [Docker Desktop](/get-started/get-docker.md) or, if you are a Linux user and are planning to use GPU acceleration, [Docker Engine](../../../engine/install/_index.md). Docker adds new features regularly and some parts of this guide may work only with the latest version of Docker Desktop.
* You have a [git client](https://git-scm.com/downloads). The examples in this section use a command-line based git client, but you can use any client.
## Overview
diff --git a/content/guides/use-case/genai-video-bot/_index.md b/content/guides/use-case/genai-video-bot/_index.md
index 0efdad69d4..1d23cd4bac 100644
--- a/content/guides/use-case/genai-video-bot/_index.md
+++ b/content/guides/use-case/genai-video-bot/_index.md
@@ -35,7 +35,7 @@ The project showcases the following technologies:
- You have a [Pinecone API Key](https://app.pinecone.io/).
-- You have installed the latest version of [Docker Desktop](../../../get-docker.md). Docker adds new features regularly and some parts of this guide may work only with the latest version of Docker Desktop.
+- You have installed the latest version of [Docker Desktop](/get-started/get-docker.md). Docker adds new features regularly and some parts of this guide may work only with the latest version of Docker Desktop.
- You have a [Git client](https://git-scm.com/downloads). The examples in this section use a command-line based Git client, but you can use any client.
## About the application
@@ -179,7 +179,7 @@ The following image shows the application's high-level service architecture, whi
The application uses Docker to run the application in containers, providing a
consistent and isolated environment for running it. This means the application
will operate as intended within its Docker containers, regardless of the
-underlying system differences. To learn more about Docker, see the [Getting started overview](../../getting-started/_index.md).
+underlying system differences. To learn more about Docker, see the [Getting started overview](/get-started/introduction/_index.md).
Docker Compose is a tool for defining and running multi-container applications.
Compose makes it easy to run this application with a single command, `docker
diff --git a/content/guides/use-case/jupyter.md b/content/guides/use-case/jupyter.md
index c7a92143a2..4be1c9b8ca 100644
--- a/content/guides/use-case/jupyter.md
+++ b/content/guides/use-case/jupyter.md
@@ -34,7 +34,7 @@ By combining Docker and JupyterLab, you can benefit from the advantages of both
## Prerequisites
-To follow along with this guide, you must install the latest version of [Docker Desktop](../../../get-docker.md).
+To follow along with this guide, you must install the latest version of [Docker Desktop](/get-started/get-docker.md).
## Run and access a JupyterLab container
diff --git a/content/guides/use-case/nlp/language-translation.md b/content/guides/use-case/nlp/language-translation.md
index c0f97eb557..6f496c3b93 100644
--- a/content/guides/use-case/nlp/language-translation.md
+++ b/content/guides/use-case/nlp/language-translation.md
@@ -18,7 +18,7 @@ methods as detect and translate.
## Prerequisites
-* You have installed the latest version of [Docker Desktop](../../../get-docker.md). Docker adds new features regularly and some parts of this guide may work only with the latest version of Docker Desktop.
+* You have installed the latest version of [Docker Desktop](/get-started/get-docker.md). Docker adds new features regularly and some parts of this guide may work only with the latest version of Docker Desktop.
* You have a [Git client](https://git-scm.com/downloads). The examples in this section use a command-line based Git client, but you can use any client.
## Get the sample application
diff --git a/content/guides/use-case/nlp/named-entity-recognition.md b/content/guides/use-case/nlp/named-entity-recognition.md
index ec3d9fda6c..439007beb1 100644
--- a/content/guides/use-case/nlp/named-entity-recognition.md
+++ b/content/guides/use-case/nlp/named-entity-recognition.md
@@ -14,7 +14,7 @@ The application processes input text to identify and print named entities, like
## Prerequisites
-* You have installed the latest version of [Docker Desktop](../../../get-docker.md). Docker adds new features regularly and some parts of this guide may work only with the latest version of Docker Desktop.
+* You have installed the latest version of [Docker Desktop](/get-started/get-docker.md). Docker adds new features regularly and some parts of this guide may work only with the latest version of Docker Desktop.
* You have a [Git client](https://git-scm.com/downloads). The examples in this section use a command-line based Git client, but you can use any client.
## Get the sample application
diff --git a/content/guides/use-case/nlp/sentiment-analysis.md b/content/guides/use-case/nlp/sentiment-analysis.md
index 5d772ee30f..dfb9f4623c 100644
--- a/content/guides/use-case/nlp/sentiment-analysis.md
+++ b/content/guides/use-case/nlp/sentiment-analysis.md
@@ -16,7 +16,7 @@ negative, or neutral.
## Prerequisites
-* You have installed the latest version of [Docker Desktop](../../../get-docker.md). Docker adds new features regularly and some parts of this guide may work only with the latest version of Docker Desktop.
+* You have installed the latest version of [Docker Desktop](/get-started/get-docker.md). Docker adds new features regularly and some parts of this guide may work only with the latest version of Docker Desktop.
* You have a [Git client](https://git-scm.com/downloads). The examples in this section use a command-line based Git client, but you can use any client.
## Get the sample application
diff --git a/content/guides/use-case/nlp/text-classification.md b/content/guides/use-case/nlp/text-classification.md
index 862462aff7..97e4eb87e5 100644
--- a/content/guides/use-case/nlp/text-classification.md
+++ b/content/guides/use-case/nlp/text-classification.md
@@ -19,7 +19,7 @@ analysis model based on a predefined dataset.
## Prerequisites
-* You have installed the latest version of [Docker Desktop](../../../get-docker.md). Docker adds new features regularly and some parts of this guide may work only with the latest version of Docker Desktop.
+* You have installed the latest version of [Docker Desktop](/get-started/get-docker.md). Docker adds new features regularly and some parts of this guide may work only with the latest version of Docker Desktop.
* You have a [Git client](https://git-scm.com/downloads). The examples in this section use a command-line based Git client, but you can use any client.
## Get the sample application
diff --git a/content/guides/use-case/nlp/text-summarization.md b/content/guides/use-case/nlp/text-summarization.md
index 6a03814756..fea2452fc7 100644
--- a/content/guides/use-case/nlp/text-summarization.md
+++ b/content/guides/use-case/nlp/text-summarization.md
@@ -19,7 +19,7 @@ cluster's centroids.
## Prerequisites
-* You have installed the latest version of [Docker Desktop](../../../get-docker.md). Docker adds new features regularly and some parts of this guide may work only with the latest version of Docker Desktop.
+* You have installed the latest version of [Docker Desktop](/get-started/get-docker.md). Docker adds new features regularly and some parts of this guide may work only with the latest version of Docker Desktop.
* You have a [Git client](https://git-scm.com/downloads). The examples in this section use a command-line based Git client, but you can use any client.
## Get the sample application
diff --git a/content/guides/use-case/tensorflowjs.md b/content/guides/use-case/tensorflowjs.md
index 88168dd8d7..8c8789f0c7 100644
--- a/content/guides/use-case/tensorflowjs.md
+++ b/content/guides/use-case/tensorflowjs.md
@@ -22,7 +22,7 @@ perform face detection. In this guide, you'll explore how to:
## Prerequisites
* You have installed the latest version of
- [Docker Desktop](../../../get-docker.md).
+ [Docker Desktop](/get-started/get-docker.md).
* You have a [Git client](https://git-scm.com/downloads). The examples in this
guide use a command-line based Git client, but you can use any client.
diff --git a/content/includes/guides-get-docker.md b/content/includes/guides-get-docker.md
index 719f9c9af4..0a5ae3a13a 100644
--- a/content/includes/guides-get-docker.md
+++ b/content/includes/guides-get-docker.md
@@ -1 +1 @@
-Before you start, get the latest version of [Docker Desktop](../../get-docker.md). Docker adds new features regularly and some parts of this guide may work only with the latest version of Docker Desktop.
+Before you start, get the latest version of [Docker Desktop](/get-started/get-docker.md). Docker adds new features regularly and some parts of this guide may work only with the latest version of Docker Desktop.
diff --git a/content/language/dotnet/containerize.md b/content/language/dotnet/containerize.md
index 24fe5d06ca..ee5cfa20aa 100644
--- a/content/language/dotnet/containerize.md
+++ b/content/language/dotnet/containerize.md
@@ -10,7 +10,7 @@ aliases:
## Prerequisites
* You have installed the latest version of [Docker
- Desktop](../../get-docker.md).
+ Desktop](/get-started/get-docker.md).
* You have a [git client](https://git-scm.com/downloads). The examples in this
section use a command-line based git client, but you can use any client.
diff --git a/content/language/golang/_index.md b/content/language/golang/_index.md
index 3be7fc8708..79b620c0c2 100644
--- a/content/language/golang/_index.md
+++ b/content/language/golang/_index.md
@@ -29,7 +29,7 @@ Some basic understanding of Go and its toolchain is assumed. This isn't a Go tut
the [Go website](https://golang.org/) is a great place to explore,
so *go* (pun intended) check it out!
-You also must know some basic [Docker concepts](../../guides/docker-concepts/the-basics/what-is-a-container.md) as well as to
+You also must know some basic [Docker concepts](/get-started/docker-concepts/the-basics/what-is-a-container.md) as well as to
be at least vaguely familiar with the [Dockerfile format](../../build/concepts/dockerfile.md).
Your Docker set-up must have BuildKit enabled. BuildKit is enabled by default for all users on [Docker Desktop](../../desktop/index.md).
diff --git a/content/language/java/containerize.md b/content/language/java/containerize.md
index 4341113eee..fc6dbf8728 100644
--- a/content/language/java/containerize.md
+++ b/content/language/java/containerize.md
@@ -9,7 +9,7 @@ aliases:
## Prerequisites
-- You have installed the latest version of [Docker Desktop](../../../get-docker.md).
+- You have installed the latest version of [Docker Desktop](/get-started/get-docker.md).
Docker adds new features regularly and some parts of this guide may
work only with the latest version of Docker Desktop.
* You have a [Git client](https://git-scm.com/downloads). The examples in this
diff --git a/content/language/nodejs/containerize.md b/content/language/nodejs/containerize.md
index 610c07e663..0992e329fd 100644
--- a/content/language/nodejs/containerize.md
+++ b/content/language/nodejs/containerize.md
@@ -11,7 +11,7 @@ aliases:
## Prerequisites
* You have installed the latest version of [Docker
- Desktop](../../get-docker.md).
+ Desktop](/get-started/get-docker.md).
* You have a [git client](https://git-scm.com/downloads). The examples in this
section use a command-line based git client, but you can use any client.
diff --git a/content/language/php/containerize.md b/content/language/php/containerize.md
index 70ac36ef5d..85c42f961e 100644
--- a/content/language/php/containerize.md
+++ b/content/language/php/containerize.md
@@ -7,7 +7,7 @@ description: Learn how to containerize a PHP application.
## Prerequisites
* You have installed the latest version of [Docker
- Desktop](../../get-docker.md).
+ Desktop](/get-started/get-docker.md).
* You have a [git client](https://git-scm.com/downloads). The examples in this
section use a command-line based git client, but you can use any client.
diff --git a/content/language/python/containerize.md b/content/language/python/containerize.md
index 0b49567c14..3c521c8a5c 100644
--- a/content/language/python/containerize.md
+++ b/content/language/python/containerize.md
@@ -9,7 +9,7 @@ aliases:
## Prerequisites
-* You have installed the latest version of [Docker Desktop](../../get-docker.md).
+* You have installed the latest version of [Docker Desktop](/get-started/get-docker.md).
* You have a [git client](https://git-scm.com/downloads). The examples in this section use a command-line based git client, but you can use any client.
## Overview
diff --git a/content/language/ruby/containerize.md b/content/language/ruby/containerize.md
index b806126601..819fcaf068 100644
--- a/content/language/ruby/containerize.md
+++ b/content/language/ruby/containerize.md
@@ -9,7 +9,7 @@ aliases:
## Prerequisites
-* You have installed the latest version of [Docker Desktop](../../get-docker.md).
+* You have installed the latest version of [Docker Desktop](/get-started/get-docker.md).
* You have a [Git client](https://git-scm.com/downloads). The examples in this section show the Git CLI, but you can use any client.
## Overview
diff --git a/content/language/rust/build-images.md b/content/language/rust/build-images.md
index 1a57337041..b778ce47cd 100644
--- a/content/language/rust/build-images.md
+++ b/content/language/rust/build-images.md
@@ -6,7 +6,7 @@ description: Learn how to build your first Rust Docker image
## Prerequisites
-* You have installed the latest version of [Docker Desktop](../../get-docker.md).
+* You have installed the latest version of [Docker Desktop](/get-started/get-docker.md).
* You have a [git client](https://git-scm.com/downloads). The examples in this section use a command-line based git client, but you can use any client.
## Overview
diff --git a/content/language/rust/develop.md b/content/language/rust/develop.md
index c7479e3009..48b8ffe59a 100644
--- a/content/language/rust/develop.md
+++ b/content/language/rust/develop.md
@@ -6,7 +6,7 @@ description: Learn how to develop your Rust application locally.
## Prerequisites
-* You have installed the latest version of [Docker Desktop](../../get-docker.md).
+* You have installed the latest version of [Docker Desktop](/get-started/get-docker.md).
* You have completed the walkthroughs in the Docker Desktop [Learning Center](../../desktop/get-started.md) to learn about Docker concepts.
* You have a [git client](https://git-scm.com/downloads). The examples in this section use a command-line based git client, but you can use any client.
diff --git a/data/toc.yaml b/data/toc.yaml
index 5ca37f9724..b74db109e8 100644
--- a/data/toc.yaml
+++ b/data/toc.yaml
@@ -1,60 +1,86 @@
-Guides:
+Get started:
- title: Overview
- path: /guides/
+ path: /get-started/
+- title: Get Docker
+ path: /get-started/get-docker/
- title: Docker overview
- path: /guides/docker-overview/
-
-- sectiontitle: "Getting started"
+ path: /get-started/docker-overview/
+- sectiontitle: "Introduction"
section:
- title: "Overview"
- path: /guides/getting-started/
+ path: /get-started/introduction/
- title: "Get Docker Desktop"
- path: /guides/getting-started/get-docker-desktop/
+ path: /get-started/introduction/get-docker-desktop/
- title: "Develop with containers"
- path: /guides/getting-started/develop-with-containers/
+ path: /get-started/introduction/develop-with-containers/
- title: "Build and push your first image"
- path: /guides/getting-started/build-and-push-first-image/
+ path: /get-started/introduction/build-and-push-first-image/
- title: "What's next"
- path: /guides/getting-started/whats-next/
-
+ path: /get-started/introduction/whats-next/
- sectiontitle: "Docker concepts"
section:
- sectiontitle: "The basics"
section:
- title: "What is a container?"
- path: /guides/docker-concepts/the-basics/what-is-a-container/
+ path: /get-started/docker-concepts/the-basics/what-is-a-container/
- title: "What is an image?"
- path: /guides/docker-concepts/the-basics/what-is-an-image/
+ path: /get-started/docker-concepts/the-basics/what-is-an-image/
- title: "What is a registry?"
- path: /guides/docker-concepts/the-basics/what-is-a-registry/
+ path: /get-started/docker-concepts/the-basics/what-is-a-registry/
- title: "What is Docker Compose?"
- path: /guides/docker-concepts/the-basics/what-is-docker-compose/
+ path: /get-started/docker-concepts/the-basics/what-is-docker-compose/
- sectiontitle: "Building images"
section:
- title: Overview
- path: /guides/docker-concepts/building-images/
+ path: /get-started/docker-concepts/building-images/
- title: "Understanding image layers"
- path: /guides/docker-concepts/building-images/understanding-image-layers/
+ path: /get-started/docker-concepts/building-images/understanding-image-layers/
- title: "Writing a Dockerfile"
- path: /guides/docker-concepts/building-images/writing-a-dockerfile/
+ path: /get-started/docker-concepts/building-images/writing-a-dockerfile/
- title: "Build, tag and publish an image"
- path: /guides/docker-concepts/building-images/build-tag-and-publish-an-image/
+ path: /get-started/docker-concepts/building-images/build-tag-and-publish-an-image/
- title: "Using the build cache"
- path: /guides/docker-concepts/building-images/using-the-build-cache/
+ path: /get-started/docker-concepts/building-images/using-the-build-cache/
- title: "Multi-stage builds"
- path: /guides/docker-concepts/building-images/multi-stage-builds/
+ path: /get-started/docker-concepts/building-images/multi-stage-builds/
- sectiontitle: "Running containers"
section:
- title: "Publishing ports"
- path: /guides/docker-concepts/running-containers/publishing-ports/
+ path: /get-started/docker-concepts/running-containers/publishing-ports/
- title: "Overriding container defaults"
- path: /guides/docker-concepts/running-containers/overriding-container-defaults/
+ path: /get-started/docker-concepts/running-containers/overriding-container-defaults/
- title: "Persisting container data"
- path: /guides/docker-concepts/running-containers/persisting-container-data/
+ path: /get-started/docker-concepts/running-containers/persisting-container-data/
- title: "Sharing local files with containers"
- path: /guides/docker-concepts/running-containers/sharing-local-files/
+ path: /get-started/docker-concepts/running-containers/sharing-local-files/
- title: "Multi-container applications"
- path: /guides/docker-concepts/running-containers/multi-container-applications/
+ path: /get-started/docker-concepts/running-containers/multi-container-applications/
+- sectiontitle: Docker workshop
+ section:
+ - title: "Part 1: Overview"
+ path: /get-started/workshop/
+ - title: "Part 2: Containerize an application"
+ path: /get-started/workshop/02_our_app/
+ - title: "Part 3: Update the application"
+ path: /get-started/workshop/03_updating_app/
+ - title: "Part 4: Share the application"
+ path: /get-started/workshop/04_sharing_app/
+ - title: "Part 5: Persist the DB"
+ path: /get-started/workshop/05_persisting_data/
+ - title: "Part 6: Use bind mounts"
+ path: /get-started/workshop/06_bind_mounts/
+ - title: "Part 7: Multi-container apps"
+ path: /get-started/workshop/07_multi_container/
+ - title: "Part 8: Use Docker Compose"
+ path: /get-started/workshop/08_using_compose/
+ - title: "Part 9: Image-building best practices"
+ path: /get-started/workshop/09_image_best/
+ - title: "Part 10: What next?"
+ path: /get-started/workshop/10_what_next/
+
+Guides:
+- title: Overview
+ path: /guides/
- sectiontitle: Language-specific guides
section:
- path: /language/
@@ -266,30 +292,6 @@ Guides:
- title: Cloud integrations
path: /cloud/
-- sectiontitle: Docker workshop
- section:
- - title: "Part 1: Overview"
- path: /guides/workshop/
- - title: "Part 2: Containerize an application"
- path: /guides/workshop/02_our_app/
- - title: "Part 3: Update the application"
- path: /guides/workshop/03_updating_app/
- - title: "Part 4: Share the application"
- path: /guides/workshop/04_sharing_app/
- - title: "Part 5: Persist the DB"
- path: /guides/workshop/05_persisting_data/
- - title: "Part 6: Use bind mounts"
- path: /guides/workshop/06_bind_mounts/
- - title: "Part 7: Multi-container apps"
- path: /guides/workshop/07_multi_container/
- - title: "Part 8: Use Docker Compose"
- path: /guides/workshop/08_using_compose/
- - title: "Part 9: Image-building best practices"
- path: /guides/workshop/09_image_best/
- - title: "Part 10: What next?"
- path: /guides/workshop/10_what_next/
-
-
- path: /guides/resources/
title: "Educational resources"
@@ -1173,8 +1175,6 @@ Reference:
Manuals:
- path: /manuals/
title: Overview
-- title: Get Docker
- path: /get-docker/
- sectiontitle: Docker Desktop
section:
- path: /desktop/
diff --git a/hugo.yaml b/hugo.yaml
index 4fe336fbde..60d5cbb902 100644
--- a/hugo.yaml
+++ b/hugo.yaml
@@ -120,15 +120,18 @@ params:
menus:
main:
+ - name: Get started
+ url: /get-started/
+ weight: 1
- name: Guides
url: /guides/
- weight: 1
+ weight: 2
- name: Manuals
url: /manuals/
- weight: 2
+ weight: 3
- name: Reference
url: /reference/
- weight: 3
+ weight: 4
footer:
- url: https://www.docker.com/products
diff --git a/layouts/index.html b/layouts/index.html
index 636996fde0..def2c76285 100644
--- a/layouts/index.html
+++ b/layouts/index.html
@@ -28,7 +28,7 @@
Learn how to install Docker for Mac, Windows, or Linux and explore
our developer tools.
-
{{ partial "icon" "download"}}
Get Docker
@@ -119,7 +119,7 @@