This release is a pre-release and may not be stable for production use.
dissect.database
A Dissect module implementing parsers for various database formats, including:
- Berkeley DB, used for example in older RPM databases
- Microsofts Extensible Storage Engine (ESE), used for example in Active Directory, Exchange and Windows Update
- SQLite3, commonly used by applications to store configuration data
For more information, please see the documentation.
Installation
dissect.database is available on PyPI.
pip install dissect.database
This module is also automatically installed if you install the dissect package.
Tools
Some CLI tools related to specific databases exists. These tools allow you to dump or inspect database content.
| Commands | Description |
|---|---|
dissect-ntds |
Windows NTDS (Active Directory database). |
dissect-ual |
Windows User Access Logging database. |
dissect-sru |
Windows System Resources And Usage Monitor database. |
dissect-certlog |
Windows AD CS database database. |
dissect-rpm |
Red Hat Package Manager database. |
dissect-impacket |
Impacket compatibility shim for secretsdump.py. |
Impacket compatibility shim for secretsdump.py
Impacket does not (yet) have native support for dissect.database,
so in the meantime a compatibility shim is provided. To use this shim, simply install dissect.database using the
instructions above, and execute secretsdump.py like so:
dissect-impacket /path/to/impacket/examples/secretsdump.py -h
Impacket secretsdump.py will now use dissect.database for parsing the NTDS.dit file, resulting in a significant performance improvement!
Build and test instructions
This project uses tox to build source and wheel distributions. Run the following command from the root folder to build
these:
tox -e build
The build artifacts can be found in the dist/ directory.
tox is also used to run linting and unit tests in a self-contained environment. To run both linting and unit tests
using the default installed Python version, run:
tox
For a more elaborate explanation on how to build and test the project, please see the documentation.
Contributing
The Dissect project encourages any contribution to the codebase. To make your contribution fit into the project, please refer to the development guide.
Copyright and license
Dissect is released as open source by Fox-IT (https://www.fox-it.com) part of NCC Group Plc (https://www.nccgroup.com).
Developed by the Dissect Team (dissect@fox-it.com) and made available at https://github.com/fox-it/dissect.
License terms: Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0). For more information, see the LICENSE file.
1 maintainer
Metadata
1 maintainer
Release files for dissect.database 1.2.dev11
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| dissect_database-1.2.dev11.tar.gz | 304.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| dissect_database-1.2.dev11-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 635.4 kB
Release files / dissect_database-1.2.dev11.tar.gz
| Download URL | dissect_database-1.2.dev11.tar.gz |
|---|---|
| Size | 304.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
16b86134bdad640e3199a349ef25b18916174545276f4a943a9ae40a53422a62
|
|
BLAKE2b-256 checksum How to use checksums |
a26a15d9ab62a18cee2ee4e272afc02409478c43001b1680c0cd099da6744db5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 27, 2026.
Transparency logRelease files / dissect_database-1.2.dev11-py3-none-any.whl
| Download URL | dissect_database-1.2.dev11-py3-none-any.whl |
|---|---|
| Size | 330.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b56213c66200052f182d08b43d943d8e93c34bb9ba1ab7033b38ccdcaf2d0214
|
|
BLAKE2b-256 checksum How to use checksums |
ec8923eb964cf5c2540b42d66ea6df3e2e8a0d5a9e69f520e6befffa19bec090
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 27, 2026.
Transparency log
