Introduction
The Flywheel command-line interface (CLI) is an additional Flywheel program you download to use on your computer's Command Prompt (Windows) or Terminal (Mac) app. It is helpful to have a basic understanding of how the Command Prompt and Terminal apps work to get the most out of the Flywheel CLI (one can learn more about the Command Prompt and Terminal app, in this introductory article by Codcademy.
Flywheel's 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 document explains how to install the Flywheel CLI onto your computer.
Instructions
To download the Flywheel CLI:
-
Log into 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:
-
Linux: fw-linux_amd64.zip
-
OS X: fw-darwin_amd64.zip
-
Windows: fw-windows_amd64.zip
To start using the CLI to interact with your Flywheel site; generate an API key from your Profile page. Learn more about creating User API Keys from the Profile page.
Follow the steps for your OS either Windows or Linux/Mac.
-
Double-click
fw-windows_amd64<version_number>
to unzip the file. You should see afw.exe
file inside. This is the Flywheel CLI program. -
Open the Command Prompt 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 the folder containing the Flywheel CLI or
fw.exe
For example:
cd C:\Users\[username]\Downloads\windows_amd64*
Note: To quickly add the file path to Command Prompt, drag and drop the folder icon containing
fw.exe.
The file path will automatically be added to the command. -
Continue to Step 4: Log in your Flywheel instance
-
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. Continue to Step 4 if you are using an earlier macOS version or Linux.
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:
Mac
cd ~/Downloads/darwin_amd64*
Linux
cd ~/Downloads/fw-linux_amd64/linux_amd64*
-
Continue to Step 4: log in from the CLI
Step 4: Log in from the CLI
-
Copy the API key generated from Step 2 above.
-
In Terminal or Command Prompt, enter:
-
Windows:
fw.exe login <APIkey>
For example:
-
Mac/Linux:
<filepath to fw> login <yourAPIKey>
-
-
The following message appears:
You are now logged in as <Flywheel username>!
The Flywheel CLI is now installed! Read our article about how to import data with the CLI or watch the webinar.
One may have noticed in the steps above that you have to include the full filepath for the fw application when you enter a command. If you plan to use the CLI often, you may want to add it to your system PATH. Adding the Flywheel CLI to your PATH means that you only need to use fw
to invoke the Flywheel CLI. If you want to learn more about the PATH variable, see this article by Oracle.
-
To begin, move the
fw
orfw.exe
file to a more permanent location on your computer. For exampleC:\Program Files\Common Files
-
Open the start menu and search for advance system settings, and click View advanced system settings
-
Click Environment Variables
-
Select PATH from the list, and click Edit.
-
Click New, and enter the filepath to fw.exe.
For example
C:\Users\IEUser\FlywheelCLI
-
Click Ok in each window presented.
-
In the command prompt enter:
fw status
The CLI shows your login information