Migrate Coolify to a new server

readme.md

Moved to a repo at https://github.com/Geczy/coolify-migration

TPGLLC-US

You didn't per chance write another that runs from a clean machine, checks the storage bucket for backups, and upon choosing one restores it?

glad everyone likes the script <3

@dreadedhamish you can probably ask chatgpt to do that no?

Here is the script modified by o1 to handle a ssh key passphrase using ssh-agent:

#!/bin/bash

# This script will backup your Coolify instance and move everything to a new server. Docker volumes, Coolify database, and ssh keys

# 1. Script must run on the source server
# 2. Have all the containers running that you want to migrate

# Configuration - Modify as needed
sshKeyPath="$HOME/.ssh/your_private_key" # Key to destination server
destinationHost="server.example.com" # destination server IP or domain

# -- Shouldn't need to modify anything below --
backupSourceDir="/data/coolify/"
backupFileName="coolify_backup.tar.gz"

# Function to initialize ssh-agent and add the SSH key
initialize_ssh_agent() {
  # Check if ssh-agent is already running
  if [ -z "$SSH_AGENT_PID" ] || ! ps -p "$SSH_AGENT_PID" > /dev/null 2>&1; then
    echo "🔄 Starting ssh-agent..."
    eval "$(ssh-agent -s)"
    if [ $? -ne 0 ]; then
      echo "❌ Failed to start ssh-agent"
      exit 1
    fi
    echo "✅ ssh-agent started"
  else
    echo "✅ ssh-agent is already running"
  fi

  # Add the SSH key to the agent
  echo "🔒 Adding SSH key to ssh-agent"
  ssh-add "$sshKeyPath"
  if [ $? -ne 0 ]; then
    echo "❌ Failed to add SSH key. Please ensure the passphrase is correct."
    exit 1
  fi
  echo "✅ SSH key added to ssh-agent"
}

# Initialize ssh-agent and add the SSH key
initialize_ssh_agent

# Check if the source directory exists
if [ ! -d "$backupSourceDir" ]; then
  echo "❌ Source directory $backupSourceDir does not exist"
  exit 1
fi
echo "✅ Source directory exists"

# Check if the SSH key file exists
if [ ! -f "$sshKeyPath" ]; then
  echo "❌ SSH key file $sshKeyPath does not exist"
  exit 1
fi
echo "✅ SSH key file exists"

# Check if we can SSH to the destination server, ignore "The authenticity of host can't be established." errors
if ! ssh -o "StrictHostKeyChecking no" -o "ConnectTimeout=5" root@"$destinationHost" "exit"; then
  echo "❌ SSH connection to $destinationHost failed"
  exit 1
fi
echo "✅ SSH connection successful"

# Get the names of all running Docker containers
containerNames=$(docker ps --format '{{.Names}}')

# Initialize an empty string to hold the volume paths
volumePaths=""

# Loop over the container names
for containerName in $containerNames; do
  # Get the volumes for the current container
  volumeNames=$(docker inspect --format '{{range .Mounts}}{{.Name}}{{end}}' "$containerName")

  # Loop over the volume names
  for volumeName in $volumeNames; do
    # Check if the volume name is not empty
    if [ -n "$volumeName" ]; then
      # Add the volume path to the volume paths string
      volumePaths+=" /var/lib/docker/volumes/$volumeName"
    fi
  done
done

# Calculate the total size of the volumes
# shellcheck disable=SC2086
totalSize=$(du -csh $volumePaths 2>/dev/null | grep total | awk '{print $1}')

# Print the total size of the volumes
echo "✅ Total size of volumes to migrate: $totalSize"

# Print size of backupSourceDir
backupSourceDirSize=$(du -csh "$backupSourceDir" 2>/dev/null | grep total | awk '{print $1}')
echo "✅ Size of the source directory: $backupSourceDirSize"

# Check if the backup file already exists
if [ ! -f "$backupFileName" ]; then
  echo "🚸 Backup file does not exist, creating"

  # Recommend stopping docker before creating the backup
  echo "🚸 It's recommended to stop all Docker containers before creating the backup"
  read -rp "Do you want to stop Docker? (y/n): " answer
  if [[ "$answer" =~ ^[Yy]$ ]]; then
    if ! systemctl stop docker; then
      echo "❌ Docker stop failed"
      exit 1
    fi
    echo "✅ Docker stopped"
  else
    echo "🚸 Docker not stopped, continuing with the backup"
  fi

  # shellcheck disable=SC2086
  if ! tar --exclude='*.sock' -Pczf "$backupFileName" -C / "$backupSourceDir" "$HOME/.ssh/authorized_keys" $volumePaths; then
    echo "❌ Backup file creation failed"
    exit 1
  fi
  echo "✅ Backup file created"
else
  echo "🚸 Backup file already exists, skipping creation"
fi

# Define the remote commands to be executed
remoteCommands="
  # Check if Docker is a service
  if systemctl is-active --quiet docker; then
    # Stop Docker if it's a service
    if ! systemctl stop docker; then
      echo '❌ Docker stop failed';
      exit 1;
    fi
    echo '✅ Docker stopped';
  else
    echo 'ℹ️ Docker is not a service, skipping stop command';
  fi

  echo '🚸 Saving existing authorized keys...';
  cp ~/.ssh/authorized_keys ~/.ssh/authorized_keys_backup;

  echo '🚸 Extracting backup file...';
  if ! tar -Pxzf - -C /; then
    echo '❌ Backup file extraction failed';
    exit 1;
  fi
  echo '✅ Backup file extracted';

  echo '🚸 Merging authorized keys...';
  cat ~/.ssh/authorized_keys_backup ~/.ssh/authorized_keys | sort | uniq > ~/.ssh/authorized_keys_temp;
  mv ~/.ssh/authorized_keys_temp ~/.ssh/authorized_keys;
  chmod 600 ~/.ssh/authorized_keys;
  echo '✅ Authorized keys merged';

  if ! curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash; then
    echo '❌ Coolify installation failed';
    exit 1;
  fi
  echo '✅ Coolify installed';
"

# SSH to the destination server, execute the remote commands
if ! ssh root@"$destinationHost" "$remoteCommands" < "$backupFileName"; then
  echo "❌ Remote commands execution or Docker restart failed"
  exit 1
fi
echo "✅ Remote commands executed successfully"

# Clean up - Ask the user for confirmation before removing the local backup file
echo "Do you want to remove the local backup file? (y/n)"
read -r answer
if [[ "$answer" =~ ^[Yy]$ ]]; then
  if ! rm -f "$backupFileName"; then
    echo "❌ Failed to remove local backup file"
    exit 1
  fi
  echo "✅ Local backup file removed"
else
  echo "🚸 Local backup file not removed"
fi

# Kill ssh-agent if it was started by this script
if [ -n "$SSH_AGENT_PID" ]; then
  echo "🔒 Stopping ssh-agent..."
  eval "$(ssh-agent -k)"
  echo "✅ ssh-agent stopped"
fi

Thanks everyone for helping with this.

Thanks a lot , Great work

Thanks very much for everyone's input. Yesterday, I had to migrate a live self-hosted admin and spent the better part of a day trying different approaches. In the end, I found the variation provided by @AlejandroAkbal to be spot-on for my needs, and it worked on the first run.

does this script works for v3? i am using v3 coolify and i want to migrate it to new vps. i guess moving it to v4 isn't possible automatically. so does it work for v3 ?

Does this script work for 4.0.0 beta?

It works like a breeze! Thank you very much! I think coolify must use this as an official extension.

I used Codeium Windsurf to create this version that moves a service from the main Coolify server to another server managed by Coolify.
Hope this is useful for someone else.

#!/bin/bash

# Exit on any error
set -e

# This script will backup specific running services identified by Coolify service uuid on the [Origin] Server (that is running Coolify) and move them to a [Destination] Server managed by Coolify Application
# You will need to manually collect and modify data from Coolify's Postgres Database (running in the container coolify-db) on the [Origin] Server.
# To do this you can install the NocoDB application on your [Origin] Server with the "Connect To Predefined Network" option activated. 
# Then in NocoDB you can create a Postgres database connection to Host address "coolify-db" with the username and password you can find in Coolify UI Settings/Backup page.
# Finally in NocoDB you can create a data source using the connection you just created to see all the tables of the "coolify" database.
# PRIVATE_KEY_UUID can be found in the table "private_keys" and Coolify service uuid in the table "services"

# Configuration - Modify as needed
sshKeyPath="/data/coolify/ssh/keys/ssh_key@PRIVATE_KEY_UUID" # PRIVATE KEY to connect to [Destination] Server. The corresponding Public Key should be added to authorized_keys on [Destination] Server
destinationHost="my.server.com" # [Destination] Server IP or Domain

# Check if running as root
if [ "$EUID" -ne 0 ]; then
    echo "❌ [Origin] Please run as root"
    exit 1
fi

# Check if service suffixes were provided
if [ $# -eq 0 ]; then
    echo "❌ [Origin] Please provide at least one Coolify service uuid"
    echo "[Origin] Usage: $0 <coolify_service_uuid1> [coolify_service_uuid2 ...]"
    exit 1
fi

# Set up directories and filenames
backupDir="/data/coolify/services_backup"
destinationDir="/data/coolify/services_backup"
servicesBackupFile="services_backup.tar.gz"
volumesBackupFile="volumes_backup.tar.gz"

# Create backup directories if they don't exist
mkdir -p "$backupDir"

# Start ssh-agent and add key
echo "🔄 [Origin] Starting ssh-agent..."
eval $(ssh-agent)
echo "✅ [Origin] ssh-agent started"

echo "🔄 [Origin] Adding SSH key to ssh-agent"
if ! ssh-add "$sshKeyPath"; then
    echo "❌ [Origin] Failed to add SSH key to ssh-agent"
    kill "$SSH_AGENT_PID"
    exit 1
fi
echo "✅ [Origin] SSH key added to ssh-agent"

# Test SSH connection
if ! ssh -o "StrictHostKeyChecking no" root@"$destinationHost" "exit"; then
    echo "❌ SSH connection to Destination Server failed"
    kill "$SSH_AGENT_PID"
    exit 1
fi
echo "✅ SSH connection to Destination Server successful"

# Ensure backup directory exists on destination server
echo "🔄 [Destination] Creating backup directory..."
if ! ssh -o "StrictHostKeyChecking no" root@"$destinationHost" "mkdir -p '$destinationDir'"; then
    echo "❌ [Destination] Failed to create backup directory"
    exit 1
fi
echo "✅ [Destination] Backup directory created"

# Process each service suffix to gather information
declare -a containers_to_stop=()
declare -A volume_dict
for service_suffix in "$@"; do
    echo "🔄 [Origin] Analyzing service: $service_suffix"
    
    # Validate service suffix
    if ! [[ $service_suffix =~ ^[a-zA-Z0-9_-]+$ ]]; then
        echo "❌ [Origin] Invalid service suffix: $service_suffix. Only alphanumeric characters, hyphens, and underscores are allowed."
        exit 1
    fi

    # Check service directory
    serviceSourceDir="/data/coolify/services/${service_suffix}"
    if [ ! -d "$serviceSourceDir" ]; then
        echo "❌ [Origin] Service directory not found: $serviceSourceDir"
        exit 1
    fi
    servicePaths+=" $serviceSourceDir"
    echo "✅ [Origin] Service directory found: $serviceSourceDir"

    # Get container IDs for this service
    container_ids=($(docker ps --filter "name=${service_suffix}" --format "{{.ID}}"))
    if [ ${#container_ids[@]} -eq 0 ]; then
        echo "❌ [Origin] No running containers found for service: $service_suffix"
        exit 1
    fi
    all_container_ids+=("${container_ids[@]}")
    containers_to_stop+=("${container_ids[@]}")
    
    echo "✅ [Origin] Found ${#container_ids[@]} container(s) for service: $service_suffix"

    # Get volumes for containers
    for container_id in "${container_ids[@]}"; do
        # Verify container state
        container_state=$(docker inspect --format '{{.State.Status}}' "$container_id")
        if [ "$container_state" != "running" ]; then
            echo "❌ [Origin] Container $container_id is not running (status: $container_state)"
            exit 1
        fi

        # Get volumes and process them line by line
        while IFS= read -r volumeName; do
            if [ -n "$volumeName" ] && [ -z "${volume_dict[$volumeName]}" ]; then
                volume_dict[$volumeName]=1
                if [ ! -d "/var/lib/docker/volumes/$volumeName/_data" ]; then
                    echo "❌ [Origin] Volume directory not found: /var/lib/docker/volumes/$volumeName/_data"
                    exit 1
                fi
                volumePaths+=" /var/lib/docker/volumes/$volumeName"
                echo "  ✅ [Origin] Found volume: $volumeName"
            fi
        done < <(docker inspect --format='{{range .Mounts}}{{if eq .Type "volume"}}{{.Name}}{{println}}{{end}}{{end}}' "$container_id")
    done
done

# Calculate total size
total_size=0
for path in $servicePaths $volumePaths; do
    size=$(du -sb "$path" 2>/dev/null | cut -f1)
    total_size=$((total_size + size))
done
echo "✅ [Origin] Total size to backup: $(numfmt --to=iec-i --suffix=B $total_size)"

# Create services backup first (without stopping containers)
echo "🔄 [Origin] Creating services backup..."
echo "[Origin] Service paths to backup:"
for path in $servicePaths; do
    echo "  - $path"
done

services_list_file=$(mktemp)
for path in $servicePaths; do
    echo "$path" >> "$services_list_file"
done

if ! tar --exclude='*.sock' -Pczf "${backupDir}/${servicesBackupFile}" -T "$services_list_file"; then
    echo "❌ [Origin] Services backup file creation failed"
    rm -f "$services_list_file"
    exit 1
fi
rm -f "$services_list_file"
echo "✅ [Origin] Services backup file created"

# Transfer services backup while containers are still running
echo "🔄 Transferring services backup to Destination Server..."
if ! scp "${backupDir}/${servicesBackupFile}" "root@${destinationHost}:${destinationDir}/${servicesBackupFile}"; then
    echo "❌ Transfer to Destination Server failed"
    exit 1
fi

# Execute Phase 1 on destination (prepare volumes) while origin containers are still running
echo "🔄 Executing Phase 1 (Services restoration and volume preparation)..."
phase1Commands="
    # Check if backup file was transferred successfully
    if [ ! -f '${destinationDir}/${servicesBackupFile}' ]; then
        echo '❌ [Destination] Services backup file not found after transfer'
        echo '[Destination] Expected location: ${destinationDir}/${servicesBackupFile}'
        ls -la '${destinationDir}'
        exit 1
    fi
    echo '✅ [Destination] Services backup file found'

    # Clean up existing volumes
    echo '🔄 [Destination] Cleaning up existing volumes...'
    for volume_name in \$(docker volume ls --format '{{.Name}}' | grep '^${@}'); do
        echo \"Removing volume: \$volume_name\"
        if ! docker volume rm -f \"\$volume_name\" 2>/dev/null; then
            echo \"⚠️ [Destination] Could not remove volume \$volume_name, it might be in use\"
            # Try to find and stop containers using this volume
            containers=\$(docker ps -a --filter volume=\$volume_name --format '{{.ID}}')
            if [ -n \"\$containers\" ]; then
                echo \"Found containers using volume \$volume_name, stopping them...\"
                echo \"\$containers\" | xargs docker rm -f
                # Try removing the volume again
                if ! docker volume rm -f \"\$volume_name\"; then
                    echo \"❌ [Destination] Failed to remove volume \$volume_name even after stopping containers\"
                    exit 1
                fi
            fi
        fi
        echo \"✅ [Destination] Removed volume: \$volume_name\"
    done
    echo '✅ [Destination] Volume cleanup completed'

    # Extract services backup
    echo '🔄 [Destination] Extracting services backup...'
    if ! tar -Pxzf '${destinationDir}/${servicesBackupFile}' -C /; then
        echo '❌ [Destination] Services backup extraction failed'
        exit 1
    fi
    echo '✅ [Destination] Services backup extracted'

    # Verify service paths
    echo '🔄 [Destination] Verifying service paths...'
    for service_path in $servicePaths; do
        if [ ! -d \"\$service_path\" ]; then
            echo \"❌ [Destination] Service directory not found after extraction: \$service_path\"
            exit 1
        fi
        if [ ! -f \"\$service_path/docker-compose.yml\" ]; then
            echo \"❌ [Destination] docker-compose.yml not found in: \$service_path\"
            exit 1
        fi
        echo \"✅ [Destination] Found service directory and compose file: \$service_path\"
    done

    # Create Docker networks for each service
    echo '🔄 [Destination] Creating Docker networks...'
    for suffix in ${@}; do
        echo \"Creating network for \$suffix\"
        network_name=\"\$suffix\"
        if docker network inspect \"\$network_name\" >/dev/null 2>&1; then
            echo \"⚠️ [Destination] Network \$network_name already exists, skipping\"
        else
            echo \"Creating network \$network_name\"
            if ! docker network create \"\$network_name\"; then
                echo \"❌ [Destination] Failed to create network \$network_name\"
                exit 1
            else
                echo \"✅ [Destination] Created network \$network_name\"
            fi
        fi
    done
    echo '✅ [Destination] Network setup completed'

    # Start containers to create volumes
    echo '🔄 [Destination] Starting containers to initialize volumes...'
    for service_path in $servicePaths; do
        echo \"Starting containers in: \$service_path\"
        cd \"\$service_path\"
        if ! docker compose up -d; then
            echo \"❌ [Destination] Failed to start containers in: \$service_path\"
            exit 1
        fi
    done

    # Wait for containers to be running
    echo '🔄 [Destination] Waiting for containers to initialize...'
    sleep 30  # Give containers time to start

    # Stop all containers
    echo '🔄 [Destination] Stopping containers...'
    for service_path in $servicePaths; do
        echo \"Stopping containers in: \$service_path\"
        cd \"\$service_path\"
        if ! docker compose down; then
            echo \"❌ [Destination] Failed to stop containers in: \$service_path\"
            exit 1
        fi
    done
    echo '✅ [Destination] All containers stopped'

    # Cleanup services backup
    rm -f '${destinationDir}/${servicesBackupFile}'
"

if ! ssh -o "StrictHostKeyChecking no" root@"$destinationHost" "$phase1Commands"; then
    echo "❌ Phase 1 remote commands execution failed"
    exit 1
fi
echo "✅ Phase 1 completed successfully"

# Now handle volume backup (requires stopping containers)
echo "🔄 [Origin] It's recommended to stop the service containers before creating the volume backup"
read -p "[Origin] Do you want to stop the containers? (y/n): " answer

if [[ "$answer" =~ ^[Yy]$ ]]; then
    # Stop containers
    echo "🔄 [Origin] Stopping service containers..."
    for container_id in "${containers_to_stop[@]}"; do
        container_name=$(docker inspect --format '{{.Name}}' "$container_id" | sed 's/^\///')
        echo "🔄 [Origin] Stopping container: $container_name"
        echo "$container_id"
        if ! docker stop "$container_id"; then
            echo "❌ [Origin] Failed to stop container: $container_name"
            exit 1
        fi
    done
    echo "✅ [Origin] All service containers stopped"
fi

# Create volumes backup
echo "🔄 [Origin] Creating volumes backup..."
echo "[Origin] Volume paths to backup:"
for path in $volumePaths; do
    echo "  - $path"
done

volumes_list_file=$(mktemp)
for path in $volumePaths; do
    echo "$path" >> "$volumes_list_file"
done

if ! tar --exclude='*.sock' -Pczf "${backupDir}/${volumesBackupFile}" -T "$volumes_list_file"; then
    echo "❌ [Origin] Volumes backup file creation failed"
    rm -f "$volumes_list_file"
    exit 1
fi
rm -f "$volumes_list_file"
echo "✅ [Origin] Volumes backup file created"

# Start containers back up on origin server if they were stopped
if [[ "$answer" =~ ^[Yy]$ ]]; then
    echo "🔄 [Origin] Starting service containers..."
    for container_id in "${containers_to_stop[@]}"; do
        container_name=$(docker inspect --format '{{.Name}}' "$container_id" | sed 's/^\///')
        echo "[Origin] Starting container: $container_name"
        if ! docker start "$container_id"; then
            echo "⚠️ [Origin] Failed to start container: $container_name"
        fi
    done
    
    # Wait for containers to be running
    echo "🔄 [Origin] Waiting for containers to be ready..."
    sleep 10  # Give containers time to initialize
    
    # Verify containers are running
    for container_id in "${containers_to_stop[@]}"; do
        container_name=$(docker inspect --format '{{.Name}}' "$container_id" | sed 's/^\///')
        if ! docker ps --format '{{.Names}}' | grep -q "^${container_name}$"; then
            echo "⚠️ [Origin] Container $container_name did not restart"
        else
            echo "✅ [Origin] Container $container_name is running"
        fi
    done
fi

# Transfer volumes backup after containers are back up
echo "🔄 Transferring volumes backup to Destination Server..."
if ! scp "${backupDir}/${volumesBackupFile}" "root@${destinationHost}:${destinationDir}/${volumesBackupFile}"; then
    echo "❌ Transfer to Destination Server failed"
    exit 1
fi

# Execute Phase 2 on destination (restore volume data)
echo "🔄 Executing Phase 2 (Volume data restoration)..."
phase2Commands="
    # Check if backup file was transferred successfully
    if [ ! -f '${destinationDir}/${volumesBackupFile}' ]; then
        echo '❌ [Destination] Volumes backup file not found after transfer'
        echo '[Destination] Expected location: ${destinationDir}/${volumesBackupFile}'
        ls -la '${destinationDir}'
        exit 1
    fi
    echo '✅ [Destination] Volumes backup file found'

    # Extract volumes backup
    echo '🔄 [Destination] Extracting volumes backup...'
    if ! tar -Pxzf '${destinationDir}/${volumesBackupFile}' -C /; then
        echo '❌ [Destination] Volumes backup extraction failed'
        exit 1
    fi
    echo '✅ [Destination] Volumes backup extracted'

    # Verify volume paths
    echo '🔄 [Destination] Verifying volume data...'
    for volume_path in $volumePaths; do
        if [ ! -d \"\$volume_path/_data\" ]; then
            echo \"❌ [Destination] Volume data directory not found: \$volume_path/_data\"
            exit 1
        fi
        if [ -z \"\$(ls -A \"\$volume_path/_data\" 2>/dev/null)\" ]; then
            echo \"⚠️ [Destination] Warning: Volume directory is empty: \$volume_path/_data\"
        else
            echo \"✅ [Destination] Found volume data: \$volume_path/_data\"
        fi
    done

    # Start containers with restored data
    echo '🔄 [Destination] Starting containers with restored data...'
    for service_path in $servicePaths; do
        echo \"[Destination] Starting containers in: \$service_path\"
        cd \"\$service_path\"
        if ! docker compose up -d; then
            echo \"❌ [Destination] Failed to start containers in: \$service_path\"
            exit 1
        fi
    done

    # Wait for containers to be running
    echo '🔄 [Destination] Waiting for containers to initialize...'
    sleep 30  # Give containers time to start

    # Verify containers are running
    echo '🔄 [Destination] Verifying container status...'
    for service_path in $servicePaths; do
        cd \"\$service_path\"
        if ! docker compose ps | grep -q 'Up'; then
            echo \"⚠️ [Destination] Warning: Some containers may not be running in: \$service_path\"
            docker compose ps
        else
            echo \"✅ [Destination] Containers are running in: \$service_path\"
        fi
    done

    # Final shutdown of containers
    echo '🔄 [Destination] Shutting down containers...'
    for service_path in $servicePaths; do
        echo \"[Destination] Stopping containers in: \$service_path\"
        cd \"\$service_path\"
        if ! docker compose down; then
            echo \"⚠️ [Destination] Warning: Failed to stop containers in \$service_path\"
        else
            echo \"✅ [Destination] Stopped containers in \$service_path\"
        fi
    done

    # Cleanup volumes backup
    rm -f '${destinationDir}/${volumesBackupFile}'

    # Create network names list for summary
    network_names=""
    for suffix in ${@}; do
        network_names+=\"\$suffix \"
    done

    echo '
🧹 [Destination] Cleanup Summary:
   - Removed temporary file: ${destinationDir}/${volumesBackupFile}
   - Stopped all service containers
   - Networks remain for future use: '\"\${network_names}\"'
   - Volumes remain intact for future use
'
"

if ! ssh -o "StrictHostKeyChecking no" root@"$destinationHost" "$phase2Commands"; then
    echo "❌ Phase 2 remote commands execution failed"
    exit 1
fi
echo "✅ Phase 2 completed successfully"

# Clean up local backup
rm -rf "$backupDir"

# Clean up ssh-agent
kill "$SSH_AGENT_PID"

echo "
✅ Service transfer completed successfully

🧹 [Origin] Cleanup Summary:
   - Removed temporary backup directory: $backupDir
   - Terminated SSH agent (PID: $SSH_AGENT_PID)
   - All containers are running
   - Original volumes remain intact

🧹 [Destination] Cleanup Summary:
   - Service files transferred and extracted
   - Volumes transferred and restored
   - All containers verified and stopped
   - Temporary files cleaned up
   - Networks remain for future use: $(echo "$@")
   - Volumes ready for use

💡 Next Steps:
   Assuming you manage your [Origin] and [Destination] servers with the same Coolify Application
   - Create a test application on the [Destination] server, this will be used to get specific values for 'environment_id', 'server_id', 'destination_id'
   - In Coolify UI, for each service you have transferred: Stop the service => It will be stopped on the [Origin] Server
   - Manual intervention required in Coolify Postgres Database on [Origin] Server
       - In the database 'coolify', table 'services', find the lines for the services you have transferred
       - Update the values of columns 'environment_id', 'server_id', 'destination_id' with the sames values of the test application you created directly on the [Destination] server
   - In Coolify UI, for each service you have transferred: Deploy the service => It will be deployed on the [Destination] Server with your all your persisted data
   - Monitor logs for any issues during startup
   - Please note that clean of unused docker volumes and services folders on the [Origin] Server is not done by this script for security reasons
"

Here's a modified version of @AspireOne's ssh-agent version. It fixes the volumes being separated wrong when extracting the volumes from a container.

#!/bin/bash

# This script will backup your Coolify instance and move everything to a new server. Docker volumes, Coolify database, and ssh keys

# 1. Script must run on the source server
# 2. Have all the containers running that you want to migrate

# Configuration - Modify as needed
sshKeyPath="$HOME/.ssh/your_private_key" # Key to destination server
destinationHost="server.example.com" # destination server IP or domain

# -- Shouldn't need to modify anything below --
backupSourceDir="/data/coolify/"
backupFileName="coolify_backup.tar.gz"

# Function to initialize ssh-agent and add the SSH key
initialize_ssh_agent() {
  # Check if ssh-agent is already running
  if [ -z "$SSH_AGENT_PID" ] || ! ps -p "$SSH_AGENT_PID" > /dev/null 2>&1; then
    echo "🔄 Starting ssh-agent..."
    eval "$(ssh-agent -s)"
    if [ $? -ne 0 ]; then
      echo "❌ Failed to start ssh-agent"
      exit 1
    fi
    echo "✅ ssh-agent started"
  else
    echo "✅ ssh-agent is already running"
  fi

  # Add the SSH key to the agent
  echo "🔒 Adding SSH key to ssh-agent"
  ssh-add "$sshKeyPath"
  if [ $? -ne 0 ]; then
    echo "❌ Failed to add SSH key. Please ensure the passphrase is correct."
    exit 1
  fi
  echo "✅ SSH key added to ssh-agent"
}

# Initialize ssh-agent and add the SSH key
initialize_ssh_agent

# Check if the source directory exists
if [ ! -d "$backupSourceDir" ]; then
  echo "❌ Source directory $backupSourceDir does not exist"
  exit 1
fi
echo "✅ Source directory exists"

# Check if the SSH key file exists
if [ ! -f "$sshKeyPath" ]; then
  echo "❌ SSH key file $sshKeyPath does not exist"
  exit 1
fi
echo "✅ SSH key file exists"

# Check if we can SSH to the destination server, ignore "The authenticity of host can't be established." errors
if ! ssh -o "StrictHostKeyChecking no" -o "ConnectTimeout=5" root@"$destinationHost" "exit"; then
  echo "❌ SSH connection to $destinationHost failed"
  exit 1
fi
echo "✅ SSH connection successful"

# Get the names of all running Docker containers
containerNames=$(docker ps --format '{{.Names}}')

# Initialize an empty string to hold the volume paths
volumePaths=""

for containerName in $containerNames; do
  # Use a delimiter to separate the volume names
  volumeNames=$(docker inspect --format '{{range .Mounts}}{{.Name}}{{print "\n"}}{{end}}' "$containerName")

  # Now, we process each line (volume name) from the output
  while IFS= read -r volumeName; do
    # Check if the volumeName is not empty
    if [ -n "$volumeName" ]; then
      echo "Adding path: /var/lib/docker/volumes/$volumeName"
      volumePaths="$volumePaths /var/lib/docker/volumes/$volumeName"
    fi
  done <<< "$volumeNames"
done

echo "Final volumePaths: $volumePaths"
# Calculate the total size of the volumes
# shellcheck disable=SC2086
totalSize=$(du -csh $volumePaths 2>/dev/null | grep total | awk '{print $1}')

# Print the total size of the volumes
echo "✅ Total size of volumes to migrate: $totalSize"

# Print size of backupSourceDir
backupSourceDirSize=$(du -csh "$backupSourceDir" 2>/dev/null | grep total | awk '{print $1}')
echo "✅ Size of the source directory: $backupSourceDirSize"

# Check if the backup file already exists
if [ ! -f "$backupFileName" ]; then
  echo "🚸 Backup file does not exist, creating"

  # Recommend stopping docker before creating the backup
  echo "🚸 It's recommended to stop all Docker containers before creating the backup"
  read -rp "Do you want to stop Docker? (y/n): " answer
  if [[ "$answer" =~ ^[Yy]$ ]]; then
    if ! systemctl stop docker; then
      echo "❌ Docker stop failed"
      exit 1
    fi
    echo "✅ Docker stopped"
  else
    echo "🚸 Docker not stopped, continuing with the backup"
  fi

  # shellcheck disable=SC2086
  if ! tar --exclude='*.sock' -Pczf "$backupFileName" -C / "$backupSourceDir" "$HOME/.ssh/authorized_keys" $volumePaths; then
    echo "❌ Backup file creation failed"
    exit 1
  fi
  echo "✅ Backup file created"
else
  echo "🚸 Backup file already exists, skipping creation"
fi

# Define the remote commands to be executed
remoteCommands="
  # Check if Docker is a service
  if systemctl is-active --quiet docker; then
    # Stop Docker if it's a service
    if ! systemctl stop docker; then
      echo '❌ Docker stop failed';
      exit 1;
    fi
    echo '✅ Docker stopped';
  else
    echo 'ℹ️ Docker is not a service, skipping stop command';
  fi

  echo '🚸 Saving existing authorized keys...';
  cp ~/.ssh/authorized_keys ~/.ssh/authorized_keys_backup;

  echo '🚸 Extracting backup file...';
  if ! tar -Pxzf - -C /; then
    echo '❌ Backup file extraction failed';
    exit 1;
  fi
  echo '✅ Backup file extracted';

  echo '🚸 Merging authorized keys...';
  cat ~/.ssh/authorized_keys_backup ~/.ssh/authorized_keys | sort | uniq > ~/.ssh/authorized_keys_temp;
  mv ~/.ssh/authorized_keys_temp ~/.ssh/authorized_keys;
  chmod 600 ~/.ssh/authorized_keys;
  echo '✅ Authorized keys merged';

  if ! curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash; then
    echo '❌ Coolify installation failed';
    exit 1;
  fi
  echo '✅ Coolify installed';
"

# SSH to the destination server, execute the remote commands
if ! ssh root@"$destinationHost" "$remoteCommands" < "$backupFileName"; then
  echo "❌ Remote commands execution or Docker restart failed"
  exit 1
fi
echo "✅ Remote commands executed successfully"

# Clean up - Ask the user for confirmation before removing the local backup file
echo "Do you want to remove the local backup file? (y/n)"
read -r answer
if [[ "$answer" =~ ^[Yy]$ ]]; then
  if ! rm -f "$backupFileName"; then
    echo "❌ Failed to remove local backup file"
    exit 1
  fi
  echo "✅ Local backup file removed"
else
  echo "🚸 Local backup file not removed"
fi

# Kill ssh-agent if it was started by this script
if [ -n "$SSH_AGENT_PID" ]; then
  echo "🔒 Stopping ssh-agent..."
  eval "$(ssh-agent -k)"
  echo "✅ ssh-agent stopped"
fi

At this point we're ironically pummeling this with unmanaged versions on a version control platform :P
Time to make this a repo and accept PRs? I could do it but it's only right that you do it @Geczy considering you took the initiative :)

Good idea, I've made the repo here! https://github.com/Geczy/coolify-migration

Also updated this gist with a readme linking to the above

Thanks everyone for your contributions! Feel free to open a PR to manage these wonderful changes that are being suggested.

Just wanted to thanks for this perfect script.

Great script, thanks.

I created a coolify db restore, if backing up locally.

Long term we need a baseline CLI similar to Plesk provides for installation, updates, and recovery.

Also reporting that the original script works perfectly with the expected setup on v4.0.0-beta.406