Deterministic Session GC

Provide a deterministic session garbage collection instead of the default random one

Technical Name:
  • Odoo Version

Deterministic Session GC

Beta License: AGPL-3 OCA/server-tools Translate me on Weblate Try me on Runbot

Whenever a new request is processed by Odoo, this statement is evaluated: random.random() < 0.001 [1]

1 time out of 1000 in average, it will return True and trigger the Garbage Collection of sessions: sessions that have not been active for more than 1 week will be deleted [2]

This random approach can become a problem in some contexts.

On a highly visited Odoo website, many sessions will be created. Going through all of them will take some time, especially on a slow/loaded FS. The Garbage Collection happening randomly, your users will report you cases of Odoo being randomly slow on random actions. They won't be able to reproduce these cases and you won't be able to trace them in your odoo logs neither, because calls' response time doesn't include the time Odoo spent on the Garbage Collection.

Moreover, on a heavily loaded server, better be in a position to control when does the Garbage Collection happen. One might want to run it once per night only for example.

That's why we created this module:

  • to disable the default random Garbage Collection
  • to enable administrators to replace it by a deterministic approach:
    • either by using the included Scheduled Action;
    • or by calling the added public method ir.autovacuum:gc_sessions() remotely

Table of contents


You need to load this module server-wide:

  • By starting Odoo with --load=web,base_deterministic_session_gc
  • Or by updating its configuration file:

You also need to install it in your database if you want to use the provided deterministic approach.


You can change the session expiry delay in the Odoo configuration file:

Default value is 7 days.

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us smashing it by providing a detailed and welcomed feedback.

Do not contact contributors directly about support or help with technical issues.



  • Trobz



This module is maintained by the OCA.

Odoo Community Association

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

This module is part of the OCA/server-tools project on GitHub.

You are welcome to contribute. To learn how please visit

This is a preview of the recently viewed products by the user.
Once the user has seen at least one product this snippet will be visible.

Recently viewed Products