MonRed is a self-hosted platform that allows you to deploy and manage MongoDB and Redis instances with ease. It provides a simple web interface to create, monitor, and manage your database containers.
- 🚀 Quick Deployment: Deploy MongoDB and Redis instances in seconds
- 🔒 Secure by Default: Automatic security configuration for all databases
- 📊 Real-time Monitoring: Monitor resource usage and performance metrics
- 📝 Live Logs: View real-time container logs
- 🔄 Container Management: Start, stop, restart, and delete containers
- 👥 User Management: Transfer containers between users
- 🔐 Authentication: JWT-based authentication system
- Node.js (v18 or higher)
- Docker
- MongoDB (for MonRed's own database)
- Clone the repository:
git clone https://github.com/yourusername/monred.git
cd monred- Install dependencies for both backend and frontend:
# Install backend dependencies
cd backend
npm install
# Install frontend dependencies
cd ../frontend
npm install- Configure environment variables:
Create a .env file in the backend directory:
PORT=4000
MONGODB_URI=mongodb://localhost:27017/monred
JWT_SECRET=your_jwt_secret_here- Start the development servers:
# Start backend server (from backend directory)
npm run dev
# Start frontend server (from frontend directory)
npm run devThe application will be available at:
- Frontend: http://localhost:3000
- Backend: http://localhost:4000
- Build the frontend:
cd frontend
npm run build-
Set up a production MongoDB instance
-
Configure environment variables for production
-
Use a process manager like PM2:
npm install -g pm2
pm2 start backend/src/index.js --name monred-backend- Set up a reverse proxy (nginx recommended) to serve the frontend build and proxy API requests
The API provides the following main endpoints:
POST /api/auth/register- Register new userPOST /api/auth/login- User loginGET /api/containers- List user's containersPOST /api/containers- Create new containerDELETE /api/containers/:id- Delete containerPOST /api/containers/:id/action- Container actions (start/stop/restart)GET /api/containers/:id/logs- Get container logsPOST /api/containers/:id/transfer- Transfer container to another user
- All database containers are created with random strong passwords
- Each container runs in its own isolated network
- JWT tokens are used for API authentication
- Container resources are limited to prevent abuse
- All sensitive data is encrypted
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details
If you encounter any problems or have suggestions, please open an issue in the GitHub repository.
- Your Name - Initial work - YourGitHub