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.

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

Using Specific Versions

For production use, it's recommended to use specific version tags instead of main:

docker pull ghcr.io/aientech/mongoman:0.1.1

Available tags:

• latest - Latest stable release
• main - Latest development build
• 0.1.1, v0.1.1 - Specific version tags
• 0.1 - Latest patch version in the 0.1.x series

See GitHub Releases for all available versions.

Releases

MongoMan uses semantic versioning for releases. Each release includes:

• Versioned Docker images on GitHub Container Registry
• Automated changelog
• Installation instructions

For maintainers: See RELEASE.md for the release process and how to create new releases.

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 against next branch

License

MIT

Acknowledgements

• shadcn/ui for the beautiful UI components
• Next.js for the amazing framework
• MongoDB for the database platform

Authors

• @aientech

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:

• Mongo Express
• MongoDB Compass