MCPcopy Index your code
hub / github.com/CERT-Polska/drakvuf-sandbox

github.com/CERT-Polska/drakvuf-sandbox @v0.20.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.20.0 ↗ · + Follow
630 symbols 2,331 edges 120 files 77 documented · 12% updated 8d agov0.20.0 · 2025-11-17★ 1,31142 open issues
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

DRAKVUF Sandbox

[!WARNING]
Here be dragons 🐉. Maintaining your own sandbox is a difficult task and this project uses technology that is not user-friendly. Be prepared to brush up on your debugging skills as bugs may be reproducible only on your configuration. On the other hand, it's not purely an R&D project and it is used in production! Source code and issues section on both DRAKVUF Sandbox and DRAKVUF engine projects are your best friend.

DRAKVUF Sandbox is an automated black-box malware analysis system with DRAKVUF engine under the hood, which does not require an agent on guest OS.

This project provides you with a friendly web interface that allows you to upload suspicious files to be analyzed. Once the sandboxing job is finished, you can explore the analysis result through the mentioned interface and get an insight on whether the file is truly malicious or not.

Because it is usually pretty hard to set up a malware sandbox, this project also provides you with an installer app that would guide you through the necessary steps and configure your system using settings that are recommended for beginners. At the same time, experienced users can tweak some settings or even replace some infrastructure parts to better suit their needs.

Quick start

DRAKVUF Sandbox - Analysis view

Recommended hardware & software

In order to run DRAKVUF Sandbox, your setup should fulfill all the listed requirements.

  • Processor:
  • ✔️ Required Intel processor with Intel Virtualization Technology (VT-x) and Extended Page Tables (EPT) features
  • Host system with at least 2 core CPU and 5 GB RAM, running GRUB as bootloader, one of:
  • ✔️ Debian 12 Bookworm
  • ✔️ Ubuntu 22.04 Jammy
  • Guest system, one of:
  • ✔️ Windows 10 build at least 2004 (x64), recommended 22H2
  • ✔️ Windows 7 (x64)

Nested virtualization:

  • ✔️ Xen - works out of the box.
  • ✔️ KVM - works, we often use it for development purposes. If you experience any bugs, please report them to us for further investigation.
  • ✔️ VMware Workstation Player - works, but you need to check Virtualize EPT option for a VM; Intel processor with EPT still required.
  • ❌ AWS, GCP, Azure - due to lack of exposed CPU features, hosting DRAKVUF Sandbox in the cloud is not supported (although it might change in the future).
  • ❌ Hyper-V - doesn't work.
  • ❌ VMWare Fusion (Mac) - doesn't work.

Maintainers/authors

Feel free to contact us if you have any questions or comments.

General contact email: info@cert.pl (fastest response)

You can also chat with us about this project on Discord: https://discord.gg/Q7eTsHnpn4

This project is authored by:

If you have any questions about DRAKVUF engine itself, contact tamas@tklengyel.com

Acknowledgements

This project was created and/or upgraded thanks to the following organizations and initiatives:

Connecting Europe Facility of the European Union

Co-financed by the Connecting Europe Facility of the European Union

The Honeynet Project

Contributed by The Honeynet Project

CERT Polska

Maintained by CERT Polska

Core symbols most depended-on inside this repo

get
called by 74
test/utils.py
run
called by 64
drakrun/lib/drakshell.py
join
called by 40
drakrun/lib/drakshell.py
createOption
called by 25
drakrun/web/frontend/src/PluginPicker.jsx
load
called by 23
drakrun/lib/config.py
load_config
called by 21
drakrun/lib/config.py
send_control
called by 15
drakrun/tools/drakshell/drakshell.c
read
called by 15
drakrun/web/storage.py

Shape

Function 350
Method 186
Class 73
Route 21

Languages

Python76%
TypeScript13%
C6%
C++4%

Modules by API surface

drakrun/lib/storage.py69 symbols
drakrun/lib/drakshell.py35 symbols
drakrun/web/api.py28 symbols
drakrun/lib/networking.py24 symbols
drakrun/analyzer/postprocessing/process_tree.py23 symbols
drakrun/tools/ipt/drak-ipt-blocks.cpp21 symbols
drakrun/tools/drakshell/drakshell.c20 symbols
drakrun/tools/drakshell/nt_loader.c18 symbols
drakrun/web/frontend/src/AnalysisSummary.jsx17 symbols
drakrun/analyzer/postprocessing/plugins/capa_plugin/capa_processor.py15 symbols
drakrun/web/storage.py13 symbols
test/vm-runner-client/vm_runner_client/client.py12 symbols

For agents

$ claude mcp add drakvuf-sandbox \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page