From 40430bf54943ad54e0621f0979cd0d58a603a027 Mon Sep 17 00:00:00 2001
From: gitea_admin <admin@gitea.local>
Date: Wed, 11 Mar 2026 14:38:55 +0000
Subject: [PATCH] Update wiki Home page for mongodb-source

---
 Home.md | 46 ++++++++++++++++++++++++++++++++--------------
 1 file changed, 32 insertions(+), 14 deletions(-)

diff --git a/Home.md b/Home.md
index 93a012c..6acacab 100644
--- a/Home.md
+++ b/Home.md
@@ -1,21 +1,39 @@
-# Deploy the Project on CamelX Platform
+# MongoDB Source
 
-Deploy on CamelX Platform in three steps
+Consume data from MongoDB.
 
-## Step 1: Create a release
-From the project space, click on **"Create a release"**
+If you enable the `persistentTailTracking` property, the consumer keeps track of the last consumed message and, on the next restart, the consumption restarts from that message. If you enable `persistentTailTracking`, you must provide a value for the `tailTrackIncreasingField` property (by default it is optional).
 
-The new version is automatically available in the list
+If you disable the `persistentTailTracking` property, the consumer consumes the whole collection and waits in idle for new data to consume.
 
-## Step 2: Deploy
-Click on **"Deploy"**
+The collection that provides the data must be a capped collection.
 
-- **Version:** Select the desired release
-- **Environment:** Choose `Development`, `Staging`, or `Production` 
-- **Configuration:** Select the configuration source
-- **Resources:** Set CPU and Memory
+## Metadata
 
-## Step 3: Expose
-Enable **"Expose"**
+| Property | Value |
+|----------|-------|
+| Type | source |
+| Group | MongoDB |
+| Namespace | Nosql |
+| Support Level | Stable |
+| Provider | Apache Software Foundation |
 
-Choose an **API Gateway** (Internal, Public, etc.)
+## Properties
+
+| Name | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `hosts` | string | ✓ |  | A comma-separated list of MongoDB host addresses in `host:port` format. |
+| `collection` | string | ✓ |  | The name of the MongoDB collection to bind to this endpoint. |
+| `password` | string |  |  | The user password for accessing MongoDB. |
+| `username` | string |  |  | The username for accessing MongoDB. The username must be present in the MongoDB's authentication database (`authenticationDatabase`). By default, the MongoDB `authenticationDatabase` is 'admin'. |
+| `ssl` | boolean |  | `true` | whether to enable ssl connection to mongodb |
+| `sslValidationEnabled` | boolean |  | `true` | IMPORTANT this should be disabled only in test environment since can pose security issues. |
+| `database` | string | ✓ |  | The name of the MongoDB database. |
+| `persistentTailTracking` | boolean |  | `false` | Specifies to enable persistent tail tracking, which is a mechanism to keep track of the last consumed data across system restarts. The next time the system is up, the endpoint recovers the cursor from the point where it last stopped consuimg data. This option will only work on capped collections. |
+| `tailTrackIncreasingField` | string |  |  | The correlation field in the incoming data which is of increasing nature and is used to position the tailing cursor every time it is generated. |
+
+## Dependencies
+
+- `camel:kamelet`
+- `camel:mongodb`
+- `camel:jackson`