Installation

Get Zync running on your machine. Official builds are available for Linux, Windows, and macOS.

Help sign Zync for Windows & macOS

Signed releases mean no SmartScreen or Gatekeeper warnings for anyone.

System requirements

Platform	Minimum version	Notes
Linux	Ubuntu 20.04 / Debian 11 or equivalent	Requires WebKit2GTK 4.1+, GTK 3. x86_64 only.
Windows	Windows 10 (build 1803+) or Windows 11	Uses WebView2 (auto-installed with Edge/Windows Update).
macOS	macOS 11 Big Sur+	Universal binary (Apple Silicon + Intel).

System resources

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

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

bash·install.sh

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

Installation details

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

Debian / Ubuntu (APT repository)

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

bash·Terminal

 # 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.

Missing dependencies on minimal distros

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.

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)

bash·uninstall.sh

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

Data will be removed

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.