API version: dev

---

# `backup:list`

Lists all backups available in local backup storage, sorted by creation date descending (most
recent first).

Takes no arguments or options. For each backup folder that contains a `summary.json` (written by
`backup:create` or `backup:fetch`), it prints the backup name, hostname, API version, creation
date, and node/relation/file counts read from that file. Folders without a `summary.json` are
skipped and logged, not shown in the table - they are typically leftovers from an interrupted
`backup:create` or `backup:fetch` run.

## Help

```bash
php bin/console backup:list --help
```

```text
Description:
  Lists all available local backups.

Usage:
  backup:list

Options:
  -h, --help            Display help for the given command. When no command is given display help for the list command
      --silent          Do not output any message
  -q, --quiet           Only errors are displayed. All other output is suppressed
  -V, --version         Display this application version
      --ansi|--no-ansi  Force (or disable --no-ansi) ANSI output
  -n, --no-interaction  Do not ask any interactive question
  -e, --env=ENV         The Environment name. [default: "prod"]
      --no-debug        Switch off debug mode.
      --profile         Enables profiling (requires debug).
  -v|vv|vvv, --verbose  Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
```

## Example

```bash
php bin/console backup:list
```

```text
    ▄
  ▄▀ ▀▄  Ember Nexus API
   ▀█▀   v0.1.31, production mode

  Backup List

  Name               Hostname     Version  Date        Nodes  Edges  Files 
  reference-dataset  ember-nexus  dev      2023-05-06  282    338    0

▶ Command finished successfully.
```

---

Home: [Ember Nexus API docs](/index.md)

Full site map: [llms.txt](/llms.txt)

Previous: [backup:fetch](/command/backup-fetch.md)

Next: [backup:load](/command/backup-load.md)