fly machine run
Run a machine
Usage
fly machine run <image> [command] [flags]
Options
-a, --app string Application name
--autostart Automatically start a stopped Machine when a network request is received (default true)
--autostop string[="stop"] Automatically stop a Machine when there are no network requests for it. Options include 'off', 'stop', and 'suspend'. (default "off")
--build-depot Build your image with depot.dev
--build-nixpacks Build your image with nixpacks
--command string Used with --shell. The command to run, if we're shelling into the Machine now (in case you don't have bash). (default "/bin/bash")
-c, --config string Path to application configuration file
--detach Return immediately instead of monitoring deployment progress
--dockerfile string The path to a Dockerfile. Defaults to the Dockerfile in the working directory.
--entrypoint string The command to override the Docker ENTRYPOINT.
-e, --env stringArray Set of environment variables in the form of NAME=VALUE pairs. Can be specified multiple times.
--file-literal stringArray Set of literals to write to the Machine, in the form of /path/inside/machine=VALUE pairs, where VALUE is the base64-encoded raw content. Can be specified multiple times.
--file-local stringArray Set of files to write to the Machine, in the form of /path/inside/machine=<local/path> pairs. Can be specified multiple times.
--file-secret stringArray Set of secrets to write to the Machine, in the form of /path/inside/machine=SECRET pairs, where SECRET is the name of the secret. The content of the secret must be base64 encoded. Can be specified multiple times.
-h, --help help for run
--host-dedication-id string The dedication id of the reserved hosts for your organization (if any)
--id string Machine ID, if previously known
--kernel-arg stringArray A list of kernel arguments to provide to the init. Can be specified multiple times.
--machine-config string Read machine config from json file or string
-m, --metadata stringArray Metadata in the form of NAME=VALUE pairs. Can be specified multiple times.
-n, --name string Machine name. Will be generated if omitted.
--org string The organization that will own the app
-p, --port strings The external ports and handlers for services, in the format: port[:machinePort][/protocol[:handler[:handler...]]])
For example: --port 80/tcp --port 443:80/tcp:http:tls --port 5432/tcp:pg_tls
To remove a port mapping use '-' as handler. For example: --port 80/tcp:-
-r, --region string The target region (see 'flyctl platform regions')
--restart string Set the restart policy for a Machine. Options include 'no', 'always', and 'on-fail'.
Default is 'on-fail' for Machines created by 'fly deploy' and Machines with a schedule. Default is 'always' for Machines created by 'fly m run'.
--rm Automatically remove the Machine when it exits. Sets the restart-policy to 'never' if not otherwise specified.
--schedule string Schedule a Machine run at hourly, daily and monthly intervals
--shell Open a shell on the Machine once created (implies --it --rm). If no app is specified, a temporary app is created just for this Machine and destroyed when the Machine is destroyed. See also --command and --user.
--skip-dns-registration Do not register the machine's 6PN IP with the internal DNS system
--standby-for strings For Machines without services, a comma separated list of Machine IDs to act as standby for.
--use-zstd Enable zstd compression for the image
--user string Used with --shell. The username, if we're shelling into the Machine now. (default "root")
--vm-cpu-kind string The kind of CPU to use ('shared' or 'performance')
--vm-cpus int Number of CPUs
--vm-gpu-kind string If set, the GPU model to attach (a100-pcie-40gb, a100-sxm4-80gb, l40s, a10, none)
--vm-gpus int Number of GPUs. Must also choose the GPU model with --vm-gpu-kind flag
--vm-memory string 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
-v, --volume strings Volume to mount, in the form of <volume_id_or_name>:/path/inside/machine[:<options>]
--wg Determines whether communication with remote builders are conducted over wireguard or plain internet(https) (default true)
Global Options
-t, --access-token string Fly API Access Token
--debug Print additional logs and traces
--verbose Verbose output
See Also
- fly machine - Manage Fly Machines.