How to Install and Setup Flutter on Linux: Complete Beginner Guide
If you want to learn how to install and setup Flutter on Linux, this complete guide will help you set up Flutter SDK, configure PATH, install Android Studio, setup VS Code, run Flutter Doctor, and create your first Flutter project.
Flutter is one of the most popular cross-platform app development frameworks. It allows developers to build Android, iOS, web, desktop, and embedded applications from a single codebase. For Linux users, Flutter is a powerful choice because Linux provides a clean, fast, and developer-friendly environment for programming.
In this article, we will explain how to install and setup Flutter on Linux step by step in a beginner-friendly way.
What is Flutter?
Flutter is an open-source UI software development kit created by Google. It is used to build beautiful and high-performance applications for multiple platforms using a single codebase. Flutter uses the Dart programming language and provides a rich collection of ready-made widgets, tools, and packages.
With Flutter, you can build:
- Android apps
- iOS apps
- Web applications
- Linux desktop apps
- Windows desktop apps
- macOS desktop apps
Flutter’s official documentation also describes Flutter as a multiplatform framework that helps developers build apps from one codebase.
Read : Dart SDK vs Flutter SDK: Architecture, Differences, and How Flutter Uses Dart
Why Install Flutter on Linux?
Linux is one of the best operating systems for developers. It is fast, stable, secure, and flexible. Many programmers prefer Linux because it gives better control over development tools, terminal commands, package managers, and open-source workflows.
You should learn how to install and setup Flutter on Linux if:
- You want to build Android apps using Flutter
- You want to create Linux desktop apps
- You want a clean and fast development environment
- You are learning Flutter development
- You want to use VS Code or Android Studio
- You prefer open-source development tools
- You want to work with Git, terminal, and command-line tools
- You want a lightweight system for app development
Linux is especially useful for Flutter developers who want to build Android apps, web apps, and Linux desktop apps from the same system.
Can You Build iOS Apps on Linux?
Before starting the Flutter Linux setup, you should understand one important point. You cannot build iOS apps directly on Linux. For iOS app development and final iOS build generation, you need macOS and Xcode.
On Linux, you can build:
- Android apps
- Flutter web apps
- Linux desktop apps
For iOS builds, you need a Mac system.
System Requirements for Flutter on Linux
Before you install Flutter on Linux, make sure your system has the basic requirements.
Recommended system requirements:
- 64-bit Linux operating system
- Ubuntu, Debian, Linux Mint, Fedora, or similar Linux distribution
- Minimum 4 GB RAM, but 8 GB or more is better
- Stable internet connection
- Git installed
- Terminal access
- Enough storage for Flutter SDK, Android Studio, Android SDK, emulator, and projects
For beginners, Ubuntu LTS or Linux Mint is a good option because most Flutter installation commands work smoothly on these distributions.
Step 1: Update Your Linux System
The first step is to update your Linux system. Open Terminal and run the following command.
For Ubuntu, Debian, or Linux Mint:
sudo apt update
sudo apt upgrade -y
For Fedora:
sudo dnf update -y
Updating your system helps avoid package errors during Flutter installation.
Step 2: Install Required Dependencies
Flutter needs some basic tools and libraries to work properly on Linux. These dependencies help with downloading, extracting, building, and running Flutter projects.
For Ubuntu, Debian, or Linux Mint, run:
sudo apt install -y curl git unzip xz-utils zip libglu1-mesa
For Fedora, run:
sudo dnf install -y curl git unzip xz zip mesa-libGLU
These packages are useful for the Flutter SDK setup and command-line development.
Step 3: Download Flutter SDK on Linux
Now you need to download the Flutter SDK. The recommended method is to clone Flutter from the GitHub repository using the stable channel.
Run these commands:
cd ~
git clone https://github.com/flutter/flutter.git -b stable
This command downloads Flutter SDK inside your home directory.
Your Flutter SDK location will be:
~/flutter
Installing Flutter inside the home directory is better for beginners because it avoids permission issues.
Flutter Download Linux Archive stable version:
https://docs.flutter.dev/install/archive
Step 4: Add Flutter to PATH
After downloading Flutter SDK, you need to add Flutter to your system PATH. If you skip this step, your terminal will not recognize the flutter command.
Open your .bashrc file:
nano ~/.bashrc
Add this line at the end of the file:
export PATH="$HOME/flutter/bin:$PATH"
Save the file and reload it:
source ~/.bashrc
Now check Flutter version:
flutter --version
If Flutter version appears, your Flutter SDK path is configured correctly. Flutter’s official setup guide also explains that the Flutter SDK must be added to PATH to run Flutter commands from the terminal.
Step 5: Run Flutter Doctor
Flutter Doctor is one of the most important commands in Flutter setup. It checks your system and tells you what is installed and what is missing.
Run:
flutter doctor
You may see warnings related to:
- Android toolchain
- Android Studio
- Android licenses
- Chrome
- Linux desktop toolchain
- Connected devices
Do not worry. Flutter Doctor is made to guide you step by step.
Read : Flutter Doctor command — What is flutter doctor (2026 Complete Guide)
Step 6: Install Android Studio on Linux
To build Android apps with Flutter, you need Android Studio or Android SDK tools. Android Studio helps you install Android SDK, Android Emulator, platform tools, and build tools.
For Ubuntu-based systems, you can install Android Studio using Snap:
sudo snap install android-studio --classic
After installation, open Android Studio and complete the setup wizard.
Install these important components:
- Android SDK
- Android SDK Platform
- Android SDK Build-Tools
- Android SDK Command-line Tools
- Android Emulator
Android Studio is the official IDE for Android development, and it includes Android SDK-related tools required for Android app development.
Step 7: Install Flutter and Dart Plugins in Android Studio
After installing Android Studio, install the Flutter plugin.
Steps:
- Open Android Studio.
- Go to Settings.
- Open Plugins.
- Search for Flutter.
- Install the Flutter plugin.
- Install Dart plugin if Android Studio asks.
- Restart Android Studio.
After this, Android Studio will support Flutter project creation, Flutter code editing, and Flutter app running.
Step 8: Accept Android Licenses
Now you need to accept Android SDK licenses.
Run this command:
flutter doctor --android-licenses
Press y whenever asked.
After accepting licenses, run Flutter Doctor again:
flutter doctor
If everything is correct, Android license warnings should be removed.
Step 9: Install VS Code for Flutter Development
VS Code is a lightweight and popular editor for Flutter development. Many developers prefer VS Code because it is fast, simple, and works well with Flutter extensions.
Install VS Code using Snap:
sudo snap install code --classic
After installing VS Code, open Extensions and install:
- Flutter
- Dart
The official Flutter documentation also provides a VS Code-based installation flow where VS Code can help install Flutter SDK and validate setup using flutter doctor -v.
Read : Flutter Installation and SDK Setup Guide Using VS Code in 2026
Step 10: Setup Android Emulator
To test Android apps, you can use an Android emulator.
Steps to create Android Emulator:
- Open Android Studio.
- Go to Device Manager.
- Click Create Device.
- Select a phone model.
- Choose a system image.
- Download the required image.
- Complete setup.
- Start the emulator.
Now check devices:
flutter devices
If your emulator appears, you can run Flutter apps on it.
Read : How to Create Android Emulator in Android Studio Step by Step
Step 11: Connect a Real Android Device
You can also test Flutter apps on a real Android phone. This is often faster than using an emulator.
On your Android phone:
- Open Settings.
- Enable Developer Options.
- Enable USB Debugging.
- Connect your phone to Linux using USB cable.
- Allow USB debugging permission.
Now run:
flutter devices
If your phone appears, your device is ready for Flutter development.
If ADB is missing, install it:
sudo apt install android-tools-adb -y
Check connected devices:
adb devices
Step 12: Enable Linux Desktop Support
If you want to build Linux desktop apps using Flutter, enable Linux desktop support.
Run:
flutter config --enable-linux-desktop
Now install Linux desktop development tools.
For Ubuntu, Debian, or Linux Mint:
sudo apt install -y clang cmake ninja-build pkg-config libgtk-3-dev libstdc++-12-dev
Flutter’s official Linux desktop setup guide lists packages like clang, cmake, ninja-build, pkg-config, libgtk-3-dev, and libstdc++-12-dev for Linux desktop development.
Now run:
flutter doctor
If Linux desktop toolchain is correct, you can build Linux desktop apps.
Step 13: Create Your First Flutter Project
Now your Flutter setup on Linux is almost complete. Create your first Flutter project:
flutter create my_first_app
Go inside the project folder:
cd my_first_app
Run the app:
flutter run
If multiple devices are available, Flutter will ask you to choose a device.
To run on Linux desktop:
flutter run -d linux
To run on Chrome:
flutter run -d chrome
Step 14: Build Flutter App on Linux
Once your app is ready, you can create production builds.
Build Android APK:
flutter build apk
Build Android App Bundle for Play Store:
flutter build appbundle
Build Flutter Web App:
flutter build web
Build Linux Desktop App:
flutter build linux
These commands help you prepare your Flutter app for different platforms.
Step 15: Update Flutter SDK on Linux
To update Flutter SDK, run:
flutter upgrade
To check your Flutter channel:
flutter channel
To switch to stable channel:
flutter channel stable
flutter upgrade
For beginners and production apps, the stable channel is recommended.
Common Errors During Flutter Setup on Linux
1. Flutter command not found
This means Flutter is not added to PATH properly.
Fix:
echo 'export PATH="$HOME/flutter/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
flutter --version
2. Android license status unknown
Fix:
flutter doctor --android-licenses
Accept all licenses by pressing y.
3. Android SDK not found
Open Android Studio and install Android SDK, platform tools, build tools, and command-line tools from SDK Manager.
Then run:
flutter doctor
4. No connected devices found
Start an Android emulator, connect a real Android phone, or run the app on Chrome or Linux desktop.
Check devices:
flutter devices
5. Linux desktop toolchain missing
Install required Linux desktop packages:
sudo apt install -y clang cmake ninja-build pkg-config libgtk-3-dev libstdc++-12-dev
Then run:
flutter doctor
6. Permission denied while updating Flutter
This usually happens when Flutter is installed in a protected system folder.
Best solution: install Flutter in your home directory.
cd ~
git clone https://github.com/flutter/flutter.git -b stable
Best Flutter Setup for Linux Beginners
For a smooth Flutter development experience, beginners should use:
- Ubuntu LTS or Linux Mint
- Flutter stable channel
- VS Code
- Android Studio
- Android SDK
- Android emulator or real Android device
- Chrome browser
- Git
This setup is enough to build Android apps, web apps, and Linux desktop apps using Flutter.
Best Practices After Installing Flutter on Linux
After completing how to install and setup Flutter on Linux, follow these best practices:
- Run
flutter doctorregularly. - Keep Flutter SDK updated.
- Use the stable channel for production projects.
- Keep Android Studio and Android SDK updated.
- Use Git for version control.
- Use a real Android device if the emulator is slow.
- Avoid installing Flutter inside protected system folders.
- Install Flutter and Dart extensions in your editor.
- Keep your Linux system updated.
Final Checklist
Before starting Flutter development, make sure these things are working:
- Flutter SDK is installed.
- Flutter path is configured.
flutter --versionis working.flutter doctoris working.- Android Studio is installed.
- Android SDK is configured.
- Android licenses are accepted.
- VS Code has Flutter and Dart extensions.
- Android emulator or real device is connected.
- Linux desktop support is enabled if required.
Read : Flutter Developer Roadmap 2026: Complete Skill Path, Career Scope, and Future Trends
Conclusion
Learning how to install and setup Flutter on Linux is the first step toward becoming a Flutter developer on a Linux system. The full setup includes installing dependencies, downloading Flutter SDK, adding Flutter to PATH, running Flutter Doctor, installing Android Studio, accepting Android licenses, setting up VS Code, and creating your first Flutter project.
Linux provides a fast, stable, and developer-friendly environment for Flutter development. Once your setup is complete, you can build Android apps, Flutter web apps, and Linux desktop apps from the same codebase.
For beginners, the simple Flutter Linux setup flow is:
- Update Linux system.
- Install required dependencies.
- Download Flutter SDK.
- Add Flutter to PATH.
- Run Flutter Doctor.
- Install Android Studio.
- Accept Android licenses.
- Install VS Code extensions.
- Create your first Flutter project.
- Run your Flutter app.
FAQs: How to Install and Setup Flutter on Linux
To install and setup Flutter on Linux, install required dependencies, download Flutter SDK, add Flutter to PATH, run Flutter Doctor, install Android Studio, accept Android licenses, and setup VS Code with Flutter and Dart extensions.
Run these commands:sudo apt update
sudo apt install -y curl git unzip xz-utils zip libglu1-mesa
cd ~
git clone https://github.com/flutter/flutter.git -b stable
Then add Flutter to PATH and run flutter doctor.
Run:echo 'export PATH="$HOME/flutter/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
Then verify:flutter --version
Run:flutter --version
flutter doctor
These commands verify your Flutter SDK and development environment.
ou can install Android Studio using Snap:sudo snap install android-studio --classic
Then install Android SDK, platform tools, build tools, emulator, and command-line tools.
Run:flutter doctor --android-licenses
Press y to accept all licenses.
Install VS Code, then install Flutter and Dart extensions from the VS Code Extensions Marketplace.
Create a Flutter project:flutter create my_app
cd my_app
flutter run
To run on Linux desktop:flutter run -d linux
Run:flutter upgrade
For stable channel:flutter channel stable
flutter upgrade