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:

1

Check Application Status

Verify if your application is showing as “Running” in the dashboard

2

Review Logs

Check application logs for error messages or warnings

3

Monitor Resources

Ensure your application has sufficient resources (CPU, RAM, storage)

4

Verify Configuration

Check that environment variables and settings are properly configured

5

Restart Application

Try restarting the application to resolve temporary issues

6

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:

1

Navigate to Instance Management

Go to your application’s management page

2

Access Logs Tab

Click on the “Logs” tab

3

View Application Logs

Browse the logs for error messages, warnings, or other relevant information

4

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:

When contacting support, please include:

  1. Your account information
  2. The application name and URL
  3. A detailed description of the issue
  4. Steps you’ve taken to troubleshoot
  5. Any relevant error messages or screenshots
  6. 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:

https://status.repocloud.io

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:

  1. Regular Backups: Ensure you have recent backups of critical data
  2. Monitoring: Regularly check your application’s health and performance
  3. Updates: Keep your application updated with the latest version
  4. Resource Planning: Monitor usage and scale before you hit resource limits
  5. Documentation: Maintain documentation about your application’s configuration and customizations