Troubleshooting Guide

Solutions for common CloudMapper issues and problems

Get Help on GitHub

For all technical support, troubleshooting, and questions, please use our GitHub repository where the community and maintainers can help you.

Ask Questions Report Issues

Quick Solutions

Installation Problems

CloudFormation deployment issues, AMI not found, instance fails to start.

Get Installation Help

Access Issues

Cannot access web interface, login failures, SSL certificate errors.

Get Access Help

Scanning Problems

Scan failures, missing resources, slow performance, permissions issues.

Get Scanning Help

Common Diagnostic Commands

Check System Status

# Service status
sudo systemctl status cloudmapper
sudo systemctl status nginx

# Resource usage
free -h
df -h

Check AWS Connectivity

# AWS credentials
aws sts get-caller-identity

# Test permissions
aws ec2 describe-regions

GitHub Support Resources

GitHub Discussions

Get help from the CloudMapper community:

Ask questions and get answers
Share troubleshooting experiences
Learn from other users' solutions
Get help with configuration

Join Discussions

GitHub Issues

Report bugs and technical issues:

Report installation problems
Submit bug reports with logs
Request new features
Track issue resolution

Create Issue

Best Practices for Getting Help

Search first: Check existing discussions and issues before creating new ones
Provide details: Include error messages, logs, and your configuration
Use templates: Follow our issue templates for faster resolution
Be specific: Describe what you expected vs. what actually happened

View Repository

Emergency Recovery Procedures

Service Recovery:

# Stop services
sudo systemctl stop cloudmapper nginx

# Clear cache and temp files
sudo rm -rf /opt/cloudmapper/cache/*
sudo rm -rf /tmp/cloudmapper-*

# Restart services
sudo systemctl start nginx cloudmapper
sudo systemctl status cloudmapper

Data Backup:

# Create EBS snapshot
aws ec2 create-snapshot \
  --volume-id vol-1234567890abcdef0 \
  --description "CloudMapper backup"

# Manual data backup
sudo tar -czf /tmp/cloudmapper-backup.tar.gz \
  /opt/cloudmapper/config \
  /opt/cloudmapper/data

Critical Issues: For severe problems, consider launching a new CloudMapper instance and migrating your configuration. Ask for help on GitHub before attempting recovery procedures.

Documentation

AWS Marketplace

Quick Help