Prerequisites

The first step is to install Rust and System Dependencies. Keep in mind that this setup is only needed for developing Tauri apps. Your end-users are not required to do any of this. You'll need an internet connection for the download.

Setting Up Windows

For those using the Windows Subsystem for Linux (WSL), please refer to our Linux specific instructions instead.

On Windows, go to https://www.rust-lang.org/tools/install to install rustup the Rust installer. You also need to install Microsoft Visual Studio C++ build tools. The easiest way is to install Build Tools for Visual Studio 2019. When asked which workloads to install, ensure "C++ build tools" and the Windows 10 SDK are selected.

Install WebView2

WebView2 is pre-installed in Windows 11.

Tauri heavily depends on WebView2 to render web content on Windows, therefore you must have WebView2 installed. The easiest way is to download and run the Evergreen Bootstrapper from the official website.
The bootstrapper script will try to determine the correct architecture and version for your system. Still, if you run into issues - especially with Windows on ARM - you can select te correct Standalone Installer or even a fixed version.

Setting Up macOS

To install Rust on macOS, open a terminal and enter the following command:

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

We have audited this bash script, and it does what it says it is supposed to do. Nevertheless, before blindly curl-bashing a script, it is always wise to look at it first. Here is the file as a plain download link.

The command downloads a script and starts the installation of the rustup tool, which installs the latest stable version of Rust. You might be prompted for your password. If the installation was successful, the following line will appear:

Rust is installed now. Great!

You also need to install CLang and macOS development dependencies. To do this, run the following command in your terminal:

xcode-select --install

Setting Up Linux

To install Rust on Linux, open a terminal and enter the following command:

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

We have audited this bash script, and it does what it says it is supposed to do. Nevertheless, before blindly curl-bashing a script, it is always wise to look at it first. Here is the file as a plain download link.

Rust is installed now. Great!

You also need to install a couple of system dependencies, such as a C compiler and webkit2gtk. Below are commands for a few popular distributions.

Debian

sudo apt update
sudo apt install libwebkit2gtk-4.0-dev \
    build-essential \
    curl \
    wget \
    libssl-dev \
    libgtk-3-dev \
    libappindicator3-dev \
    librsvg2-dev

Arch

sudo pacman -Syu
sudo pacman -S --needed \
    webkit2gtk \
    base-devel \
    curl \
    wget \
    openssl \
    appmenu-gtk-module \
    gtk3 \
    libappindicator-gtk3 \
    librsvg \
    libvips

Fedora

sudo dnf check-update
sudo dnf install webkit2gtk3-devel.x86_64 \
    openssl-devel \
    curl \
    wget \
    libappindicator-gtk3 \
    librsvg2-devel
sudo dnf group install "C Development Tools and Libraries"

Windows Subsystem for Linux (WSL)

To run a graphical application with WSL, you need to download one of these X servers: Xming, Cygwin X, and vcXsrv. Since vcXsrv has been used internally, it's the one we recommend installing.

WSL Version 1

Open the X server and then run

export DISPLAY=:0

in the terminal. You should now be able to run any graphical application via the terminal.

WSL Version 2

You'll need to run a command that is slightly more complex than WSL 1:

export DISPLAY=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}'):0

and you need to add -ac to the X server as an argument. If for some reason this command doesn't work you can use an alternative command such as:

export DISPLAY=$(cat /etc/resolv.conf | grep nameserver | sed 's/.* //g'):0

or you can manually find the Address using:

cat /etc/resolve.conf | grep nameserver

Don't forget that you'll have to use the "export" command anytime you want to use a graphical application for each newly opened terminal.

You can download some examples to try with sudo apt-get install x11-apps. xeyes is always a good one. It can be handy when troubleshooting WSL issues.

Updating and Uninstalling

Tauri and its components can be manually updated by editing the Cargo.toml file or running the cargo upgrade command that is part of the cargo-edit tool. Open a terminal and enter the following command:

cargo upgrade

Updating Rust itself is easy via rustup. Open a terminal and run the following command:

rustup update

rustup can also be used to uninstall Rust from your machine fully:

rustup self uninstall

Troubleshooting

To check whether you have Rust installed correctly, open a shell and enter this line:

rustc --version

You should see the version number, commit hash, and commit date for the latest stable version that has been released in the following format:

rustc x.y.z (abcabcabc yyyy-mm-dd)

If you don't see this information, your Rust installation might be broken. Please consult Rust's Troubleshooting Section on how to fix this. If your problems persist, you can get help from the official Tauri Discord and GitHub Discussions.

The Tauri Documentation WIP