Installation

What Access X-Ray requires, how to install it, and how to check the install worked.

Module: technovision_access_xray Odoo: 18.0, Community or Enterprise Depends on: base only

Requirements

Depending on base alone is deliberate. A governance tool that drags accounting or HR into the database to be installed is a tool that cannot be installed on the databases that most need it.

On-premise

# 1. Put the module on the addons path
cp -r technovision_access_xray /opt/odoo/custom/

# 2. Restart Odoo so the new module is discovered
sudo systemctl restart odoo

# 3. Install it
#    Apps -> Update Apps List -> search "Access X-Ray" -> Install

Or from the command line:

odoo-bin -d YOUR_DATABASE -i technovision_access_xray --stop-after-init

Odoo.sh

• Add the module to your project's repository, under any directory on the addons path.
• Commit and push. Odoo.sh rebuilds the branch.
• Apps → Update Apps List, then install Access X-Ray.

No configuration files, no environment variables and no external service credentials are involved at any point.

Upgrading

odoo-bin -d YOUR_DATABASE -u technovision_access_xray --stop-after-init

Findings are regenerated by running a scan, not by the upgrade. Nothing in an upgrade destroys data that cannot be recreated by pressing Run Scan again.

Uninstalling

Apps → Access X-Ray → Uninstall.

Uninstalling removes the module's own tables — findings and the transient probe records — and nothing else. It cannot affect users, groups, access rules or record rules, because the module never writes to them.

Verifying the install

After installing, an Access X-Ray menu appears in the top-level app menu for users in the Settings group. It contains:

Access X-Ray
├── Findings
├── Run Scan
└── Explore
    ├── By User
    ├── By Model
    └── Compare Users

If the menu is not visible, the account is not in the Settings group — see SECURITY.md, which explains why access is restricted that way.

Running the tests

odoo-bin -d test_db -i technovision_access_xray \
  --test-enable --test-tags /technovision_access_xray --stop-after-init

45 tests. Most of them exercise the resolver in isolation with no database at all — see TEST_REPORT.md.