Instance Troubleshooting
Advanced troubleshooting guide for resolving Odoo instance issues.
Instance Won't Start
Symptoms
- Instance shows "Stopped" and won't change to "Running"
- Start button doesn't work or times out
- Instance stuck in "Provisioning" state
Troubleshooting Steps
- Wait 2-3 minutes: Starting can take time, especially after updates
- Check your subscription: Ensure it's active and not suspended
- Try restarting instead of start (if available)
- Check resource limits: You may have hit plan limits
- Contact support if stuck for more than 10 minutes
Subscription Issue? If your subscription is past due, instances may not start. Check My Subscriptions for payment status.
Instance Crashes or Restarts Unexpectedly
Common Causes
| Cause | Signs | Solution |
|---|---|---|
| Out of Memory (OOM) | RAM usage near 100% before crash | Upgrade plan or optimize memory usage |
| Runaway Process | CPU spikes to 100% | Identify and fix problematic code/cron |
| Bad Scheduled Action | Crashes at same time daily | Disable or fix the scheduled action |
| Database Issues | Errors mentioning PostgreSQL | Contact support for database repair |
How to Identify the Cause
- Check Resource History: Look for spikes before crash
- Review Timing: Does it happen at specific times?
- Recent Changes: Did you install new modules or make changes?
- Check Scheduled Actions: In Odoo, go to Settings > Technical > Scheduled Actions
Database Connection Errors
Error Messages
- "Database connection failed"
- "FATAL: too many connections"
- "Server closed the connection unexpectedly"
Solutions
- Restart Instance: Clears stale connections
- Wait and Retry: Temporary network issues resolve themselves
- Check Concurrent Users: You may have exceeded user limits
- Reduce Long-Running Reports: Heavy reports hold connections
Recovery from Errors
Instance in Error State
- Note any error messages displayed
- Try Restart from your portal
- If restart fails, try Stop then Start
- Check recent backups are available
- Contact support with error details
Restoring from Backup
If your instance is corrupted or has bad data:
- Go to My Instances > [Instance] > Backups
- Select a backup from before the issue
- Click Restore
- Confirm the restore action
Warning: Restoring a backup will overwrite all current data. Make sure to create a new backup first if you want to preserve current state.
Performance Optimization Tips
Reduce Memory Usage
- Limit list view records (Settings > Users > Preferences)
- Disable unused modules
- Archive old records instead of deleting
- Optimize scheduled actions frequency
Reduce CPU Usage
- Avoid running heavy reports during business hours
- Optimize custom code and queries
- Spread scheduled actions throughout the day
- Use asynchronous processing for bulk operations
Reduce Storage Usage
- Compress images before uploading
- Clean up old attachments and logs
- Archive old accounting entries
- Delete test databases if any
When to Contact Support
Create a support ticket if:
- Instance won't start after 10+ minutes
- You see database corruption errors
- Repeated crashes with no clear cause
- You need help interpreting error logs
- Backup restoration fails