flatimage

icon	compact-disc
description	A hybrid of Flatpak sandboxing with AppImage portability

FlatImage

• Author: @ruanformigoni
• Project Page: https://github.com/ruanformigoni/flatimage
• Detailed Docs: https://flatimage.github.io/docs/

---

Schema

{% hint style="info" %} .pkg: ${PKG_NAME}-${BASE_DISTRO_IMAGE}

.pkg_type: flatimage

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

{% code overflow="wrap" %}

!#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

{% endcode %} {% endhint %}

---

Prerequisites (HOST)

{% hint style="info" %}

• 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 {% endhint %}

---

Sandbox

{% hint style="success" %} FlatImages have built-in sandboxing, check docs: https://flatimage.github.io/docs/cmd/perms/ {% endhint %}

---

Quirks

{% hint style="info" %} 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. {% endhint %}