Start building Flutter native desktop apps on Linux

To install and run Flutter, your Linux environment must meet the following hardware and software requirements.

Your Linux Flutter development environment must meet the following minimal hardware requirements.

To write and compile Flutter code for desktop, you must have the following version of Linux and the listed software packages.

Flutter supports Debian Linux 11 or later and Ubuntu Linux 20.04 LTS or later .

To develop Flutter on Linux:

1. Verify that you have the following tools installed: bash, file, mkdir, rm, which

   $ which bash file mkdir rm which
   /bin/bash
   /usr/bin/file
   /bin/mkdir
   /bin/rm
   which: shell built-in command

2. Install the following packages: curl, git, unzip, xz-utils, zip, libglu1-mesa

   $ sudo apt-get update -y && sudo apt-get upgrade -y;
   $ sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa

3. To develop Linux apps, use the following command to install these packages:
   clang, cmake, ninja-build, pkg-config, libgtk-3-dev, libstdc++-12-dev

   $ sudo apt-get install \
         clang cmake git \
         ninja-build pkg-config \
         libgtk-3-dev liblzma-dev \
         libstdc++-12-dev

When you run the current version of flutter doctor, it might list a different version of one of these packages. If it does, install the version it recommends.

The developers of the preceding software provide support for those products. To troubleshoot installation issues, consult that product's documentation.

You can build apps with Flutter using any text editor or integrated development environment (IDE) combined with Flutter's command-line tools.

Using an IDE with a Flutter extension or plugin provides code completion, syntax highlighting, widget editing assists, debugging, and other features.

Popular options include:

• Visual Studio Code 1.77 or later with the Flutter extension for VS Code.
• Android Studio 2023.2.1 (Iguana) or later with the Flutter plugin for IntelliJ.
• IntelliJ IDEA 2023.2 or later with the Flutter plugin for IntelliJ.

To install the Flutter SDK, you can use the VS Code Flutter extension or download and install the Flutter bundle yourself.

• Use VS Code to install
• Download and install

help Help

The flutter doctor command validates that all components of a complete Flutter development environment for Linux.

1. Open a shell.

2. To verify your installation of all the components, run the following command.

   $ flutter doctor

As you chose to develop for , you do not need all components. If you followed this guide, the result of your command should resemble:

Running flutter doctor...
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.19.3, on Ubuntu 20.04 (LTS), locale en)
[!] Android toolchain - develop for Android devices
[!] Chrome - develop for the web
[!] Android Studio (not installed)
[✓] Linux toolchain - develop for Linux desktop
[✓] VS Code (version 1.86)
[✓] Connected device (1 available)
[✓] Network resources


! Doctor found issues in 3 categories.

When the flutter doctor command returns an error, it could be for Flutter, VS Code, , the connected device, or network resources.

If the flutter doctor command returns an error for any of these components, run it again with the verbose flag.

$ flutter doctor -v

Check the output for other software you might need to install or further tasks to perform.

If you change the configuration of your Flutter SDK or its related components, run flutter doctor again to verify the installation.

Congratulations! Now that you have installed all prerequisites and the Flutter SDK, you should be able to start developing Flutter apps for on Linux.

To learn more about managing your Flutter SDK install, consult the following resources.

• Upgrade Flutter
• Uninstall Flutter