fly deploy
Deploy Fly applications from source or an image using a local or remote builder.
To disable colorized output and show full Docker build output, set the environment variable NO_COLOR=1.
Usage
flyctl deploy [WORKING_DIRECTORY] [flags]
Options
-a, --app string Application name
--build-arg stringArray Set of build time variables in the form of NAME=VALUE pairs. Can be specified multiple times.
--build-only Build but do not deploy
--build-secret stringArray Set of build secrets of NAME=VALUE pairs. Can be specified multiple times. See https://docs.docker.com/engine/reference/commandline/buildx_build/#secret
--build-target string Set the target build stage to build if the Dockerfile has more than one stage
-c, --config string Path to application configuration file
--detach Return immediately instead of monitoring deployment progress
--dockerfile string Path to a Dockerfile. Defaults to the Dockerfile in the working directory.
-e, --env stringArray Set of environment variables in the form of NAME=VALUE pairs. Can be specified multiple times.
--exclude-regions strings Deploy to all machines except machines in these regions. Multiple regions can be specified with comma separated values or by providing the flag multiple times. --exclude-regions iad,sea --exclude-regions syd will exclude all three iad, sea, and syd regions. Applied after --only-regions. V2 machines platform only.
--file-literal stringArray Set of literals in the form of /path/inside/machine=VALUE pairs where VALUE is the content. Can be specified multiple times.
--file-local stringArray Set of files in the form of /path/inside/machine=<local/path> pairs. Can be specified multiple times.
--file-secret stringArray Set of secrets in the form of /path/inside/machine=SECRET pairs where SECRET is the name of the secret. Can be specified multiple times.
--ha Create spare machines that increases app availability (default true)
-h, --help help for deploy
--ignorefile string Path to a Docker ignore file. Defaults to the .dockerignore file in the working directory.
-i, --image string The Docker image to deploy
--image-label string Image label to use when tagging and pushing to the fly registry. Defaults to "deployment-{timestamp}".
--immediate-max-concurrent int Maximum number of machines to update concurrently when using the immediate deployment strategy. (default 16)
--label stringArray Add custom metadata to an image via docker labels
--lease-timeout int Seconds to lease individual machines while running deployment. All machines are leased at the beginning and released at the end. The lease is refreshed periodically for this same time, which is why it is short. flyctl releases leases in most cases. (default 13)
--local-only Perform builds locally using the local docker daemon. The default is --remote-only.
--max-unavailable float Max number of unavailable machines during rolling updates. A number between 0 and 1 means percent of total machines (default 0.33)
--nixpacks Deploy using nixpacks to build the image
--no-cache Do not use the build cache when building the image
--no-extensions Do not provision Sentry nor other auto-provisioned extensions (default true)
--no-public-ips Do not allocate any new public IP addresses
--now Deploy now without confirmation
--only-regions strings Deploy to machines only in these regions. Multiple regions can be specified with comma separated values or by providing the flag multiple times. --only-regions iad,sea --only-regions syd will deploy to all three iad, sea, and syd regions. Applied before --exclude-regions. V2 machines platform only.
--provision-extensions Provision any extensions assigned as a default to first deployments
--push Push image to registry after build is complete
-r, --region string The target region (see 'flyctl platform regions')
--release-command-timeout string Seconds to wait for a release command finish running, or 'none' to disable. (default "300")
--remote-only Perform builds on a remote builder instance instead of using the local docker daemon. This is the default. Use --local-only to build locally.
--smoke-checks Perform smoke checks during deployment (default true)
--strategy string The strategy for replacing running instances. Options are canary, rolling, bluegreen, or immediate. Default is canary, or rolling when max-per-region is set.
--update-only Do not create Machines for new process groups
--vm-cpu-kind string The kind of CPU to use ('shared' or 'performance')
--vm-cpus int Number of CPUs
--vm-memory int Memory (in megabytes) to attribute to the VM
--vm-size string The VM size to set machines to. See "fly platform vm-sizes" for valid values
--wait-timeout int Seconds to wait for individual machines to transition states and become healthy. (default 120)
-y, --yes Accept all confirmations
Global Options
-t, --access-token string Fly API Access Token
--debug Print additional logs and traces
--verbose Verbose output
See Also
- flyctl - The Fly.io command line interface