Docker-harbor-backup

Harbor Backup & Restore Guide

📌 Overview

This document outlines the steps to backup and restore a Harbor registry setup on the server. It includes a custom backup script, storage paths, S3 upload details, and a step-by-step restore process.

🔄 Backup Process

📍 Script Location

The backup script is located at:

/home/pheonix/harbor/backup_harbor.sh

📋 What the Script Does

• Dumps the Harbor PostgreSQL database using pg_dumpall.
• Archives the following essential files and directories:
  • /root/harbor/harbor.yml
  • /root/harbor/install.sh
  • /root/harbor/docker-compose.yml
  • /root/harbor/prepare
  • /root/harbor/common/
  • /data/ – Contains Harbor image layers, configurations, and certificates.
  • The SQL dump file generated.

📂 Backup Output

After running the script, the following files are generated locally:

/opt/harbor/backups/

├── harbor_backup_<timestamp>.tar.gz

└── harbor_backup_<timestamp>_db.sql

☁️ Upload Destinations

Backup files are uploaded to:

• Local Directory: /opt/harbor/backups/
• AWS S3 Bucket: s3://docker-harbor-pheonix/ (docker-harbor-pheonix)

♻️ Harbor Restore Procedure

🔁 Step 1: Download Backup Files

Use the following commands to download the latest backup files from S3:

aws s3 cp s3://docker-harbor-pheonix/harbor_backup_<timestamp>.tar.gz /tmp/

aws s3 cp s3://docker-harbor-pheonix/harbor_backup_<timestamp>_db.sql /tmp/

📦 Step 2: Extract Archive

⚠️ Important: Untar the archive at the root "/" directory. Do not extract in /tmp, /home, or other directories — this could break path structure.

cd /

tar -xzf /tmp/harbor_backup_<timestamp>.tar.gz

This will restore:

• /root/harbor/ – Harbor installation files
• /data/ – Registry data, configs, certs
• /var/log/harbor/ – Harbor logs
• /opt/harbor/backups/ – DB dump file

🛠️ Step 3: Restore the Database

Start the database container:

cd /root/harbor

./prepare

docker-compose up -d harbor-db

sleep 10

Restore the database:

cat /opt/harbor/backups/harbor_backup_<timestamp>_db.sql | docker exec -i harbor-db psql -U postgres

🚀 Step 4: Start All Harbor Services

cd /root/harbor & ./prepare

docker-compose up -d

✅ Step 5: Access and Verify

Open your browser and visit:

https://dockerhub.pheonixsolutions.com

Check if:

• Harbor UI loads correctly
• Project and image data are intact
• Logs show normal activity

📎 Notes

• Ensure the S3 credentials used by the script have write permissions to the harbor-backups/ folder.
• Backup script should be scheduled via cron for regular automated backups.
• Always verify space availability on /opt and /data before starting a restore.