{"id":46391810,"url":"https://github.com/1panel-dev/1panel-migrator","last_synced_at":"2026-03-10T14:01:40.317Z","repository":{"id":341950225,"uuid":"1172159047","full_name":"1Panel-dev/1panel-migrator","owner":"1Panel-dev","description":"1Panel V1 to V2 Migration Tool","archived":false,"fork":false,"pushed_at":"2026-03-05T07:12:40.000Z","size":23,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-05T12:04:02.131Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/1Panel-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-04T02:09:34.000Z","updated_at":"2026-03-05T07:10:48.000Z","dependencies_parsed_at":"2026-03-06T10:01:09.697Z","dependency_job_id":null,"html_url":"https://github.com/1Panel-dev/1panel-migrator","commit_stats":null,"previous_names":["1panel-dev/1panel-migrator"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/1Panel-dev/1panel-migrator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1Panel-dev%2F1panel-migrator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1Panel-dev%2F1panel-migrator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1Panel-dev%2F1panel-migrator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1Panel-dev%2F1panel-migrator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/1Panel-dev","download_url":"https://codeload.github.com/1Panel-dev/1panel-migrator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1Panel-dev%2F1panel-migrator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30171656,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-06T07:56:45.623Z","status":"ssl_error","status_checked_at":"2026-03-06T07:55:55.621Z","response_time":250,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-03-05T09:04:20.322Z","updated_at":"2026-03-07T11:00:50.852Z","avatar_url":"https://github.com/1Panel-dev.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"## ⚠️ Before You Start\n\n**1panel-migrator** is the official migration tool for smoothly upgrading from **1Panel V1** to **1Panel V2**.\n\nTo ensure a safe and successful migration, please read the following notes carefully before you begin.\n\n---\n\n### Create a Snapshot in Advance\n\nTo reduce risks from unexpected issues, it is strongly recommended to:\n\n- Sign in to **1Panel Console -\u003e Panel Settings** and create a system snapshot manually.\n- Or create a cloud server snapshot through your cloud provider.\n\n### Required V1 Version\n\nMigration is supported only for **1Panel `v1.10.29-lts` and later**.\n\n### Target V2 Version After Migration\n\nAfter migration, the system will be upgraded to **1Panel v2.1.2**.\n\n### Pro Edition and Licenses\n\n- Existing licenses will be cleared, and the system will be migrated to the **Community Edition**.\n- One-time purchase licenses from V1 cannot be used in V2.\n- Lifetime licenses have no version restriction and do not require an upgrade.\n\n### Websites\n\n#### Website Root Directory Migration\n\nAfter migration, **all website data will be stored in `{1Panel installation directory}/www`**.\n\n\u003e Example: `/opt/1panel/www`\n\n#### OpenResty Version\n\nThe system will be automatically upgraded to **OpenResty `1.27.1.2-0-1-focal`**.\n\n#### OpenResty Main Configuration\n\n- `1panel-migrator upgrade website` resets the OpenResty main configuration file. If you have custom changes, back it up in advance.\n- If you need HTTP/3 after the upgrade, it is recommended to uninstall and reinstall OpenResty (existing websites will not be deleted).\n\n#### Websites Using PHP Runtime\n\n- The built-in PHP runtime in the panel will be removed.\n- **PHP containers of existing websites will not be deleted** and will be migrated as static websites.\n- You can create a V2 PHP runtime later, then switch migrated static websites back to PHP websites in the original site settings.\n\n#### Reverse Proxy Websites\n\nV2 refactors the reverse-proxy cache mechanism so each website uses an independent directory. Before running `1panel-migrator upgrade website`, make sure reverse-proxy caching is disabled for all websites.\n\n### Backup Records\n\nFor compatibility reasons:\n\n- All **V1 backup records for websites, applications, and databases will be cleared**.\n- Reconfigure backup strategies after migration.\n\n### Host Terminal\n\nHost lists, groups, and quick commands are migrated only when upgrading as a primary node. If upgrading as a secondary node, this data is not migrated.\n\n### Scheduled Tasks\n\n- **Scheduled tasks themselves are migrated**.\n- **Task execution history is not retained**.\n\n### Snapshots\n\nDue to version mechanism differences, **V1 snapshot records cannot be migrated to V2**.\n\n### Panel Settings\n\nAfter the upgrade, panel settings for all nodes will follow the current V2 primary node configuration.\n\n### WAF and Website Monitoring\n\nDue to architecture changes:\n\n- **Most V1 WAF configurations and website monitoring records are incompatible** and will not be migrated.\n- WAF preserves only: allow/block lists, IP groups, and custom rules.\n- Reconfigure related features after migration.\n\n### Feedback\n\nIf you encounter issues or have feedback, please submit an issue in the [1Panel main repository](https://github.com/1Panel-dev/1Panel/issues).\n\n## 📚 Documentation\n\n### Installation Guide\n\n- [Installation Guide](install.md)\n\nLearn how to download and install the `1panel-migrator` tool.\n\n### Upgrade Guide\n\n- [Upgrade Guide](upgrade.md)\n\nDetailed steps for upgrading 1Panel from V1 to V2, including both primary and secondary nodes.\n\n### Rollback Guide\n\n- [Rollback Guide](rollback.md)\n\nHow to roll back services and websites if the upgrade fails or recovery is required.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1panel-dev%2F1panel-migrator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F1panel-dev%2F1panel-migrator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1panel-dev%2F1panel-migrator/lists"}