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

12 April 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

Why I Love Stripe Docs (API Documentation Best Practices)

Why I Love Stripe Docs (API Documentation Best Practices)

As a developer, I’ve had my fair share of late nights fueled by frustration and bad documentation. I think we all have. I can still vividly recall the cold sweat of trying to integrate a certain legacy payment processor years ago. It was a nightmare of fragmented guides, conflicting API versions, and a dashboard that felt like a labyrinth designed by a committee that hated joy. After hours of wrestling with convoluted SOAP requests and getting absolutely nowhere, I threw in the towel. A colleagu

20 June 2025

How to Install and Configure MongoDB MCP Server

How to Install and Configure MongoDB MCP Server

In the ever-evolving landscape of software development, the integration of Artificial Intelligence is no longer a futuristic concept but a present-day reality. AI-powered tools are rapidly becoming indispensable for developers, streamlining workflows, and enhancing productivity. Recognizing this trend, MongoDB has introduced a groundbreaking tool that bridges the gap between your database and AI: the MongoDB Model Context Protocol (MCP) Server. This tutorial provides a comprehensive, step-by-ste

20 June 2025

How to Use graphql-codegen, A Beginners' Guide

How to Use graphql-codegen, A Beginners' Guide

In the ever-evolving landscape of web development, GraphQL has emerged as a powerful alternative to traditional REST APIs, offering clients the ability to request precisely the data they need. However, this flexibility can introduce a new set of challenges, particularly when it comes to maintaining type safety between the frontend and backend. This is where graphql-codegen comes in, a revolutionary tool that automates the generation of typed code from your GraphQL schema, supercharging your deve

20 June 2025

Practice API Design-first in Apidog

Discover an easier way to build and use APIs