mirror of
https://github.com/ditatompel/insights.git
synced 2025-01-08 03:12:06 +07:00
105 lines
4.5 KiB
Markdown
105 lines
4.5 KiB
Markdown
|
---
|
|||
|
|
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.
|
|||
|
|
|
|||
|
|
<!--more-->
|
|||
|
|
|
|||
|
|
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/)
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|