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. - ![A screenshot of the landing page of the Nginx web server running in a container](/guides/docker-concepts/the-basics/images/access-the-frontend.webp?border=true) + ![A screenshot of the landing page of the Nginx web server running in a container](/get-started/docker-concepts/the-basics/images/access-the-frontend.webp?border=true) ### 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 @@

- Get started