Ghost Developer FAQs - Ghost Developer Docs

https://docs.ghost.org/faq • 298 KB fetched
Open original page

Ghost Developer FAQs - Ghost Developer Docs
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.

Skip to main content
Ghost Developer Docs home page

Search...

⌘ K

* Sign in

* Get Started

* Get Started

Search...

Navigation
Resources
Ghost Developer FAQs

Home
Documentation
Migration Guides

*
Tutorials

*
Developer Forum
Getting Started

* Introduction

* Installation

* Hosting Guide

* Updates & Versions

Core Concepts

* Overview

* Architecture

* Configuration

* Staff Users

* Publishing

* Memberships

* Recommendations

* Newsletters

* Security

Themes

* Overview

* Structure

* Contexts

* Assets

* Helpers

* Content

* Search

* Share

* Members

* Routing

* Custom Settings

* GScan

Advanced Tools

* Ghost CLI

* Content API

* Admin API

* JAMstack

* Webhooks

Resources

* FAQ

* Breaking Changes

* Contributing

* LLM

* License

* Logos

* Trademark

Resources

Ghost Developer FAQs

Frequently asked questions and answers about running Ghost

API versioning
Ghost ships with a mature set of APIs. Each API endpoint has a status, which indicates suitability for production use. Read more about Ghost’s architecture .

Clustering, sharding, HA and other multi-server setups
Ghost doesn’t support load-balanced clustering or multi-server setups of any description, there should only be one Ghost instance per site.

Connection timeout when sending email on DigitalOcean
DigitalOcean blocks outbound SMTP on ports 25, 465 and 587 by default, which causes Ghost to fail with a connection timeout when sending transactional email.

Filter property not working in routing
Working with more complex iterations of the filter property in the routes.yaml file can cause conflicts or unexpected behaviour. Here are the most common issues.

How can I backup my site data?
Learn how to backup your self-hosted Ghost install

How to resolve errors when running ghost start
If an error occurs when trying to run ghost start or ghost restart , try using ghost run first to check that Ghost can start successfully. The start and restart commands are talking to your process manager (e.g. systemd) which can hide underlying errors from Ghost.

Image upload issues
Image uploads can be affected by the default max upload size of 50mb. If you need more, you’ll need to increase the limit by editing your nginx config file, and setting the limit manually.

Mail config error in Ghost with Google Cloud
There’s a known issue that Google Cloud Platform does NOT allow any traffic on port 25 on a Compute Engine instance .

Major Versions & Long Term Support
Major version release dates and end of life support for Ghost.

Missing newsletter analytics
Open rates that are 0% may indicate that the connection between Ghost and Mailgun has stalled, which prevents Ghost from fetching your newsletter analytics.

Missing SSL protocol
After installing Ghost a url for your site is set. This is the URL people will use to access your publication.

Reverse proxying to Ghost
Ghost is designed to have a reverse proxy in front of it. If you use Ghost-CLI to install Ghost, this will be setup for you using nginx. If you configure your own proxy, you’ll need to make sure the proxy is configured correctly.

Root user permissions fix
A fix for root user permissions problems

Salt Incident Report: May 3rd, 2020
Analysis and retrospective of the critical Salt vulnerability on Ghost(Pro)

Supported Node versions
Ghost’s current recommended Node version is Node v20 LTS.

Supported providers for self-hosting
We recommend using Digital Ocean who provide a stable option on which Ghost can be installed and have a very active community and an official Ghost One-Click Application .

Translation in Ghost
Creators from all over the world use Ghost. Publications abound in German, French, Spanish, Sinhalese, and Arabic—and the list keeps going!

Troubleshooting MySQL databases
If your MySQL database is not correctly configured for Ghost, then you may run into some issues.

Unable to open sqlite3 database file
If the sqlite3 database file is not readable or writable by the user running Ghost, then you’ll run into some errors.

Update from Ghost 0.x versions
If you’re running Ghost 0.x versions, your site must be updated to Ghost 1.0 before it can be successfully updated to Ghost 2.0 and beyond.

Updating from deprecated Ghost-CLI
When managing your self-hosted Ghost publication using the recommended ghost-cli tooling, you should update your CLI version. If you are using a deprecated version and need to update in order to update or manage your Ghost site, some extra steps may be required.

URL for tags and authors returns 404 errors
The tag and author taxonomies must be present in routes.yaml otherwise the URLs will not exist. By default, Ghost installs with the following:

Using Cloudflare with Ghost
If you’ve added Cloudflare to your self-hosted Ghost publication and find that Ghost Admin doesn’t load after updates you may run into some errors in the JavaScript console:

Using nvm with local and production installs
This guide explains how to use nvm with local and production Ghost installs.

What databases are supported in production?
MySQL 8 is the only supported database in production.

Why do I have to set up Mailgun?
Ghost has the ability to deliver posts as email newsletters natively. A bulk-mail provider is required to use this feature and SMTP cannot be used — read more about mail config .

Suggest edits Raise issue

Webhooks
Breaking Changes

github twitter bluesky reddit
Powered by This documentation is built and hosted on Mintlify, a developer documentation platform

Links found on this page

1. /llms.txt [direct]
2. Skip to main content [direct]
3. Ghost Developer Docs home page [direct]
4. Sign in [direct]
5. Get Started [direct]
6. Home [direct]
7. Documentation [direct]
8. Migration Guides [direct]
9. Tutorials [direct]
10. Developer Forum [direct]
11. Installation [direct]
12. Hosting Guide [direct]
13. Updates & Versions [direct]
14. Overview [direct]
15. Architecture [direct]
16. Configuration [direct]
17. Staff Users [direct]
18. Publishing [direct]
19. Memberships [direct]
20. Recommendations [direct]
21. Newsletters [direct]
22. Security [direct]
23. Overview [direct]
24. Structure [direct]
25. Assets [direct]
26. Content [direct]
27. Search [direct]
28. Share [direct]
29. Members [direct]
30. Routing [direct]
31. Custom Settings [direct]
32. GScan [direct]
33. Ghost CLI [direct]
34. Webhooks [direct]
35. Breaking Changes [direct]
36. Contributing [direct]
37. LLM [direct]
38. License [direct]
39. Logos [direct]
40. Trademark [direct]
41. Compute Engine instance [direct]
42. Ghost One-Click Application [direct]
43. Suggest edits [direct]
44. Raise issue [direct]
45. github [direct]
46. twitter [direct]
47. bluesky [direct]
48. reddit [direct]
49. Powered by This documentation is built and hosted on Mintlify, a developer documentation platform [direct]