File tree Expand file tree Collapse file tree
formats/packages/errors-and-quirks Expand file tree Collapse file tree Original file line number Diff line number Diff line change 11---
22icon : triangle-exclamation
3- description : Common Issues
3+ description : Common Issues with Portable Packages
44---
55
66# Errors & Quirks
77
88Common issues when running portable packages:
99
10- - [ FUSE ] ( fuse.md ) - Filesystem in Userspace issues
11- - [ Fonts] ( fonts.md ) - Font rendering problems
12- - [ Namespaces ] ( namespaces.md ) - User namespace restrictions
10+ * [ ** Fuse ** ] ( fuse.md ) : Required for mounting Filesystems & Images
11+ * [ ** Fonts** ] ( fonts.md ) : Required to display/render Non-English Chars, Emojis, Symbols etc.
12+ * [ ** Kernel User NameSpaces ** ] ( namespaces.md ) : Required for Sandboxing, Security & Performance
Original file line number Diff line number Diff line change 11---
22icon : font
3- description : Font Issues
3+ description : Required to display/render Non-English Chars, Emojis, Symbols etc.
44---
55
66# Fonts
77
8+ {% hint style="info" %}
9+ Required to display/render Non-English Chars, Emojis, Symbols etc.
10+ {% endhint %}
11+
812Portable packages may have font rendering issues due to missing fonts or fontconfig.
913
1014## Common Issues
1115
1216- Missing fonts (squares or boxes instead of characters)
1317- Wrong font fallbacks
1418- CJK characters not rendering
19+ - Emojis showing as boxes
1520
1621## Solutions
1722
1823### Install Common Fonts
1924
2025** Debian/Ubuntu:**
2126``` bash
22- sudo apt install fonts-noto fonts-liberation
27+ sudo apt install fonts-noto fonts-liberation fonts-noto-color-emoji
2328```
2429
2530** Fedora:**
2631``` bash
27- sudo dnf install google-noto-fonts-common liberation-fonts
32+ sudo dnf install google-noto-fonts-common liberation-fonts google-noto-emoji-fonts
2833```
2934
3035** Arch:**
3136``` bash
32- sudo pacman -S noto-fonts ttf-liberation
37+ sudo pacman -S noto-fonts noto-fonts-emoji ttf-liberation
3338```
3439
3540### Set Font Environment
Original file line number Diff line number Diff line change 11---
22icon : hard-drive
3- description : FUSE Issues
3+ description : Required for mounting Filesystems & Images
44---
55
66# FUSE
77
8+ {% hint style="info" %}
9+ Required for mounting Filesystems & Images
10+
11+ Can still be run with ` --appimage-extract-and-run ` | ` APPIMAGE_EXTRACT_AND_RUN=1 `
12+ {% endhint %}
13+
814AppImages and similar formats use FUSE (Filesystem in Userspace) to mount themselves.
915
1016## Common Errors
@@ -38,8 +44,18 @@ sudo pacman -S fuse2
3844
3945### Extract Instead
4046
41- Most AppImages support ` --appimage-extract ` :
47+ Most AppImages support extraction as fallback:
48+
49+ ``` bash
50+ ./app.AppImage --appimage-extract-and-run
51+ ```
52+
53+ Or set the environment variable:
54+ ``` bash
55+ APPIMAGE_EXTRACT_AND_RUN=1 ./app.AppImage
56+ ```
4257
58+ Manual extraction:
4359``` bash
4460./app.AppImage --appimage-extract
4561./squashfs-root/AppRun
Original file line number Diff line number Diff line change 11---
22icon : shield-halved
3- description : Namespace Issues
3+ description : Required for Sandboxing, Security & Performance
44---
55
6- # Namespaces
6+ # Kernel User NameSpaces
7+
8+ {% hint style="info" %}
9+ Required for Sandboxing, Security & Performance
10+ {% endhint %}
711
812Some portable packages use user namespaces for sandboxing, which may be restricted on certain systems.
913
You can’t perform that action at this time.
0 commit comments