> For the complete documentation index, see [llms.txt](https://docs.pkgforge.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pkgforge.dev/formats/packages/nixappimage.md).

# NixAppImage

* **Author**: [`@ralismark`](https://github.com/ralismark) `+` [`@Azathothas`](https://github.com/Azathothas) `+` [`Others`](https://github.com/NixOS/bundlers)
* **Project Page**: <https://github.com/pkgforge/nix-appimage>
* Described as An AppImage created using a [Nix-Bundler](https://github.com/NixOS/bundlers) like [pkgforge/nix-appimage](https://github.com/pkgforge/nix-appimage) & [DavHau/nix-portable](https://github.com/DavHau/nix-portable)
* **Sources**: [NixOS Packages](https://github.com/NixOS/nixpkgs)

***

### Schema

{% hint style="info" %}
[<mark style="color:purple;">**`.pkg`**</mark>](/sbuild/specification/2.pkg.md): <mark style="color:orange;">**`${PKG_NAME}`**</mark>

[<mark style="color:purple;">**`.pkg_type`**</mark>](/sbuild/specification/2.pkg.md): <mark style="color:green;">**`nixappimage`**</mark>

<mark style="color:blue;">**`${SBUILD_PKG}`**</mark> : <mark style="color:green;">**`${PKG_NAME}.nixappimage`**</mark>
{% endhint %}

***

### **Prerequisites (`HOST)`**

{% hint style="info" %}

* [**Fuse**](broken://pages/8hHKbF95BBtvZUMBe4k9): Required for mounting Filesystems & Images
* [**Fonts**](broken://pages/1Jy4S9xshgEUK6bIc0fl): Required to display/render Non-English Chars, Emojis, Symbols etc.
* [<mark style="color:blue;">**Kernel User NameSpaces**</mark>](broken://pages/tjmP70tpwiHVQQutUXFd): Required for Sandboxing, Security & Performance
  {% endhint %}

***

### Sandbox

{% hint style="success" %}
NixAppImages have built-in sandboxing, run **`SHOW_HELP=1`** to see available options.
{% endhint %}

***

### Quirks

{% hint style="info" %} <mark style="color:red;">**KNOWN ISSUES**</mark>

* **LibGL**: <https://github.com/NixOS/nixpkgs/issues/9415>
* **Size**: About **`2-5x`** larger than other formats, but **guarantee absolute portability**.

<mark style="color:red;">**WARNINGS**</mark>

* 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 <mark style="color:green;">**`.nixappimage`**</mark> file is not a real elf binary, thus will not survive this process.
  {% endhint %}