mongo Dhārā!

MongoDB management made elegant, fast, and intuitive.

mongoDhārā is a blazing-fast web UI for MongoDB — built with Svelte & FastAPI.
Manage databases, collections, documents, and GridFS visually with zero overhead.

📖 Table of Contents

• ✨ Key Features
• 🚀 Quick Start with Helm
• 📦 Helm Chart Deployment
• 🐳 Build & Push Docker Images
• 🧑‍💻 Local Development
• 📁 Project Structure
• 🔧 Environment Variables
• 📊 Monitoring and Scaling
• 🛡️ Security
• 🤝 Contributing
• ⚖️ Legal Notice
• 📄 License

💡 Why mongoDhārā?

• Designed for speed — near-raw MongoDB performance with minimal overhead
• Clean, modern UI for effortless data exploration and management
• Full control: databases, collections, documents, GridFS, and bulk operations
• Scalable deployment with Kubernetes and Helm support
• Open-source and developer-friendly

✨ Key Features

⚡ High-Performance UI

• Near-raw MongoDB speed with minimal overhead (PyMongo-powered)
• Optimized queries with fast pagination and filtering
• Responsive layout with light/dark theme support
• Real-time status updates and notifications
• Intuitive navigation with breadcrumbs and global search

🗂️ Database, Collection & Document Management

• Create, rename, and delete databases and collections
• Browse, query, and edit documents with a rich JSON editor
• Advanced query builder with filtering, sorting, and aggregation
• Full CRUD support with bulk import/export of documents (JSON)
• Run large-scale bulk operations with progress and error tracking
• MongoDB-compliant naming and validation

📁 GridFS File Storage

• Upload, download, and manage files with GridFS
• Search files by name or metadata
• Create and manage multiple storage buckets

🧾 Rich JSON Editing

• Syntax-highlighted editor with real-time validation
• Inline error detection and formatting
• Auto-format and schema assistance

🚀 Quick Start with Helm

The easiest way to deploy mongoDhārā is using the included Helm chart:

# Clone the repository
git clone <your-repo-url>
cd mongodhara

# Deploy with custom MongoDB URI and images
helm install mongodhara ./helm-chart \
  --set backend.image.repository=mongodhara/backend \
  --set backend.image.tag=1.0.0 \
  --set frontend.image.repository=mongodhara/frontend \
  --set frontend.image.tag=1.0.0 \
  --set backend.env[0].value="mongodb://your-mongo-host:27017/yourdb"

💡 For production deployments and advanced configuration options, see the detailed Helm Chart Deployment section below.

📦 Helm Chart Deployment

Prerequisites

• Kubernetes cluster (1.16+)
• Helm 3.2.0+
• Docker images pushed to a registry (or use default placeholder images)

Installation Options

1. Basic Installation

helm install mongodhara ./helm-chart

This deploys with default settings:

• Backend: mongodhara/backend:1.0.0
• Frontend: mongodhara/frontend:1.0.0
• Ingress: mongodhara.local
• MongoDB URI: mongodb://localhost:27017

2. Production Installation with Custom Values

Create a production-values.yaml:

# Production configuration
backend:
  replicaCount: 3
  image:
    repository: your-registry.com/mongodhara-backend
    tag: v1.2.0
  env:
    - name: MONGO_URI
      value: "mongodb://prod-mongo-cluster:27017/production"
  resources:
    limits:
      cpu: 500m
      memory: 512Mi
    requests:
      cpu: 100m
      memory: 128Mi
  autoscaling:
    enabled: true
    minReplicas: 2
    maxReplicas: 10
    targetCPUUtilizationPercentage: 70

frontend:
  replicaCount: 2
  image:
    repository: your-registry.com/mongodhara-frontend
    tag: v1.2.0
  env:
    - name: REMOTE_API_BASE_URL
      value: "https://api.yourdomain.com/mongodharaapi"
  resources:
    limits:
      cpu: 200m
      memory: 256Mi
    requests:
      cpu: 50m
      memory: 64Mi

ingress:
  enabled: true
  className: "nginx"
  annotations:
    cert-manager.io/cluster-issuer: "letsencrypt-prod"
    nginx.ingress.kubernetes.io/ssl-redirect: "true"
  hosts:
    - host: mongodhara.yourdomain.com
      paths:
        - path: /mongodhara
          pathType: Prefix
          backend: frontend
        - path: /mongodharaapi
          pathType: Prefix
          backend: backend
  tls:
    - secretName: mongodhara-tls
      hosts:
        - mongodhara.yourdomain.com

Deploy with:

helm install mongodhara ./helm-chart -f production-values.yaml

3. Development Installation with Port Forwarding

# Install without ingress for local development
helm install mongodhara-dev ./helm-chart \
  --set ingress.enabled=false \
  --set backend.env[0].value="mongodb://docker.for.mac.localhost:27017/dev"

# Port forward to access services
kubectl port-forward svc/mongodhara-dev-frontend 8080:80 &
kubectl port-forward svc/mongodhara-dev-backend 8000:80 &

# Access at http://localhost:8080

Configuration Options

Global Settings

Backend Configuration

Frontend Configuration

Ingress Configuration

🐳 Build & Push Docker Images

Build and push images for backend and frontend:

# Backend
docker build -t your-registry.com/mongodhara/backend:1.0.0 ./backend
docker push your-registry.com/mongodhara/backend:1.0.0

# Frontend
docker build -t your-registry.com/mongodhara/frontend:1.0.0 ./frontend
docker push your-registry.com/mongodhara/frontend:1.0.0

Replace your-registry.com with your Docker registry URL.

🧑‍💻 Local Development

Prerequisites

• Python 3.9+
• Node.js 16+
• MongoDB server running locally

Setup Backend

cd backend
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload --host 0.0.0.0 --port 8000

Setup Frontend

cd frontend
npm install
npm run dev

Open your browser at http://localhost:5173 (or the port indicated).

📁 Project Structure

mongodhara/
├── backend/               # FastAPI backend source code
│   ├── main.py            # App entry point
│   ├── api/               # API endpoints and routes
│   ├── models/            # Pydantic models & schemas
│   └── db/                # MongoDB access & utilities
├── frontend/              # Svelte frontend source code
│   ├── src/               # Svelte components & pages
│   ├── static/            # Static assets (favicon, images)
│   └── vite.config.js     # Vite build config
├── helm-chart/            # Helm chart for Kubernetes deployment
│   ├── templates/         # K8s manifests templates
│   ├── values.yaml        # Default chart values
│   └── Chart.yaml         # Chart metadata
├── README.md              # This documentation
└── LICENSE                # License info

🔧 Environment Variables

📊 Monitoring and Scaling

• Configure resource limits and requests in Helm values
• Enable Horizontal Pod Autoscaler (HPA) for backend for CPU-based scaling
• Use Kubernetes native monitoring tools like Prometheus + Grafana
• Leverage logging (e.g., Fluentd, EFK stack) for production debugging

🛡️ Security

• Use TLS with Ingress for secure connections
• Configure authentication and authorization on the backend (future enhancement)
• Sanitize and validate all incoming requests
• Use network policies to restrict pod communication as needed

🤝 Contributing

Contributions, issues, and feature requests are welcome!

1. Fork the repository
2. Create your feature branch (git checkout -b feature/your-feature)
3. Commit your changes (git commit -m 'Add some feature')
4. Push to the branch (git push origin feature/your-feature)
5. Open a Pull Request

Please adhere to the coding style and write clear commit messages.

⚖️ Legal Notice

This project is not affiliated with, endorsed by, or sponsored by MongoDB, Inc.
MongoDB® is a registered trademark of MongoDB, Inc.
All product names, logos, and brands are property of their respective owners. Use of these names, trademarks, and brands does not imply endorsement.

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

Made with ❤️ by the mongoDhārā Team