▸ Agent Skills
6 min read

Prerequisites

In order to get started building your project with Tauri you’ll first need to install a few dependencies:

  1. System Dependencies
  2. Rust
  3. Configure for Mobile Targets (only required if developing for mobile)

System Dependencies

Follow the link to get started for your respective operating system:

Linux

Tauri requires various system dependencies for development on Linux. These may be different depending on your distribution but we’ve included some popular distributions below to help you get setup.

sudo apt updatesudo apt install libwebkit2gtk-4.1-dev \  build-essential \  curl \  wget \  file \  libxdo-dev \  libssl-dev \  libayatana-appindicator3-dev \  librsvg2-dev

Terminal window

sudo pacman -Syusudo pacman -S --needed \  webkit2gtk-4.1 \  base-devel \  curl \  wget \  file \  openssl \  appmenu-gtk-module \  libappindicator-gtk3 \  librsvg \  xdotool

Terminal window

sudo dnf check-updatesudo dnf install webkit2gtk4.1-devel \  openssl-devel \  curl \  wget \  file \  libappindicator-gtk3-devel \  librsvg2-devel \  libxdo-develsudo dnf group install "c-development"

Terminal window

sudo emerge --ask \  net-libs/webkit-gtk:4.1 \  dev-libs/libayatana-appindicator \  net-misc/curl \  net-misc/wget \  sys-apps/file

Terminal window

sudo rpm-ostree install webkit2gtk4.1-devel \  openssl-devel \  curl \  wget \  file \  libappindicator-gtk3-devel \  librsvg2-devel \  libxdo-devel \  gcc \  gcc-c++ \  makesudo systemctl reboot

Terminal window

sudo zypper upsudo zypper in webkit2gtk3-devel \  libopenssl-devel \  curl \  wget \  file \  libappindicator3-1 \  librsvg-develsudo zypper in -t pattern devel_basis

Terminal window

sudo apk add \  build-base \  webkit2gtk-4.1-dev \  curl \  wget \  file \  openssl \  libayatana-appindicator-dev \  librsvg

Terminal window

Note: Alpine Linux containers don’t include any fonts by default. To ensure text renders correctly in your Tauri app, install at least one font package (for example, font-dejavu ).

Note: Alpine targets the musl C library, so Rust builds link a number of system libraries statically. If cargo/pnpm tauri build fails with linker errors for symbols from libraries that pkg-config reports as present, install the matching *-static packages alongside the -dev ones above:

sudo apk add --no-cache \  openssl-libs-static \  cairo-static \  harfbuzz-static \  glib-static \  wayland-static \  zlib-static

Terminal window

Not every dependency Tauri pulls in is packaged as *-static on Alpine; in those cases you may need to build the missing static library from source.

If your distribution isn’t included above then you may want to check Awesome Tauri on GitHub to see if a guide has been created.

Next: Install Rust

macOS

Tauri uses Xcode and various macOS and iOS development dependencies.

Download and install Xcode from one of the following places:

Be sure to launch Xcode after installing so that it can finish setting up.

Only developing for desktop targets?

If you’re only planning to develop desktop apps and not targeting iOS then you can install Xcode Command Line Tools instead:

xcode-select --install

Terminal window

Next: Install Rust

Windows

Tauri uses the Microsoft C++ Build Tools for development as well as Microsoft Edge WebView2. These are both required for development on Windows.

Follow the steps below to install the required dependencies.

Microsoft C++ Build Tools

  1. Download the Microsoft C++ Build Tools installer and open it to begin installation.
  2. During installation check the “Desktop development with C++” option.

Visual Studio C++ Build Tools installer screenshot

Next: Install WebView2.

WebView2

Tauri uses Microsoft Edge WebView2 to render content on Windows.

Install WebView2 by visiting the WebView2 Runtime download section. Download the “Evergreen Bootstrapper” and install it.

Next: Check VBSCRIPT

VBSCRIPT (for MSI installers)

Building MSI packages on Windows requires the VBSCRIPT optional feature to be enabled. This feature is enabled by default on most Windows installations, but may have been disabled on some systems.

If you encounter errors like failed to run light.exe when building MSI packages, you may need to enable the VBSCRIPT feature:

  1. Open Settings → Apps → Optional features → More Windows features
  2. Locate VBSCRIPT in the list and ensure it’s checked
  3. Click Next and restart your computer if prompted

Note: VBSCRIPT is currently enabled by default on most Windows installations, but is being deprecated and may be disabled in future Windows versions.

Next: Install Rust

Rust

Tauri is built with Rust and requires it for development. Install Rust using one of following methods. You can view more installation methods at https://www.rust-lang.org/tools/install.

Install via rustup using the following command:

curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh

Terminal window

Visit https://www.rust-lang.org/tools/install to install rustup.

Alternatively, you can use winget to install rustup using the following command in PowerShell:

winget install --id Rustlang.Rustup

Terminal window

Be sure to restart your Terminal (and in some cases your system) for the changes to take effect.

Next: Configure for Mobile Targets if you’d like to build for Android and iOS, or, if you’d like to use a JavaScript framework, install Node. Otherwise Create a Project.

Node.js

  1. Go to the Node.js website, download the Long Term Support (LTS) version and install it.
  2. Check if Node was successfully installed by running:
node -v# v20.10.0npm -v# 10.2.3

Terminal window

It’s important to restart your Terminal to ensure it recognizes the new installation. In some cases, you might need to restart your computer.

While npm is the default package manager for Node.js, you can also use others like pnpm or yarn. To enable these, run corepack enable in your Terminal. This step is optional and only needed if you prefer using a package manager other than npm.

Next: Configure for Mobile Targets or Create a project.

Configure for Mobile Targets

If you’d like to target your app for Android or iOS then there are a few additional dependencies that you need to install:

Android

  1. Download and install Android Studio from the Android Developers website
  2. Set the JAVA_HOME environment variable:
export JAVA_HOME=/opt/android-studio/jbr

Terminal window

export JAVA_HOME="/Applications/Android Studio.app/Contents/jbr/Contents/Home"

Terminal window

[System.Environment]::SetEnvironmentVariable("JAVA_HOME", "C:\Program Files\Android\Android Studio\jbr", "User")

Terminal window

  1. Use the SDK Manager in Android Studio to install the following:
  • Android SDK Platform
  • Android SDK Platform-Tools
  • NDK (Side by side)
  • Android SDK Build-Tools
  • Android SDK Command-line Tools

Selecting “Show Package Details” in the SDK Manager enables the installation of older package versions. Only install older versions if necessary, as they may introduce compatibility issues or security risks.

  1. Set ANDROID_HOME and NDK_HOME environment variables.
export ANDROID_HOME="$HOME/Android/Sdk"export NDK_HOME="$ANDROID_HOME/ndk/$(ls -1 $ANDROID_HOME/ndk)"

Terminal window

export ANDROID_HOME="$HOME/Library/Android/sdk"export NDK_HOME="$ANDROID_HOME/ndk/$(ls -1 $ANDROID_HOME/ndk)"

Terminal window

[System.Environment]::SetEnvironmentVariable("ANDROID_HOME", "$env:LocalAppData\Android\Sdk", "User")$VERSION = Get-ChildItem -Name "$env:LocalAppData\Android\Sdk\ndk" | Select-Object -Last 1[System.Environment]::SetEnvironmentVariable("NDK_HOME", "$env:LocalAppData\Android\Sdk\ndk\$VERSION", "User")

Terminal window

  1. Add the Android targets with rustup:
rustup target add aarch64-linux-android armv7-linux-androideabi i686-linux-android x86_64-linux-android

Terminal window

Next: Setup for iOS or Create a project.

iOS

  1. Add the iOS targets with rustup in Terminal:
rustup target add aarch64-apple-ios x86_64-apple-ios aarch64-apple-ios-sim

Terminal window

  1. Install Homebrew:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Terminal window

  1. Install Cocoapods using Homebrew:
brew install cocoapods

Terminal window

Next: Create a project.

Troubleshooting

If you run into any issues during installation be sure to check the Troubleshooting Guide or reach out on the Tauri Discord.

Next Steps

Now that you’ve installed all of the prerequisites you’re ready to create your first Tauri project!

Support on Open CollectiveSponsor on GitHub

© 2026 Tauri Contributors. CC-BY / MIT

Last updated Oct 08, 2026