FlatImage

A hybrid of Flatpak sandboxing with AppImage portability

• Author: @ruanformigoni

• Project Page: https://github.com/ruanformigoni/flatimage

• Detailed Docs: https://flatimage.github.io/docs/

---

Schema

.pkg: ${PKG_NAME}-${BASE_DISTRO_IMAGE}

.pkg_type: flatimage

${SBUILD_PKG} : ${PKG_NAME}-${BASE_DISTRO_IMAGE}.flatimage

!#Examples
firefox-alpine.FlatImage --> Created using alpine as base BaseImage/RootFS
steam-cachyos.FlatImage --> Created using CachyOs as BaseImage/RootFS
librewolf-alpine-nix.FlatImage --> Created using alpine as BaseImage/RootFS with Nix on top of it

---

Prerequisites (HOST)

• Fuse: Required for mounting Filesystems & Images

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

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

---

Sandbox

FlatImages have built-in sandboxing, check docs: https://flatimage.github.io/docs/cmd/perms/

---

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 .flatimage file is not a real elf binary, thus will not survive this process.