Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Docker Images of Malware Analysis Tools

Docker images of malware analysis tools that you can run without the REMnux distro, including Thug, Binary Refinery, RetDec, and Rizin.

The REMnux toolkit provides Docker images of popular malware analysis tools that you can run on any compatible system even without installing the REMnux distro. These images reside in the REMnux repository on Docker Hub, and are based on the files maintained in the REMnux Github repository.

Docker is installed as part of the REMnux distro. If you're planning to run REMnux Docker images on another system, you may need to install Docker. The first time you run an image (e.g., using the docker run command), Docker will automatically download the image from Docker Hub, run it locally as an active container. Your system will need to be connected to the internet to retrieve the image; afterwards, Docker will use a locally cached copy. You can use the docker pull command to update the cached version of the image.

The following Docker images of malware analysis tools are available as part of REMnux. If you have the expertise, consider adding to this collection by contributing a Dockerfile to the REMnux toolkit.

The Radare2, Rizin, Binary Refinery, PyLingual, and Sogen images run on Intel or AMD processors (amd64) and on 64-bit ARM processors (arm64). Docker downloads the version that matches your processor, such as arm64 on Apple's M-series Macs. The Thug, JSC Deobfuscator, and RetDec images are amd64-only, because some of their components exist only for that architecture. To run one of them on an arm64 system, add --platform linux/amd64 to the docker run command. Docker Desktop then runs the image through emulation, which is slower than running it natively.

Thug Low-Interaction Honeyclient

Thug is a low-interaction honeyclient for examining suspicious websites. This tool was created by Angelo Dell'Aera. It's licensed under GNU General Public License (GPL) v2. In addition to being available as a Docker image, Thug is also installed as part of the REMnux distro.

One way to run Thug as a Docker image is to invoke it using the following command to open a shell in the container where you can run thug with the desired parameters, such as -F to enable file logging).

docker run --rm -it --entrypoint "/bin/bash" remnux/thug

The password for the container's user thug is thug. The remnux/thug image is hosted on its Docker Hub page.

Binary Refinery

The Binary Refinery™ is a collection of Python scripts that implement transformations of binary data such as compression and encryption. You can chain the tools as necessary to achieve your objective. This toolkit is authored by Jesko Hüttenhain and licensed under the 3-Clause BSD License.

To run Binary Refinery tools within the "remnux/binary-refinery" container, create a directory where you'll store your input files, e.g. ~/workdir. Then, use a command like this to launch the container and have your directory mapped as /home/nonroot/workdir inside the container:

docker run --rm -it -v ~/workdir:/home/nonroot/workdir remnux/binary-refinery

The binary-refinery Docker image is hosted in the REMnux Docker Hub repository.

For documentation about this toolkit, including the listing of its tools, see https://binref.github.io and https://github.com/binref/refinery.

PyLingual Python Bytecode Decompiler

PyLingual is an ML-based decompiler that translates Python 3.9+ bytecode back to source code using transformer models. It was created by UT Dallas Systems Security (syssec-utd) and is licensed under the GNU General Public License (GPL) v3.

To run PyLingual, create a directory where you'll store the .pyc files you plan to decompile. Then, open a shell inside the container:

PyLingual downloads ML models from Hugging Face on first use. To persist the model cache across container runs, mount a second volume:

The remnux/pylingual image is hosted on its Docker Hub page.

JSC Deobfuscator

JSC Deobfuscator statically deobfuscates compiled V8 JavaScript bytecode (.jsc) that was protected with javascript-obfuscator, producing View8 pseudocode for static inspection. It was created by Aleksandra "Hasherezade" Doniec at Check Point Research and is licensed under the GNU General Public License (GPL) v2 or later. The image bundles the complete pipeline: the version-matched v8dasm disassembler, the View8 decompiler, brotli, and the deobfuscation filters.

To run JSC Deobfuscator, create a directory where you'll store the .jsc payloads you plan to examine. Then, open a shell inside the container where you can run the pipeline and have your local directory mapped as /home/nonroot/workdir inside the container:

The bundled v8dasm disassembler targets V8 version 10.2.154.26, used by JSCeal-era payloads. Payloads compiled with a different V8 build need a matching disassembler, as explained in the project wiki. This image is amd64-only; on Apple Silicon and other arm64 hosts, add --platform linux/amd64.

The optional LLM-assisted function renaming needs an API key passed into the container, such as -e ANTHROPIC_API_KEY or -e OPENAI_API_KEY, or a reachable Ollama server.

The remnux/jsc-deobfuscator image is hosted on its Docker Hub page.

Sogen Windows User-Mode Emulator

Sogen emulates Windows user-mode programs on Linux. Instead of reimplementing the Windows API, it runs the real Windows system DLLs on an emulated CPU, so you can trace a program's API calls and syscalls, debug it over GDB from outside the emulated process, take snapshots, and make runs reproducible. Sogen was created by Maurice Heumann and is licensed under the GNU General Public License (GPL) v2.

To run Sogen, create a directory where you'll store your samples. Then, open a shell inside the container and have your local directory mapped as /home/nonroot/workdir inside the container:

Sogen needs an emulation root: a directory with the Windows system DLLs, registry hives, and API set map that the emulated program will see. The image doesn't include one, because Microsoft owns those files. When you open a shell in the container and no root exists in your working directory, a message explains how to get one. Run get-sogen-root inside the container to download the prebuilt root that the Sogen project publishes (about 180 MB, 520 MB unpacked) into ~/workdir/root, or build your own on a Windows system by following the Sogen wiki. You do this once, since the root stays in your working directory.

With the root in place, copy a sample into ~/workdir and run:

The analyzer command maps the sample to c:\ inside the emulated Windows and runs it from there. Add -v for verbose logging, --report run.jsonl for a machine-readable event log, -s to see only the program's own output, or -d to wait for a GDB connection. Run analyzer --help for the full list of options. Sogen runs native Windows executables. The .NET runtime files are absent from the prebuilt root, so .NET assemblies stop early with error 0x80131700. The emulated program's sockets stay inside the emulator unless you add --network live to the analyzer command. To keep the container itself offline as well, add --network none to docker run.

To debug the emulated program from the host with GDB or IDA, publish the debug port on loopback when you start the container, such as -p 127.0.0.1:28960:28960, then run analyzer -d --bind 0.0.0.0 --port 28960 sample.exe inside it. The image's README on GitHub has the details.

The remnux/sogen image is hosted on its Docker Hub page.

RetDec Retargetable Machine-Code Decompiler

RetDec is a decompiler that supports a variety of file formats, including PE and ELF, and several 32 and 64-bit architectures. It was created by Avast Software, and is licensed under MIT License with third-party components that are distributed under their own licenses.

To run RetDec, create a directory where you'll store the files you plan to examine. Then, open a shell inside the container where you can run RetDec commands and have your local directory mapped as /home/retdec/workdir inside the container:

The password for the container's user retdec is retdec. The remnux/retdec image is hosted on its Docker Hub page.

The commands provided by RetDec start with the retdec- prefix and include retdec-decompiler, retdec-unpacker, and retdec-fileinfo.

Rizin Reverse-Engineering Framework

Rizin is a reverse-engineering framework that includes a disassembler and analysis capabilities for a variety of executable formats and architectures. It's licensed under GNU Lesser General Public License (LGPL) v3. This is a fork of the Radare2 project.

To run Rizin, create a directory where you'll store the files you plan to examine. Then, open a shell inside the container where you can run Rizin commands (rizin and others that start with rz-) and have your local directory mapped as /home/nonroot/workdir inside the container:

If you're planning to perform kernel-mode debugging, process tracing, or syscall tracing inside the container, then supply the parameters --cap-drop=ALL --cap-add=SYS_PTRACE when launching it.

The password for the container's user nonroot is nonroot. The remnux/rizin image is hosted on its Docker Hub page.

Radare2 Reverse-Engineering Framework

Radare2 is a reverse-engineering framework that includes a disassembler and analysis capabilities for a variety of executable formats and architectures. It's licensed under GNU Lesser General Public License (LGPL) v3.

To run Radare2, create a directory where you'll store the files you plan to examine. Then, open a shell inside the container where you can run Radare2 commands and have your local directory mapped as /home/nonroot/workdir inside the container:

If you're planning to perform kernel-mode debugging, process tracing, or syscall tracing inside the container, then supply the parameters --cap-drop=ALL --cap-add=SYS_PTRACE when launching it.

The image includes r2ai and decai plugins for LLM-powered reverse engineering. These require an LLM backend such as a cloud API or a local model server like Ollama. To use a cloud API, pass the API key and configure the provider inside r2:

The password for the container's user nonroot is nonroot. The remnux/radare2 image is hosted on its Docker Hub page.

Last updated