Overview
Fuego is available for Linux distributions through multiple installation methods: DEB packages, RPM packages, and manual binary installation.
Available methods:
- DEB package — For Debian, Ubuntu, and derivatives (coming soon)
- RPM package — For Fedora, RHEL, and derivatives (coming soon)
- Binary installation — Manual setup for any Linux distribution
Prerequisites
- A 64-bit Linux distribution
sudoaccess for system-wide installation- Basic terminal knowledge
Binary installation
Download the required files
- Download the latest Linux binary from the official download page
- Download the support files (icon and desktop entry) from linux-manual-installation.zip
- 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 fuego.desktop icons/
Install the executable
Copy the executable to a directory in your $PATH. If you’re unsure which directory to use, /usr/bin is a safe choice:
sudo mv ./Fuego /usr/bin/fuego
sudo chmod +x /usr/bin/fuego
Note: The executable is renamed to lowercase
fuegoto follow Linux naming conventions.
Install the application icon
Copy the icon to the system icons directory:
sudo mv ./icons/256/fuego.png /usr/share/icons/hicolor/256x256/apps/fuego.png
Install the desktop entry
Copy the .desktop file to make Fuego appear in your application menu:
sudo mv ./fuego.desktop /usr/share/applications/fuego.desktop
After completing these steps, Fuego should appear in your application launcher. You can also start it from the terminal by running fuego.
Desktop entry reference
The fuego.desktop file contains the following configuration:
[Desktop Entry]
Version=1.0
Type=Application
Name=Fuego
GenericName=Firestore Manager
Comment=Manage Firestore and Firebase services with ease
Categories=Development;Database;
Exec=fuego %U
Icon=fuego
Terminal=false
Keywords=Firebase;Firestore;Database;Management;NoSQL;
StartupWMClass=Fuego
StartupNotify=true
Troubleshooting
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/fuego.desktop
Find the Exec line and modify it as follows:
Before:
Exec=fuego %U
After:
Exec=env WEBKIT_DISABLE_COMPOSITING_MODE=1 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 fuego
Uninstallation
To remove Fuego from your system, delete the installed files:
sudo rm /usr/bin/fuego
sudo rm /usr/share/icons/hicolor/256x256/apps/fuego.png
sudo rm /usr/share/applications/fuego.desktop
