Commit Graph

26 Commits

Author SHA1 Message Date
Alvaro Fuentes
59405f073f [IMP] developer/reference/cli: add --skip-auto-install
Document new cli option.

X-original-commit: b54e3ef498
2025-12-10 09:24:40 +00:00
Sylvain Francis
c0e1d73b7c [IMP] reference/cli: db-filter for Web UI
The odoo-bin help for the db-filter says:
`Regular expressions for filtering available databases for Web UI.`

However, the current documentation does not mention that the filters
only affect the Web UI, and not the cron workers.

closes odoo/documentation#15380

X-original-commit: fbc787474f
Signed-off-by: Sylvain Francis (syf) <syf+odoo@odoo.com>
2025-11-21 06:32:56 +00:00
Paolo Gatti
912b07fe25 [IMP] developer: new CLI commands and improvements
Added the new `i18n` and `module` commands.
Added the existing `deploy`, `obfuscate`, `upgrade_code` commands.
Reviewed titles to make the commands stand out in the ToC.
Removed the no longer present `tsconfig` command.

task-4866527

closes odoo/documentation#14368

Signed-off-by: Victor Feyens (vfe) <vfe@odoo.com>
2025-09-13 00:54:45 +00:00
Julien Castiaux
c65b0d769f [IMP] developer/reference/cli: --dev=access
closes odoo/documentation#14294

Related: odoo/odoo#222807
Signed-off-by: Julien Castiaux (juc) <juc@odoo.com>
2025-08-25 15:43:07 +00:00
Julien Castiaux
7b237096b0 [FIX] developer/reference/cli: --dev=all is a lie
--dev=all actually means --dev=xml,qweb,reload

Part-of: odoo/documentation#14294
Related: odoo/odoo#222807
Signed-off-by: Julien Castiaux (juc) <juc@odoo.com>
2025-08-25 15:43:07 +00:00
Julien Castiaux
884313c1bc [FIX] developer/reference/cli: --dev=pdb was removed
Does nothing since odoo/odoo#78857 and was removed in odoo/odoo#115076
both in 16.0.

Part-of: odoo/documentation#14294
Related: odoo/odoo#222807
Signed-off-by: Julien Castiaux (juc) <juc@odoo.com>
2025-08-25 15:43:07 +00:00
Julien Castiaux
18e8581d58 [FIX] developer/reference/cli: --dev=replica
Introduced by odoo/odoo#195280 in saas-18.1

Part-of: odoo/documentation#14294
Related: odoo/odoo#222807
Signed-off-by: Julien Castiaux (juc) <juc@odoo.com>
2025-08-25 15:43:07 +00:00
Julien Castiaux
ec7913246b [FIX] developer/reference/cli: --db_replica_host
Introduced by odoo/odoo#112000 in 17.0

Part-of: odoo/documentation#14294
Related: odoo/odoo#222807
Signed-off-by: Julien Castiaux (juc) <juc@odoo.com>
2025-08-25 15:43:07 +00:00
Chong Wang (cwg)
bde3b8fa3e [IMP] core: support reinit modules
closes odoo/documentation#13222

Related: odoo/odoo#206408
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2025-06-25 11:46:23 +00:00
Alvaro Fuentes
7febd70de5 [IMP] developer/reference/cli: improve docs of --upgrade-path
Be explicit about what we expect as parameter.

closes odoo/documentation#12751

X-original-commit: 246a2122e1
Related: odoo/odoo#204388
Signed-off-by: Alvaro Fuentes Suarez (afu) <afu@odoo.com>
2025-04-02 14:26:28 +00:00
Alvaro Fuentes
3e4ee4ed58 [IMP] developer/reference/cli: --pre-upgrade-scripts
Document the new cli option.

X-original-commit: 2844e193d4
Part-of: odoo/documentation#12751
Related: odoo/odoo#204388
Signed-off-by: Alvaro Fuentes Suarez (afu) <afu@odoo.com>
2025-04-02 14:26:28 +00:00
Julien Castiaux
d4e13fc634 [IMP] developer,*: Demo data no longer loaded by default
Community: https://github.com/odoo/odoo/pull/194585

task-4317765

closes odoo/documentation#12680

Signed-off-by: Julien Castiaux (juc) <juc@odoo.com>
2025-03-31 14:04:58 +00:00
Odoo's Mergebot
d51324d503 [FW][IMP] developer/reference/cli: neutralize option
closes odoo/documentation#12267

Forward-port-of: odoo/documentation#11478
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Co-authored-by: Chris Smith <cgsmith105@gmail.com>
Co-authored-by: Chris Smith <chris@cgsmith.net>
2025-03-05 14:20:32 +00:00
William Braeckman
8b49ad8add [IMP] developer/reference/cli: --limit-time-cron-conn
Document the newly created config option.

closes odoo/documentation#11851

See: https://github.com/odoo/odoo/pull/194141
X-original-commit: ff6f55ae20
Related: odoo/odoo#195042
Signed-off-by: William Braeckman (wbr) <wbr@odoo.com>
2025-01-24 15:20:41 +00:00
Paolo Gatti
096d17c474 [IMP] developer: added "--shell-file" CLI option
Added the description for the new '--shell-file' option, which overrides
the the $PYTHONSTARTUP env variable to initialize the shell session with
a startup Python script.

Related docs: https://docs.python.org/3/using/cmdline.html#envvar-PYTHONSTARTUP

Community PR: odoo/odoo#185075
task-4306704

closes odoo/documentation#11334

Signed-off-by: Paolo Gatti (pgi) <pgi@odoo.com>
2024-11-27 15:32:22 +00:00
Aurelien van Delft (avd)
9049311711 [ADD] tools: add populate cli documentation
closes odoo/documentation#11266

X-original-commit: b0ede2819a
Signed-off-by: Aurélien van Delft (avd) <avd@odoo.com>
2024-10-23 12:07:16 +00:00
Victor Piryns (pivi)
840a739396 [REM] developer/performance: remove mentions to the populate tool
closes odoo/documentation#11034

Related: odoo/odoo#180318
Related: odoo/enterprise#70095
Signed-off-by: Piryns Victor (pivi) <pivi@odoo.com>
Co-authored-by: Aurelienvd <avd@odoo.com>
2024-09-21 00:13:24 +00:00
Jonathan Castillo (jcs)
0249d9d0a6 [MOV] documentation structure reorganization
This commit aims to improve the documentation's navigability by
redefining some categories' purposes and titles.

There is a redirection rule for each documentation page moved.
This ensures that users won't have a 404 error message.

task-3217827

closes odoo/documentation#8064

Signed-off-by: Jonathan Castillo (jcs) <jcs@odoo.com>
2024-03-12 07:08:34 +00:00
Nathan Marotte (nama)
080dc64e54 [ADD] Upgrade documentation: How-to-guide for developers
closes odoo/documentation#7336

X-original-commit: 44f4683519
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2024-01-11 17:21:54 +00:00
Julien Castiaux
b0cc13d4fe [FIX] developer/reference/cli: log on stderr
Odoo is actually logging on sys.stderr and not sys.stdout[^1][^2][^3].

Remove passage about the workflows, the workflows were an OpenERP
feature removed almost a decade ago in odoo/odoo@98cb4719db.

Fixes: #7210

[^1]: b3b9b2b49e/odoo/netsvc.py (L156)
[^2]: b3b9b2b49e/odoo/netsvc.py (L198)
[^3]: https://docs.python.org/3/library/logging.handlers.html#logging.StreamHandler

closes odoo/documentation#7274

X-original-commit: c55e8f251a
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Julien Castiaux (juc) <juc@odoo.com>
2024-01-04 23:00:59 +00:00
Julien Castiaux
883442e483 [IMP] developer/reference/cli: --proxy-mode
Many customers struggle with their web server configuration, notably
regarding the `--proxy-mode` option and the way `X-Forwarded-*` HTTP
request headers are interpreted within Odoo.

The `--proxy-mode` section has been updated to cover the most common
misunderstandings and to give guidances on how to setup a web server.

Odoo always only takes the last entry of the `X-Forwarded-*` request
header because there are situations where it is not possible to
determine which last n-th entry to use. Employees might access their
odoo database via the internal network: connecting directly to nginx,
while customers might access the database via an additional proxy such
as cloudflare. The real IP of employees would be the last inside the
`X-Forwarded-For` chain, while the real IP of customers would be the
*second* last entry inside the chain. It would be incorrect to always
take the same nth last entry inside the chain. The cloudflare's own IP
address must be discarded from the chain. Web servers usually feature
a way to ignore trusted IP from the chain, a way so that the real IP
of the user is always the last entry inside the chain. Odoo relies on
such feature to be active and configured.

Prior discussions about `X-Forwarded-For`:
* odoo/odoo#104947
* odoo/odoo#118629
* odoo/odoo#139536

All `X-Forwarded-*` headers are ignored in case the `X-Forwarded-Host`
header is missing (even with `--proxy-mode`). System admin might be
tempted to not set this header and to set `Host` instead, this is
broken as this a user-agent would be able to spoof `X-Forwarded-Host`
and Odoo would use that instead of the correct `Host`.

Prior discussions about `X-Forwarded-Host`:
* odoo/odoo#63277
* odoo/odoo#70117

closes odoo/documentation#6744

X-original-commit: 3d91c57b57
Signed-off-by: Julien Castiaux (juc) <juc@odoo.com>
2023-12-03 08:26:12 +00:00
Rémy Voet (ryv)
d53c676288 [FIX] developer: fix bad documentation of --unaccent
In the CLI, `--unaccent` try to enable PostgreSQL unaccent extention
when odoo is responsible to create new database(s).

closes odoo/documentation#6246

X-original-commit: 1639d22efd
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Rémy Voet (ryv) <ryv@odoo.com>
2023-10-31 08:06:49 +00:00
Leloup Loïc (lole)
f18162fe2a [IMP] cli: add unit to memory options
The documentation is unclear about the unit used for the --limit-memory-soft
and --limit-memory-hard options of odoo-bin.  The unit used is bytes, but
it isn't mentioned and the default unit is shown in mebibytes, causing
confusion.

closes odoo/documentation#5794

X-original-commit: 9fadc3355d
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-09-11 10:29:04 +00:00
Xavier (XPL)
ea53f06197 [REF] install: move intro to main install page and split by install type
This PR moves the introduction about the different installation methods and editions found on the
install/install.rst page directly under the main install/ page. It creates three pages, one per
installation method documented on the install/install.rst page (Docker being documented on
docker.com and maintained by us), and moves the related content there. In addition, it fixes various
typos/grammar issues and improves the content according to the documentation guidelines. Various
references and links across the documentation had to be fixed accordingly.

task-3459070

closes odoo/documentation#5543

X-original-commit: 91c28fd433
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
2023-08-19 07:58:45 +02:00
Christophe Monniez
899ee1c4c1 [FIX] deploy: reference the config parameter
The deploy documentation is assuming that `/etc/odoo.conf` is the
default config file, which is not the case.

With this commit, the configuration file references the cli
documentation.

closes odoo/documentation#4808

X-original-commit: 8aed7988ba
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Christophe Monniez (moc) <moc@odoo.com>
2023-06-20 18:02:00 +02:00
Antoine Vandevenne (anv)
ed4b8c1320 [MOV] developer/cli: move "Command-line interface (CLI)" to the reference dir
task-2991663

closes odoo/documentation#3660

X-original-commit: 3dc6bb83c1
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-02-23 16:09:00 +01:00