GunamayaGunamaya
Sign inSign up

Setup

Gunamaya on Linux

Native packages for the three architectures that matter on Linux desktops and single-board computers: x64, Arm64, and Arm32.

Package downloads

sudo apt install ./gunamaya_<version>_<arch>.deb

Using apt install instead of dpkg -i automatically resolves any missing shared-library dependencies for you.

Architecture support

Windows

  • x64
  • Arm64

macOS

  • Apple Silicon
  • Intel

Linux

  • x64
  • Arm64
  • Arm32

Check your architecture with uname -m: x86_64 maps to the x64 build, aarch64 maps to Arm64, and armv7l maps to Arm32.

Installing directly from a .deb or .rpm file works, but registering Gunamaya's package repository lets your system's package manager handle future updates the same way it handles everything else:

# Debian/Ubuntu
curl -fsSL https://gunamaya.com/linux/gpg | sudo gpg --dearmor -o /usr/share/keyrings/gunamaya.gpg
echo "deb [signed-by=/usr/share/keyrings/gunamaya.gpg] https://gunamaya.com/linux/apt stable main" | sudo tee /etc/apt/sources.list.d/gunamaya.list
sudo apt update && sudo apt install gunamaya

Linux-specific notes

1

Missing shared libraries on minimal distributions

If Gunamaya fails to start with an error about a missing .so file, your distribution's minimal base image is likely missing a GTK or libnss dependency that most desktop-oriented installs already have. Install your distribution's gtk3 and libnss3 (or equivalently named) packages.

2

File watchers and inotify limits

Very large workspaces can exceed the default Linux limit on the number of files a process can watch for changes, which shows up as a warning about file watching being disabled for part of your workspace. Raise the limit with:

echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
3

Wayland vs. X11

Gunamaya runs on both. If you notice window-dragging or fractional-scaling quirks under Wayland, launching with the --ozone-platform=wayland flag forces native Wayland rendering instead of falling back to XWayland.

Uninstalling

# Debian/Ubuntu
sudo apt remove gunamaya
 
# Fedora/RHEL
sudo rpm -e gunamaya

Configuration and extensions live in ~/.config/Gunamaya and ~/.gunamaya and are left in place after uninstalling so a future reinstall picks up your settings again — see Portable Mode & Uninstalling to remove those too.