Quick Answer
The Odoo Mobile App provides full ERP access on iOS/Android with barcode scanning, field signatures, and push notifications. Common issues: white screen (clear asset cache), no push notifications (configure WebSocket/longpolling), camera not working (requires HTTPS + permissions).
Introduction: Your ERP, Now Pocket-Sized
An ERP that chains you to a desk is obsolete. Whether your sales team is visiting a client, your warehouse manager is scanning a pallet, or your CEO is approving an expense report at the airport, mobile access is non-negotiable.
The Odoo Mobile App (available on iOS and Android) is not a "lite" version; it is the full power of Odoo, optimized for touch.
However, "It just works" is not always true. From white screens to missing push notifications, setting up the mobile experience requires specific configurations. This guide covers what you can do with the app and how to troubleshoot the most common setup issues.
Key Features: What Can You Do on Mobile?
The Odoo app wraps the web interface in a native container, giving you access to all your installed apps.
1. Mobile Barcode Scanning (Inventory)
The Feature
Turn your phone's camera into a barcode scanner
The Use Case
Process receipts, picking, and inventory without $500 Zebra scanners
How to Enable
Inventory → Settings → Check "Barcode Scanner"
2. Field Service & Signatures
✓ The Feature: Technicians can clock in at a client site, take a photo of the repair, and get the customer to sign on the screen glass.
✓ The Sync: The signature updates the "Task" and triggers the invoice instantly.
3. Push Notifications
✓ The Feature: Get alerted instantly for "New Leads," "Approval Requests," or "Chat Mentions."
✓ The Benefit: Reduces email clutter and speeds up decision-making.
Common Setup Issue #1: The "White Screen of Death"
⚠️ Symptom: You open the app, log in, and see a blank white screen.
This is the #1 complaint. It usually happens after installing a custom module.
The Fix:
| Method | Steps |
|---|---|
| Clear Assets | The app caches JavaScript assets. If a custom module breaks the JS, the app freezes. |
| Server Action | Enable Developer Mode → Settings → Technical → Automation → Scheduled Actions → Run "Regenerate Assets Bundles" |
| Database Command | If you have database access, delete cached assets manually (see below) |
DELETE FROM ir_attachment WHERE url LIKE '/web/content/%';Common Setup Issue #2: Push Notifications Not Working
⚠️ Symptom: You get mentions in the browser, but your phone is silent.
Push notifications rely on a connection to Odoo's "Longpolling" or "WebSocket" bus.
The Fix:
| Check | Action Required |
|---|---|
| Proxy Config | If self-hosted, you must forward WebSocket traffic through Nginx/Apache |
| Nginx Rule | Ensure /websocket (Odoo 16+) or /longpolling (Odoo 15-) redirects to port 8072 |
| Odoo Settings | Settings → General Settings → Discuss → Enable "Push Notifications" |
| Firewall | Allow outgoing connections to fcm.googleapis.com (Firebase for Android) |
location /websocket {
proxy_pass http://127.0.0.1:8072;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}location /longpolling {
proxy_pass http://127.0.0.1:8072;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
}Common Setup Issue #3: Camera Scanner Not Triggering
⚠️ Symptom: You click the barcode icon, but the camera doesn't open.
The Fix:
✓ Check Permissions: Go to your phone's Settings → Apps → Odoo and ensure "Camera" permission is Allowed.
✓ HTTPS is Mandatory: Modern browsers and apps block camera access on insecure (HTTP) connections. You must have a valid SSL certificate (HTTPS) on your Odoo server for the camera to work.
💡 Pro Tip: Use Let's Encrypt for free SSL certificates. Many hosting providers offer one-click SSL setup.
Mobile Setup Checklist
| Requirement | Why It Matters | ✓ |
|---|---|---|
| Valid HTTPS/SSL | Camera access blocked without it | ☐ |
| WebSocket/Longpolling configured | Push notifications won't work | ☐ |
| Port 8072 open | Required for real-time messaging | ☐ |
| Firebase whitelisted | Android push delivery | ☐ |
| Odoo Enterprise license | Official app requires Enterprise | ☐ |
Frequently Asked Questions
Is the Odoo Mobile App free?
Yes. The official "Odoo" app on the App Store and Play Store is free to download. However, it requires an Odoo Enterprise license to work seamlessly. Odoo Community users often need third-party apps or must use the mobile browser.
Can I brand the mobile app with my logo?
Not the official app. To have your own "Company App" in the App Store, you need the Odoo Mobile App Builder (a paid customization service) or a third-party white-label solution.
Does the app work offline?
Sort of. The Barcode and Point of Sale apps have offline modes. However, most other apps (CRM, Accounting) require an active internet connection to load data.
Why does the mobile app show old data?
The app caches data aggressively for performance. Pull down to refresh on any list view, or log out and back in to force a full cache clear.
What Odoo version supports WebSocket instead of Longpolling?
Odoo 16 and later use WebSocket at /websocket. Odoo 15 and earlier use Longpolling at /longpolling. Configure your Nginx accordingly.
Conclusion: Mobility is a Configuration, Not a Given
The Odoo Mobile App changes the game for field teams, but it requires a secure (HTTPS) and properly configured (WebSockets) server environment.
Is Your Mobile App Acting Up?
Don't let your field team go dark. Let Braincuber's DevOps experts configure your server for mobile success.
Schedule a Mobile Server Configuration Review
Get your Nginx, SSL, and WebSocket configuration reviewed by experts. We'll ensure your mobile app works flawlessly from anywhere.
Work from anywhere • Secure setup • Full mobile access