explaingit

piat0n/baremetal-ram-dumper

Analysis updated 2026-05-18

100AssemblyAudience · researcherComplexity · 5/5Setup · hard

TLDR

A bare-metal tool that boots from USB and dumps a computer's RAM to disk, built for cold boot attack security research.

Mindmap

mindmap
  root((RAM Dumper))
    What it does
      Bare metal boot
      Dumps RAM to disk
      Cold boot research
    Tech stack
      Assembly
      NASM
      BIOS interrupts
    Use cases
      Cold boot attack study
      Memory forensics
      Low level programming
    Audience
      Security researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Study cold boot attacks by capturing a frozen laptop's memory contents after reboot.

USE CASE 2

Research how encryption keys can be recovered from physical memory.

USE CASE 3

Learn low-level x86 boot process and BIOS interrupt programming.

USE CASE 4

Build a bootable USB tool for memory forensics experiments.

What is it built with?

AssemblyNASMBIOS

How does it compare?

piat0n/baremetal-ram-dumperplummerssoftwarellc/tinyretropadcjauvin/tetris-464
Stars1005334
LanguageAssemblyAssemblyAssembly
Last pushed2014-02-01
MaintenanceDormant
Setup difficultyhardhardhard
Complexity5/54/54/5
Audienceresearcherdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires NASM to assemble, a blank dedicated USB drive, and a target machine with Legacy BIOS/CSM boot enabled.

The README does not state a license.

In plain English

BareMetal RAM Dumper is a small tool that boots directly from a USB drive, without any operating system, and copies the contents of a computer's memory straight to disk. It works at a very low level, talking directly to the computer's BIOS rather than relying on Windows, Linux, or macOS to do anything for it. The project was built for a specific kind of security research called a Cold Boot Attack. The idea is that if you physically cool a laptop's memory chips down to a very low temperature, the data stored in memory decays much more slowly after the power is cut. By quickly rebooting the frozen laptop from a USB drive running this tool, it becomes possible to capture the memory's contents to disk before that data fades away, which can include sensitive information like encryption keys. Under the hood, the tool is written in two stages using assembly language. The first stage is a tiny boot sector that loads a second, larger program into memory. That second stage figures out how much RAM the machine has, then copies it in small chunks from high memory into a temporary buffer, and writes each chunk out to the USB drive. The README includes a clear warning: running this tool will overwrite data on the boot drive starting partway through it, so it should only be used with a blank, dedicated USB drive set aside for this purpose. Building it requires the NASM assembler, and build scripts are provided for both Windows and Linux.

Copy-paste prompts

Prompt 1
Explain how BareMetal RAM Dumper uses BIOS interrupts to read and write memory.
Prompt 2
Walk me through building boot.bin from stage1.asm and stage2.asm with NASM.
Prompt 3
What is a cold boot attack and how does this tool relate to it?
Prompt 4
How do I write boot.bin to a USB drive safely using dd?

Frequently asked questions

What is baremetal-ram-dumper?

A bare-metal tool that boots from USB and dumps a computer's RAM to disk, built for cold boot attack security research.

What language is baremetal-ram-dumper written in?

Mainly Assembly. The stack also includes Assembly, NASM, BIOS.

What license does baremetal-ram-dumper use?

The README does not state a license.

How hard is baremetal-ram-dumper to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is baremetal-ram-dumper for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.