
So you’re trying to build or run a Tauri app, but keep hitting those annoying dependency errors? Don’t worry – it happens to everyone! Let’s fix those problems in plain, everyday language without any fancy tech talk.
What’s Going On?
When building Tauri apps on Ubuntu or Debian, you might see errors like:
1 2 |
The system library `libsoup-3.0` required by crate `soup3-sys` was not found. |
or
1 2 |
The system library `webkit2gtk-4.1` required by crate `webkit2gtk-sys` was not found. |
This is just your system telling you it’s missing some packages that Tauri needs to work properly.
The Quick Fix
Open up your terminal and run this command to install all the dependencies you need:
1 2 3 |
sudo apt update sudo apt install libwebkit2gtk-4.1-dev libsoup-3.0-dev libjavascriptcoregtk-4.1-dev libgtk-3-dev build-essential curl wget libappindicator3-dev librsvg2-dev patchelf |
This single command will grab everything you need for Tauri version 2 apps on newer Ubuntu/Debian systems (Ubuntu 22.04+).
Important Version Differences
Tauri comes in two main versions that need different packages:
- Tauri v1: Needs the older
libwebkit2gtk-4.0-dev
(works on Ubuntu 18.04+) - Tauri v2: Needs the newer
libwebkit2gtk-4.1-dev
(works on Ubuntu 22.04+)
If you’re building a Tauri v1 app on a newer system, you’ll need this command instead:
1 2 3 |
sudo apt update sudo apt install libwebkit2gtk-4.0-dev build-essential curl wget libssl-dev libgtk-3-dev libayatana-appindicator3-dev librsvg2-dev |
For Ubuntu 24.04 Users
If you’re on the very latest Ubuntu 24.04, you might have trouble finding the older libwebkit2gtk-4.0-dev
package which Tauri v1 needs. In this case, you have two options:
- Upgrade your project to Tauri v2 (recommended)
- Use an AppImage build instead (which bundles dependencies)
Running Tauri Apps (Not Building Them)
If you’re just trying to RUN (not build) a Tauri app someone else made, you need fewer packages:
For Tauri v2 apps:
1 2 3 |
sudo apt update sudo apt install libwebkit2gtk-4.1-0 libgtk-3-0 libappindicator3-1 |
For Tauri v1 apps:
1 2 3 |
sudo apt update sudo apt install libwebkit2gtk-4.0-37 libgtk-3-0 libappindicator3-1 |
Final Tips
- Always restart your terminal after installing new packages.
- If you’re building apps for others, consider using AppImage format – it includes all dependencies!
- The error messages actually tell you exactly which package is missing – look for phrases like “The system library
X
was not found”. - Older Ubuntu systems (like 18.04) work best for building Tauri v1 apps that need to run on many systems.
That’s it! No complicated explanations needed – just install the right packages and you’ll be up and running in no time.