Skip to content

Install on Linux

To install Balsa on Linux, you need to ensure that the Necessary Dependencies are correctly installed and configured on your system.

Once the dependencies are ready, simply download the archive containing the Balsa application via the link below and extract it to any directory to complete the installation.

To run the installed Balsa, you only need to execute the balsa binary in the extraction directory via the console (or terminal).

bash
./balsa

TIP

If your extraction utility does not support automatic file permission configuration (such as older versions of unzip), you may need to manually set the balsa file as executable using chmod.

bash
chmod +x ./balsa

Dependencies

Balsa depends on the following supporting libraries.

DependencyVersion RequirementNotes
glibc>= 2.31Required
gtk3>= 3.24.20Required
gcc-libs>= 10.5.0Required
xdg-desktop-portal>= 1.6.0Optional, for better platform integration
libayatana-appindicator3>= 0.5.4Optional, for displaying the tray icon

TIP

If you need to manually install the dependencies mentioned above, please note that dependencies may have different names across different distributions.

If you need to manually install xdg-desktop-portal, you may need to choose a specific xdg-desktop-portal backend based on your Desktop Environment. For example, Gnome requires xdg-desktop-portal-gnome, and KDE requires xdg-desktop-portal-kde.

If you are using Gnome and the status bar fails to display the Balsa tray icon, please install the Gnome extension AppIndicator and KStatusNotifierItem Support.

桂ICP备2024025025号