---
title: Roll Back from an Upgrade
weight: 45
---

If, for any reason, you need to roll back to the previous version of Harbor, perform the following steps.

{{< note >}}
To roll back from an upgrade, you must have backed up the previous version of Harbor. For information about backing up Harbor before an upgrade, see [Upgrade Harbor and Migrate Data](../upgrade-migrate-data.md).
{{< /note >}}

1. Stop and remove the current Harbor service if it is still running.

    ```sh
    cd harbor
    docker-compose down
    ```

2. Remove current Harbor instance.

    ```sh
    rm -rf harbor
    ```

3. Restore the older version of Harbor.

    ```sh
    mv /my_backup_dir/harbor harbor
    ```

4. To restore the database, copy the data files from the backup directory to your data volume, which by default is `/data/database`.

5. Restart the Harbor service using the previous configuration.  
   
   If the previous version of Harbor was installed by a release build:

    ```sh
    cd harbor
    ./install.sh
    ```

{{< note >}}
While you can roll back an upgrade to the state before you started the upgrade, Harbor does not support downgrades.
{{< /note >}}