Install dependencies
yarn
Start the development server. You now have a Gatsby site pulling content from headless Ghost.
gatsby develop
By default, the starter will populate content from a default Ghost install located at https://gatsby.ghost.io.
To use your own install, you will need to edit the .ghost.json
config file with your credentials. Change the apiUrl
value to the URL of your Ghost site. For Ghost(Pro) customers, this is the Ghost URL ending in .ghost.io
, and for people using the self-hosted version of Ghost, it's the same URL used to access your site.
Next, update the contentApiKey
value to a key associated with the Ghost site. A key can be provided by creating an integration within Ghost Admin. Navigate to Integrations and click "Add new integration". Name the integration appropriately and click create.
Finally, configure your desired URL in siteConfig.js
, so links (e. g. canonical links) are generated correctly. You can also update other default values, such as postsPerPage
in this file.
To use this starter without issues, your Ghost installation needs to be at least on version 2.10.0
.
The default Ghost version that is used for this starter is 3.x
. If your Ghost installation is on a lower version, you will need to pass in a version
property in your .ghost.json
settings:
Ghost >=2.10.0 <3.0.0
{
"apiUrl": "https://gatsby.ghost.io",
"contentApiKey": "9cc5c67c358edfdd81455149d0",
"version": "v2"
}
Ghost <=3.0.0
{
"apiUrl": "https://gatsby.ghost.io",
"contentApiKey": "9cc5c67c358edfdd81455149d0"
}
You can disable the default Ghost Handlebars Theme front-end by enabling the Make this site private
flag within your Ghost settings. This enables password protection in front of the Ghost install and sets <meta name="robots" content="noindex" />
so your Gatsby front-end becomes the source of truth for SEO.
# Run a production build, locally
gatsby build
# Serve a production build, locally
gatsby serve
Gatsby develop
uses the development
config in .ghost.json
- while Gatsby build
uses the production
config.