About Fly.io flyctl
Fly.io flyctl enables developers to manage applications, Machines, and volumes on Fly.io from the command line. It supports launching new applications, deploying updates, managing compute resources and databases, and debugging via SSH and logs.
Key features
- 01Launch new applications with fly launch and configure the Fly.io environment
- 02Deploy application updates to global Machines with fly deploy
- 03Create and manage volume storage and Postgres database instances
- 04Connect to Machines via SSH for debugging and view live logs
Use cases
- 01Quickly launch and deploy containerized applications to Fly.io's global network
- 02Manage application compute resources, storage, and databases
- 03Debug remotely and monitor production application performance
Install
Pick your OS or package manager and run the command in a terminal.
Once installed, runflyctl --versionto confirm it works.
Example commands
Common commands in the order you’d use them.
Details
From the project READMEflyctl
flyctl is a command-line interface for fly.io.
Note: Most installations of flyctl also alias flyctl to fly as a command name, and this will become the default name in the future. During the transition, note that where you see flyctl as a command, it can be replaced with fly.
Installation
Using a Package Manager
Homebrew (macOS, Linux, WSL)
brew install flyctl
To upgrade to the latest version:
brew upgrade flyctl
Install Script
Download flyctl and install it into a local bin directory.
macOS, Linux, WSL
Installing the latest version:
curl -L https://fly.io/install.sh | sh
Installing the latest pre-release version:
curl -L https://fly.io/install.sh | sh -s pre
Installing a specific version:
curl -L https://fly.io/install.sh | sh -s 0.0.200
Windows
Run the PowerShell install script:
iwr https://fly.io/install.ps1 -useb | iex
Downloading from GitHub
Download the appropriate version from the Releases page of the flyctl GitHub repository.
Getting Started
-
Sign into your Fly account:
fly auth login -
List your apps:
fly apps list -
View app status:
fly status -a {app-name}
App Settings
flyctl will attempt to use the app name from a fly.toml file in the current directory. For example, if the current directory contains this file:
$ cat fly.toml
app: banana
flyctl will operate against the banana app unless overridden by the -a flag or another app name setting in the command line.
Releases
flyctl is automatically released at 3 PM Eastern Standard Time, Monday - Thursday. If needed, you can bump a release by running ./scripts/bump_version.sh.
Building on Windows
There is a simple PowerShell script, winbuild.ps1, which will run the code generation for the help files, format them, and run a full build, leaving a new binary in the bin directory.
Contributing Guide
See CONTRIBUTING.md