# Backup list tool - Enterprise features

**URL:** https://discuss.dgraph.io/t/backup-list-tool-enterprise-features/12718
**Category:** Documentation
**Created:** [February 9, 2021, 7:04pm UTC](https://discuss.dgraph.io/t/backup-list-tool-enterprise-features/12718 "2021-02-09T19:04:12Z")
**Posts on this page:** 1
**Page:** 1

<div class="post-metadata">

### Author: ![diggy](https://yyz1.discourse-cdn.com/flex007/user_avatar/discuss.dgraph.io/diggy/32/3666_2.png) [@diggy](https://discuss.dgraph.io/u/diggy)
#### Post date: [February 9, 2021, 7:04pm UTC](https://discuss.dgraph.io/t/backup-list-tool-enterprise-features/12718/1 "2021-02-09T19:04:12Z")

</div>

The `lsbackup` command-line tool prints information about the stored backups in a user-defined location.

## Parameters

The `lsbackup` command has two flags:

```
Flags:
  -h, --help help for lsbackup
  -l, --location string Sets the source location URI (required).
      --verbose Outputs additional info in backup list.

```

- `--location`: indicates a [source URI](https://dgraph.io#source-uri) with Dgraph backup objects. This URI supports all the schemes used for backup.
- `--verbose`: if enabled will print additional information about the selected backup.

For example, you can execute the `lsbackup` command as follows:

```
dgraph lsbackup -l <source-location-URI>

```

### Source URI

Source URI formats:

- `[scheme]://[host]/[path]?[args]`
- `[scheme]:///[path]?[args]`
- `/[path]?[args]` (only for local or NFS)

Source URI parts:

- `scheme`: service handler, one of: `s3`, `minio`, `file`
- `host`: remote address; e.g.: `dgraph.s3.amazonaws.com`
- `path`: directory, bucket or container at target; e.g.: `/dgraph/backups/`
- `args`: specific arguments that are ok to appear in logs

## Output

The following snippet is an example output of `lsbackup`:

```
[Decoder]: Using assembly version of decoder
Page Size: 4096
Listing backups from: ~/bkp
Name	Since	Groups	Encrypted
dgraph_backup/dgraph.20210121.125014.852/manifest.json	30005	map[1:[dgraph.graphql.schema_created_at dgraph.graphql.xid dgraph.drop.op dgraph.type dgraph.cors dgraph.graphql.schema_history score dgraph.graphql.p_query dgraph.graphql.schema dgraph.graphql.p_sha256hash series]]	false

```

### Return values

- `Name`: Name of the backup

- `Since`: is the timestamp at which this backup was taken. It’s called `Since` because it will become the timestamp from which to backup in the next incremental backup.

- `Groups`: is the map of valid groups to predicates at the time the backup was created. This is printed only if `--verbose` flag is enabled

- `Encrypted`: Indicates whether this backup is encrypted or not

## Examples

### S3

Checking information about backups stored in an AWS S3 bucket:

```
dgraph lsbackup -l s3:///s3.us-west-2.amazonaws.com/dgraph_backup

```

You might need to set up access and secret key environment variables in the shell (or session) you are going to run the `lsbackup` command. For example:

```
AWS_SECRET_ACCESS_KEY=<paste-your-secret-access-key>
AWS_ACCESS_ID=<paste-your-key-id>

```

### MinIO

Checking information about backups stored in a MinIO bucket:

```
dgraph lsbackup -l minio://localhost:9000/dgraph_backup

```

In case the MinIO server is started without `tls`, you must specify that `secure=false` as it set to `true` by default. You also need to set the environment variables for the access key and secret key.

In order to get the `lsbackup` running, you should following these steps:

- Set `MINIO_ACCESS_KEY` as an environment variable for the running shell this can be done with the following command: (`minioadmin` is the default access key, unless is changed by the user)

- Set MINIO\_SECRET\_KEY as an environment variable for the running shell this can be done with the following command: (`minioadmin` is the default secret key, unless is changed by the user)

- Add the argument `secure=false` to the `lsbackup command`, that means the command will look like: (the double quotes `"` are required)

### Local

Checking information about backups stored locally (on disk):

```
dgraph lsbackup -l ~/dgraph_backup

```

* * *
This is a companion discussion topic for the original entry at [https://dgraph.io/docs/enterprise-features/lsbackup/](https://dgraph.io/docs/enterprise-features/lsbackup/)
