In this tutorial, we’ll walk you through the steps of installing Ghost locally on your machine.
Running Ghost locally is essential for custom theme development because it allows you to:
⌚ Make and preview changes to your theme in real-time
🧑🔬 Quickly test out new ideas
🤩 Ensure your theme is free of bugs and ready for primetime
Install Ghost CLI
Ghost CLI (command-line interface) is a tool for installing and configuring Ghost. It assists you in installing Ghost locally. To install the tool, open a terminal and run:
npm install ghost-cli@latest -g
This command tells
npm (Node Package Manager) to install the latest version of Ghost CLI. The
-g flag means “globally” and ensures that you’re able to access the tool anywhere on your machine.
Confirm that Ghost CLI is installed correctly by running
ghost help in the terminal. The tool will output a list of all available commands. It’s a handy way to see everything the Ghost CLI can do!
Make your inbox fire
Build a better internet with early access to features, tools, and tutorials.No spam. Once a month. Unsubscribe any time.
Install Ghost locally
You’re now ready to install Ghost. In the terminal, navigate to an empty directory. The directory can have any name you want.
Run the install command:
ghost install local
This command uses the Ghost CLI tool installed in the previous step. The
local argument means that you’re going to run Ghost locally, that is, on your computer and not exposed to the internet. This local installation of Ghost makes testing and development easier.
Once the installation finishes, the CLI tool will output the URL for your Ghost site. By default, it’ll be
Open the link in your browser to go through Ghost’s onboarding flow. Access Ghost Admin at any time via
That’s it. You’re done! Your local Ghost site is ready for use 🖥️
5 Ghost CLI commands to know
Ghost runs in a separate background process and remains running until you stop it or restart your computer. So you may find these commands useful for taming it:
Run this command from your installation directory. It will stop the currently running Ghost instance.
Run this command from your installation directory to start your local instance of Ghost. It’s necessary to run
ghost start after you restart your computer.
Run this command from anywhere on your machine to list your Ghost installs. It shows where you installed them, whether they’re running, and their URL. You can install multiple Ghost publications on your machine, which is helpful if you want to test out different content, debug something without messing with your current setup, or develop several themes at once.
Run this command from your installation directory to update Ghost.
Run this command from anywhere to show all available commands. Also, find a deep dive and full explanation of all Ghost CLI commands in the docs.
In this tutorial, you learned how to install Ghost locally. You began by installing the Ghost CLI globally. Now, you can run
ghost install local in any empty directory to launch a full-fledged Ghost publication on your computer!
You’re now in the perfect place to start creating a custom Ghost theme. Jump into our developer theme documentation to learn how to get started or visit us on the official Ghost forum, where we talk about all things Ghost.