Skip to content

Various server CLI #14294

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 5 commits into
base: master
Choose a base branch
from
Open

Various server CLI #14294

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
1fe1565
[FIX] developer/reference/cli: --db_replica_host
Julien00859 Aug 13, 2025
0b2d8f2
[FIX] developer/reference/cli: --dev=replica
Julien00859 Aug 13, 2025
a16b6bd
[FIX] developer/reference/cli: --dev=pdb was removed
Julien00859 Aug 13, 2025
de7ab15
[FIX] developer/reference/cli: --dev=all is a lie
Julien00859 Aug 13, 2025
5ee04f6
[IMP] developer/reference/cli: --dev=access
Julien00859 Aug 13, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 16 additions & 4 deletions content/developer/reference/cli.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -236,6 +236,14 @@ Database

port the database listens on, defaults to 5432

.. option:: --db_replica_host <hostname>

host for the replica database server, disabled when not set / empty

.. option:: --db_replica_port <port>

port the replica database listens on, defaults to :option:`--db_port`
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
port the replica database listens on, defaults to :option:`--db_port`
the port the replica database listens on, defaults to :option:`--db_port`


.. option:: --db-filter <filter>

hides databases that do not match ``<filter>``. The filter is a
Expand Down Expand Up @@ -411,7 +419,7 @@ Developer features
comma-separated list of features. For development purposes only. Do not use it in production.
Possible features are:

* ``all``: all the features below are activated
* ``all``: alias for xml,reload,qweb,access

* ``xml``: read QWeb template from xml file directly instead of database.
Once a template has been modified in database, it will be not be read from
Expand All @@ -423,11 +431,15 @@ Developer features

* ``qweb``: break in the evaluation of QWeb template when a node contains ``t-debug='debugger'``

* ``(i)p(u)db``: start the chosen python debugger in the code when an
unexpected error is raised before logging and returning the error.

* ``werkzeug``: display the full traceback on the frontend page in case of exception

* ``replica``: simulate :option:`db_replica_host` but connect to the same datbase server as
:option:`db_host`, this makes it possible to test read-only features without the need to setup
a replicated database.
Comment on lines +436 to +438
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* ``replica``: simulate :option:`db_replica_host` but connect to the same datbase server as
:option:`db_host`, this makes it possible to test read-only features without the need to setup
a replicated database.
* ``replica``: simulate :option:`db_replica_host` but connect to the same database server as
:option:`db_host`, this makes it possible to test read-only features without the need to set up
a replicated database.


* ``access``: log the traceback next to the AccessError when it results as a 403 - Forbidden
HTTP response.
Comment on lines +440 to +441
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* ``access``: log the traceback next to the AccessError when it results as a 403 - Forbidden
HTTP response.
* ``access``: log the traceback next to the AccessError when it results in a 403 - Forbidden
HTTP response.



.. _reference/cmdline/server/http:

Expand Down