How to Install Flutter on Windows, Mac, and Linux

This tutorial will guide you through the installation process of Flutter on Windows, macOS, and Linux operating systems

Mark Ponomarev

Mark Ponomarev

26 June 2025

How to Install Flutter on Windows, Mac, and Linux

Flutter is Google's UI toolkit for building beautiful, natively compiled applications for mobile, web, and desktop from a single codebase. This tutorial will guide you through the installation process of Flutter on Windows, macOS, and Linux operating systems.


While developing Flutter applications, you'll often need to test and interact with APIs. Apidog is an excellent alternative to Postman that offers a comprehensive set of features for API development and testing.

Why Consider Apidog?

Apidog provides a streamlined experience with features that make API testing more efficient:

  1. All-in-one Platform: API documentation, design, debugging, automated testing, and mocking in a single tool
  2. Intuitive Interface: User-friendly design with powerful capabilities
  3. Built-in Mock Server: Create mock APIs without writing any code

4. Collaboration Features: Real-time team collaboration with synchronized updates

5. OpenAPI Support: Import and export OpenAPI specifications seamlessly

6. Auto-generated Documentation: Create beautiful, interactive API docs automatically

7. Advanced Testing Capability: Create complex test scenarios with powerful scripting

Getting Started with Apidog

button
  1. Visit apidog.com to download and install Apidog for your platform
  2. Create a free account to unlock cloud synchronization and team collaboration features
  3. Import your existing Postman collections or start fresh with Apidog's intuitive interface

By incorporating Apidog into your Flutter development workflow, you can streamline API testing and make your development process more efficient.

Flutter: A Quick Introduction

Flutter has revolutionized cross-platform app development by offering a single codebase approach with near-native performance. Before you can start building amazing apps with Flutter, you need to set up your development environment. This guide will walk you through the installation process step-by-step for each major operating system.

To get the most out of Flutter, you'll need to install:

Let's dive into the installation process for each operating system.

Installing Flutter on Windows

System Requirements

Step 1: Download Flutter SDK

  1. Visit the official Flutter website at flutter.dev/docs/get-started/install/windows
  2. Click on the "flutter_windows_[version]-stable.zip" link to download the latest stable release
  3. Extract the zip file to a desired location (e.g., C:\src\flutter). Note: Avoid installing Flutter in directories like C:\Program Files\ that require elevated privileges

Step 2: Update your path

  1. In the Windows search bar, type "env" and select "Edit the system environment variables"
  2. Click on "Environment Variables"
  3. Under "User variables", find the "Path" variable, select it and click "Edit"
  4. Click "New" and add the path to your Flutter bin directory (e.g., C:\src\flutter\bin)
  5. Click "OK" to save changes

Step 3: Run Flutter Doctor

  1. Open a new Command Prompt or PowerShell window
  2. Verify Flutter is in your path by running:
where flutter dart
  1. Run Flutter Doctor to identify any dependencies you need to install:
flutter doctor

Step 4: Install Android Studio (for Android development)

  1. Download and install Android Studio from developer.android.com/studio
  2. Launch Android Studio and go through the "Android Studio Setup Wizard"
  3. Install the latest Android SDK, Android SDK Command-line Tools, and Android SDK Build-Tools
  4. Accept the Android licenses by running:
flutter doctor --android-licenses

Step 5: Set up an editor

  1. Install Visual Studio Code or Android Studio
  2. Install the Flutter and Dart plugins for your chosen editor

Installing Flutter on macOS

System Requirements

Step 1: Download Flutter SDK

  1. Visit flutter.dev/docs/get-started/install/macos
  2. Download the latest stable release of the Flutter SDK
  3. Extract the file in your desired location (e.g., ~/development):
cd ~/development
unzip ~/Downloads/flutter_macos_[version]-stable.zip

Step 2: Update your path

  1. Determine which shell you're using (zsh for newer macOS, bash for older versions):
echo $SHELL
  1. For zsh, edit ~/.zshrc. For bash, edit ~/.bash_profile:
nano ~/.zshrc
  1. Add Flutter to your PATH:
export PATH="$PATH:~/development/flutter/bin"
  1. Save the file and run:
source ~/.zshrc

Step 3: Run Flutter Doctor

flutter doctor

Step 4: Install Xcode (for iOS development)

  1. Install Xcode from the Mac App Store
  2. Configure the Xcode command-line tools:
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -runFirstLaunch
  1. Accept the Xcode license:
sudo xcodebuild -license
  1. Set up the iOS simulator:
open -a Simulator

Step 5: Install Android Studio (for Android development)

  1. Download and install Android Studio from developer.android.com/studio
  2. Launch Android Studio and follow the setup wizard
  3. Install the Android SDK, tools, and build tools
  4. Accept Android licenses:
flutter doctor --android-licenses

Step 6: Set up an editor

  1. Install Visual Studio Code or use Android Studio
  2. Install the Flutter and Dart plugins for your chosen editor

Installing Flutter on Linux

System Requirements

Step 1: Install dependencies

For Ubuntu/Debian:

sudo apt update
sudo apt install -y curl git unzip xz-utils zip libglu1-mesa

Step 2: Download Flutter SDK

  1. Visit flutter.dev/docs/get-started/install/linux
  2. Download the latest stable release
  3. Extract it to your preferred location:
cd ~/development
tar xf ~/Downloads/flutter_linux_[version]-stable.tar.xz

Step 3: Update your path

  1. Determine your shell:
echo $SHELL
  1. Edit your profile file (.bashrc for bash or .zshrc for zsh):
nano ~/.bashrc
  1. Add Flutter to your PATH:
export PATH="$PATH:~/development/flutter/bin"
  1. Save and reload the settings:
source ~/.bashrc

Step 4: Run Flutter Doctor

flutter doctor

Step 5: Install Android Studio

  1. Download Android Studio from developer.android.com/studio
  2. Extract the archive file and run the installation script:
cd android-studio/bin
./studio.sh
  1. Follow the setup wizard to install Android SDK, tools, and build tools
  2. Accept Android licenses:
flutter doctor --android-licenses

Step 6: Set up an editor

  1. Install Visual Studio Code or use Android Studio
  2. Install the Flutter and Dart plugins

Verifying Your Installation

Regardless of operating system, after installation, verify that everything is set up correctly:

  1. Open a terminal or command prompt
  2. Run the Flutter Doctor command to check for any issues:
flutter doctor -v
  1. Address any issues reported by Flutter Doctor
  2. Create a new Flutter project:
flutter create my_first_app
  1. Navigate to the project directory and run the app:
cd my_first_app
flutter run

If you see the default Flutter app running on your simulator or connected device, congratulations! You have successfully installed Flutter and are ready to start building cross-platform applications.

Conclusion

You've now successfully installed Flutter on your preferred operating system and are ready to start building beautiful cross-platform applications. Flutter's hot reload feature allows you to see changes in real-time, making development faster and more enjoyable.

Remember to keep your Flutter SDK updated by running flutter upgrade periodically, and explore the rich ecosystem of Flutter packages available.

Whether you're building mobile, web, or desktop applications, Flutter provides the tools and flexibility to bring your ideas to life with a single codebase. Happy coding!

button

Explore more

How to Use Kimi K2 in VSCode Copilot with Fake Ollama

How to Use Kimi K2 in VSCode Copilot with Fake Ollama

In an era where AI-powered developer tools are no longer a novelty but a necessity, Visual Studio Code's Copilot has firmly established itself as a leader. However, the true power of AI lies in its diversity and the specialized capabilities of different models. What if you could swap out the default engine of your Copilot for something more powerful, more specialized, or even something you run yourself? This article will guide you through the process of integrating the formidable Kimi K2 languag

13 July 2025

How to Use Kimi K2 with Claude Code

How to Use Kimi K2 with Claude Code

Something crazy just happened for the AI Coding Game. I was scrolling through my feed when I stumbled upon a thread discussing a wild new setup: developers are running Moonshot AI's brand-new Kimi K2 model directly within Claude's coding environment. At first, it sounded like a weird fan-fiction crossover, but the more I read, the more I realized it was not only possible but game-changing. I managed to get my hands on a test key, and after a few hours of tinkering, I can confirm: this combinati

12 July 2025

Kimi-K2: A Quick Look

Kimi-K2: A Quick Look

💡Want a great API Testing tool that generates beautiful API Documentation? Want an integrated, All-in-One platform for your Developer Team to work together with maximum productivity? Apidog delivers all your demands, and replaces Postman at a much more affordable price!button Unveiling Kimi-K2-Base: The Foundation for Open Agentic Intelligence A new Open Source Model has emerged from Moonshot AI, promising not just to answer questions, but to actively perform tasks. This is Kimi K2, a s

11 July 2025

Practice API Design-first in Apidog

Discover an easier way to build and use APIs