Install the Desktop App

The Wayland desktop app runs on macOS, Windows, and Linux. Download it from getwayland.com/download, then follow the steps for your platform.

The app bundles the Wayland Core engine for your platform and architecture, so there is nothing else to install to start working.

macOS

1. Download the .dmg for your chip (Apple silicon or Intel).
2. Open the .dmg and drag Wayland into Applications.
3. Launch it from Applications.

macOS

The macOS builds are signed and notarized by Apple, so they open normally with no Gatekeeper workaround.

Windows

1. Download the .exe installer (NSIS).
2. Run it. The installer requests elevation so it can install for all users.
3. Launch Wayland from the Start menu.

SmartScreen

Until the Microsoft signing certificate lands, Windows SmartScreen may warn about an unrecognized publisher. Choose More info -> Run anyway to proceed.

Linux

Wayland ships three Linux formats. Pick the one that matches your distribution:

• AppImage: download, chmod +x it, and run. No install required.
• .deb: sudo apt install ./Wayland-*.deb on Debian and Ubuntu.
• .rpm: sudo dnf install ./Wayland-*.rpm on Fedora and RHEL-family systems.

Linux is new

Linux builds compile and run, but they have had less hardware testing than macOS and Windows. If you hit a problem, please report it on GitHub.

What is bundled

Each installer carries the matching wayland-core engine binary for your platform and architecture. The desktop app finds it automatically on first run. You do not need to install Wayland Core separately to use the desktop app. If you also want the engine on your PATH for scripting, see Install Wayland Core.

Next

After the app installs, the first launch walks you through onboarding. See First Run and Onboarding.