Skip to content

Latest commit

 

History

History
60 lines (42 loc) · 2.16 KB

README.md

File metadata and controls

60 lines (42 loc) · 2.16 KB
icon description
compact-disc
A hybrid of Flatpak sandboxing with AppImage portability

FlatImage

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 %}