From e2f4c33bff542dae800a523ed19f8939f112bd34 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Nguy=E1=BB=85n=20H=E1=BB=93ng=20Qu=C3=A2n?=
 <ng.hong.quan@gmail.com>
Date: Wed, 26 Nov 2025 15:25:06 +0700
Subject: [PATCH 1/2] Align with more common way to install softwares on Debian

---
 content/manuals/engine/install/debian.md | 12 +++++++-----
 content/manuals/engine/install/ubuntu.md | 12 +++++++-----
 2 files changed, 14 insertions(+), 10 deletions(-)

diff --git a/content/manuals/engine/install/debian.md b/content/manuals/engine/install/debian.md
index 7f2e683fc22f..386345d4cb31 100644
--- a/content/manuals/engine/install/debian.md
+++ b/content/manuals/engine/install/debian.md
@@ -110,18 +110,20 @@ Docker from the repository.
    ```bash
    # Add Docker's official GPG key:
    sudo apt update
-   sudo apt install ca-certificates curl
+   sudo apt install ca-certificates
    sudo install -m 0755 -d /etc/apt/keyrings
-   sudo curl -fsSL {{% param "download-url-base" %}}/gpg -o /etc/apt/keyrings/docker.asc
-   sudo chmod a+r /etc/apt/keyrings/docker.asc
+   wget -qO- {{% param "download-url-base" %}}/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
+   sudo chmod a+r /etc/apt/keyrings/docker.gpg
 
-   # Add the repository to Apt sources:
+   # Add the repository to Apt sources. This command uses Bash syntax.
+   # If you are using different shell, please run `bash` to switch to Bash
+   # before running the following command.
    sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
    Types: deb
    URIs: {{% param "download-url-base" %}}
    Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
    Components: stable
-   Signed-By: /etc/apt/keyrings/docker.asc
+   Signed-By: /etc/apt/keyrings/docker.gpg
    EOF
 
    sudo apt update
diff --git a/content/manuals/engine/install/ubuntu.md b/content/manuals/engine/install/ubuntu.md
index eea8f16f1899..e10a21ce9adb 100644
--- a/content/manuals/engine/install/ubuntu.md
+++ b/content/manuals/engine/install/ubuntu.md
@@ -127,18 +127,20 @@ Docker from the repository.
    ```bash
    # Add Docker's official GPG key:
    sudo apt update
-   sudo apt install ca-certificates curl
+   sudo apt install ca-certificates
    sudo install -m 0755 -d /etc/apt/keyrings
-   sudo curl -fsSL {{% param "download-url-base" %}}/gpg -o /etc/apt/keyrings/docker.asc
-   sudo chmod a+r /etc/apt/keyrings/docker.asc
+   wget -qO- {{% param "download-url-base" %}}/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
+   sudo chmod a+r /etc/apt/keyrings/docker.gpg
 
-   # Add the repository to Apt sources:
+   # Add the repository to Apt sources. This command uses Bash syntax.
+   # If you are using different shell, please run `bash` to switch to Bash
+   # before running the following command.
    sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
    Types: deb
    URIs: {{% param "download-url-base" %}}
    Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
    Components: stable
-   Signed-By: /etc/apt/keyrings/docker.asc
+   Signed-By: /etc/apt/keyrings/docker.gpg
    EOF
 
    sudo apt update

From 642a798e1cbbeb0d4398f256653635e666684f44 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Nguy=E1=BB=85n=20H=E1=BB=93ng=20Qu=C3=A2n?=
 <ng.hong.quan@gmail.com>
Date: Thu, 27 Nov 2025 15:18:41 +0700
Subject: [PATCH 2/2] ca-certificates is pre-included in Debian & Ubuntu

---
 content/manuals/engine/install/debian.md | 1 -
 content/manuals/engine/install/ubuntu.md | 1 -
 2 files changed, 2 deletions(-)

diff --git a/content/manuals/engine/install/debian.md b/content/manuals/engine/install/debian.md
index 386345d4cb31..ae92617a6a15 100644
--- a/content/manuals/engine/install/debian.md
+++ b/content/manuals/engine/install/debian.md
@@ -110,7 +110,6 @@ Docker from the repository.
    ```bash
    # Add Docker's official GPG key:
    sudo apt update
-   sudo apt install ca-certificates
    sudo install -m 0755 -d /etc/apt/keyrings
    wget -qO- {{% param "download-url-base" %}}/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
    sudo chmod a+r /etc/apt/keyrings/docker.gpg
diff --git a/content/manuals/engine/install/ubuntu.md b/content/manuals/engine/install/ubuntu.md
index e10a21ce9adb..13f4e61fa835 100644
--- a/content/manuals/engine/install/ubuntu.md
+++ b/content/manuals/engine/install/ubuntu.md
@@ -127,7 +127,6 @@ Docker from the repository.
    ```bash
    # Add Docker's official GPG key:
    sudo apt update
-   sudo apt install ca-certificates
    sudo install -m 0755 -d /etc/apt/keyrings
    wget -qO- {{% param "download-url-base" %}}/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
    sudo chmod a+r /etc/apt/keyrings/docker.gpg