From b796521732f236d2a28761558f2e8002b5ec57c2 Mon Sep 17 00:00:00 2001 From: "docs-syncer[bot]" <134718678+docs-syncer[bot]@users.noreply.github.com> Date: Thu, 12 Nov 2026 20:35:07 +0000 Subject: [PATCH] [flyctl-bot] Update docs from flyctl --- flyctl/cmd/fly_mpg_connect.mdx | 23 +++++++++++++++---- flyctl/cmd/fly_tokens_create.mdx | 2 +- flyctl/cmd/fly_tokens_create_deploy.mdx | 2 +- flyctl/cmd/fly_tokens_create_machine-exec.mdx | 2 +- flyctl/cmd/fly_tokens_create_org.mdx | 2 +- flyctl/cmd/fly_tokens_create_readonly.mdx | 2 +- flyctl/cmd/fly_tokens_create_ssh.mdx | 2 +- flyctl/cmd/fly_tokens_create_wireguard.mdx | 2 +- 8 files changed, 26 insertions(+), 11 deletions(-) diff --git a/flyctl/cmd/fly_mpg_connect.mdx b/flyctl/cmd/fly_mpg_connect.mdx index fa67111eb7..105b6fb76a 100644 --- a/flyctl/cmd/fly_mpg_connect.mdx +++ b/flyctl/cmd/fly_mpg_connect.mdx @@ -3,18 +3,33 @@ title: fly mpg connect source_url: https://docs.fly.io/flyctl/cmd/fly_mpg_connect --- -Connect to a MPG database using psql +Connect to a MPG database using psql. + +With --command or --file, psql stops at the first SQL error and skips its +startup file. See the examples for scripted usage. ## Usage ``` fly mpg connect [flags] ``` +## Examples + +``` + fly mpg connect -c 'select count(*) from orders' + fly mpg connect -f migrations.sql + fly mpg connect -c 'select * from orders' -- --csv -t + # Piped SQL keeps psql defaults; enable ON_ERROR_STOP explicitly: + cat queries.sql | fly mpg connect -- -v ON_ERROR_STOP=1 + fly mpg connect --database app --username reader -c 'select current_user' +``` ## Options ``` - -d, --database string The database to connect to - -h, --help help for connect - -u, --username string The username to connect as + -c, --command stringArray The SQL command to run and exit (repeatable; mutually exclusive with --file) + -d, --database string The database to connect to + -f, --file stringArray The SQL file to run and exit (repeatable, - for stdin; mutually exclusive with --command) + -h, --help help for connect + -u, --username string The username to connect as ``` ## Global Options diff --git a/flyctl/cmd/fly_tokens_create.mdx b/flyctl/cmd/fly_tokens_create.mdx index 00cf16fd24..1c880eafc9 100644 --- a/flyctl/cmd/fly_tokens_create.mdx +++ b/flyctl/cmd/fly_tokens_create.mdx @@ -3,7 +3,7 @@ title: fly tokens create source_url: https://docs.fly.io/flyctl/cmd/fly_tokens_create --- -Create Fly.io API tokens +Create Fly.io API tokens The token is printed with its authorization scheme, as in "FlyV1 fm2_...". The "FlyV1 " prefix and the space after it are part of the token: copy the whole string, and quote it when you set it in a shell or a secret. ## Usage ``` diff --git a/flyctl/cmd/fly_tokens_create_deploy.mdx b/flyctl/cmd/fly_tokens_create_deploy.mdx index 1cdee516a0..f6e70d7217 100644 --- a/flyctl/cmd/fly_tokens_create_deploy.mdx +++ b/flyctl/cmd/fly_tokens_create_deploy.mdx @@ -3,7 +3,7 @@ title: fly tokens create deploy source_url: https://docs.fly.io/flyctl/cmd/fly_tokens_create_deploy --- -Create an API token limited to managing a single app and its resources. Also available as TOKENS DEPLOY. Tokens are valid for 20 years by default. We recommend using a shorter expiry if practical. +Create an API token limited to managing a single app and its resources. Also available as TOKENS DEPLOY. Tokens are valid for 20 years by default. We recommend using a shorter expiry if practical. The token is printed with its authorization scheme, as in "FlyV1 fm2_...". The "FlyV1 " prefix and the space after it are part of the token: copy the whole string, and quote it when you set it in a shell or a secret. ## Usage ``` diff --git a/flyctl/cmd/fly_tokens_create_machine-exec.mdx b/flyctl/cmd/fly_tokens_create_machine-exec.mdx index 1abf095858..2492f327c4 100644 --- a/flyctl/cmd/fly_tokens_create_machine-exec.mdx +++ b/flyctl/cmd/fly_tokens_create_machine-exec.mdx @@ -3,7 +3,7 @@ title: fly tokens create machine-exec source_url: https://docs.fly.io/flyctl/cmd/fly_tokens_create_machine-exec --- -Create an API token that can execute a restricted set of commands on a machine. Commands can be specified on the command line or with the command and command-prefix flags. If no command is provided, all commands are allowed. Tokens are valid for 20 years by default. We recommend using a shorter expiry if practical. +Create an API token that can execute a restricted set of commands on a machine. Commands can be specified on the command line or with the command and command-prefix flags. If no command is provided, all commands are allowed. Tokens are valid for 20 years by default. We recommend using a shorter expiry if practical. The token is printed with its authorization scheme, as in "FlyV1 fm2_...". The "FlyV1 " prefix and the space after it are part of the token: copy the whole string, and quote it when you set it in a shell or a secret. ## Usage ``` diff --git a/flyctl/cmd/fly_tokens_create_org.mdx b/flyctl/cmd/fly_tokens_create_org.mdx index ea82781829..468a19d327 100644 --- a/flyctl/cmd/fly_tokens_create_org.mdx +++ b/flyctl/cmd/fly_tokens_create_org.mdx @@ -3,7 +3,7 @@ title: fly tokens create org source_url: https://docs.fly.io/flyctl/cmd/fly_tokens_create_org --- -Create an API token limited to managing a single org and its resources. Tokens are valid for 20 years by default. We recommend using a shorter expiry if practical. +Create an API token limited to managing a single org and its resources. Tokens are valid for 20 years by default. We recommend using a shorter expiry if practical. The token is printed with its authorization scheme, as in "FlyV1 fm2_...". The "FlyV1 " prefix and the space after it are part of the token: copy the whole string, and quote it when you set it in a shell or a secret. ## Usage ``` diff --git a/flyctl/cmd/fly_tokens_create_readonly.mdx b/flyctl/cmd/fly_tokens_create_readonly.mdx index 5a30170794..05d925dfe1 100644 --- a/flyctl/cmd/fly_tokens_create_readonly.mdx +++ b/flyctl/cmd/fly_tokens_create_readonly.mdx @@ -3,7 +3,7 @@ title: fly tokens create readonly source_url: https://docs.fly.io/flyctl/cmd/fly_tokens_create_readonly --- -Create an API token limited to reading a single org and its resources. Tokens are valid for 20 years by default. We recommend using a shorter expiry if practical. +Create an API token limited to reading a single org and its resources. Tokens are valid for 20 years by default. We recommend using a shorter expiry if practical. The token is printed with its authorization scheme, as in "FlyV1 fm2_...". The "FlyV1 " prefix and the space after it are part of the token: copy the whole string, and quote it when you set it in a shell or a secret. ## Usage ``` diff --git a/flyctl/cmd/fly_tokens_create_ssh.mdx b/flyctl/cmd/fly_tokens_create_ssh.mdx index 342b4626f9..0017ec04d1 100644 --- a/flyctl/cmd/fly_tokens_create_ssh.mdx +++ b/flyctl/cmd/fly_tokens_create_ssh.mdx @@ -3,7 +3,7 @@ title: fly tokens create ssh source_url: https://docs.fly.io/flyctl/cmd/fly_tokens_create_ssh --- -Create token for SSH'ing to a single app. To be able to SSH to an app, this token is also allowed to connect to the org's wireguard network. +Create token for SSH'ing to a single app. To be able to SSH to an app, this token is also allowed to connect to the org's wireguard network. The token is printed with its authorization scheme, as in "FlyV1 fm2_...". The "FlyV1 " prefix and the space after it are part of the token: copy the whole string, and quote it when you set it in a shell or a secret. ## Usage ``` diff --git a/flyctl/cmd/fly_tokens_create_wireguard.mdx b/flyctl/cmd/fly_tokens_create_wireguard.mdx index d1cba144af..3680de46f7 100644 --- a/flyctl/cmd/fly_tokens_create_wireguard.mdx +++ b/flyctl/cmd/fly_tokens_create_wireguard.mdx @@ -3,7 +3,7 @@ title: fly tokens create wireguard source_url: https://docs.fly.io/flyctl/cmd/fly_tokens_create_wireguard --- -Create an API token limited to WireGuard peer management for an organization. Tokens are valid for 20 years by default. We recommend using a shorter expiry if practical. +Create an API token limited to WireGuard peer management for an organization. Tokens are valid for 20 years by default. We recommend using a shorter expiry if practical. The token is printed with its authorization scheme, as in "FlyV1 fm2_...". The "FlyV1 " prefix and the space after it are part of the token: copy the whole string, and quote it when you set it in a shell or a secret. ## Usage ```