Skip to content

Removed deprecated command from the docs and clarified required format for the --image-ref argument #1962

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
kcmartin merged 2 commits into from
Jul 7, 2026
Merged

Removed deprecated command from the docs and clarified required format for the --image-ref argument #1962

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a96ab99
Removed deprecated command from the docs and clarified required froma…
eporto2021 Mar 14, 2025
8dd3d91
Fix placeholder rendering and typos, match docs placeholder style
kcmartin Jul 7, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 4 additions & 32 deletions postgres/managing/backup-and-restore.html.markerb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,35 +13,7 @@ Postgres databases on Fly.io are treated as Fly Apps, which you can [read more a

## Finding the database app instance

If you set up your application using `fly launch`, the name of your database app might be `<app-name>-db`, or you might have given it a name during the initial configuration. To figure that out for sure, run the following from the root of the project:

```cmd
fly info
```
```output
App
Name = my-app
Owner = personal
Version = 40
Status = running
Hostname = my-app.fly.dev
```

The `Name` key is the name of your app. In this case, the database app would be `my-app-db`. Let's see if that instance exists by appending the `-a` flag with the name of the database application:

```cmd
fly info -a my-app-db
```
```output
App
Name = my-app-db
Owner = personal
Version = 40
Status = running
Hostname = my-app-db.fly.dev
```

If that doesn't work, then try to find the database instance by running:
If you set up your application using `fly launch`, the name of your database app might be `<app-name>-db`, or you might have given it a name during the initial configuration. To find the name of your Postgres app, run:

```cmd
fly postgres list
Expand All @@ -51,7 +23,7 @@ NAME OWNER STATUS LATEST DEPLOY
my-app-db personal running 37m11s ago
```

and look for the database instance under the `NAME` column on the list.
Look for your database app under the `NAME` column. In this example, `my-app-db` is the value to use for `<postgres-app-name>` in the following commands.

## Listing snapshots

Expand Down Expand Up @@ -97,14 +69,14 @@ MACHINE ID REGISTRY REPOSITORY TAG VERSION DIGEST
e286004f696700 registry-1.docker.io flyio/postgres 14.6 v0.0.41 sha256:3c25db96357a78e827ca7d fly.app_role=postgres_clusterfly.pg-version=14.6-1.pgdg110+1fly.version=v0.0.41
```
The values under the `REPOSITORY` and `TAG` columns reference the image you'll use to restore the snapshot.
Legacy postgres images use the `flyio/postgres` repository, while new Postgres Flex images use the `flyio/postgres-flex` repository. In the above example, the machine is running a legacy `flyio/postgres:14.6` image.
Legacy postgres images use the `flyio/postgres` repository, while new Postgres Flex images use the `flyio/postgres-flex` repository. Join the two values with a colon to form the image reference: in the above example, the machine is running a legacy `flyio/postgres:14.6` image.

## Restoring from a snapshot

To restore a Postgres application from a snapshot, simply specify the `--snapshot-id` argument and the `--image-ref` argument when running the `create` command as shown below:

```cmd
fly postgres create --snapshot-id <snapshot-id> --image-ref <image-version>
fly postgres create --snapshot-id <snapshot-id> --image-ref <repository>:<tag>
```
```output
? App Name: my-app-db-restored
Expand Down
Loading