Skip to content
Sébastien Andreatta edited this page Apr 27, 2026 · 2 revisions

odev shell

shell demo

Run the odoo-bin process in shell mode for the selected database locally.

Usage

odev shell [-v {CRITICAL,ERROR,WARNING,INFO,DEBUG,DEBUG_SQL,NOTSET}] [-h] [-f] [-c] [-V VERSION] [--venv VENV] [-w WORKTREE] [--no-pretty] [--script SCRIPT] database [addons]

Aliases

No aliases

Arguments

Positional Arguments:

Argument Description
database The database to target.
addons Comma-separated list of additional addon paths. The standard Odoo addons paths are automatically added to the odoo-bin command (including enterprise if any enterprise module is installed). If this command is run from within an Odoo addons directory and no additional addons are specified, the current directory will be added to the list of addons.

Optional Arguments:

Argument Description
-v, --log-level Set logging verbosity for the execution of odev.
-h, --help Show help for the current command.
-f, --force Bypass confirmation prompts and assume a default value to all, use with caution!
-c, --community Force running the database without enterprise addons.
-V, --version The Odoo version to use for running the database. If not specified, defaults to the latest version of the base module installed in the database.
--venv Name of the Python virtual environment to use when running this database. If not specified, defaults to the common virtual environment for the current Odoo version.
-w, --worktree Name of the worktree to use when running this database. If not specified, defaults to the common worktree for the current Odoo version.
--no-pretty Do not pretty print the output of odoo-bin but rather display logs as output by the subprocess.
--script Run a script inside of odoo-bin shell and exit. Can be a path to a file containing python code or a string representing python code to be executed inside the shell environment.

Examples

Show help

odev shell --help

Open an interactive Odoo shell (Interactive shell)

odev shell demo_19

Run a python string and exit

odev shell demo_19 --script "print(env['res.users'].search([]).mapped('name'))"

Run a python file and exit

odev shell demo_19 --script ./my_script.py

Clone this wiki locally