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)
  • Container/CI support: Set FVM_ALLOW_ROOT=true for Docker/CI environments
  • Help: ./install.sh --help
  • Version info: ./install.sh --version

Supported Platforms

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

Requirements

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

PATH Configuration

The install script automatically configures your shell PATH. For manual installations, add FVM to your PATH:

The install script automatically adds FVM to your PATH by updating your shell configuration:

  • Bash: ~/.bashrc or ~/.bash_profile
  • Zsh: ~/.zshrc
  • Fish: ~/.config/fish/config.fish

The script adds: export PATH="$HOME/.fvm_flutter/bin:$PATH"

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

Uninstallation

Install Script:

./install.sh --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