Documentation
Getting Started
Installation

Installation

There are several ways to install FVM. Choose the method that best fits your development environment.

Recommendation

We recommend installing the Flutter SDK globally using the official installation guide here (opens in a new tab). This will be the main version of Flutter across your machine.

Use FVM to manage the Flutter SDK version for your projects.

You can download the standalone packages from the GitHub repo here (opens in a new tab).

Install Script (Recommended)

Install the latest version:

curl -fsSL https://fvm.app/install.sh | bash

Install a specific version:

curl -fsSL https://fvm.app/install.sh | bash -s -- <version>

Replace <version> with your desired FVM version (e.g., 3.2.1)

Homebrew

Install:

brew tap leoafarias/fvm
brew install fvm

Uninstall:

brew uninstall fvm
brew untap leoafarias/fvm

Installation Options

Install Script Features

The install script (install.sh) supports several options:

  • Latest version: curl -fsSL https://fvm.app/install.sh | bash
  • Specific version: curl -fsSL https://fvm.app/install.sh | bash -s -- <version> (replace <version> with desired FVM version)
  • Custom install location: FVM_INSTALL_DIR=<path> curl -fsSL https://fvm.app/install.sh | bash (absolute path under $HOME)
  • Help: ./install.sh --help
  • Version info: ./install.sh --version

Supported Platforms

PlatformArchitectureSupport
macOSx64, arm64✅
Linuxx64, arm64, riscv64✅
Windowsx64✅ (via PowerShell/Chocolatey)

Requirements

  • macOS/Linux: curl and tar
  • Windows: PowerShell (for script) or Chocolatey

PATH Configuration

The install script prints instructions to add FVM to your shell PATH. For manual installations, add FVM to your PATH:

The install script prints instructions to add FVM to your PATH. Add the following to your shell configuration:

  • Bash: Add to ~/.bashrc
  • Zsh: Add to ~/.zshrc
  • Fish: Run fish_add_path "<install_dir>/bin"

Add this line: export PATH="<install_dir>/bin:$PATH" (default install dir is $HOME/fvm)

To apply changes immediately: source ~/.zshrc (or your shell config file)

Uninstallation

Install Script:

curl -fsSL https://fvm.app/install.sh | bash -s -- --uninstall

Homebrew:

brew uninstall fvm
brew untap leoafarias/fvm

Chocolatey:

choco uninstall fvm

Pub:

dart pub global deactivate fvm

Remove cached Flutter versions (optional):

fvm destroy
OverviewConfiguration