Troubleshooting
Resolve common issues and problems with your RepoCloud applications
Troubleshooting Guide
Even with RepoCloud’s streamlined deployment and management experience, you may occasionally encounter issues with your applications. This guide will help you diagnose and resolve common problems.
General Troubleshooting Process
When facing any issue with your RepoCloud application, follow this general process:
Check Application Status
Verify if your application is showing as “Running” in the dashboard
Review Logs
Check application logs for error messages or warnings
Monitor Resources
Ensure your application has sufficient resources (CPU, RAM, storage)
Verify Configuration
Check that environment variables and settings are properly configured
Restart Application
Try restarting the application to resolve temporary issues
Contact Support
If the issue persists, contact RepoCloud support at team@repocloud.io
Common Issues and Solutions
Application Access Issues
Deployment Issues
Database Issues
Update and Scaling Issues
Custom Domain Issues
Accessing and Understanding Logs
Logs are a crucial tool for troubleshooting. RepoCloud provides access to application logs through the dashboard:
Navigate to Instance Management
Go to your application’s management page
Access Logs Tab
Click on the “Logs” tab
View Application Logs
Browse the logs for error messages, warnings, or other relevant information
Filter Logs (Optional)
Use the search and filter options to find specific information in the logs
Look for error messages that include terms like “Error”, “Exception”, “Failed”, or “Fatal” in the logs. These often provide valuable clues about what’s going wrong.
Contact Support
If you’ve tried the troubleshooting steps and still can’t resolve your issue, don’t hesitate to contact RepoCloud support:
- Email: team@repocloud.io
- Contact Form: https://repocloud.io/contact
When contacting support, please include:
- Your account information
- The application name and URL
- A detailed description of the issue
- Steps you’ve taken to troubleshoot
- Any relevant error messages or screenshots
- When the issue started occurring
Platform Status
Check the RepoCloud status page to see if there are any ongoing platform issues or maintenance that might be affecting your applications:
Application-Specific Troubleshooting
Different applications have their own common issues and troubleshooting approaches. Here are some application-specific resources:
WordPress Troubleshooting
MySQL Troubleshooting
Node.js Troubleshooting
Nginx Troubleshooting
Preventative Measures
Prevent issues before they happen with these best practices:
- Regular Backups: Ensure you have recent backups of critical data
- Monitoring: Regularly check your application’s health and performance
- Updates: Keep your application updated with the latest version
- Resource Planning: Monitor usage and scale before you hit resource limits
- Documentation: Maintain documentation about your application’s configuration and customizations