{"id":18750677,"url":"https://github.com/webiny/migrate-v1-to-v2","last_synced_at":"2025-11-26T21:30:15.277Z","repository":{"id":40940419,"uuid":"220067252","full_name":"webiny/migrate-v1-to-v2","owner":"webiny","description":null,"archived":false,"fork":false,"pushed_at":"2023-02-03T03:06:39.000Z","size":105,"stargazers_count":0,"open_issues_count":5,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-12-28T22:53:44.962Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/webiny.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}},"created_at":"2019-11-06T18:50:43.000Z","updated_at":"2019-11-08T17:55:05.000Z","dependencies_parsed_at":"2024-11-07T17:12:52.210Z","dependency_job_id":null,"html_url":"https://github.com/webiny/migrate-v1-to-v2","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webiny%2Fmigrate-v1-to-v2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webiny%2Fmigrate-v1-to-v2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webiny%2Fmigrate-v1-to-v2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webiny%2Fmigrate-v1-to-v2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/webiny","download_url":"https://codeload.github.com/webiny/migrate-v1-to-v2/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239635989,"owners_count":19672271,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":"2024-11-07T17:12:48.983Z","updated_at":"2025-11-26T21:30:15.233Z","avatar_url":"https://github.com/webiny.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# migrate-v1-to-v2\n\nThis tool is created for projects that used Webiny v1 and were hosted on DigitalOcean and similar VPS services.\n\n## How to migrate?\n\n\u003e WARNING: use at your own responsibility!! Create a backup copy of your database and do a test run against a copy you're not afraid to mess up.    \n\nYou will need the Webiny v2 API URL to use this tool.\n\nPreparation:\n- Create a new Webiny v2 project.\n- The `MONGODB_SERVER` and `MONGODB_NAME` should point to a copy of an existing MongoDB database you use for the v1 project.\n- Deploy your new API\n\nOn your existing server:  \n- Clone this repo on your server.\n- Run `yarn` to install dependencies\n- Copy `example.env` to `.env` and insert your variable values.\n- The `FILES_LOCATION` should point to the folder where your files are located.\n- Run `yarn migrate`.\n\n## React plugins\nYou will have to migrate the React plugins, if you have them, as well. Notable changes in v2 are:\n- `CMS` is now renamed to `PageBuilder` and so are all the plugin names. It is now `pb-....`.\n- we migrated to `hooks` instead of `HOC`s\n- Webiny packages are now scoped, and look like this: `@webiny/xy`\n- Page Builder element plugins no longer store the plugin name to the DB. Instead, each element plugin now has a `elementType` key which goes to DB and that is how we pair the plugin with the element that gets stored to DB.\n\nThere are lots of examples in our own codebase. If you are stuck with something, get in touch via Github.\n\n## This doesn't really work\nThis tool was tested against a moderately customized Webiny project. Of course, it may not migrate all the custom things you have in your project. That is why you are free to dig into the code and add handling for your custom stuff. If you need help, let us know.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebiny%2Fmigrate-v1-to-v2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwebiny%2Fmigrate-v1-to-v2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebiny%2Fmigrate-v1-to-v2/lists"}