diff --git a/.gitignore b/.gitignore
index c5aa2d25..e6ae4965 100644
--- a/.gitignore
+++ b/.gitignore
@@ -13,3 +13,6 @@ deploy_key.pub
 
 # Pycharm
 .idea
+
+# VS Code devcontainer
+.devcontainer
diff --git a/.devcontainer/devcontainer.json b/devcontainer-example/devcontainer.json
similarity index 100%
rename from .devcontainer/devcontainer.json
rename to devcontainer-example/devcontainer.json
diff --git a/.devcontainer/docker-compose.yml b/devcontainer-example/docker-compose.yml
similarity index 100%
rename from .devcontainer/docker-compose.yml
rename to devcontainer-example/docker-compose.yml
diff --git a/development/README.md b/development/README.md
index f7e4bc25..607e53ed 100644
--- a/development/README.md
+++ b/development/README.md
@@ -22,6 +22,12 @@ git clone https://github.com/frappe/frappe_docker.git
 cd frappe_docker
 ```
 
+Copy example devcontainer config from `devcontainer-example` to `.devcontainer`
+
+```shell
+cp -R devcontainer-example .devcontainer
+```
+
 ## Use VSCode Remote Containers extension
 
 For most people getting started with Frappe development, the best solution is to use [VSCode Remote - Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers).