diff --git a/content/tutorials/self-hosted-ghost-how-to-upgrade-ghost-v4/feature-upgrade-ghost-4.png b/content/tutorials/self-hosted-ghost-how-to-upgrade-ghost-v4/feature-upgrade-ghost-4.png new file mode 100644 index 0000000..6e4dc04 Binary files /dev/null and b/content/tutorials/self-hosted-ghost-how-to-upgrade-ghost-v4/feature-upgrade-ghost-4.png differ diff --git a/content/tutorials/self-hosted-ghost-how-to-upgrade-ghost-v4/index.md b/content/tutorials/self-hosted-ghost-how-to-upgrade-ghost-v4/index.md new file mode 100644 index 0000000..2b5a1dc --- /dev/null +++ b/content/tutorials/self-hosted-ghost-how-to-upgrade-ghost-v4/index.md @@ -0,0 +1,104 @@ +--- +title: "Self-Hosted Ghost: How to Upgrade Ghost v4.x" +description: "Step-by-step upgrading Self-Hosted Ghost version 4.x, the latest major version of the product." +# linkTitle: +date: 2021-03-30T21:51:29+07:00 +lastmod: +draft: false +noindex: false +# comments: false +nav_weight: 1000 +# nav_icon: +# vendor: bootstrap +# name: toggles +# color: '#e24d0e' +series: +# - Tutorial +categories: + - Self-Hosted + - SysAdmin +tags: + - Ghost +images: +# menu: +# main: +# weight: 100 +# params: +# icon: +# vendor: bs +# name: book +# color: '#e24d0e' +authors: + - ditatompel +--- + +Ghost releasing [Ghost 4.0](https://ghost.org/changelog/4/) on March 16, 2021, the latest major version of the product, as well as small refresh of Ghost brand. + + + +As a prerequisite to using this guide, make sure that you have running Ghost service by following the original [installation guide](https://ghost.org/docs/install/). And before continuing upgrade process to a new [major version](https://ghost.org/docs/faq/major-versions-lts) you need to take care of any [breaking changes](https://ghost.org/docs/changes/). + +## Upgrade Step +Whenever doing a manual update **always to take a full backup** of your site first. If anything goes wrong, you'll still have all your data. + +### Export Your Theme +It’s a good idea to check whenever your current theme is compatible with Ghost `4.x`. Depending on your current version of Ghost, **you might need to make some changes** to your theme. + +To see what changes are need to be made, download a copy of your theme zip file, and upload it to [GScan](https://gscan.ghost.org/) automatic theme compatibility testing tool. + +GScan will provide a report on any new features in the Ghost theme API which are not being used, or any old ones you might be using which have been deprecated - so you can get everything fixed up. + +### Export Content and Members +Start by exporting a JSON file of all your posts from the **labs area** of Ghost Admin. + +Then, make a copy of entire `/content` directory as a backup for themes and images: +```bash +mkdir /backup +cp -rv content /backup/content +``` +Members can be exported to a CSV file from the **Members page** of Ghost Admin. + +### Upgrade Ghost-CLI +When you're ready, **as your Ghost admin user**, upgrade `Ghost-CLI` using `npm -g` command : +```bash +sudo npm install -g ghost-cli@latest +``` + +### Update to the latest minor version +Now, after you upgrade `Ghost-CLI` to the lastest version, you need to update every site to the latest minor version before upgrading to major version. + +**Make sure you’re in your site’s root directory** and then run the Ghost update command using Ghost-CLI **as your ghost admin user**. + +For example, if you're on version `3.x` : + +```bash +ghost update v3 +``` +> _**TIPS**: You do not need to upgrade through every major version. For example if you’re on `2.33.0`, you only need to upgrade to `2.38.3` (the latest `2.x` version) first, and then to `4.x`._ + +>> _**INFO**: the `ghost update` command will inform you of the commands to run to perform the necessary intermediate updates._ + +### Upgrade to the latest major version +After updating your site(s) to latest minor version, you're ready to upgrade to latest major version. Simply run `ghost upgrade` from your site’s root directory **as Ghost admin user**. + +{{< youtube udbaAvl3s3E >}} + +## v4.0 Highlight Changelog +- **Dashboard**: Get detailed insights into how content and members are performing so you can understand what's working. +- **Memberships and subscriptions** are now natively part of the core platform - no longer in beta. +- **Email newsletters** are now natively built into Ghost. +- Brand **new post-preview** UI, showing you what your post will look like on web, mobile, email, social and search - all in one place. +- Premium subscriptions with **Stripe** now work in **135 currencies**, with support for **Apple Pay**, **Google Pay**, and 0% payment fees. +- Embedded memberships and subscriptions UI, called **Portal**, which works with every Ghost theme. Past, present and future. +- Re-built the Ghost [Theme directory](https://ghost.org/themes/), including live previews and automatic installs. +- **Performance improvement**: Front-end performance jumped by more than 50%, **overall performance** in terms of requests-per-second by 40%, reduced latency by 30%, and made serving requests after start/restart faster by 300%. + +## Links and Resources +- [https://ghost.org/changelog/4/](https://ghost.org/changelog/4/) +- [https://ghost.org/docs/update/](https://ghost.org/docs/update/) + + + + + + diff --git a/resources/_gen/images/tutorials/self-hosted-ghost-how-to-upgrade-ghost-v4/feature-upgrade-ghost-4_hu2694c21139c99bf1a2389c35327b6358_317722_0x360_resize_box_3.png b/resources/_gen/images/tutorials/self-hosted-ghost-how-to-upgrade-ghost-v4/feature-upgrade-ghost-4_hu2694c21139c99bf1a2389c35327b6358_317722_0x360_resize_box_3.png new file mode 100644 index 0000000..c22b8e1 Binary files /dev/null and b/resources/_gen/images/tutorials/self-hosted-ghost-how-to-upgrade-ghost-v4/feature-upgrade-ghost-4_hu2694c21139c99bf1a2389c35327b6358_317722_0x360_resize_box_3.png differ diff --git a/resources/_gen/images/tutorials/self-hosted-ghost-how-to-upgrade-ghost-v4/feature-upgrade-ghost-4_hu2694c21139c99bf1a2389c35327b6358_317722_0x640_resize_box_3.png b/resources/_gen/images/tutorials/self-hosted-ghost-how-to-upgrade-ghost-v4/feature-upgrade-ghost-4_hu2694c21139c99bf1a2389c35327b6358_317722_0x640_resize_box_3.png new file mode 100644 index 0000000..0fc5213 Binary files /dev/null and b/resources/_gen/images/tutorials/self-hosted-ghost-how-to-upgrade-ghost-v4/feature-upgrade-ghost-4_hu2694c21139c99bf1a2389c35327b6358_317722_0x640_resize_box_3.png differ diff --git a/resources/_gen/images/tutorials/self-hosted-ghost-how-to-upgrade-ghost-v4/feature-upgrade-ghost-4_hu2694c21139c99bf1a2389c35327b6358_317722_1034e5195ab4aeefd402fdf5f5dc3328.webp b/resources/_gen/images/tutorials/self-hosted-ghost-how-to-upgrade-ghost-v4/feature-upgrade-ghost-4_hu2694c21139c99bf1a2389c35327b6358_317722_1034e5195ab4aeefd402fdf5f5dc3328.webp new file mode 100644 index 0000000..4af6072 Binary files /dev/null and b/resources/_gen/images/tutorials/self-hosted-ghost-how-to-upgrade-ghost-v4/feature-upgrade-ghost-4_hu2694c21139c99bf1a2389c35327b6358_317722_1034e5195ab4aeefd402fdf5f5dc3328.webp differ diff --git a/resources/_gen/images/tutorials/self-hosted-ghost-how-to-upgrade-ghost-v4/feature-upgrade-ghost-4_hu2694c21139c99bf1a2389c35327b6358_317722_19469a7a96d37748b6618af3e04e283f.webp b/resources/_gen/images/tutorials/self-hosted-ghost-how-to-upgrade-ghost-v4/feature-upgrade-ghost-4_hu2694c21139c99bf1a2389c35327b6358_317722_19469a7a96d37748b6618af3e04e283f.webp new file mode 100644 index 0000000..f9eba86 Binary files /dev/null and b/resources/_gen/images/tutorials/self-hosted-ghost-how-to-upgrade-ghost-v4/feature-upgrade-ghost-4_hu2694c21139c99bf1a2389c35327b6358_317722_19469a7a96d37748b6618af3e04e283f.webp differ