Imported from shipshitdev/skills (
skills/mongodb-atlas-checker/SKILL.md). Install upstream withnpx skills add shipshitdev/skills --skill mongodb-atlas-checker. Copyright stays with the author.
MongoDB Atlas Checker
When to Use
- Verifying MongoDB Atlas backend setup
- Checking connection string configuration
- Validating environment variable setup
- Troubleshooting database connection issues
- Auditing database setup before deployment
Quick Checklist
1. Environment Variables
-
MONGODB_URIexists (not hardcoded) - Uses
mongodb+srv://protocol (required for Atlas) - Includes database name
- Includes
retryWrites=true&w=majority - No credentials in
.env.example
2. Connection String Format
mongodb+srv://USERNAME:PASSWORD@CLUSTER-HOST/DATABASE?retryWrites=true&w=majority
3. Driver Installation
-
mongooseormongodbpackage installed - In dependencies (not devDependencies)
4. Connection Setup
- Singleton pattern (Next.js)
-
MongooseModule.forRoot()(NestJS) - Error handling implemented
5. Atlas Configuration
- IP whitelist configured
- Database user exists with permissions
- SSL/TLS enabled (default with
mongodb+srv://)
Common Issues
| Issue | Solution |
|---|---|
Missing MONGODB_URI |
Add to .env.local or .env |
| Wrong protocol | Use mongodb+srv:// not mongodb:// |
| Multiple connections (Next.js) | Use singleton pattern |
| Connection timeout | Check IP whitelist in Atlas |
| Auth failed | Verify credentials, URL-encode special chars |
Recommended Connection Options
{
retryWrites: true,
w: 'majority',
maxPoolSize: 10,
serverSelectionTimeoutMS: 5000,
bufferCommands: false,
}
For detailed setup patterns, verification scripts, and complete examples: references/full-guide.md