Merge branch 'main' into main

Author: tokifyi

blog/2025-06-06-may-product-updates.md

@@ -1,7 +1,6 @@
 ---
 title: "May 2025 Defang Compose Update"
 description: "Monthly product updates from the Defang team - May 2025"
-slug: 2025-06-06-product-update
 tags:
   [
     Cloud,

blog/2025-06-16-crew-ai-sample.md

@@ -1,7 +1,6 @@
 ---
 title: "Sample: Starter Kit for RAG + Agents with CrewAI"
 description: "Going over our sample for RAG + Agents with CrewAI"
-slug: rag-agents-crewai-sample
 tags: [Cloud, NoDevOps, Docker Compose, Defang, Sample]
 author: Defang Team
 ---
@@ -89,4 +88,3 @@ DEFANG_PROVIDER=<provider> defang compose up
 ```
 
 Want more? File an [issue](https://github.com/DefangLabs/samples/issues) to request a sample—we'll do everything we can to help you deploy better and faster!
-

blog/2025-06-16-docker-compose-defang.md

@@ -1,7 +1,6 @@
 ---
 title: "Bridging Local Development and Cloud Deployment"
 description: "Announcing our new whitepaper: Bridging Local Development and Cloud Deployment with Docker Compose and Defang"
-slug: defang-docker-compose
 tags: [Cloud, NoDevOps, Docker Compose, Defang, Whitepaper]
 author: Defang Team
 ---

blog/2025-08-22-agentic-apps.md

@@ -45,6 +45,7 @@ Defang works seamlessly with leading agentic frameworks. Try them out with our r
 - [LangGraph](https://github.com/DefangLabs/samples/tree/main/samples/agentic-langgraph) - workflow sample that defines and controls multi-step agentic graphs with LangChain.
 - [Agentic Strands](https://github.com/DefangSamples/sample-agentic-strands-template/tree/main) - A Strands Agent application.
 
+
 More framework templates coming soon.
 
 ## Why It Matters

docs/concepts/authentication.md

@@ -12,7 +12,7 @@ To do pretty much anything with Defang, you'll need to authenticate with the sys
 defang login
 ```
 
-This will prompt you to open a browser and log in to your [Defang account](/docs/concepts/accounts). For now, the only way to log in is with GitHub, though we will offer other providers to authenticate in the future. Once you've logged in, you can close the browser and return to the terminal. You should see a message that you've successfully logged in.
+This will prompt you to open a browser and log in to your [Defang account](/docs/concepts/accounts). You can log in using [GitHub](https://github.com/) or [GitLab](https://gitlab.com/). We will offer other authentication providers in the future. Once you've logged in, you can close the browser and return to the terminal. You will see a message that you've successfully logged in.
 
 :::tip
 Keep in mind that your Defang account is separate from your [cloud provider account](/docs/concepts/defang-byoc). You will need to authenticate with your cloud provider account separately to deploy services to your own cloud account.

docs/concepts/deployment-modes.md

@@ -16,13 +16,12 @@ Defang provides three deployment modes: `affordable`, `balanced`, and `high_avai
 
 | Feature | Affordable | Balanced | High Availability |
 |-|-|-|-|
-| Build Resources | Builds will be run with 2x vCPUs | Builds will be run with 2x vCPUs | Builds will be run with 4x vCPUs |
+| Build Resources | Builds will be run with 2x vCPUs |  (like `affordable`) | Builds will be run with 4x vCPUs |
 | Compute | Using spot instances | (like `affordable`) | On-demand instances |
 | Databases | Defang will provision resources optimized for burstable memory | (like `high_availability`) | Defang will provision resources optimized for production |
-| Deployment | Previous deployments will be spun down before new deployments are spun up. | (like `high_availability`) | Rolling updates will be used to deploy new versions. Defang will gradually replace services while maintaining at least [the original number of replicas](/docs/tutorials/scaling-your-services). |
-| Logging | Logs retained for 1 day to save costs. | | Logs retained for 30 days for compliance. |
+| Deployment | Previous deployments will be spun down before new deployments are spun up. Stopped tasks will not restart. | (like `high_availability`) | Rolling updates will be used to deploy new versions. Defang will gradually replace services while maintaining at least [the original number of replicas](/docs/tutorials/scaling-your-services). |
+| Logs | Logs retained for 1 day to save costs. | Logs retained for 7 days to balance cost and access. | Logs retained for 30 days for compliance. |
 | Networking | | (like `high_availability`) | Defang will provision a NAT gateway. |
 | Load Balancing | HTTP redirect to HTTPS using `302 Found` | | Termination Protection will be enabled; logs are retained on "down" |
 | DNS | Defang will provision shorter TTLs; zones will be forcefully destroyed | | Defang will provision longer TTLs; records can be overwritten for ZDT |
-| Managed storage | Operations that cause downtime are allowed | | Encryption at rest; Final snapshot created on "down" |
-| Logs | 1 day retention | 7 days retention | 30 days retention |
+| Managed Storage | Operations that cause downtime are allowed | | Encryption at rest; Final snapshot created on "down" |

docs/concepts/estimation.md

@@ -9,17 +9,17 @@ sidebar_position: 280
 Defang enables you to estimate the cost of deploying and running your project without needing to create an account with your cloud provider.
 
 :::info
-Currently, AWS is the only provider supported for cost estimation. Support for GCP and Digital Ocean is coming soon.
+Currently, AWS and GCP are supported for cost estimation. Support for Digital Ocean is coming soon.
 :::
 
 ## Generating an Estimate
 
 Navigate your shell to your application's working directory and run
 ```
-defang estimate [--provider aws] [--mode affordable|balanced|high_availability]
+defang estimate [--provider=aws|gcp] [--mode=affordable|balanced|high_availability]
 ```
 
-Here is an example of the output you would see if you estimated the cost deploying the [django-postgres](https://github.com/DefangLabs/samples/tree/main/samples/django-postgres) sample using the `balanced` [deployment mode](/docs/concepts/deployment-modes).
+Here is an example of the output you would see if you estimated the cost deploying the [django-postgres](https://github.com/DefangLabs/samples/tree/main/samples/django-postgres) to AWS sample using the `balanced` [deployment mode](/docs/concepts/deployment-modes).
 
 ```
 defang estimate --provider=aws --mode=balanced

docs/concepts/managed-storage/managed-mongodb.md

@@ -7,7 +7,7 @@ sidebar_position: 3000
 # Managed MongoDB
 
 :::info
-This feature was introduced in Defang v1.2.0 released on June 3, 2025. [Upgrade to the latest version](/docs/cli/defang_upgrade)
+This feature was introduced in Defang v1.2.0 released on June 3, 2025 for AWS. [Upgrade to the latest version](/docs/cli/defang_upgrade)
 :::
 
 Managed MongoDB is a service that allows you to store and retrieve large amounts of data in a document-oriented format. MongoDB is ideal for storing unstructured data like JSON documents, making it a popular choice for modern applications.
@@ -19,15 +19,33 @@ Managed MongoDB is a service that allows you to store and retrieve large amounts
 | [Playground](/docs/providers/playground#managed-services) | ⚠️ Unmanaged |
 | [AWS](/docs/providers/aws#managed-storage) | ✅ DocumentDB |
 | [DigitalOcean](/docs/providers/digitalocean#future-improvements) | ⚠️ Unmanaged |
-| [GCP](/docs/providers/gcp#future-improvements) | ⚠️ Unmanaged |
+| [GCP](/docs/providers/gcp#future-improvements) | ✅ Firestore |
 
 ## How to use Managed MongoDB
 
 To use managed MongoDB, in your `compose.yaml` file, use the `x-defang-mongodb` extension to define your MongoDB service. Adding the extension will tell Defang to provision a managed instance, rather than running MongoDB as a container.
 
 ### Required Configuration
 
-When using managed MongoDB, you **must** set a username and password for the database. By default, these are read from the `MONGO_INITDB_ROOT_USERNAME` and `MONGO_INITDB_ROOT_PASSWORD` config variables, conform [the official MongoDB container image](https://hub.docker.com/_/mongo). These can be set using the `defang config set MONGO_INITDB_ROOT_USERNAME` and `defang config set MONGO_INITDB_ROOT_PASSWORD` commands. If you do not provide these values, the deployment will fail.
+### AWS
+When using managed MongoDB on AWS, you **must** set a username and password for the database. By default, these are read from the `MONGO_INITDB_ROOT_USERNAME` and `MONGO_INITDB_ROOT_PASSWORD` config variables, following [the official MongoDB container image](https://hub.docker.com/_/mongo) convention.
+
+You can set these using the following commands:
+
+```bash
+defang config set MONGO_INITDB_ROOT_USERNAME <your-username>
+defang config set MONGO_INITDB_ROOT_PASSWORD <your-password>
+```
+
+If you do not provide these values, the deployment will fail.
+
+### GCP
+
+When using managed MongoDB on GCP, you **must** set a `MONGO_INITDB_DATABASE` environment variable with the name of the database to create.
+
+Defang will automatically create a config variable named `<SERVICE_NAME>_URL` that contains the connection string for your MongoDB database. For example, if your service is named `db`, the config variable will be `DB_URL`.
+
+**Important:** GCP will ignore `MONGO_INITDB_ROOT_USERNAME` and `MONGO_INITDB_ROOT_PASSWORD` credentials since they are not needed. GCP automatically handles authentication and grants your service access to the MongoDB database.
 
 ### Example
 
@@ -36,15 +54,23 @@ services:
   app:
     # [...]
     environment:
-      MONGO_URI: mongodb://$MONGO_INITDB_ROOT_USERNAME:$MONGO_INITDB_ROOT_PASSWORD@db:27017/
+      DB_URL: mongodb://$MONGO_INITDB_ROOT_USERNAME:$MONGO_INITDB_ROOT_PASSWORD@db:27017/
     depends_on:
       - db
 
   db:
     image: mongo:5
     x-defang-mongodb: true
+    environment:
+      MONGO_INITDB_DATABASE: mydb
 ```
 
+:::warning[Deleting a GCP Firestore MongoDB Database]
+Please be aware that GCP Firestore does not allow deletion of your database when you bring down your project using `defang compose down`. You must go to the [GCP Cloud Console for Firestore](https://console.cloud.google.com/firestore/databases/) to delete it manually.
+:::
+
 :::warning[Version]
 AWS DocumentDB is compatible with MongoDB 3.6, 4.0, and 5.0. The `mongo:5` image is compatible with DocumentDB 5.0, so we recommend using this version for your MongoDB service. Deployment will fail for versions higher than 5.
+
+GCP Firestore does not have a configurable version.
 :::

docs/concepts/managed-storage/managed-storage.md

@@ -6,4 +6,4 @@ sidebar_position: 000
 
 # Managed Storage
 
-Defang helps you provision the infrastructure you need to run your services. That infrastructure is designed to scale in and out without persistent storage, so you can build highly scalable services. But Defang can also help you provision managed services to store and persist your data, like [caches](./managed-redis.md), [databases](./managed-postgres.mdx), and [object storage](./managed-object-storage.md).
+Defang helps you provision the infrastructure you need to run your services. That infrastructure is designed to scale in and out without persistent storage, so you can build highly scalable services. Defang can also help you provision managed services to store and persist your data, like [caches](./managed-redis.md), [sql databases](./managed-postgres.mdx), [nosql databases](./managed-mongodb.md), and [object storage](./managed-object-storage.md).

docs/concepts/mcp.md

@@ -20,31 +20,39 @@ This page is a guide to the Defang MCP Server detailing its installation, tools,
 
 ## Installation
 
-Ensure that you have the [npm package manager](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) installed, as `npx` commands are required for setup.
+Ensure that you have the [Defang CLI](/docs/getting-started.mdx#install-the-defang-cli) installed.
 
-:::warning
-At this time, the Defang MCP Server can only be installed using `npx`. Other methods are not yet supported.
-:::
 Run the setup command in your terminal for your IDE of choice from the [Supported IDEs](#supported-ides) section. This will connect the Defang MCP Server to your IDE. The general format of the command is as follows:
 
+:::tip[Recommended Installation]
+Install the [Defang CLI](/docs/getting-started.mdx#install-the-defang-cli) using [Curl](https://curl.se/) or [Homebrew](https://brew.sh/)
+
 ```bash
-npx -y defang@latest mcp setup --client=<your-ide>
+defang mcp setup --client=<your-ide>
 ```
 
+:::
+
 Once the command completes, you may need to restart your IDE for the changes to take effect.
 
 Once the MCP Server is running, you can access the Defang MCP tools directly through the AI agent chat in your IDE.
 
 That's it! Feel free to explore our [Example Prompts](#example-prompts) to get ideas on how to interact with the AI agent and make the most of the Defang MCP Server.
 
+Note that `npx` installation is supported, but not recommended.
+
+```bash
+npx -y defang@latest mcp setup --client=<your-ide>
+```
+
 ## Supported IDEs
 
 ### Cursor
 
 Setup command:
 
 ```bash
-npx -y defang@latest mcp setup --client=cursor
+defang mcp setup --client=cursor
 ```
 
 Once setup is complete, you can interact with the AI coding agent using Defang-related actions like `check defang services` or [other prompts](#example-prompts). Here's an example of what it could look like:
@@ -56,7 +64,7 @@ Once setup is complete, you can interact with the AI coding agent using Defang-r
 Setup command:
 
 ```bash
-npx -y defang@latest mcp setup --client=windsurf
+defang mcp setup --client=windsurf
 ```
 
 Once setup is complete, you can interact with the AI coding agent using Defang-related actions like `check defang services` or [other prompts](#example-prompts). Here's an example of what it could look like:
@@ -68,7 +76,7 @@ Once setup is complete, you can interact with the AI coding agent using Defang-r
 Setup command:
 
 ```bash
-npx -y defang@latest mcp setup --client=vscode
+defang mcp setup --client=vscode
 ```
 
 Once setup is complete, you can interact with the AI coding agent using Defang-related actions like `check defang services` or [other prompts](#example-prompts). Here's an example of what it could look like:
@@ -80,21 +88,33 @@ Once setup is complete, you can interact with the AI coding agent using Defang-r
 Setup command:
 
 ```bash
-npx -y defang@latest mcp setup --client=vscode-insiders
+defang mcp setup --client=vscode-insiders
 ```
 
 Once setup is complete, you can interact with the AI coding agent using Defang-related actions like `check defang services` or [other prompts](#example-prompts). Here's an example of what it could look like:
 
 ![VS Code](/img/mcp-concept/vscode-insiders.png)
 
+### Kiro
+
+Setup command:
+
+```bash
+defang mcp setup --client=kiro
+```
+
+Once setup is complete, you can interact with the AI coding agent using Defang-related actions like `check defang services` or [other prompts](#example-prompts). Here's an example of what it could look like:
+
+![Kiro](/img/mcp-concept/kiro.png)
+
 ### Claude Desktop
 
 While this is not an IDE in the traditional sense, it can support MCP servers. For a smoother experience, consider specifying a project name or directory when making chat prompts to this platform.
 
 Setup command:
 
 ```bash
-npx -y defang@latest mcp setup --client=claude
+defang mcp setup --client=claude
 ```
 
 Once setup is complete, you can interact with the AI coding agent using Defang-related actions like `check defang services` or [other prompts](#example-prompts). Here's an example of what it could look like:
@@ -121,6 +141,22 @@ The `services` tool displays the details of all your services that are currently
 
 Given a project name or directory, the `destroy` tool identifies any services deployed with Defang and terminates them. If no services are found, it will display an appropriate message.
 
+### `estimate`
+
+The `estimate` tool scan your project directory and considers your [deployment mode](/docs/concepts/deployment-modes.md) (which defaults to `AFFORDABLE`) to provide a [cost estimation](/docs/concepts/estimation.md) for your project. Currently, the tool supports two providers: `AWS` or `GCP`.
+
+### `list_configs`
+
+The `list_configs` tool will [list](/docs/cli/defang_config) all the Defang configs set for your project.
+
+### `set_config`
+
+The `set_config` tool will [set](/docs/tutorials/configure-environment-variables#step-2---set-the-actual-value-in-the-defang-cli) a specific Defang config for your project.
+
+### `remove_config`
+
+The `remove_config` tool will [remove](/docs/tutorials/configure-environment-variables#removing-a-config-value) a specific Defang config for your project.
+
 ## Example Prompts
 
 After connecting the Defang MCP Server to your IDE using an installation method, you can type in prompts in your chat to invoke the AI agent to use any MCP tool(s).
@@ -149,4 +185,32 @@ deploy this with defang /Users/yourname/Documents/project1
 do I have a service called project1
 ```
 
+You can estimate the cost of a deployment to a supported cloud provider:
+
+```
+can you estimate balance mode on aws for this project?
+```
+
+```
+can you estimate how much this project will cost on gcp?
+```
+
+You can list, set and remove Defang configs for a project:
+
+```
+what defang configs do I have set for this project?
+```
+
+```
+list all the defang configs I have set for this project
+```
+
+```
+set the defang config DATABASE_URL to example.com
+```
+
+```
+remove the defang config DATABASE_URL
+```
+
 Feel free to try any of these prompts or create your own!