# mc tree

LLMS index: [llms.txt](/llms.txt)

---

<a id="mc-tree"></a>

<a id="command-mc.tree"></a>

## Syntax {#syntax}

The [`mc tree`](#command-mc.tree) command lists all prefixes inside a MinIO bucket in a tree format. The command optionally supports listing all objects inside of bucket at each prefix, including the bucket root.

You can also use [`mc tree`](#command-mc.tree) against a local filesystem directory to produce similar results to the `tree` commandline tool.

**EXAMPLE**

The following command prints a complete tree of all objects at any depth in the `mydata` bucket on the `myminio` MinIO deployment:

```shell
mc tree --files myminio/mydata
```

**SYNTAX**

The command has the following syntax:

```shell
mc [GLOBALFLAGS] tree                 \
                 [--depth int]        \
                 [--files]            \
                 [--rewind "string"]  \
```

- Brackets `[]` indicate optional parameters.
- Parameters sharing a line are mutually dependent.
- Parameters separated using the pipe `|` operator are mutually exclusive.

Copy the example to a text editor and modify as-needed before running the command in the terminal/shell.

### Parameters {#parameters}

##### `ALIAS` {#mc.tree.ALIAS}

*mc-cmd*

*Required* The [alias](/reference/minio-mc/mc-alias-set/#alias) of a MinIO deployment and the full path to the bucket to list the tree hierarchy. For example:

```shell
mc tree myminio/mybucket
```

You can specify multiple targets to the [`mc tree`](#command-mc.tree) command. For example:

```shell
mc tree myminio/mybucket myminio/myotherbucket
```

For retrieving the tree heirarchy of a local filesystem directory, specify the full path to that directory. For example:

```shell
mc tree ~/minio/mydata/
```

##### `--depth, d` {#mc.tree.-depth}

*mc-cmd*

*Optional* Limit the tree depth to the specified integer value.

Defaults to `-1` or unlimited depth.

##### `--files, f` {#mc.tree.-files}

*mc-cmd*

*Optional* Includes files in the object or directory in the [`mc tree`](#command-mc.tree) output.

##### `--rewind` {#mc.tree.-rewind}

*mc-cmd*

*Optional*

Directs [`mc tree`](#command-mc.tree) to operate only on the object version(s) that existed at specified point-in-time.

- To rewind to a specific date in the past, specify the date as an ISO8601-formatted timestamp. For example: `--rewind "2020.03.24T10:00"`.
- To rewind a duration in time, specify the duration as a string in `#d#hh#mm#ss` format. For example: `--rewind "1d2hh3mm4ss"`.

[`--rewind`](#mc.tree.-rewind) requires that the specified [`ALIAS`](#mc.tree.ALIAS) be an S3-compatible service that supports [Bucket Versioning](/administration/object-management/object-versioning/#minio-bucket-versioning). For MinIO deployments, use [`mc version`](/reference/minio-mc/mc-version/#command-mc.version) to enable or disable bucket versioning.

## Examples {#examples}

```shell
mc tree ALIAS/PATH
```

- Replace [`ALIAS`](#mc.tree.ALIAS) with the [alias](/reference/minio-mc/mc-alias-set/#alias) of the MinIO deployment.
- Replace [`PATH`](#mc.tree.ALIAS) with the path to the bucket on the MinIO deployment.

## Behavior {#behavior}

### S3 Compatibility {#s3-compatibility}

SILO is the supported server for PGSTY mcli; compatibility with upstream MinIO and other S3 services is [best effort](/reference/minio-mc/#command-mc).