Troubleshoot¶
auth error, although the credentials look right¶
Most commands need an API key, not your login password. Odoo rejects a
password over XML-RPC without saying why (especially with 2FA enabled).
Create an API key and put it in api-key ([op_secrets]) or
ODOO_PASSWORD. See Secrets.
clock in fails with "authentication failed"¶
clock in and clock out (without --at) log in like the browser, and that
login rejects API keys. Set your real login password as password in
[op_secrets] or ODOO_WEB_PASSWORD.
"2FA is enabled but no TOTP secret configured"¶
Set totp_secret in [op_secrets] or ODOO_TOTP_SECRET: the base32 secret,
or the whole otpauth:// URL, that Odoo showed when you enabled 2FA.
"TOTP verification failed"¶
The secret is wrong, or your computer's clock is off. TOTP codes depend on the time.
"You are not allowed to create/modify 'Attendance'"¶
clock in --at, clock out --at, clock edit and clock add need the
Attendance Officer right. See
Clock in and out → Permissions. Plain
clock in and clock out are not affected.
secrets_locked after 5 seconds¶
1Password is locked or not reachable, so the op:// references in
[op_secrets] could not be resolved. Unlock 1Password and retry. Set
ODOO_OP_TIMEOUT=10s for a longer wait, or provide the credentials as
environment variables; then op is not called for them.
1Password asks too often? See 1Password prompts.
op inject errors at startup¶
The config has [op_secrets], the 1Password CLI is installed but not signed
in. Run op signin, or set the credentials as environment variables, or set
ODOO_WORK_CLI_NO_OP=1.
clock in fails against a server with several databases¶
A known limitation: the web session is not reliably bound to the requested
database on multi-database servers
(#48). clock status
and all other commands work.
The TUI does not show an entry I booked on another company¶
It does: the TUI grid ignores [models.timesheet] filters and shows all of
your bookings. The entries and timesheets commands apply those filters;
check them with odoo-work-cli config --merged.
The TUI says "terminal too narrow"¶
The weekly grid needs at least 68 columns. Widen the terminal window or reduce
the font size. On narrower terminals the TUI squeezes the project/task
column and shortens long names in the middle ([EXA] …pha: Design); open the
cell with Enter to see the full name.
Still stuck¶
Run the command with --json and look at kind; the table in
Errors and exit codes says what each kind means.
Report bugs (internal) on
GitHub.