Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/damianiglesias/amnesiaOS/llms.txt

Use this file to discover all available pages before exploring further.

AmnesiaOS is a custom Linux distribution built from scratch using Linux From Scratch (LFS) methodology. The entire operating system — kernel, userland, and init system — loads into RAM at boot time. When you power off, the RAM clears and no forensic footprint remains on your storage device.

Quickstart

Flash the ISO to a USB drive and boot into a RAM-only environment in minutes.

Architecture

Understand how AmnesiaOS achieves full RAM execution with zero disk writes.

Build from Source

Compile the kernel, assemble the initramfs, and produce your own bootable ISO.

Configuration

Customize the kernel, bootloader, and network settings for your environment.

Why AmnesiaOS?

Traditional operating systems leave traces everywhere — swap files, journal entries, temporary directories, and filesystem metadata. AmnesiaOS eliminates this by design: there is no persistent root filesystem, no swap partition, and no disk writes after boot.

Full RAM Execution

The entire OS runs in tmpfs. No reads or writes to any storage device after the kernel hands off to init.

Zero Forensic Footprint

Power off and the hardware RAM clears. No log files, no temp files, no artifacts.

Minimal Surface

A ~10 MB initramfs with BusyBox 1.35.0 provides over 300 Unix utilities in a single static binary.

Get up and running

1

Download the ISO

Grab the latest amnesia-os.iso from the GitHub Releases page.
2

Flash to USB

Write the image to a USB drive using dd:
dd if=amnesia-os.iso of=/dev/sdX bs=4M status=progress
Replace /dev/sdX with your USB device node.
3

Boot

Insert the USB drive, select it in your BIOS/UEFI boot menu, and AmnesiaOS will load entirely into RAM.
4

Done

You are now running a fully stateless Linux environment. Nothing is written to disk.

Current version

AmnesiaOS v0.2.0 ships with:
ComponentVersion
Linux Kernel6.16.1
BusyBox1.35.0
BootloaderGRUB 2.12
Init systemCustom shell script
NetworkDHCP via udhcpc
Filesystemtmpfs (RAM)
AmnesiaOS is in early development (0.x.x series). The planned v1.0.0 release will add a full LFS userland loaded entirely into RAM via SquashFS, eliminating any USB dependency after boot.

Build docs developers (and LLMs) love