Skip to main content

Learn how to set up your development environment to run, build, and deploy Flutter apps for the Linux desktop platform.

Set up tooling

#

To run and debug desktop Flutter apps on Linux, download and install the prerequisite packages.

Using your preferred package manager or mechanism, install the latest versions of the following packages:

  • clang
  • cmake
  • ninja-build
  • pkg-config
  • libgtk-3-dev
  • libstdc++-12-dev

On Debian-based distros with apt-get, such as Ubuntu, install these packages using the following commands:

sudo apt-get update -y && sudo apt-get upgrade -y
sudo apt-get install -y clang cmake ninja-build pkg-config libgtk-3-dev libstdc++-12-dev

Validate your setup

#

  1. Check for toolchain issues

    To check for any issues with your Linux development setup, run the flutter doctor command in your preferred terminal:

    flutter doctor -v

    If you see any errors or tasks to complete under the Linux toolchain section, complete and resolve them, then run flutter doctor -v again to verify any changes.

  2. Check for Linux devices

    To ensure Flutter can find and connect to your Linux device correctly, run flutter devices in your preferred terminal:

    flutter devices

    If you set everything up correctly, there should be at least one entry with the platform marked as linux.

  3. Troubleshoot setup issues

    If you need help resolving any setup issues, check out Install and setup troubleshooting.

    If you still have issues or questions, reach out on one of the Flutter community channels.

Start developing for Linux

#

Congratulations! Now that you've set up Linux desktop development for Flutter, you can continue your Flutter learning journey while testing on Linux or begin expanding integration with Linux.

Continue learning Flutter
Build for Linux

Unless stated otherwise, the documentation on this site reflects the latest stable version of Flutter. Page last updated on 2025-05-12. View source or report an issue.