Troubleshooting · SmartERP Documentation

Symptoms, what causes them and how to fix them, for installing, publishing and automation.

Installing#

Symptom	Cause	Fix
`Since 17.0, the "attrs" and "states" attributes are no longer used.` during install	`social_media_integration`'s views are Odoo 16.	Run `deploy/migrate_base_to_17.py` on it. The install scripts do this for you. See Choose a module.
`ModuleNotFoundError: aiogram` (or `bs4`, `dateutil`)	The base module imports packages it does not declare.	`pip3 install aiogram beautifulsoup4 requests python-dateutil`.
The AI Workforce does not appear in Apps	It depends on the base module, which failed or is missing.	Fix the base module first. Neither appears until it installs.
The installer says it cannot find `social_media_integration`	It looks in `--base-module`, next to the checkout, then in your `addons_path`.	Pass `--base-module /path/to/social_media_integration`.
`unrecognized parameters: 'shell'`	`shell` is a subcommand and must come first.	`odoo-bin shell -c odoo.conf -d <db> --no-http < script.py`.
The installer refuses: not `17.0.x`	The database is not Odoo 17.	Use Route A (Docker) instead.
The page at port 8291 does not load from another machine	`localhost` means the machine the browser runs on.	Use `http://<server-ip>:8291` and open the port in the firewall.
Two people started an update at once	Two processes migrating one database corrupt it.	Stop Odoo before running the installer. Restore from backup if in doubt.

Publishing#

Symptom	Cause	Fix
"This post has not been approved…"	No approval and no agent.	Submit for approval, or ask a Manager to publish.
"Agent 'X' is not active"	The agent is Paused or Not Deployed.	Activate it.
"…runs at '…' autonomy, so a human must approve…"	The agent's autonomy is below Semi-Autonomous.	Submit for approval.
"…requires human approval for posts containing media."	The post has an attachment.	Submit for approval.
"…has reached its daily limit…"	The daily cap is used up.	Wait, raise the cap, or have a Manager publish.
"Set a Scheduled Date…"	Submitting or scheduling without a date.	Set one.
"The scheduled date must be in the future."	The date has passed.	Choose a later time.
"Only a Social Media Manager can …"	A User pressed a Manager button.	Ask a Manager.
A post is Failed with `No live API integration is configured for platform …`	Test Mode is off with no integration (Social Marketing).	Turn Test Mode on, or implement `_api_publish`. See Publishing.
A post never publishes	Not Scheduled, or the date is in the future, or the scheduled action is off.	Check the state, the date and the scheduled action.
A post publishes twice	The scheduled action and n8n both publish.	Deactivate one.
Nothing happens on the schedule	Odoo has no cron workers.	Check `--max-cron-threads` and that the cron worker runs.

Automation#

Symptom	Cause	Fix
Webhook returns `401`	Wrong key, or no key set in Odoo.	Set the key and send it as `X-Api-Key`. See Webhook API.
"AI content generation is not configured…" / "Configure the n8n AI webhook URL and shared API key first…"	The URL or key is missing.	Set both. See System parameters.
"Could not reach the AI workflow"	Wrong URL, workflow inactive, n8n unreachable.	Check the URL, activate the workflow, test connectivity from the Odoo server.
AI status stuck on Requested	The callback cannot reach Odoo.	Set `web.base.url` to your public address; check the key matches.
The prompt contains `undefined`	The workflow reads fields the AI Workforce does not send.	See AI content workflow.
n8n reports success but the post is unchanged	The callback went to a different database or URL.	Check `ODOO_BASE_URL`.

Documentation site#

Symptom	Cause	Fix
`/docs` shows a 404	The `smarterp_docs` module is not installed, or the database is not selected.	Install it. On a multi-database server, set `dbfilter`. See Publish on doc.smarterp.et.
A page you edited in a file did not change	It was edited in Odoo, so it is detached from the file.	Use Reset to File Version on the page.
A new page does not appear	The module was not updated.	Update the module, or use Documentation → Sync from Files.
Links on the domain root go to `/docs/...`	`smarterp_docs.base_path` is still `/docs`.	Set it to `/`.
A page shows English in the Amharic site	It has no Amharic version yet.	Add it. See Translating.
The CSS or JavaScript did not update	The server caches those files.	Restart Odoo.

Still stuck#

Collect the server log lines around the failure, the module versions, and the exact text of any message, and send them to your administrator. Messages in this documentation are quoted exactly as SmartERP shows them, so you can search for them.