Troubleshooting

Find solutions to common issues when using OEC.sh. Each guide includes symptoms, causes, and step-by-step solutions.

Quick Links

Before You Start

Essential Troubleshooting Steps

1. Check Environment Status - Is the environment running, stopped, or in error state?
2. View Logs - Check Odoo logs, PostgreSQL logs, and deployment logs
3. Check Resources - Is the server running low on CPU, RAM, or disk space?
4. Review Recent Changes - Did a recent deployment or configuration change cause the issue?

Common Issues by Category

Deployment Issues

• Build fails during deployment
• Container won't start
• Git clone or pull errors
• Module installation failures

Database Issues

• Connection refused errors
• Database locked or slow
• Migration or upgrade failures
• Corrupted database recovery

Backup & Restore Issues

• Backup creation fails
• Restore fails or incomplete
• Storage provider connection issues
• Large backup handling

Domain & SSL Issues

• SSL certificate errors
• Domain not resolving
• Mixed content warnings
• Custom domain configuration

Error Code Reference

See our Common Errors page for a complete list of error codes and their solutions.

Still Need Help?

If you can't find a solution here:

1. Search the Documentation - Use the search bar at the top
2. Check Server Metrics - Go to Server → Metrics for resource usage
3. Contact Support - Email support@oec.sh with:
   • Environment ID
   • Error message or screenshot
   • Steps to reproduce the issue
   • Recent changes made