{"_id":"59368bb5283eac000f901cf8","project":"543026235eceb608003fde5f","version":{"_id":"59365226e16643001bac5030","project":"543026235eceb608003fde5f","__v":1,"createdAt":"2017-06-06T06:56:38.999Z","releaseDate":"2017-06-06T06:56:38.999Z","categories":["59365227e16643001bac5031","59365227e16643001bac5032","59365227e16643001bac5033","59365227e16643001bac5034"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0.0"},"category":{"_id":"59365227e16643001bac5031","version":"59365226e16643001bac5030","project":"543026235eceb608003fde5f","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2017-06-05T21:09:59.596Z","from_sync":false,"order":0,"slug":"general","title":"General"},"user":"55acc88c6b4ff90d00784b61","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-06-06T11:02:13.553Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"Unlike previous migrations we do not recommend keeping your existing database but instead the migration path is:\n\n1. [Backup your content](#section-1-backup-your-content) using the exporter \n2. [Create a new Ghost v1.0.0 blog](doc:getting-started-guide)\n3. [Use Ghost v1.0.0 Importer](#section-3-use-ghost-v1-0-0-importer-to-import-existing-content) to import existing content\n4. [Copy your images](#section-4-copy-your-images-to-new-blog-) to new blog. \n5. [Upload your theme](#section-5-upload-your-theme) - your theme will not be uploaded from the importer\n\n## 1. Backup your content\n\nIn your existing (pre v1.0.0) Ghost blog, navigate to `yourblogdomain.com/ghost/settings/labs/` (the settings>labs page in Ghost-Admin) and click on the **Export** button. It should look something like this:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/9913703-ScreenShot2017-06-06at12.05.44.png\",\n        \"Screen+Shot+2017-06-06+at+12.05.44.png\",\n        2470,\n        1272,\n        \"#eaedeb\"\n      ],\n      \"caption\": \"lts labs page\"\n    }\n  ]\n}\n[/block]\nThis will download your JSON export file that you need later.\n\n## 2. Create a new Ghost v1.0.0 blog\n\nCheck out our [getting started guide](doc:getting-started-guide) to create a new blog.\n\n## 3.  Use Ghost v1.0.0 Importer to import existing content\n\nOn your new blog import navigate to `yourblogdomain.com/ghost/#/settings/labs` (the settings>labs page in Ghost-Admin)\n\nClick **Choose file** and select the JSON export file created in [step 1] then click on the **Import** button.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/ec09fb6-ScreenShot2017-06-07at12.31.00.png\",\n        \"Screen+Shot+2017-06-07+at+12.31.00.png\",\n        2728,\n        624,\n        \"#f1f9fa\"\n      ],\n      \"caption\": \"v1.0.0 Labs page\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Note:\",\n  \"body\": \"The importer will not import themes from lts blogs. \\n\\nYou should see a warning that your theme has not been imported, this is expected and you can continue on to step 4.\"\n}\n[/block]\nIf see other warnings or errors, you may need to [troubleshoot your Ghost Import](doc:troubleshooting-ghost-imports). \n\n## 4. Copy your images to new blog.\n\nYou need to copy/move your images from your existing directory `<ghost-dir>/content/images` to the new blog directory.\n\n## 5 Upload your theme\n\nNavigate to `yourblogdomain.com/ghost/#/settings/design` (the Settings>Design page in Ghost Admin) then click `Upload a Theme` button and follow on-screen instructions.\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/c1676bc-ScreenShot2017-06-06at12.52.00.png\",\n        \"Screen+Shot+2017-06-06+at+12.52.00.png\",\n        1810,\n        717,\n        \"#f2fafa\"\n      ],\n      \"caption\": \"Upload a theme\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Note:\",\n  \"body\": \"The posts per page setting is now [controlled by your theme](http://themes.ghost.org/v1.0.0/docs/packagejson#section-recommended-property), and this will default to 5 posts if not set.\"\n}\n[/block]","excerpt":"","slug":"migrating-to-ghost-version-100","type":"basic","title":"Migrating to Ghost version 1.0.0"}

Migrating to Ghost version 1.0.0


Unlike previous migrations we do not recommend keeping your existing database but instead the migration path is: 1. [Backup your content](#section-1-backup-your-content) using the exporter 2. [Create a new Ghost v1.0.0 blog](doc:getting-started-guide) 3. [Use Ghost v1.0.0 Importer](#section-3-use-ghost-v1-0-0-importer-to-import-existing-content) to import existing content 4. [Copy your images](#section-4-copy-your-images-to-new-blog-) to new blog. 5. [Upload your theme](#section-5-upload-your-theme) - your theme will not be uploaded from the importer ## 1. Backup your content In your existing (pre v1.0.0) Ghost blog, navigate to `yourblogdomain.com/ghost/settings/labs/` (the settings>labs page in Ghost-Admin) and click on the **Export** button. It should look something like this: [block:image] { "images": [ { "image": [ "https://files.readme.io/9913703-ScreenShot2017-06-06at12.05.44.png", "Screen+Shot+2017-06-06+at+12.05.44.png", 2470, 1272, "#eaedeb" ], "caption": "lts labs page" } ] } [/block] This will download your JSON export file that you need later. ## 2. Create a new Ghost v1.0.0 blog Check out our [getting started guide](doc:getting-started-guide) to create a new blog. ## 3. Use Ghost v1.0.0 Importer to import existing content On your new blog import navigate to `yourblogdomain.com/ghost/#/settings/labs` (the settings>labs page in Ghost-Admin) Click **Choose file** and select the JSON export file created in [step 1] then click on the **Import** button. [block:image] { "images": [ { "image": [ "https://files.readme.io/ec09fb6-ScreenShot2017-06-07at12.31.00.png", "Screen+Shot+2017-06-07+at+12.31.00.png", 2728, 624, "#f1f9fa" ], "caption": "v1.0.0 Labs page" } ] } [/block] [block:callout] { "type": "info", "title": "Note:", "body": "The importer will not import themes from lts blogs. \n\nYou should see a warning that your theme has not been imported, this is expected and you can continue on to step 4." } [/block] If see other warnings or errors, you may need to [troubleshoot your Ghost Import](doc:troubleshooting-ghost-imports). ## 4. Copy your images to new blog. You need to copy/move your images from your existing directory `<ghost-dir>/content/images` to the new blog directory. ## 5 Upload your theme Navigate to `yourblogdomain.com/ghost/#/settings/design` (the Settings>Design page in Ghost Admin) then click `Upload a Theme` button and follow on-screen instructions. [block:image] { "images": [ { "image": [ "https://files.readme.io/c1676bc-ScreenShot2017-06-06at12.52.00.png", "Screen+Shot+2017-06-06+at+12.52.00.png", 1810, 717, "#f2fafa" ], "caption": "Upload a theme" } ] } [/block] [block:callout] { "type": "info", "title": "Note:", "body": "The posts per page setting is now [controlled by your theme](http://themes.ghost.org/v1.0.0/docs/packagejson#section-recommended-property), and this will default to 5 posts if not set." } [/block]