How do I download and install Windsurf Editor on macOS/Windows/Linux?

Most developers don’t want to fight installers—they just want to get into flow and ship. Windsurf Editor is built for that: fast downloads, native installers, and updates that mostly take care of themselves. This guide walks you through how to download and install Windsurf Editor on macOS, Windows, and Linux, plus how to handle old versions and early-access builds.

Quick Answer: Go to the Windsurf Editor download page, choose your OS (macOS, Windows, or Linux), grab the installer that matches your architecture (Apple Silicon vs Intel, x64 vs arm64), run it, and you’re in. Auto-updates are on by default; you can switch to manual if your org needs strict version control.

---

The Quick Overview

• What It Is: Windsurf Editor is an AI-native IDE built to keep you in flow state, combining Cascade (agentic collaborator), Tab (workflow-wide autocomplete and actions), Browser, Previews, and Deploys in one environment.
• Who It Is For: Individual developers and engineering teams who want powerful AI coding superpowers without giving up control, especially those shipping in security-conscious or enterprise environments.
• Core Problem Solved: Eliminate context-switching and glue work—no more bouncing between IDE, terminal, browser, and chat tools. Windsurf keeps the agent in sync with your edits, commands, and previews, so you can see it, shape it, and ship it from one place.

---

How It Works

From an installation perspective, Windsurf behaves like a modern desktop IDE:

• You download a platform-native build (DMG on macOS, EXE/installer on Windows, DEB/TAR/RPM on Linux).
• On first launch, Windsurf boots into the Windsurf Editor, where you can open a local repo or folder, connect to GitHub, and start coding with Cascade and Tab.
• Auto-update keeps you on the latest stable unless you explicitly switch to manual/none in settings—handy for enterprises that pin versions.

At a high level, installation flows like this:

1. Choose your platform & architecture:
   Confirm your OS (macOS, Windows, Linux) and hardware (Apple Silicon vs Intel, x64 vs arm64).

2. Download the right installer:
   From the download page, select the correct variant (e.g., “Download for Apple Silicon”, “Windows x64”, “Linux x64 .deb”).

3. Install & launch Windsurf Editor:
   Use your OS’s standard install path (drag to Applications on macOS, system installer or standalone EXE on Windows, package manager or tarball on Linux). On first launch, open a project and start using Cascade (Cmd/Ctrl+I), Tab, and the integrated surfaces (Terminal, Browser, Previews).

---

macOS: Download and Install Windsurf Editor

Windsurf ships native builds for:

• Apple Silicon (.dmg)
• Intel macOS (.dmg and archive .zip)

macOS prerequisites

• Supported versions: macOS versions that still receive Apple security updates (typically the latest + previous two major releases).
• Not supported: macOS 10.15 (Catalina) and earlier.

Step 1: Download Windsurf for macOS

1. Go to the Windsurf Editor download page.
2. Under Mac, choose:
   • Download for Apple Silicon if you’re on M1/M2/M3 hardware.
   • Download for Intel if you’re on older Intel-based Macs.
3. Download the .dmg (recommended). Advanced users can opt for the .zip archive if they want a portable build.

Step 2: Install Windsurf on macOS

1. Open the downloaded .dmg file.
2. Drag Windsurf into your Applications folder.
3. Eject the Windsurf disk image after the copy completes.

If you downloaded the .zip:

1. Unzip the archive.
2. Move the Windsurf app into Applications (or another preferred location).

Step 3: Handle macOS Gatekeeper prompts

On first launch, macOS might warn you about running an app from the internet:

1. Right-click (or Ctrl+click) the Windsurf app in Applications.
2. Click Open, then confirm you want to open it.
3. Subsequent launches can be done via Spotlight, Dock, or Finder as normal.

Step 4: First launch setup on macOS

Once Windsurf Editor opens:

• Open a folder or repo.
• Hit Cmd+I inside the editor or terminal to bring up Cascade.
• Start coding—Tab will surface context-aware suggestions as you type.

Auto-updates will keep Windsurf current by default (you can change this later in settings).

---

Windows: Download and Install Windsurf Editor

Windsurf provides native installers for both x64 and arm64:

• Windows x64 (.exe) + System Installer (.exe)
• Windows arm64 (.exe) + System Installer (.exe)
• Archive .zip options if you prefer a portable-style install.

Windows prerequisites

• Supported versions: Windows 10 (64‑bit) or later.
• Architectures: x64 and arm64.

Step 1: Download Windsurf for Windows

1. Go to the Windsurf Editor download page.
2. Under Windows, choose:
   • Download for x64 if you’re on a standard 64-bit PC.
   • Download for arm64 if you’re on an ARM-based Windows device.
3. Pick your preferred format:
   • Standard Installer (.exe): For user-level installs.
   • System Installer (.exe): For machine-wide installs (typical in managed enterprise environments).
   • Archive (.zip): For portable deployments or custom locations.

Step 2: Install Windsurf on Windows

For the regular .exe installer:

1. Double-click the downloaded .exe.
2. Follow the setup wizard prompts:
   • Accept the license terms.
   • Choose an install location (default is fine for most users).
   • Decide if you want a desktop/start menu shortcut.
3. Click Install, then Finish.

For the System Installer:

• Run the installer with admin privileges.
• Follow the prompts for a per-machine installation—helpful when rolling out via IT.

For the .zip archive:

1. Extract the archive to your desired directory (e.g., C:\Tools\Windsurf).
2. Run windsurf.exe from that directory.
3. Optionally, add a shortcut to the Start menu or taskbar.

Step 3: First launch setup on Windows

• Launch Windsurf from the Start menu, desktop, or your chosen folder.
• Open your project directory.
• Use Ctrl+I in the editor or terminal to invoke Cascade.
• Start iterating with Tab-driven completions and integrated tools like Browser and Previews.

Auto-updates are enabled by default; they’ll run in the background and prompt when needed.

---

Linux: Download and Install Windsurf Editor

Linux gets full first-class support with:

• DEB packages for Debian/Ubuntu.
• RPM packages via dnf for Fedora/RHEL (using the Windsurf repo).
• .tar.gz source tarballs for x64 and ARM64, for other distributions.

Linux prerequisites

• Minimum libraries:
  • glibc >= 2.28
  • glibcxx >= 3.4.25
• Typical compatible distros:
  • Ubuntu 20.04+
  • Debian 10+
  • Fedora 36+
  • RHEL 8+

Option 1: Install Windsurf on Debian/Ubuntu (DEB-based)

For deb-based distros (Ubuntu 20.04+, Debian 10+), you can add the Windsurf repository and install via apt.

Step 1: Add the Windsurf repository

In a terminal:

sudo apt-get update
sudo apt-get install -y wget gpg

# Download and install the GPG key
wget -qO- "https://windsurf-stable.codeiumdata.com/wVxQEIWkwPUEAGf3/windsurf.gpg" | \
  gpg --dearmor > windsurf-stable.gpg
sudo install -D -o root -g root -m 644 windsurf-stable.gpg /etc/apt/keyrings/windsurf-stable.gpg

# Add the Windsurf repo to sources.list.d
echo "deb [signed-by=/etc/apt/keyrings/windsurf-stable.gpg] https://windsurf-stable.codeiumdata.com/wVxQEIWkwPUEAGf3 stable main" | \
  sudo tee /etc/apt/sources.list.d/windsurf-stable.list

(If your organization has custom repo policies, you can mirror or wrap this repository as needed.)

Step 2: Install Windsurf via apt

sudo apt-get update
sudo apt-get install -y windsurf

You can then run windsurf from your application launcher or the terminal.

Option 2: Install Windsurf on Fedora/RHEL (RPM-based via dnf)

Windsurf can be installed via dnf on supported RPM-based distros like Fedora 36+ and RHEL 8.

Step 1: Configure the Windsurf repo

Windsurf provides a repo file. The simplest path is:

1. Download the repo configuration from the Windsurf documentation or download page.
2. Place it under /etc/yum.repos.d/ (e.g., windsurf.repo).

(If your team prefers, you can manually create the repo file pointing to the Windsurf stable URL.)

Step 2: Install Windsurf via dnf

sudo dnf install -y windsurf

This will install Windsurf system-wide and wire it into your desktop environment’s launcher.

Option 3: Install Windsurf from tarball (other distributions)

If you’re on a different distribution, or you prefer a manual install:

1. Go to the Windsurf download page.
2. Under Linux, choose:
   • Linux x64 (.tar.gz), or
   • ARM64 source tarball, depending on your architecture.
3. Extract the tarball:

tar -xzf windsurf-linux-x64.tar.gz -C ~/apps

4. Run Windsurf:

~/apps/windsurf/windsurf

You can add a .desktop file or alias for easier launch if you like.

---

Features & Benefits Breakdown (Post-Install)

Once you’ve installed Windsurf Editor, here’s what you get out of the box:

Core Feature	What It Does	Primary Benefit
Cascade	Tracks your edits, terminal commands, clipboard, and conversation history to stay in sync with your flow and execute multi-step coding tasks.	Lets you build and refactor entire features without re-explaining context or micromanaging file-by-file changes.
Tab	Powers autocomplete and workflow-wide actions (“Tab to Import,” “Tab to Jump”) based on everything you’ve done in the editor.	Reduces friction in the tight loop—type less, navigate faster, and stay locked in flow instead of hunting for files or imports.
Browser & Previews	Pulls in real-time web context and shows live previews of your app right inside the IDE, where you can click elements and ask for changes.	See it, shape it, ship it—all without leaving Windsurf; perfect for UI iteration and full-stack dev.

---

Ideal Use Cases

• Best for individual devs wanting a single, AI-native IDE:
  Because Windsurf combines chat-like collaboration (Cascade), deep autocomplete (Tab), terminal help, Previews, and Deploys in one install—so you don’t juggle extensions or external tools.

• Best for teams with security and governance needs:
  Because Windsurf pairs its agentic IDE with enterprise controls: SOC 2 Type II posture, FedRAMP High environment options, automated zero data retention defaults for Teams/Enterprise, SSO/RBAC, Hybrid and Self-hosted deployments, and admin analytics.

---

Limitations & Considerations

• OS version boundaries:
  macOS 10.15 and older are not supported, and Linux requires glibc >= 2.28 and glibcxx >= 3.4.25. If you’re on legacy environments, you may need OS upgrades or containerized setups to run Windsurf.

• Auto-update behavior for regulated teams:
  By default, Windsurf auto-updates to the latest version. If your organization requires pinned versions or controlled rollout, you’ll need to set Update: Mode to manual or none in Windsurf’s settings and manage updates via your internal tooling.

---

Managing Updates, Old Versions, and Windsurf Next

Auto-updates (default behavior)

• Windsurf auto-updates to the latest stable version by default on all platforms.
• Updates are surfaced in the IDE with prompts; in most cases you just accept and keep shipping.

Staying on an older version

If you need to freeze on a specific version:

1. Open Settings in Windsurf.
2. Find the Update configuration.
3. Set Mode to manual or none.

You can then:

• View all releases from the download/release page.
• Download the specific version you want and deploy it via your org’s standard software management.

Trying early features with Windsurf Next

If you’re comfortable with pre-release builds:

• Install Windsurf Next from the download page to get early access to upcoming features.
• This is especially useful for teams testing new agentic capabilities, MCP integrations, or workflow changes before standardizing them across the org.

---

Frequently Asked Questions

Do I need admin rights to install Windsurf Editor?

Short Answer: Not always—it depends on how you install it and your OS.

Details:

• macOS: Dragging the app into your user’s Applications folder typically doesn’t require admin rights. Installing into the system-wide /Applications may.
• Windows: The System Installer usually requires admin privileges for a machine-wide install. The user-level .exe or .zip options can often be installed without admin rights, depending on your IT policies.
• Linux: Package manager installs (apt, dnf) require sudo. Tarball-based installs can be done in user space (~/apps) without elevated permissions.

---

How do I keep Windsurf in sync with my enterprise security requirements?

Short Answer: Use the built-in controls (ZDR defaults, manual update mode) and choose the right deployment model (Cloud, Hybrid, or Self-hosted).

Details:

• By default, Windsurf Teams/Enterprise can be configured with automated zero data retention so code and prompts aren’t stored beyond what’s needed to service requests.
• You can:
  • Enforce SSO and RBAC for access control.
  • Use Hybrid deployment (e.g., via Docker Compose + Cloudflare Tunnel) to keep code and tools on-prem while using Windsurf’s models.
  • Run Self-hosted via Docker Compose or Helm if you need full control within your own infrastructure, including EU or FedRAMP environments.
• Pair this with manual update mode plus your org’s software distribution to align with internal change-management and audit requirements.

---

Summary

Installing Windsurf Editor on macOS, Windows, or Linux is straightforward: grab the right binary for your architecture, run the standard installer (or package manager / tarball), and you’re coding with Cascade and Tab in minutes. Under the hood, Windsurf is backing that smooth setup with serious scale (1M+ users, 4,000+ enterprise customers, 70M+ lines of AI-written code every day) and enterprise-grade controls (ZDR defaults, SSO, RBAC, Hybrid/Self-hosted).

Once it’s installed, the real value kicks in: no more juggling tools or re-explaining context. Your edits, commands, Previews, and PRs all live in one agent-aware IDE—built to keep you in flow state.

---

Next Step

Get Started