Skip to content

MongoMan is a MongoDB admin interface that combines modern web technologies with powerful database management features. It offers a way to manage MongoDB databases, collections, and documents through a clean interface. Perfect for developers who want a lightweight, Docker-ready alternative to mongo-express or mongo-compass

Notifications You must be signed in to change notification settings

AienTech/mongoman

Repository files navigation

MongoMan

A modern, web-based MongoDB admin interface built with Next.js, shadcn/ui, and Tailwind CSS. MongoMan provides an intuitive way to manage your MongoDB databases, collections, and documents with a clean and responsive UI.

⚠️ Note: This project is currently under active development. Some features may be missing or partially implemented. Bug reports, feature requests, and contributions are warmly welcomed! Please feel free to open issues or submit pull requests.

🤖 AI-Powered Development: The initial version of MongoMan is primarily developed through conversations with Anthropic's Claude AI (3.5 Sonnet), with minimal manual coding from my side, just quick code reviews and partial improvements. I am now actively maintaining and improving the codebase myself as the project scope has grown.

Features

  • 🎨 Modern UI
  • 📊 Database statistics and monitoring
  • 📝 Collection management
  • 📄 Document management

Environment Variables

To run this project, you will need to add the following environment variable:

MONGODB_URI - Your MongoDB connection string (e.g., mongodb://localhost:27017)

Run Locally

Clone the project

git clone git@github.com:AienTech/mongoman.git

Go to the project directory

cd mongoman

Install dependencies

yarn install

Set up your environment variables

cp .env.example .env.local

Then edit .env.local with your MongoDB connection string.

Start the development server

yarn dev

Docker Installation

Run with docker-compose:

version: '3'
services:
  mongoman:
    image: ghcr.io/aientech/mongoman:main
    environment:
      - MONGODB_URI=mongodb://mongo:27017
    ports:
      - '3000:3000'

Or run directly with Docker:

docker run -p 3000:3000 -e MONGODB_URI=mongodb://mongo:27017 ghcr.io/aientech/mongoman:main

Building from Source

Build the Docker image:

docker build --build-arg MONGODB_URI=mongodb://temporary:27017 -t mongoman .

Tech Stack

  • Next.js 15
  • React
  • TypeScript
  • shadcn/ui
  • Tailwind CSS
  • TanStack Table
  • MongoDB Node.js Driver

Contributing

Contributions are always welcome! Here's how you can help:

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

License

MIT

Acknowledgements

Authors

Support

For support, please open an issue in the GitHub repository or contact the maintainers.

Roadmap

  • Add authentication and authorization
  • Support for MongoDB Atlas integration
  • Advanced query builder
  • Database backup and restore functionality
  • Collection and document import/export
  • Aggregation pipeline builder
  • Light/dark mode support

Screenshots

Coming soon...

Related

Here are some related projects:

About

MongoMan is a MongoDB admin interface that combines modern web technologies with powerful database management features. It offers a way to manage MongoDB databases, collections, and documents through a clean interface. Perfect for developers who want a lightweight, Docker-ready alternative to mongo-express or mongo-compass

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Languages