Documentation - Substack Migrations

[nickagliano]

Issue Summary

Instructions are either slightly out of date for migrations from Substack, or maybe a bit broken.

https://ghost.org/docs/migration/substack/

Steps to Reproduce

Issue number 1

I went to the docs and installed the CLI tool

# Install CLI
npm install --global @tryghost/migrate

But the next instruction is incorrect (I think? I guess might depend on your npm setup?)

# Verify it's installed
migrate

I had to run npx @tryghost/migrate.

---

Issue number 2

I wasn't actually able to upload the migrated .zip file from substack to ghost--it just asked for the substack file. So I ended up just uploading the un-migrated substack export zip via the Ghost admin page and that worked great, and I should have just done that instead of messing with the CLI migrate tool.

---

Issue number 3

NOTE: This might just be from an old node or @tryghost/migrate version.

The migrate script ended with an error:

✔ Write Ghost import zip
   →  Successfully written zip to /Path/redacted/to/gh-substack-export-1744156689391.zip in 587ms
[2025-04-08 23:58:09] INFO
Error: ENOENT: no such file or directory, open '/Path/redacted/to/localhost_development.log'

Maybe this has been fixed in more recent versions.

Ghost Version

using @tryghost/migrate v 0.49.2), version 5.116.1 of the docs?

Node.js Version

v16.17.0

How did you install Ghost?

N/A

Database type

MySQL 5.7

Browser & OS version

N/A

Relevant log / error output

Code of Conduct

• I agree to be friendly and polite to people in this repository