---
name: "zpool-upgrade"
section: "8"
platform: "linux"
package: "zfsutils-linux"
version: "2.3.9-0+deb13u1"
release: "Debian 13 (Trixie)"
platforms: ["linux", "freebsd"]
url: "https://new.carta.tech/zpool-upgrade"
---

# zpool-upgrade(8)

manage version and feature flags of ZFS storage pools

## NAME

**zpool-upgrade** – manage version and feature flags of ZFS storage pools

## SYNOPSIS

**zpool** **upgrade**

**zpool** **upgrade** **-v**

**zpool** **upgrade** \[**-V** *version*\] **-a**\|*pool*…

## DESCRIPTION

-

  **zpool** **upgrade** Displays pools which do not have all supported features enabled and pools formatted using a legacy ZFS version number. These pools can continue to be used, but some features may not be available. Use **zpool** **upgrade** **-a** to enable all features on all pools (subject to the **-o** **compatibility** property).

-

  **zpool** **upgrade** **-v** Displays legacy ZFS versions supported by the this version of ZFS. See [zpool-features(7)](/zpool-features/7.md) for a description of feature flags features supported by this version of ZFS.

-

  **zpool** **upgrade** \[**-V** *version*\] **-a**\|*pool*… Enables all supported features on the given pool.

  If the pool has specified compatibility feature sets using the **-o** **compatibility** property, only the features present in all requested compatibility sets will be enabled. If this property is set to *legacy* then no upgrade will take place.

  Once this is done, the pool will no longer be accessible on systems that do not support feature flags. See [zpool-features(7)](/zpool-features/7.md) for details on compatibility with systems that support feature flags, but do not support all features enabled on the pool.

  - **-a**

    Enables all supported features (from specified compatibility sets, if any) on all pools.

  - **-V** *version*

    Upgrade to the specified legacy version. If specified, no features will be enabled on the pool. This option can only be used to increase the version number up to the last supported legacy version number.

## EXAMPLES

### Example 1 : No Upgrading All ZFS Storage Pools to the Current Version

The following command upgrades all ZFS Storage pools to the current version of the software:

```
# zpool upgrade -a
This system is currently running ZFS version 2.
```

## SEE ALSO

[zpool-features(7)](/zpool-features/7.md), [zpoolconcepts(7)](/zpoolconcepts/7.md), [zpoolprops(7)](/zpoolprops/7.md), [zpool-history(8)](/zpool-history/8.md)