Pure Go ext4 filesystem implementation for creating disk images without external dependencies.

This library creates ext4 filesystem images suitable for virtual machines and embedded systems. It's designed for building disk images programmatically without requiring root privileges or external tools like mke2fs.

Note: This is a write-only library for creating ext4 images. Reading or modifying existing images is not supported.

• Pure Go: No external dependencies or system calls
• Extent-based: Modern ext4 extent trees for efficient block mapping
• Extended attributes: Full xattr support for security labels and metadata
• Symlinks: Both fast (inline) and slow (block-based) symlinks
• Simple API: Easy to use for creating filesystem images programmatically
• Docker integration: End-to-end testing with real Linux kernel verification

go get github.com/pilat/go-ext4fs

package main

import (
    "github.com/pilat/go-ext4fs"
)

func main() {
    // Create 64MB ext4 image
    builder, err := ext4fs.New("disk.img", 64)
    if err != nil {
        panic(err)
    }
    defer builder.Close()

    // Prepare filesystem
    if err := builder.PrepareFilesystem(); err != nil {
        panic(err)
    }

    // Create directories and files
    etcDir, err := builder.CreateDirectory(ext4fs.RootInode, "etc", 0755, 0, 0)
    if err != nil {
        panic(err)
    }

    _, err = builder.CreateFile(etcDir, "hostname", []byte("myhost\n"), 0644, 0, 0)
    if err != nil {
        panic(err)
    }

    // Create symlinks
    _, err = builder.CreateSymlink(etcDir, "hosts", "/etc/hostname", 0, 0)
    if err != nil {
        panic(err)
    }

    // Set extended attributes
    err = builder.SetXattr(etcDir, "user.comment", []byte("System configuration"))
    if err != nil {
        panic(err)
    }

    // Finalize and save
    if err := builder.Save(); err != nil {
        panic(err)
    }
}

This library is optimized for creating simple disk images for small VMs. The following ext4 features are not implemented:

For most VM use cases (boot disks, configuration filesystems, small data volumes), these limitations have no practical impact.

Created images can be verified using standard Linux tools:

# Check filesystem integrity
e2fsck -n -f disk.img

# Mount and inspect (requires root)
sudo mount -o loop disk.img /mnt

# View filesystem info
dumpe2fs disk.img

MIT License - see LICENSE file for details.