From c6f0e587ef9cea393294e3f93ebefee8eb991175 Mon Sep 17 00:00:00 2001 From: vincent Date: Thu, 23 Jul 2026 14:06:25 -0400 Subject: [PATCH 1/2] Clarify interactive shell app lifecycle --- machines/flyctl/fly-machine-run.html.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/machines/flyctl/fly-machine-run.html.md b/machines/flyctl/fly-machine-run.html.md index 4d9424dc8e..6fd3724a23 100644 --- a/machines/flyctl/fly-machine-run.html.md +++ b/machines/flyctl/fly-machine-run.html.md @@ -123,7 +123,7 @@ The following command creates a temporary Machine using the Dockerfile in the wo fly machine run . --shell ``` -If you don't specify an app, a temporary app is created for the Machine. When you log out of the shell, the Machine, and if applicable, the temporary app, is deleted. +If you don't specify an app, flyctl creates or reuses an app for interactive shells. When you log out of the shell, the Machine is deleted; the app is retained for future shells. The default shell is Bash. The `--command` flag allows you to specify a different shell if Bash isn't present in the Machine's Docker image. Log in as a non-`root` user using the `--user` flag. From f0c1c9ec2cf5e4dc178ab80ce31fb7eec02f3f25 Mon Sep 17 00:00:00 2001 From: vincent Date: Thu, 23 Jul 2026 14:22:59 -0400 Subject: [PATCH 2/2] docs: simplify region heading --- machines/flyctl/fly-machine-run.html.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/machines/flyctl/fly-machine-run.html.md b/machines/flyctl/fly-machine-run.html.md index 6fd3724a23..9fc4543872 100644 --- a/machines/flyctl/fly-machine-run.html.md +++ b/machines/flyctl/fly-machine-run.html.md @@ -77,7 +77,7 @@ You can give the Machine a custom name with the `--name` flag: fly machine run . --name my-special-Machine ``` -## Choose a geographical region +## Choose a region Tell the Fly.io platform which [region](/docs/reference/regions/) to create the Machine in with the `--region` flag; if for some reason it can't start a new Machine in that region, you'll get an error. If the `--region` flag is omitted, the platform chooses the region that's fastest to reach from your location.