Linux installation

Download and run

1. Download the AppImage from the official download page
2. Make it executable and start it:

chmod +x ./Fuego-*.AppImage
./Fuego-*.AppImage

Note: AppImages require FUSE. On distributions where FUSE 2 is not installed by default (for example Ubuntu 22.04 and later), install it with sudo apt install libfuse2, or extract and run the bundle with ./Fuego-*.AppImage --appimage-extract-and-run.

Desktop integration

The AppImage doesn’t register itself in the application menu. To add it, move the file to a stable location and install the canonical desktop/icon support files for your user. Download linux-manual-installation.zip next to the AppImage first, then run:

mkdir -p ~/Applications
mv ./Fuego-*.AppImage ~/Applications/Fuego.AppImage
chmod +x ~/Applications/Fuego.AppImage

unzip linux-manual-installation.zip
install -Dm644 ./com.miserve.fuego.png \
  ~/.local/share/icons/hicolor/256x256/apps/com.miserve.fuego.png
install -Dm644 ./com.miserve.fuego.svg \
  ~/.local/share/icons/hicolor/scalable/apps/com.miserve.fuego.svg
install -Dm644 ./com.miserve.fuego.desktop \
  ~/.local/share/applications/com.miserve.fuego.desktop

sed -i \
  -e "s|^Exec=.*|Exec=$HOME/Applications/Fuego.AppImage %u|" \
  -e "s|^TryExec=.*|TryExec=$HOME/Applications/Fuego.AppImage|" \
  ~/.local/share/applications/com.miserve.fuego.desktop

The desktop filename, icon basename and running GTK application ID remain com.miserve.fuego, so launchers can group the window and show the icon.

To remove the user integration completely, delete the AppImage, desktop entry and both installed icon files:

rm ~/Applications/Fuego.AppImage \
  ~/.local/share/applications/com.miserve.fuego.desktop \
  ~/.local/share/icons/hicolor/256x256/apps/com.miserve.fuego.png \
  ~/.local/share/icons/hicolor/scalable/apps/com.miserve.fuego.svg

Download the required files

1. Download the latest Linux binary from the official download page
2. Download the support files (icon and desktop entry) from linux-manual-installation.zip
3. Extract the zip file in the same directory where you downloaded the Fuego binary

Navigate to the download directory

Open a terminal and navigate to your downloads folder:

cd ~/Downloads

Extract the support files:

unzip linux-manual-installation.zip

Verify that you have all the required files:

ls -la Fuego com.miserve.fuego.desktop com.miserve.fuego.png com.miserve.fuego.svg

Install the executable

Install the executable in the same canonical location used by the native packages:

sudo install -Dm755 ./Fuego /usr/bin/Fuego

Install the application icon

Copy the icon to the system icons directory:

sudo install -Dm644 ./com.miserve.fuego.png /usr/share/icons/hicolor/256x256/apps/com.miserve.fuego.png
sudo install -Dm644 ./com.miserve.fuego.svg /usr/share/icons/hicolor/scalable/apps/com.miserve.fuego.svg

Install the desktop entry

Copy the .desktop file to make Fuego appear in your application menu:

sudo install -Dm644 ./com.miserve.fuego.desktop /usr/share/applications/com.miserve.fuego.desktop

After completing these steps, Fuego should appear in your application launcher. You can also start it from the terminal by running /usr/bin/Fuego.

Fuego fails to start or shows a blank window

Symptoms: The application doesn’t launch, crashes immediately, or displays a blank white window.

Cause: This typically occurs when your system lacks hardware acceleration support for WebKit (WebView). Some Linux environments, particularly virtual machines or older hardware, may not have proper GPU acceleration configured.

Solution: Disable WebKit compositing mode by editing the desktop entry file:

sudo nano /usr/share/applications/com.miserve.fuego.desktop

Find the Exec line and modify it as follows:

Before:

Exec=/usr/bin/Fuego %u

After:

Exec=env WEBKIT_DISABLE_COMPOSITING_MODE=1 /usr/bin/Fuego %u

Save the file and restart Fuego. The application should now launch correctly using software rendering.

Tip: If you’re running Fuego from the terminal, you can test this fix without modifying the desktop file:

WEBKIT_DISABLE_COMPOSITING_MODE=1 /usr/bin/Fuego