Installation

Schnellinstallation (5 Minuten)

TL;DR - Erfahrene Entwickler

# Go 1.25+ installieren, dann:
go install github.com/wailsapp/wails/v3/cmd/wails3@latest
wails3 doctor  # Installation überprüfen

Wenn wails3 doctor erfolgreich durchläuft, sind Sie fertig. Zum ersten App-Projekt springen →

Schritt-für-Schritt-Installation

1. Go installieren (Erforderlich)

   Wails erfordert Go 1.25 oder höher.

   Windows

   Laden Sie den Windows-Installer von go.dev/dl herunter und führen Sie ihn aus.

   Installation überprüfen:

   go version  # Sollte 1.25 oder höher anzeigen

   PATH überprüfen:

   $env:PATH -split ';' | Where-Object { $_ -like '*\go\bin' }

   Wenn die Ausgabe leer ist, fügen Sie C:\Users\IhrName\go\bin zu Ihrem PATH hinzu.

   macOS

   Option 1: Offizieller Installer

   Laden Sie den macOS-Installer (.pkg-Datei) von go.dev/dl herunter und führen Sie ihn aus.

   Option 2: Homebrew

   brew install go

   Installation überprüfen:

   go version  # Sollte 1.25 oder höher anzeigen
   echo $PATH | grep go/bin  # Sollte ~/go/bin anzeigen

   Wenn ~/go/bin nicht im PATH enthalten ist, fügen Sie es zu ~/.zshrc oder ~/.bash_profile hinzu:

   export PATH=$PATH:~/go/bin

   Linux

   Option 1: Offizielles Tarball

   Laden Sie das Linux-Tarball von go.dev/dl herunter, dann:

   sudo rm -rf /usr/local/go
   sudo tar -C /usr/local -xzf go1.25.linux-amd64.tar.gz

   Option 2: Paketmanager

   # Ubuntu/Debian
   sudo apt install golang-go
   
   # Fedora
   sudo dnf install golang
   
   # Arch
   sudo pacman -S go

   Zum PATH hinzufügen (fügen Sie dies zu ~/.bashrc oder ~/.zshrc hinzu):

   export PATH=$PATH:/usr/local/go/bin:~/go/bin
   source ~/.bashrc  # Neu laden

   Überprüfen:

   go version
   echo $PATH | grep go/bin

2. Plattformabhängigkeiten installieren

   Windows

   WebView2-Laufzeitumgebung (normalerweise vorinstalliert)

   Windows 10/11 enthält WebView2 standardmäßig. Falls fehlend:

   • Von Microsoft herunterladen
   • Oder führen Sie später wails3 doctor aus – es wird Sie anleiten

   Das war’s! Keine weiteren Abhängigkeiten erforderlich.

   Leistungstipp für Windows 11

   Erwägen Sie die Verwendung von Dev Drive, um Ihre Projekte zu speichern. Dev Drives sind für Entwicklerworkloads optimiert und können die Build-Zeiten und die Festplattenzugriffsgeschwindigkeit um bis zu 30 % erheblich verbessern.

   macOS

   Xcode Command Line Tools (erforderlich)

   xcode-select --install

   Klicken Sie im erscheinenden Dialogfeld auf “Installieren”.

   Überprüfen:

   xcode-select -p  # Sollte /Library/Developer/CommandLineTools anzeigen

   Das war’s! macOS enthält WebKit standardmäßig.

   Linux

   Build-Tools und WebKit

   Minimale Distro-Versionen

   Wails v3 erfordert WebKitGTK 4.1 (verwendet libsoup3). Ältere Veröffentlichungen, die nur 4.0 ausliefern – Ubuntu 20.04, Debian 11, RHEL 8/9 und deren Derivate – werden nicht unterstützt.

   Ubuntu/Debian

   Erfordert Ubuntu 22.04+ oder Debian 12+.

   sudo apt update
   sudo apt install build-essential pkg-config libgtk-3-dev libwebkit2gtk-4.1-dev

   Fedora

   sudo dnf install gcc pkg-config gtk3-devel webkit2gtk4.1-devel

   Arch

   sudo pacman -S base-devel gtk3 webkit2gtk-4.1

   openSUSE

   sudo zypper install gcc pkg-config gtk3-devel webkit2gtk3-devel

   Gentoo

   sudo emerge --ask net-libs/webkit-gtk:4.1

   NixOS

   Fügen Sie dies zu Ihrer shell.nix oder devShell hinzu:

   buildInputs = with pkgs; [ webkitgtk_4_1 gtk3 pkg-config gcc ];

   Andere

   Führen Sie nach der Installation von Wails wails3 doctor aus – es zeigt die genauen Pakete an, die für Ihre Distribution benötigt werden.

   Optional: GTK4-Unterstützung

   Wails bietet auch experimentelle GTK4 / WebKitGTK 6.0-Unterstützung. Wenn Sie mit GTK4 erstellen möchten, installieren Sie die zusätzlichen Abhängigkeiten für Ihre Distribution und erstellen Sie mit wails3 build -tags gtk4. Einzelheiten finden Sie unter Linux-Paketierung - GTK4.

3. Wails CLI installieren

   go install github.com/wailsapp/wails/v3/cmd/wails3@latest

   Dies installiert den Befehl wails3 nach ~/go/bin (oder %USERPROFILE%\go\bin unter Windows).

4. Installation überprüfen

   wails3 doctor

   Erwartete Ausgabe (oder ähnlich):

   Wails (v3.0.0-dev)  Wails Doctor
   
   # System
   
   ┌──────────────────────────────────────────────────┐
   | Name          | MacOS                            |
   | Version       | 26.0                             |
   | ID            | 25A354                           |
   | Branding      | MacOS 26.0                       |
   | Platform      | darwin                           |
   | Architecture  | arm64                            |
   | Apple Silicon | true                             |
   | CPU           | Apple M2 Pro                     |
   | CPU 1         | Apple M2 Pro                     |
   | CPU 2         | Apple M2 Pro                     |
   | GPU           | 16 cores, Metal Support: Metal 4 |
   | Memory        | 16 GB                            |
   └──────────────────────────────────────────────────┘
   
   # Build Environment
   
   ┌─────────────┬─────────────────┐
   | Wails CLI   | v3.0.0-alpha.40 |
   | Go Version  | go1.24.6        |
   └─────────────┴─────────────────┘
   
   # Dependencies
   
   ┌─────────────────┬─────────────────────────────────────────────────┐
   | npm             | 11.6.2                                          |
   | *NSIS           | Not Installed. Install with `brew install...`.  |
   | Xcode cli tools | 2412                                            |
   └─────────────────┴─────────────────────────────────────────────────┘
   
   # Checking for issues
   
   SUCCESS No issues found
   
   # Diagnosis
   
   SUCCESS Your system is ready for Wails development!

   Falls der Befehl wails3 nicht gefunden wird

   Ihr ~/go/bin ist nicht im PATH enthalten. Siehe Schritt 1 oben, um dies zu beheben, und starten Sie Ihr Terminal anschließend neu.

5. npm installieren (Optional, aber empfohlen)

   Die meisten Wails-Vorlagen verwenden npm für die Frontend-Tooling.

   Windows

   Laden Sie es von nodejs.org herunter und führen Sie den Installer aus.

   Überprüfen:

   npm --version

   macOS

   Option 1: Offizieller Installer Von nodejs.org herunterladen

   Option 2: Homebrew

   brew install node

   Überprüfen:

   npm --version

   Linux

   Option 1: NodeSource

   curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
   sudo apt-get install -y nodejs  # Ubuntu/Debian

   Option 2: Paketmanager

   sudo dnf install nodejs  # Fedora
   sudo pacman -S nodejs npm  # Arch

   Überprüfen:

   npm --version

   Alternative Paketmanager

   Bevorzugen Sie pnpm, yarn oder bun? Kein Problem! Aktualisieren Sie einfach die Taskfile.yml in Ihrem Projekt, um Ihr bevorzugtes Tool zu verwenden.

Fehlerbehebung

wails3-Befehl nicht gefunden

Ursache: ~/go/bin (oder %USERPROFILE%\go\bin) ist nicht in Ihrem PATH enthalten.

Lösung:

Windows

1. Öffnen Sie “Umgebungsvariablen” (in der Startsuche suchen)
2. Unter “Benutzervariablen” den Eintrag Path finden
3. Klicken Sie auf “Bearbeiten” → “Neu”
4. Hinzufügen: C:\Users\IhrName\go\bin (ersetzen Sie IhrName)
5. Klicken Sie auf allen Dialogen auf “OK”
6. Terminal neu starten

Überprüfen:

$env:PATH -split ';' | Where-Object { $_ -like '*\go\bin' }

macOS/Linux

Fügen Sie zu ~/.zshrc (macOS) oder ~/.bashrc (Linux) hinzu:

export PATH=$PATH:~/go/bin

Neu laden:

source ~/.zshrc  # oder ~/.bashrc

Überprüfen:

echo $PATH | grep go/bin
wails3 version

---

wails3 doctor meldet fehlende Abhängigkeiten

Linux: Die Ausgabe zeigt genau an, welche Pakete installiert werden sollen. Beispiel:

❌ webkit2gtk nicht gefunden
   Installation mit: sudo apt install libwebkit2gtk-4.1-dev

Windows: Falls WebView2 fehlt:

• Von Microsoft herunterladen
• Oder es wird automatisch installiert, wenn Sie Ihre erste App ausführen

macOS: Falls Xcode-Tools fehlen:

xcode-select --install

---

Go-Version zu alt

Wails v3 erfordert Go 1.25+. Wenn Sie eine ältere Version haben:

Windows/macOS

Laden Sie die neueste Version von go.dev/dl herunter und installieren Sie sie erneut.

Linux

Laden Sie die neueste Tarball-Datei von go.dev/dl herunter, dann:

sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.25.linux-amd64.tar.gz

Entwicklungsversion (Bleeding Edge)

Möchten Sie den absolut neuesten Code aus dem Hauptentwicklungsbranch verwenden? Dies gibt Ihnen Zugang zu neuen Funktionen und Fehlerbehebungen, bevor sie veröffentlicht werden, bringt jedoch das Risiko von Bugs und Breaking Changes mit sich. Nur für Mitwirkende oder diejenigen empfohlen, die kommende Funktionen testen müssen.

git clone https://github.com/wailsapp/wails.git
cd wails
git checkout v3
cd v3/cmd/wails3
go install

Entwicklungsversion

• Kann Bugs oder Breaking Changes enthalten
• Erstellte Projekte verwenden den replace-Direktiv, um auf das lokale Wails zu verweisen
• Nur für Mitwirkende oder zum Testen neuer Funktionen empfohlen

Nächste Schritte

Installation abgeschlossen! Ihr System ist bereit für die Wails-Entwicklung.

Erstellen Sie Ihre erste App

Erstellen Sie in 10 Minuten eine funktionierende Anwendung.

Tutorial zur ersten App →

Vorlagen erkunden

Sehen Sie, was standardmäßig verfügbar ist.

wails3 init -l  # Vorlagen auflisten

---

Haben Sie Probleme? Fragen Sie in Discord oder öffnen Sie ein Issue.