Roll Back from an Upgrade

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

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.
  1. Stop and remove the current Harbor service if it is still running.

    cd harbor
    docker-compose down
    
  2. Remove current Harbor instance.

    rm -rf harbor
    
  3. Restore the older version of Harbor.

    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:

    cd harbor
    ./install.sh
    
While you can roll back an upgrade to the state before you started the upgrade, Harbor does not support downgrades.