How to Download & Install Sajest on Linux

Sajest ships as an AppImage (works on any distro) and a .deb package (for Ubuntu/Debian). This guide covers both installation methods and common issues.

---

Option A — AppImage (recommended, any distro)

AppImage requires no installation. It runs directly as a single file.

1. Download

Go to the Download page and download Sajest-x.x.x.AppImage.

2. Make it executable

chmod +x ~/Downloads/Sajest-*.AppImage

3. Run

~/Downloads/Sajest-*.AppImage

Or double-click it in your file manager.

4. Optional — integrate with desktop

Install AppImageLauncher to add Sajest to your app menu and handle automatic updates.

# Ubuntu/Debian
sudo apt install appimagelauncher

---

Option B — .deb package (Ubuntu / Debian)

1. Download

Download sajest_x.x.x_amd64.deb from the Download page.

2. Install

sudo dpkg -i ~/Downloads/sajest_*.deb
sudo apt-get install -f  # fix any missing dependencies

3. Launch

sajest
# or find it in your applications menu

---

Common Issues & Fixes

"Permission denied" when running AppImage

chmod +x Sajest-*.AppImage

---

"No such file or directory" / FUSE error

AppImage requires FUSE to run. Many modern distros ship without it.

Fix — Ubuntu/Debian:

sudo apt install libfuse2

Fix — Fedora/RHEL:

sudo dnf install fuse fuse-libs

Fix — Arch:

sudo pacman -S fuse2

Alternative — extract and run without FUSE:

./Sajest-*.AppImage --appimage-extract
./squashfs-root/AppRun

---

App opens but shows blank screen

Usually a GPU/sandbox issue common on Electron apps.

Fix:

./Sajest-*.AppImage --no-sandbox --disable-gpu

If that works, create a desktop entry with those flags:

cat > ~/.local/share/applications/sajest.desktop << EOF
[Desktop Entry]
Name=Sajest
Exec=/path/to/Sajest-*.AppImage --no-sandbox --disable-gpu
Type=Application
Categories=Utility;
EOF

---

"The SUID sandbox helper binary was found, but is not configured correctly"

sudo chmod 4755 /path/to/sajest/chrome-sandbox

Or run with --no-sandbox flag as shown above.

---

Microphone not working

Check PulseAudio/PipeWire:

# Check if PulseAudio is running
pulseaudio --check
# or for PipeWire
systemctl --user status pipewire

Grant permission (Flatpak/Snap environments): If you're running in a restricted environment, make sure Sajest has access to the audio device:

# Check audio devices
arecord -l

Ensure your user is in the audio group:

sudo usermod -aG audio $USER
# log out and back in

---

Missing shared libraries (libnss, libgbm, etc.)

Ubuntu/Debian:

sudo apt install libgbm1 libnss3 libatk-bridge2.0-0 libgtk-3-0 libx11-xcb1

Fedora:

sudo dnf install nss atk at-spi2-atk gtk3 libX11-xcb

---

Screen recording / display capture not working on Wayland

Electron has limited Wayland screen capture support. Run Sajest under XWayland instead:

ELECTRON_OZONE_PLATFORM_HINT=x11 ./Sajest-*.AppImage

Or force X11 session at login if you need full screen capture support.

---

How to uninstall

AppImage:

rm ~/Downloads/Sajest-*.AppImage
rm -rf ~/.config/sajest

.deb:

sudo dpkg -r sajest
rm -rf ~/.config/sajest