Installation

System requirements

Minimum RAM: 256 MB. Disk space: ~80 MB installed. An internet connection is required to check for updates and load the plugin marketplace; SSH connections are fully offline.

Download

Grab the latest release from the GitHub Releases page or use the Download page to get the right build for your OS automatically.

• Linux — .deb, .rpm, .AppImage, or .tar.gz
• Windows — .exe (NSIS installer)
• macOS — .dmg (universal)

One-line install (Linux)

The quickest way to get started on Linux — detects your architecture and installs the latest AppImage:

$curl -fsSL https://zync.thesudoer.in/install.sh | sh

Installs to ~/.local/share/zync/, adds a symlink at ~/.local/bin/zync, and registers a .desktop entry. Currently supports x86_64. No sudo required.

Linux

Debian / Ubuntu (APT repository)

The recommended method for Debian-based distros — keeps Zync up-to-date via apt upgrade:

 # 1. Add the GPG key$curl -fsSL https://apt.zync.thesudoer.in/key.gpg | sudo gpg --dearmor -o /etc/apt/keyrings/zync.gpg  # 2. Add the repository$echo "deb [signed-by=/etc/apt/keyrings/zync.gpg] https://apt.zync.thesudoer.in stable main" | sudo tee /etc/apt/sources.list.d/zync.list  # 3. Update and install$sudo apt update && sudo apt install zync

Other Linux

• Debian / Ubuntu (manual .deb) — sudo dpkg -i zync_*.deb. If you get dependency errors: sudo apt-get install -f.
• Fedora / RHEL / openSUSE (.rpm) — sudo rpm -i zync-*.rpm or sudo dnf install ./zync-*.rpm.
• AppImage — chmod +x zync-*.AppImage && ./zync-*.AppImage. Self-contained, no install needed. Works on any x86_64 distro.
• tar.gz — tar -xzf zync-*.tar.gz && ./zync. Move the binary to /usr/local/bin/ for system-wide access.

Some minimal distributions may be missing WebKit2GTK or GTK3. Install them with: sudo apt install libwebkit2gtk-4.1-0 libgtk-3-0 (Debian/Ubuntu) or the equivalent for your distro.

Windows

To bypass the SmartScreen warning:

1. Download the .exe installer from the Releases page.
2. Double-click the installer. When the SmartScreen dialog appears, click More info.
3. Click Run anyway.
4. Proceed through the installer — choose per-user (no admin required) or machine-wide installation.

Zync will appear in the Start Menu after installation. The installer downloads WebView2 automatically if it's not already present (most Windows 10/11 systems already have it via Edge).

macOS

Method 1 — Right-click to open (easiest):

1. Open the .dmg and drag Zync.app to /Applications.
2. In Finder, right-click (or Control-click) Zync.app and choose Open.
3. A dialog will appear asking if you're sure — click Open. macOS remembers this choice for future launches.

Method 2 — System Settings:

1. Try to open Zync normally — it will be blocked.
2. Go to System Settings → Privacy & Security and scroll down to the Security section.
3. You'll see a message saying Zync was blocked. Click Open Anyway.

Method 3 — Terminal (if the app shows "damaged"):

$xattr -cr /Applications/Zync.app

This clears the quarantine extended attribute that macOS sets when an app is downloaded from the internet. After running this command, Zync will open normally.

The macOS build is a universal binary that runs natively on both Apple Silicon (M1/M2/M3) and Intel Macs.

Updates

Zync checks for updates in the background on launch. When a new version is available, a notification appears in Settings → About. Click Download Update to fetch it, then Install & Restart to apply. On Linux (APT install), updates also come through apt upgrade.

Uninstall

One-line uninstall (script install)

$curl -fsSL https://zync.thesudoer.in/uninstall.sh | sh

Removes: ~/.local/share/zync/, the ~/.local/bin/zync symlink, the .desktop entry, and the icon. Your connection data in ~/.local/share/zync/data/ is also removed — back up your connections first if needed.

Other Linux

• APT — sudo apt remove zync. To also remove the repo: sudo rm /etc/apt/sources.list.d/zync.list /etc/apt/keyrings/zync.gpg
• .deb (manual) — sudo dpkg -r zync
• .rpm — sudo rpm -e zync or sudo dnf remove zync
• AppImage — Delete the .AppImage file. No system-wide files are created.

Windows

Go to Settings → Apps → Installed apps, find Zync, and click Uninstall.

macOS

Drag Zync.app from /Applications to the Trash. To also remove app data: rm -rf ~/Library/Application\ Support/zync.

Troubleshooting

• Linux: "error while loading shared libraries: libwebkit2gtk" — Install the missing library: sudo apt install libwebkit2gtk-4.1-0 or sudo dnf install webkit2gtk4.1.
• Linux AppImage won't launch — Make sure it's executable: chmod +x zync-*.AppImage. On some distros you may also need libfuse2: sudo apt install libfuse2.
• macOS: "Zync is damaged and can't be opened" — Run xattr -cr /Applications/Zync.app to clear the quarantine attribute, then try launching again.
• Windows: WebView2 error on startup — Download and install the WebView2 Runtime manually from Microsoft.
• App data not found after reinstall — Connection and settings data is stored in ~/.local/share/zync/ (Linux), %APPDATA%\zync (Windows), or ~/Library/Application Support/zync (macOS). Back this up before uninstalling if you want to preserve your connections.