How to Seamlessly Migrate 1Panel from V1 to V2 Using the Official Migrator

Overview

1Panel is a modern open‑source Linux server management panel. The 1panel-migrator tool provided by the project upgrades a 1Panel V1 installation to V2.

Official site:

https://1panel.cn/

Precautions

Only versions ≥ 1Panel v1.10.29‑lts can be migrated.

After migration the system upgrades to 1Panel v2.0.0.

All website configurations are moved to {1Panel installation directory}/www.

The system automatically upgrades OpenResty to OpenResty 1.27.1.2‑0‑1‑focal.

The built‑in PHP environment is removed.

Existing PHP containers are retained and converted to static sites.

You can later create a V2 PHP runtime and switch the migrated static site back to a PHP site.

Install Migration Script

wget https://gitee.com/fit2cloud-feizhiyun/1panel-migrator/releases/download/v2.0.4/1panel-migrator-linux-amd64

chmod +x 1panel-migrator-linux-amd64

sudo mv 1panel-migrator-linux-amd64 /usr/local/bin/1panel-migrator

Upgrade Process

The upgrade consists of two steps: upgrade service and upgrade website . Complete the service upgrade before upgrading websites.

Upgrade Service

sudo1panel-migrator upgrade coree
# prompts for sudo password
# Important notes:
# 1. V1 license info is cleared and converted to the community edition.
# 2. All V1 website, application and database backup records are cleared.
# 3. Scheduled task execution logs are not retained (task definitions remain).
# 4. V1 snapshots cannot be migrated to V2.
# Migration stops the V1 service; confirm the risk before proceeding.
# Confirm migration (y/n): y
# ... log output showing download, initialization, data migration, and success ...
# After successful service upgrade, run:
1panel-migrator upgrade website

Upgrade Website

Note: Execute this command only after the V2 service has started successfully.

sudo 1panel-migrator upgrade website

# Important notes:
# 1. After migration, all website configurations are stored in {1Panel installation directory}/www.
# 2. OpenResty will be upgraded to 1.27.1.2‑0‑1‑focal.
# 3. OpenResty main configuration file is reset; back up any custom changes.
# 4. PHP runtime is removed; existing PHP containers become static sites.
# 5. After migration you can switch static sites back to PHP sites in the website settings.
# 6. Reverse‑proxy cache has been restructured; ensure caches are disabled.
# The website will be inaccessible during migration; confirm the risk.
# Confirm website migration (y/n): y
# ... log output showing Docker image pull, possible timeout, suggestion to configure Docker mirror ...

Upgrade Completed

Images showing successful upgrade: