Writing
Install Flutter on Windows and Fix flutter doctor Errors
Install Flutter on Windows step by step: download the SDK, set the PATH, set up Android Studio, and fix the common flutter doctor errors in minutes.
Arbab Naseer Published Last updated 7 min read
- Flutter
- Windows
- flutter doctor
- Android Studio
- Dart
Short answer: install Git for Windows, download the Flutter SDK zip for Windows (or let VS Code download it), extract it to a simple path like C:\Users\<you>\develop\flutter, add the flutter\bin folder to your user PATH, open a new terminal and run flutter doctor. Then install Android Studio, the Android SDK command line tools, and accept the licenses with flutter doctor --android-licenses.
This guide follows the setup I use for my own Flutter work, including PocketPOS, and covers the errors I see most often when helping other developers get started. It was written for Flutter 3.47, the current stable release in October 2026, but the steps barely change between versions.
What you need before installing Flutter
You need a 64 bit Windows 10 or Windows 11 PC, about 10 GB of free disk space for Flutter plus Android tools, and Git for Windows. Flutter uses Git to manage its own versions, so flutter doctor fails without it. Android Studio is only needed for Android builds, and Visual Studio is only needed for Windows desktop apps.
Install Git from git-scm.com with the default options, then check it in a new PowerShell window:
git --version
Step 1: Download the Flutter SDK for Windows
There are two good ways to get the SDK. Pick one.
Option A: let VS Code do it (easiest). Install Visual Studio Code and the official Flutter extension. Open the Command Palette (Ctrl + Shift + P), run Flutter: New Project, and when VS Code says the SDK is missing, choose Download SDK and pick a folder such as C:\Users\<you>\develop. VS Code clones the stable SDK and offers to add it to your PATH.
Option B: download the zip manually. Go to the Flutter SDK archive on docs.flutter.dev, open the Windows tab under the stable channel, and download the latest stable zip. This is the official “flutter sdk download for windows” and the safest source. Avoid third party mirrors.
You can also clone it with Git if you prefer:
git clone -b stable https://github.com/flutter/flutter.git C:\Users\<you>\develop\flutter
Step 2: Extract Flutter to the right folder
Extract the zip so that you end up with C:\Users\<you>\develop\flutter\bin\flutter.bat. Where you put the folder matters more than people expect.
Use a path that:
- has no spaces and no special characters,
- is not inside
C:\Program Files\(it needs admin rights to write, and Flutter updates itself), - is not inside a OneDrive synced folder (sync locks files during updates and builds).
C:\Users\<you>\develop\flutter or C:\src\flutter both work well.
Step 3: Add Flutter to your PATH
This is the step that fixes the most common error, 'flutter' is not recognized as an internal or external command.
- Press the Windows key and search for Edit environment variables for your account.
- Under User variables, select Path and click Edit.
- Click New and add the full path to the
binfolder, for exampleC:\Users\<you>\develop\flutter\bin. - Click OK on every window.
- Close all terminals and VS Code, then open a new one. Old windows keep the old PATH.
Check it:
flutter --version
where.exe flutter
where.exe flutter should print the path you just added. If it prints two paths, remove the old one from PATH so you do not run an outdated Flutter by mistake.
Step 4: Run flutter doctor
flutter doctor checks your whole setup and tells you exactly what is missing:
flutter doctor
Use flutter doctor -v for full details. A green check means that part is ready, a yellow exclamation mark is a warning, and a red cross must be fixed if you need that platform. You do not need every line to be green. If you only build Android apps, you can ignore the Visual Studio line.
Step 5: Set up Android Studio and the Android SDK
To build and run Android apps:
-
Install Android Studio from developer.android.com and open it once so it downloads the default SDK.
-
Go to More Actions > SDK Manager (or Settings > Languages & Frameworks > Android SDK).
-
In SDK Platforms, install the latest stable Android version.
-
In SDK Tools, check Android SDK Command-line Tools (latest), Android SDK Build-Tools, Android SDK Platform-Tools and Android Emulator. Click Apply.
-
Accept the Android licenses:
flutter doctor --android-licensesPress
yfor each license. Then runflutter doctoragain. -
Create an emulator in Device Manager, or plug in a phone with USB debugging enabled in Developer options.
Fixing the most common flutter doctor errors
| Error message | Fix |
|---|---|
'flutter' is not recognized as an internal or external command |
The flutter\bin folder is not on PATH, or the terminal is old. Redo Step 3 and open a new terminal. |
Unable to find git in your PATH |
Install Git for Windows, then open a new terminal. |
cmdline-tools component is missing |
In Android Studio SDK Manager > SDK Tools, install Android SDK Command-line Tools (latest). |
Android license status unknown |
Run flutter doctor --android-licenses and accept all. If it fails, install the command line tools first. |
Unable to locate Android SDK |
Run flutter config --android-sdk "C:\Users\<you>\AppData\Local\Android\Sdk" with your real SDK path. |
Could not determine Java version or Gradle Java errors |
Point Flutter to the JDK bundled with Android Studio: flutter config --jdk-dir "C:\Program Files\Android\Android Studio\jbr". |
Building with plugins requires symlink support |
Turn on Developer Mode: run start ms-settings:developers and switch it on. |
Visual Studio not installed |
Only needed for Windows desktop apps. Install Visual Studio (not VS Code) with the Desktop development with C++ workload, or ignore it. |
Cannot find Chrome executable |
Only needed for Flutter web. Install Chrome, or set CHROME_EXECUTABLE to the path of another Chromium browser. |
No devices available |
Start an emulator from Android Studio Device Manager, or enable USB debugging and accept the prompt on your phone. Check with flutter devices. |
If you do not plan to build for a platform at all, you can turn it off so doctor stops warning about it, for example flutter config --no-enable-windows-desktop.
Step 6: Create and run your first app
flutter create my_app
cd my_app
flutter run
Flutter picks a connected device or asks you to choose one. While the app runs, press r for hot reload and R for hot restart.
Build an APK or App Bundle on Windows
When you are ready to share the app:
flutter build apk --release
The APK is created at build\app\outputs\flutter-apk\app-release.apk. Use it for testing on devices or sharing directly.
For Google Play, build an Android App Bundle instead, because Play requires the AAB format for new apps:
flutter build appbundle --release
Before uploading to Play, set up a release signing key and add it to android\key.properties as described in the Flutter Android deployment guide.
About iOS: you can write and test the Flutter code on Windows, but building and signing an iOS app needs macOS and Xcode. If you do not have a Mac, use a cloud CI service with macOS machines to build the iOS version.
Keeping Flutter up to date
flutter upgrade
flutter --version
Stay on the stable channel for real projects (flutter channel stable). Flutter ships a new stable release roughly every three months, and flutter upgrade handles it in place.
FAQ
How do I install Flutter on Windows 11?
The steps are the same as Windows 10. Install Git for Windows, download the stable Flutter SDK zip for Windows, extract it to a path without spaces such as C:\Users\<you>\develop\flutter, add its bin folder to your user PATH, open a new terminal and run flutter doctor.
Where should I put the Flutter SDK path on Windows?
Use a simple folder you own, such as C:\Users\<you>\develop\flutter or C:\src\flutter. Avoid C:\Program Files\ because it needs admin rights, avoid paths with spaces or special characters, and avoid OneDrive folders because file syncing interferes with updates and builds.
Do I need Android Studio for Flutter?
You need the Android SDK to build Android apps, and Android Studio is the easiest way to install and manage it. You can write code in VS Code and only use Android Studio for the SDK Manager and emulators. For web or Windows desktop only, Android Studio is not required.
Do I need Visual Studio for Flutter on Windows?
Only if you build Windows desktop apps. Then you need Visual Studio (not VS Code) with the “Desktop development with C++” workload. For Android, iOS or web apps, you can ignore the Visual Studio warning in flutter doctor.
Why does flutter doctor say cmdline-tools component is missing?
Android Studio does not install the command line tools by default. Open SDK Manager, go to the SDK Tools tab, check “Android SDK Command-line Tools (latest)”, apply, then run flutter doctor --android-licenses and flutter doctor again.
Still deciding between Flutter and React Native? Read my comparison: Flutter vs React Native in 2026. If you need a Flutter app built and published, get in touch.