diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
index 49e36288f..fb6b13ab7 100644
--- a/.devcontainer/devcontainer.json
+++ b/.devcontainer/devcontainer.json
@@ -13,6 +13,13 @@
 	// Use 'appPort' to create a container with published ports. If the port isn't working, be sure
 	// your server accepts connections from all interfaces (0.0.0.0 or '*'), not just localhost.
 	// "appPort": [],
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	"forwardPorts": [5073],
+	// "portsAttributes": {
+	//   "5073": {
+	//     "protocol": "https"
+	//   }
+	// },
 
 	// Uncomment the next line to run commands after the container is created.
 	// "postCreateCommand": "rustc --version",
@@ -26,8 +33,19 @@
 	// Uncomment the line below to mount your local usersecrets into the devcontainer from a Mac/Linux OS
 	// "mounts": [ "source=${localEnv:HOME}/.microsoft/usersecrets,target=/root/.microsoft/usersecrets,type=bind" ],
 	
+	
 	// Add the IDs of extensions you want installed when the container is created in the array below.
-	"extensions": [
-		"ms-dotnettools.csharp"	
-	]
+	"customizations": {
+        "vscode": {
+            "extensions": [
+                "ms-vscode.vscode-node-azure-pack",
+                "GitHub.copilot",
+                "GitHub.vscode-github-actions",
+				"GitHub.copilot-chat",
+                "ms-dotnettools.vscode-dotnet-runtime",
+                "ms-dotnettools.csdevkit",
+                "ms-dotnetools.csharp"
+            ]
+        }
+    }
 }
diff --git a/docs/codespaces.md b/docs/codespaces.md
new file mode 100644
index 000000000..34618ad0f
--- /dev/null
+++ b/docs/codespaces.md
@@ -0,0 +1,29 @@
+Launching the SDK in github Codespaces
+========
+
+> Note: These instructions do not include anything about 
+
+Browse to the folder
+```sh
+cd src/CarbonAware.WebApi/src/
+```
+
+Run the project
+```sh
+dotnet run
+```
+
+It should look like that
+
+![sceenshot of the terminal view starting the webapi in codespaces](./images/codespaces-terminal-1.png)
+
+You can then select the browser icon to open in the browser
+
+![codespaces port tab](./images/codespaces-ports-1.png)
+
+> Note: the URL to browse needs to have that format: https://<codespace public URL>/swagger
+
+Make sure to browser to the swagger UI by appending `/swagger` to the URL, and the following should open.
+
+![sceenshot of the browser view starting the webapi and navigating to the Swagger UI](./images/codespaces-browser-1.png)
+
diff --git a/docs/images/codespaces-browser-1.png b/docs/images/codespaces-browser-1.png
new file mode 100644
index 000000000..70f2a1437
Binary files /dev/null and b/docs/images/codespaces-browser-1.png differ
diff --git a/docs/images/codespaces-ports-1.png b/docs/images/codespaces-ports-1.png
new file mode 100644
index 000000000..5bc5fd48a
Binary files /dev/null and b/docs/images/codespaces-ports-1.png differ
diff --git a/docs/images/codespaces-terminal-1.png b/docs/images/codespaces-terminal-1.png
new file mode 100644
index 000000000..73c59ef52
Binary files /dev/null and b/docs/images/codespaces-terminal-1.png differ