Quick Answer
The 15 most common DIY Odoo fixes cover: Email issues (outgoing failures, incoming sync, accidental mass mail), Access problems (locked admin, missing menus, access denied), Performance bugs (slow system, website cache, PDF issues), Finance/Inventory (invoice cancellation, bank sync, zero stock), and "Nuclear" fixes (frozen database, wrong valuation, JavaScript errors). Clear browser cache solves 90% of JS errors. Always restart before calling support.
You Are the First Responder
Odoo is robust, but it relies on correct configuration. Most "bugs" aren't bugs—they're settings issues you can fix yourself.
By mastering these 15 fixes, you can resolve 80% of daily issues without spending a dime on support. Here's the cheat sheet every Odoo admin needs.
Email Issues
Outgoing Emails Not Sending
Symptom: Invoices, confirmations, and notifications are stuck in the queue.
The Fix:
Go to Settings → Technical → Emails → Emails. Filter by "State: Exception."
Click on a failed email and read the "Failure Reason" at the bottom.
99% of the time: wrong SMTP password, port blocked, or "Less Secure Apps" not enabled on your mail server.
Incoming Emails Not Syncing
Symptom: Customers reply to emails, but nothing shows up in Odoo.
The Fix:
Check your "Incoming Mail Server" in Settings → Technical → Incoming Mail Servers. Click "Test & Confirm" to see if the connection is live. IMAP/POP3 password changes are the usual culprit.
Too Many Emails Sent (Accidental Mass Mail)
Symptom: You accidentally started a mass mailing to 10,000 people.
The Fix:
Panic doesn't help. Speed does. Go to Settings → Technical → Emails. Filter by "State: Outgoing." Select All → Action → Delete. This stops any emails that haven't left the server yet.
Access & Users
Locked Out of the Admin Account
Symptom: You forgot the master admin password and cannot log in.
The Fix:
If you have server access (Odoo.sh or On-Premise): use the command line to reset it.
If on Odoo Online: use the "Reset Password" link on the login screen.
Pro Tip: Always have a "Backup Admin" user created for exactly this scenario.
User Can't See a Specific Menu/Module
Symptom: You installed "Inventory," but your warehouse manager can't see the app.
The Fix:
Go to Settings → Users → [The User]. Under "Access Rights," ensure the correct checkboxes are ticked.
Note: Some apps require "Extra Rights" at the bottom of the form.
"Document Access Denied" Error
Symptom: A user tries to open an invoice but gets a red "Access Denied" pop-up.
The Fix:
This is a Record Rule issue. Go to Settings → Technical → Record Rules. Search for the model (e.g., Account Move). Check if there is a rule restricting the user based on their Company or Branch.
Performance & "Bugs"
Odoo is Slow (The "Scheduled Actions" Clog)
Symptom: The system feels sluggish, especially in the mornings.
The Fix:
Check your Scheduled Actions. Go to Settings → Technical → Scheduled Actions. Look for tasks like "Database Vacuum" or "Image Indexing" running during business hours. Move them to 2:00 AM.
Changes to Website Not Showing Up
Symptom: You edited your homepage, but visitors still see the old version.
The Fix:
1. Click "Save" (Don't forget!)
2. Go to Settings → Dashboard and click "Activate Developer Mode"
3. Click the "Cloud" icon in the top right and select "Regenerate Assets". This clears the system-level cache.
Report Layout is Messy (PDF Issues)
Symptom: Your invoices look perfect on screen but have overlapping text on the PDF.
The Fix:
This is usually a wkhtmltopdf version issue or a DPI setting. Go to Settings → Technical → System Parameters. Search for web.report.url. Ensure it is set to http://127.0.0.1:8069 (or your specific port). If it's missing, add it.
Finance & Inventory
Cannot Cancel a Validated Invoice
Symptom: You made a mistake, but the "Cancel" button is missing.
The Fix:
Odoo (especially in v17+) protects validated invoices. First, check if "Allow Cancelling Entries" is ticked in your Journal settings.
If not: You must create a "Credit Note" instead. This is the legally correct way to "undo" an invoice.
Bank Sync Stopped Working
Symptom: Your bank feed hasn't updated in 3 days.
The Fix:
Don't wait. Go to Accounting → Configuration → Online Synchronizations. Click "Update" on the bank connection. 90% of the time: the bank just needs you to re-verify your 2FA on their portal.
"Zero Stock" but Item is on the Shelf
Symptom: You see the item, but Odoo says "0 On Hand."
The Fix:
Check for "Reserved" stock. Go to the Product Form → On Hand. Click the "Forecasted" link. You will likely see that the stock is "Reserved" for an old Sales Order that was never shipped or cancelled.
The "Nuclear" Fixes
System Frozen (The "Unresponsive" Database)
Symptom: No one can log in, and the screen is white.
The Fix:
If on Odoo.sh: Go to the "Builds" tab and click "Restart".
If On-Premise: Restart the Odoo service via terminal: sudo service odoo-server restart
Rule: Always try a restart before calling support.
Inventory Valuation is Wrong
Symptom: Stock Value is $0 but you have 10 units.
The Fix:
You likely changed the "Costing Method" (e.g., from Standard to AVCO) after stock was moved.
Solution: Zero out stock → Change Costing Method → Re-import stock.
"JavaScript Error" Pop-ups
Symptom: Random pop-ups when clicking buttons.
The Fix:
Clear your browser cache! 90% of JS errors in Odoo are due to an old cached version of the interface conflicting with a new update.
Frequently Asked Questions
How do I activate Developer Mode?
Go to Settings → General Settings. Scroll to the bottom and click "Activate the developer mode". Or, install the "Odoo Debug" browser extension for a one-click toggle.
Can I undo a "Delete" action?
No. If you delete a record in Odoo, it is gone forever (unless you have a database backup). This is why you should always Archive instead of Delete.
Where do I see the real error logs?
If you are on Odoo.sh: Go to the Logs tab in your project dashboard. If On-Premise: Check /var/log/odoo/odoo-server.log. The browser pop-up only shows a simplified error; the logs show the truth.
Remember: Odoo is robust, but it relies on correct configuration. Most "bugs" aren't bugs—they're settings issues you can fix yourself.
Stuck on a Problem That Isn't on This List?
If the DIY approach fails, you need a specialist. We find the bugs you can't.
Expert Odoo Health Check
We'll diagnose complex issues, review your configuration, identify hidden problems, and provide actionable fixes—so you can get back to business.
We find the bugs you can't.