diff --git a/docs/deployment.md b/docs/deployment.md
index 38a91ab..b0c541f 100644
--- a/docs/deployment.md
+++ b/docs/deployment.md
@@ -22,6 +22,18 @@ Check the [Azure Products by Region](https://azure.microsoft.com/explore/global-
 
 Here are some examples of the regions where the services are available: East US, East US2, Japan East, UK South, Sweden Central.
 
+### Install and verify the Bicep CLI
+
+`azd up` compiles every file under `infra/*.bicep`. To avoid network downloads during deployment, make sure the Bicep CLI is already available on your machine (or Codespace) through the Azure CLI:
+
+```bash
+az bicep install   # or az bicep upgrade
+az bicep version   # verify installation
+```
+
+If you prefer to use the standalone `bicep` binary, place it on your `PATH` before running `azd up`.
+
+
 ### **Important Note for PowerShell Users**
 
 If you encounter issues running PowerShell scripts due to the policy of not being digitally signed, you can temporarily adjust the `ExecutionPolicy` by running the following command in an elevated PowerShell session: