The Flywheel Command-Line Interface (CLI) is a tool for uploading existing data into Flywheel and downloading data from Flywheel to work with offline. The Flywheel CLI is also required to start jobs and build gears. This article explains how to download and install the Flywheel CLI.
This article explains how to update your Flywheel CLI to the latest version. If you haven't installed the Flywheel CLI, see our article to learn how to download and install the Flywheel CLI.
To download the Flywheel CLI:
Log in to Flywheel.
In the upper-right corner, select your account menu, and select Profile.
Go to the Download Flywheel CLI section, and select your computer's operating system.
A zip file with the following name is downloaded to your computer:
OS X: fw-darwin_amd64.zip
Follow these steps to download the newest version of the Flywheel CLI and replace your older version.
Open the Terminal app.
Unzip the file.
If you are using macOS 10.15 Catalina release (or later), you need to add the Flywheel CLI as a security exception. If you are using an earlier macOS version or Linux, continue to step 4.
To add the Flywheel CLI as a security exception:
Right-click on fw, and click Open.
Click Open on the warning prompt.
In Terminal, navigate to the Flywheel CLI. For example:
(Optional) Enter this command to add the CLI to your PATH:
sudo mv ./fw /usr/local/bin
This makes it easier to access the Flywheel CLI later on. It is not required to add the Flywheel CLI to your PATH. If you do not to add it to your PATH, you must either enter the file path where fw resides in the commands below or run the commands from the same location as the Flywheel CLI.
Enter your password when prompted.
fw-windows_amd64to unzip the file. You should see a
Open the Command Prompt utility as an administrator.
From the start menu, Search Command.
Command Prompt appears as one of the results.
Right click on Command Prompt, and choose Run as Administrator.
In the Command prompt, navigate to fw-windows_amd64.
(Optional) To make it easier to access the Flywheel CLI later on, you can add it to your PATH (If you want to learn more about the PATH variable, see this article by Oracle ). You don't need to add the Flywheel CLI to your PATH. However, if you do not add it, you must either enter the file path where fw.exe resides each time your enter a command or you must run the commands from the same folder as fw.exe.
Enter the following command to add the Flywheel CLI to you PATH:
setx path "%path%;C:\your_path"
setx path "%path%;C:\Programs\fw.exe"
Close and reopen the command prompt utility for the new path to be recognized.
To verify that you are using the newer version of the CLI, enter:
$ fw version
Or if you have not added the Flywheel CLI to your PATH, include the file path where the CLI resides. For example:
C:\Users\[username]\FlywheelCLI\windows_amd64\fw.exe fw version