Update the Flywheel CLI

  • Updated

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.

Step 1: Download

To download the Flywheel CLI:

  1. Log in to Flywheel.

  2. In the upper-right corner, select your account menu, and select Profile.

    15dc5862bea12c.png

  3. Go to the Download Flywheel CLI section, and select your computer's operating system.

    15dc5862bf1c29.png

    A zip file with the following name is downloaded to your computer:

  • Linux: fw-linux_amd64.zip

  • OS X: fw-darwin_amd64.zip

  • Windows: fw-windows_amd64.zip

Step 2: Overwrite the old Flywheel CLI

Follow these steps to download the newest version of the Flywheel CLI and replace your older version.

Mac and Linux

  1. Open the Terminal app.

  2. Unzip the file.

  3. 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:

    1. Right-click on fw, and click Open.
      fwOpen.png
    2. Click Open on the warning prompt.
      fwWarning.png

  4. In Terminal, navigate to the Flywheel CLI. For example:

    Mac:

    cd ~/Downloads/darwin_amd64

    Linux:

    cd ~/Downloads/fw-linux_amd64

  5. (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.

  6. Enter your password when prompted.

Windows

  1. Double-click fw-windows_amd64 to unzip the file. You should see a fw.exe file inside.

  2. Open the Command Prompt utility as an administrator.

    1. From the start menu, Search Command.
      Command Prompt appears as one of the results.

    2. Right click on Command Prompt, and choose Run as Administrator.

  3. In the Command prompt, navigate to fw-windows_amd64.

    For example,

    cd C:\Users\[username]\Downloads\windows_amd64

  4. (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"

    For example:

    setx path "%path%;C:\Programs\fw.exe"

  5. Close and reopen the command prompt utility for the new path to be recognized.

Step 3: Verify you are using the new Flywheel CLI version

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