Developer docs

Migrating from Ghost to Ghost

Migrate from a self-hosted instance to Ghost(Pro) with this guide

The Ghost Concierge team, at your service

Let us handle the Ghost migration for you! This migration is included when you make an annual payment on the Ghost(Pro) Creator, Team, or Business plans. Send an email to concierge@ghost.org to learn more and get started.

This guide will walk you through the process of migrating from a self-hosted Ghost instance on your own server to Ghost(Pro).

Prerequisites

If your self-hosted site is running an older major version of Ghost, you may need to update. Check the latest version of Ghost on GitHub, and follow this upgrade guide.

Back up your data

The first step towards moving from your own self-hosted Ghost instance to Ghost(Pro) is to retrieve all of your data from your server to your local machine. It’s best to do this first, to ensure you have a backup in place.

The commands in this guide assume you followed our Ubuntu guide to set up your own instance. If you used another method, you’ll need to adapt the paths in the commands to suit.

Exporting content

Log into Ghost Admin for your self-hosted in production and navigate to the Labs view, and click Export to download your content. This will be .json file, with a name like my-site.ghost.2020-09-30-14-15-49.json.

content import export

Routes and redirects

Staying on the Labs page, click Download current redirects to get your redirects file. This will be called redirects.yaml (or redirects.json depending on your Ghost version). If you’re using custom routes, click Download current routes.yaml to get your routes.yaml file.

routes redirects

Themes

Navigate to the Design view, and click the Download button next to the Active label export your current theme. This will be a .zip file. Optionally, if you have other themes that you’d like to save, download them and back them up.

themes settings

Images

To download your images, you’ll need shell access to your server. If you’re unable to gain shell access to your current web host, you may need to contact their support team and ask for a zip of your images directory.

Once you’re logged in to your server, cd to the content directory:

cd /var/www/ghost/content

And then zip the images directory with all its contents:

zip -r images.zip images/*

Now we need to get that zip file from your server onto your local machine:

scp user@123.456.789.123:/var/www/ghost/content/images.zip ~/Desktop/images.zip

The folder structure should look like this, with images being the only top-level folder once unzipped:

images in finder

Uploading to Ghost(Pro)

Once you’ve retreived all of these exports, you can upload them to Ghost(Pro) in the same order.

Content

Log into your new Ghost(Pro) site, and head to the Labs view. Next to the Import content header, select your content .json file and click Import.

user import successful

Routes and Redirects

Staying on the Labs view, click Upload redirects JSON, then select your redirects.json file to upload it. Then click Upload routes YAML, select your routes.yaml file to upload that.

Themes

Head over to the Design view, and click Upload a theme, select your theme .zip file, and activate it.

activate theme

Images

The final step is to upload your images. The best way to approach this depends on how big your images.zip file is. A large file will take longer to upload and process.

If your file is less than 500mb, you can upload this zip in the same way you uploaded your content JSON file. If the file is larger, it’s recommended to split it into multiple smaller files, whilst retaining the folder structure.

If you have a large image directory or encounter any errors, contact support so we can help upload your images.


Summary

Congratulations on moving to Ghost(Pro). All that’s left to do is check over your content to ensure everything works as expected.

By hosting your site with us, you directly fund future product development of Ghost itself and allow us to make the product better for everyone 💘