RunImage

Portable single-file Linux container, Similar to FlatImage

• Author: @VHSgunzo

• Project Page: https://github.com/VHSgunzo/runimage

• Sources: A base runimage is used to install packages using a distro & then rebuilt/packaged

---

Schema

.pkg: ${PKG_NAME}

.pkg_type: runimage

${SBUILD_PKG} : ${PKG_NAME}.runimage

---

Prerequisites (HOST)

• Fuse: Required for mounting Filesystems & Images (Can still be run with --runtime-extract-and-run | RUNTIME_EXTRACT_AND_RUN=1 )

• Fonts: Required to display/render Non-English Chars, Emojis, Symbols etc.

• Kernel User NameSpaces: Required for Sandboxing, Security & Performance

---

Sandbox

RunImages have built-in sandboxing, check the docs: https://github.com/VHSgunzo/runimage#usage

---

Quirks

WARNINGS

• NEVER run strip, objcopy or any other binary rewriting tool as they will often just strip the squashfs|dwarfs archive, only preserving the runtime.

• A typical .runimage file is not a real elf binary, thus will not survive this process.