fly launch

Create and configure a new app from source code or a Docker image

Usage

flyctl launch [flags]

Options

     --auto-confirm                  Accept all confirmations 
     --build-arg                     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                  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                  Set the target build stage to build if the Dockerfile has more than one stage 
     --buildpacks-docker-host        Address to docker daemon that will be exposed to the build container.
If not set (or set to empty string) the standard socket location will be used.
Special value 'inherit' may be used in which case DOCKER_HOST environment variable will be used.
This option may set DOCKER_HOST environment variable for the build container if needed.
 
     --buildpacks-volume             Mount host volume into the build container, in the form '<host path>:<target path>[:<options>]'.
- 'host path': Name of the volume or absolute directory path to mount.
- 'target path': The path where the file or directory is available in the container.
- 'options' (default "ro"): An optional comma separated list of mount options.
    - "ro", volume contents are read-only.
    - "rw", volume contents are readable and writeable.
    - "volume-opt=<key>=<value>", can be specified more than once, takes a key-value pair consisting of the option name and its value.
Repeat for each volume in order (comma-separated lists not accepted)
 
     --copy-config                   Use the configuration file if present without prompting 
     --cpus                          Number of CPUs 
     --detach                        Return immediately instead of monitoring deployment progress 
     --dns-checks                    Perform DNS checks during deployment 
     --dockerfile                    Path to a Dockerfile. Defaults to the Dockerfile in the working directory. 
     --dockerignore-from-gitignore   If a .dockerignore does not exist, create one from .gitignore files 
-e,  --env                           Set of environment variables in the form of NAME=VALUE pairs. Can be specified multiple times. 
     --exclude-regions               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                  Set of literals in the form of /path/inside/machine=VALUE pairs where VALUE is the content. Can be specified multiple times. 
     --file-local                    Set of files in the form of /path/inside/machine=<local/path> pairs. Can be specified multiple times. 
     --file-secret                   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. 
     --force-machines                Use the Apps v2 platform built with Machines 
     --force-nomad                   (Deprecated) Use the Apps v1 platform built with Nomad 
     --from-manifest                 Path to a manifest file for Launch ('-' reads from stdin) 
     --generate-name                 Always generate a name for the app, without prompting 
     --ha                            Create spare machines that increases app availability 
     --host-dedication-id            The dedication id of the reserved hosts for your organization (if any) 
     --ignorefile                    Path to a Docker ignore file. Defaults to the .dockerignore file in the working directory. 
-i,  --image                         The Docker image to deploy 
     --image-label                   Image label to use when tagging and pushing to the fly registry. Defaults to "deployment-{timestamp}". 
     --immediate-max-concurrent      Maximum number of machines to update concurrently when using the immediate deployment strategy. 
     --internal-port                 Set internal_port for all services in the generated fly.toml 
     --label                         Add custom metadata to an image via docker labels 
     --lease-timeout                 Time duration 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. 
     --legacy                        Use the legacy CLI interface (deprecated) 
     --local-only                    Perform builds locally using the local docker daemon. The default is --remote-only. 
     --manifest                      Output the generated manifest to stdout 
     --max-unavailable               Max number of unavailable machines during rolling updates. A number between 0 and 1 means percent of total machines 
     --memory                        Memory (in megabytes) to attribute to the VM 
     --name                          Name of the new app 
     --nixpacks                      Deploy using nixpacks to build the image 
     --no-cache                      Do not use the build cache when building the image 
     --no-deploy                     Do not immediately deploy the new app after fly launch creates and configures it 
     --no-public-ips                 Do not allocate any new public IP addresses 
     --now                           Deploy now without confirmation 
     --only-regions                  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. 
-o,  --org                           The target Fly.io organization 
     --path                          Path to the app source root, where fly.toml file will be saved 
     --process-groups                Deploy to machines only in these process groups 
     --provision-extensions          Provision any extensions assigned as a default to first deployments 
     --push                          Push image to registry after build is complete 
-r,  --region                        The target region (see 'flyctl platform regions') 
     --release-command-timeout       Time duration to wait for a release command finish running, or 'none' to disable. 
     --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. 
     --reuse-app                     Continue even if app name clashes with an existent app 
     --smoke-checks                  Perform smoke checks during deployment 
     --strategy                      The strategy for replacing running instances. Options are canary, rolling, bluegreen, or immediate. Default is canary, or rolling when max-per-region is set. 
     --vm-cpu-kind                   The kind of CPU to use ('shared' or 'performance') 
     --vm-cpukind                    The kind of CPU to use ('shared' or 'performance') 
     --vm-cpus                       Number of CPUs 
     --vm-gpu-kind                   If set, the GPU model to attach (a100-pcie-40gb, a100-sxm4-80gb, l40s) 
     --vm-gpukind                    If set, the GPU model to attach (a100-pcie-40gb, a100-sxm4-80gb, l40s) 
     --vm-gpus                       Number of GPUs. Must also choose the GPU model with --vm-gpu-kind flag 
     --vm-memory                     Memory (in megabytes) to attribute to the VM 
     --vm-size                       The VM size to set machines to. See "fly platform vm-sizes" for valid values 
     --volume-initial-size           The initial size in GB for volumes created on first deploy 
     --wait-timeout                  Time duration to wait for individual machines to transition states and become healthy. 
-y,  --yes                           Accept all confirmations 

Global Options

  -t, --access-token string   Fly API Access Token
      --debug                 Print additional logs and traces
      --verbose               Verbose output