Skip to main content

Certification track: Associate Cloud Engineer (ACE)

Ghost on Google Cloud Run

Ghost on Google Cloud Run

Ghost is a modern open-source publishing platform powering 2M+ publications with built-in membership, subscriptions, and newsletters. This module deploys Ghost on Cloud Run v2 on top of the App_CloudRun foundation, which provisions and manages the shared Google Cloud infrastructure.

This guide focuses on the cloud services Ghost uses and how to explore and operate them from the Google Cloud Console and the command line. For the mechanics common to every Cloud Run application — service identity, ingress and load balancing, scaling and concurrency, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, backups, and the deployment lifecycle — refer to the App_CloudRun foundation guide rather than repeating them here.


What Ghost costs on RAD, and how that compares​

Running Ghost in your own Google Cloud project costs about US$81.23/month in Google Cloud charges, on top of a one-time 110-credit RAD module fee (99 credits — 10% lower — in a RAD-managed project). Ghost is a modern open-source publishing platform with 48,000+ GitHub stars, powering 2M+ publications and used by leading independent media brands. If you deploy into a RAD-managed project, you can pause the whole thing for free and pick it back up later — see "Pause it for free" below.

Ghost is also available on GKE — see the GKE guide if you need Kubernetes-based orchestration; this guide covers the lower-cost Cloud Run option.

What you pay on RAD​

Own projectRAD-managed project
Module fee110 credits (one-time)99 credits (one-time, 10% lower)
Build time~3–6 credits (one-time, per build)~3–6 credits (one-time, per build)
Google Cloud running cost~US$81.23/month, billed to your own Google billing account at list price~32 credits/day (~US$3.20/day), metered hourly at list price plus RAD's margin

Default running cost in your own project

ResourceUS$/month (Google list price, us-central1)
Cloud Run, 1x vCPU / 0.5 GiB (scaleToZero)US$10.78
Cloud SQL for MySQL, 1 vCPU / 3.75 GB, zonal, 10 GB SSDUS$51.02
NFS/cache file server (small VM)US$13.43
Cloud NAT and networkingUS$5
Cloud Storage (add-ons, backups)US$1
TotalUS$81.23

How it compares​

  • Ghost(Pro)'s cheapest paid plan, Starter, is US$18/month (up to 1,000 members, one newsletter, a free custom domain (billed yearly)) — verified at https://ghost.org/pricing/. That undercuts RAD's ~US$81.23/month Google Cloud bill for the Cloud Run variant on sticker price alone, but it caps usage; RAD's instance is uncapped, self-hosted, and the data never leaves your own project.
  • The honest trade here is cap vs. control, not price: a managed SaaS plan is cheaper at this scale, and RAD's running cost is what real Cloud SQL, compute and networking actually cost at Google's list price with nothing hidden in a bundled seat price.
  • RAD is not claiming to be cheaper than a bare VPS in cash terms — it usually is not. The case for RAD is what's managed for you.

Pause it for free: delete a RAD-managed project, restore it when you need it​

If Ghost is running in a RAD-managed project, you can stop paying for it entirely without destroying it. Deleting that project first unlinks its billing, then asks Google to delete the project outright — Google's own 30-day recoverable soft delete. Unlike deleting the Ghost module on its own, this does not tear down Cloud SQL, any VM or the compute resource one by one: the whole project simply stops, and nothing is charged while it waits, because billing is already unlinked.

Restoring, within 30 days and only by the project's owner, asks Google to undelete the project and reattaches its billing account, then asks you to run Update on each deployment to confirm everything came back. Because nothing was individually destroyed, that Update finds the same resources already there — it is a check, not a rebuild, and an Update never charges the module fee again. This costs only a handful of build-time credits in total — roughly 5–10 credits, under US$1, for a typical 2–3-deployment chain. The 99-credit module fee is not charged again.

What this needs: you must own the project (not one RAD only manages billing for), you must restore it yourself within 30 days — after that Google deletes it for good — and restoring is admitted like creating a new project, so your purchased credit balance must still clear the tier's floor (100 credits for the sandbox tier most study/demo use fits). Google says most services are fully working again within 36 hours of a restore.

One real gap: nightly backups are written to a bucket inside the project, and that bucket has Cloud Storage's soft-delete explicitly turned off, so it is very likely gone as soon as you delete the project — even though the project itself is recoverable for 30 days. If you have customised Ghost and want to keep that work, copy a backup out (to Google Drive, or a bucket outside the project) before deleting. For a default install with nothing irreplaceable in it, this does not matter.

Pay only while you use it, the other way: delete and redeploy​

If Ghost is in your own project (or more than 30 days have passed on a RAD-managed one), the way to stop paying is to delete the deployment and redeploy later when you need it again.

A redeploy costs the module fee again, plus the builds: roughly 110 + ~3–6 credits (~US$11.45) in your own project, or 99 + ~3–6 credits on a RAD-managed one.

Deleting only saves money once Ghost would otherwise sit unused long enough to clear that redeploy cost against its own running cost: roughly about 5 days or more idle in your own project (against its ~US$81.23/month Google Cloud bill), or about 4 days or more idle in a RAD-managed project (against its ~32 credits/day).

Most of Ghost's running cost is the database and the shared file/cache VM. They stop only when nothing else in the project uses them, so deleting this app while something else shares the project saves only this app's own compute share of the total above.

Keep data first: nightly backups go to a bucket inside the deployment and are deleted with it, so copy the latest backup out before deleting if you want to keep it.

Lab sessions and Managed Environments​

  • Lab sessions, for training: a trainer runs a session for a class. Each participant gets the app in their own Google Cloud project for 15 minutes to 24 hours, within an allowance the trainer sets. Either the trainer funds every place, or each participant pays for their own. Everything is deleted when the session ends and unused credits go back to the trainer.
  • Managed Environments, for consultancies: a partner runs the app for a client from a ring-fenced wallet it funds, and settles with the client directly. If the wallet runs low, billing pauses and the data is kept, so nobody receives an unexpected charge. At the end the partner hands the project over and the deployments become the client's own.
  • Credits can be bought in more than 20 currencies, including XAF, XOF, NGN, GHS, KES and ZAR, by card, bank transfer or mobile money.

Sources (8 October 2026): Google Cloud Billing Catalog API list prices; radmodules.dev/pricing for RAD's own fees and daily-credit estimates; Google's project delete/restore docs for the pause/restore mechanics; Ghost(Pro) pricing for the Ghost(Pro) figures.

1. Overview​

Ghost runs as a Node.js container on Cloud Run v2. The deployment wires together a focused set of Google Cloud services:

CapabilityGoogle Cloud serviceNotes
ComputeCloud Run v2Node.js service, 1 vCPU / 512 MiB by default, request-based billing with scale-to-zero
DatabaseCloud SQL for MySQL 8.0Required — Ghost 6.x does not support PostgreSQL
Shared filesFilestore (NFS)Uploaded content and themes shared across all instances (gen2 required)
Object storageCloud StorageA dedicated content bucket (ghost-content) provisioned automatically
CacheRedisEnabled by default; falls back to the NFS host IP when no Redis host is given
SecretsSecret ManagerDatabase password managed automatically
IngressCloud Run URL / Cloud Load BalancingDefault run.app URL, optional external HTTPS load balancer + custom domain

Sensible defaults worth knowing up front:

  • MySQL 8.0 is mandatory. Ghost 6.x requires MySQL; PostgreSQL is not supported and will not start.
  • database__client = "mysql" is injected automatically. Without this Ghost silently falls back to SQLite — the module handles it so you never need to set it manually.
  • Redis is enabled by default. Ghost uses Redis for page caching to reduce database load and improve response times.
  • Dynamic URL detection. The custom entrypoint queries the Cloud Run API at startup to discover the service URL and export it as url for Ghost. An explicit url environment variable takes precedence.
  • A ghost-content GCS bucket is provisioned automatically by Ghost_Common and does not need to be added to storage_buckets.
  • A db-init job runs on every apply to idempotently create the Ghost MySQL database and user.
  • Health probes target / with a 90-second initial delay to allow Ghost to run database migrations and compile themes on first boot.
  • The database password is generated automatically and stored in Secret Manager.

2. Google Cloud Services & How to Explore Them​

All commands assume PROJECT and REGION are set. Service and resource names are reported in the deployment Outputs.

A. Cloud Run — the Ghost service​

Ghost runs as a Cloud Run v2 service that autoscales by request load between the minimum and maximum instance counts. Each deployment creates an immutable revision; traffic can be split across revisions for safe rollouts.

  • Console: Cloud Run → select the service for revisions, traffic, logs, and metrics.
  • CLI:
    gcloud run services list --project "$PROJECT" --region "$REGION"
    gcloud run services describe <service-name> --project "$PROJECT" --region "$REGION"
    gcloud run revisions list --service <service-name> --project "$PROJECT" --region "$REGION"

See App_CloudRun for scaling, concurrency, execution environment, and traffic splitting.

B. Cloud SQL for MySQL 8.0​

Ghost stores all application data (posts, members, settings) in a managed Cloud SQL for MySQL 8.0 instance. The service connects privately through the Cloud SQL Auth Proxy over a Unix socket (no public IP). On first deploy a db-init Job creates the application database and user.

  • Console: SQL → select the instance for connections, backups, flags, metrics.
  • CLI:
    gcloud sql instances list --project "$PROJECT"
    gcloud sql instances describe <instance-name> --project "$PROJECT"
    gcloud sql connect <instance-name> --user=<db-user> --project "$PROJECT"

The instance name, database, user, and password secret are in the Outputs. See App_CloudRun for the connection model, backups, and password rotation.

C. Filestore (NFS) and Cloud Storage​

Uploaded content (images, themes, files) is written to a Filestore (NFS) share mounted into the service so all instances share the same files. A dedicated Cloud Storage bucket (ghost-content) is also provisioned automatically for content. The gen2 execution environment is required for NFS mounts.

  • Console: Filestore → Instances; Cloud Storage → Buckets.
  • CLI:
    gcloud filestore instances list --project "$PROJECT"
    gcloud storage buckets list --project "$PROJECT"
    gcloud storage ls gs://<content-bucket>/ # bucket name is in the Outputs

See App_CloudRun for the NFS mount, GCS Fuse, and CMEK.

D. Redis cache​

Redis backs Ghost's page caching. When no external Redis host is configured and NFS is enabled, the NFS host IP is used as the Redis endpoint.

  • Console: Memorystore → Redis (if using a managed instance).
  • CLI:
    redis-cli -h <redis-host> ping
    redis-cli -h <redis-host> info keyspace

E. Secret Manager​

The database password is stored in Secret Manager and injected into the service at runtime; plaintext never appears in configuration.

  • Console: Security → Secret Manager.
  • CLI:
    gcloud secrets list --project "$PROJECT"
    gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"

See App_CloudRun for injection and rotation details.

F. Networking & ingress​

The service is reachable at its run.app URL by default. An external HTTPS load balancer with a custom domain, Cloud CDN, and Cloud Armor can be layered on; ingress settings and VPC egress control connectivity.

  • Console: Cloud Run (service URL); Network services → Load balancing.
  • CLI:
    gcloud run services describe <service-name> --region "$REGION" --format='value(status.url)'
    gcloud compute addresses list --project "$PROJECT"

See App_CloudRun.

G. Cloud Logging & Monitoring​

Container logs flow to Cloud Logging; Cloud Run and Cloud SQL metrics flow to Cloud Monitoring, with optional uptime checks and alert policies.

  • Console: Logging → Logs Explorer; Monitoring → Dashboards / Alerting.
  • CLI:
    gcloud run services logs read <service-name> --project "$PROJECT" --region "$REGION" --limit 50

3. Ghost Application Behaviour​

  • First-deploy database setup. A db-init Job connects to Cloud SQL via the Auth Proxy and idempotently creates the Ghost database (with utf8mb4 charset and utf8mb4_0900_ai_ci collation), creates the application user, and grants full privileges. The job runs on every apply and is safe to re-run.
  • Slow first boot. Ghost runs database migrations and compiles themes on first start. The startup probe allows 90 seconds of initial delay — do not reduce this below 60 seconds or the instance will be killed before Ghost finishes initialising.
  • Dynamic URL detection. On startup the custom entrypoint queries the Cloud Run metadata API to discover the service URL and sets it as Ghost's url and admin__url. An explicit url environment variable always takes precedence. This ensures Ghost generates correct absolute links in membership emails and admin navigation.
  • Database connection. The entrypoint maps DB_HOST, DB_USER, DB_NAME, DB_PASSWORD, and DB_PORT to Ghost's database__connection__* settings automatically. When DB_HOST starts with / it is treated as a Unix socket path (the Cloud SQL Auth Proxy socket).
  • SMTP for email. Ghost requires SMTP for member sign-ups, password resets, and newsletter delivery. Pre-populated environment_variables (SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASSWORD, SMTP_SSL, EMAIL_FROM) — configure them before inviting members.
  • Admin login. Ghost's admin panel is at <url>/ghost. On first boot Ghost creates an admin user interactively.
  • Health path. Startup and liveness probes target /, which returns HTTP 200 when Ghost is fully initialised.

4. Configuration Variables​

Variables are grouped exactly as they appear on the deployment platform. Only settings specific to or notable for Ghost are listed; every other input is inherited from App_CloudRun with its standard behaviour.

Group 1 — Project & Identity​

VariableDefaultDescription
project_id(required)Target Google Cloud project.
regionus-central1Region for the service and regional resources.

Group 2 — Deployment Environment​

VariableDefaultDescription
tenant_iddemoShort suffix that makes resource names unique per environment.
support_users[]Emails granted project access and monitoring alerts.
resource_labels{}Labels applied to all resources.

Group 3 — Application Identity​

VariableDefaultDescription
application_nameghostBase name for resources. Do not change after first deploy.
display_nameGhost PublishingFriendly name shown in the Console.
descriptionGhost - Professional publishing platformService description.
application_version6.14.0Ghost image version tag; increment to trigger a new revision.

Group 4 — Runtime & Scaling​

VariableDefaultDescription
deploy_applicationtrueSet false to provision infrastructure only.
cpu_limit1000mCPU per instance; sized for light/typical usage — raise to 2000m for production with heavy image processing or membership.
memory_limit512MiMemory per instance (Ghost's floor); raise to 1Gi+ for production with active membership features.
min_instance_count0Minimum instances; 0 enables scale-to-zero — set 1 to avoid cold starts with migration delays. Known bug: main.tf's ghost_module local currently hardcodes min_instance_count = 0, silently overriding this variable regardless of what is configured (flagged by a TODO in main.tf) — see the Configuration Pitfalls entry below.
max_instance_count1Maximum instances; caps concurrent scale-out. Known bug: main.tf's ghost_module local currently hardcodes max_instance_count = 5, silently overriding this variable regardless of what is configured.
container_port2368Ghost's native HTTP port.
container_image_sourcecustomcustom builds via Cloud Build (default); prebuilt deploys an existing image.
enable_cloudsql_volumetrueCloud SQL Auth Proxy for socket connections. Required for Ghost.
execution_environmentgen2Cloud Run gen2 required for NFS mounts.
traffic_split[]Split traffic across revisions for staged rollouts.
max_revisions_to_retain7How many old revisions to keep.

Group 5 — Access & Ingress Control​

VariableDefaultDescription
enable_iapfalseRequire Google sign-in via Identity-Aware Proxy.
iap_authorized_users / iap_authorized_groups[]Who may access through IAP.
ingress_settingsallWhich networks may reach the service (all / internal / LB-only).
vpc_egress_settingPRIVATE_RANGES_ONLYHow outbound traffic is routed through the VPC connector.

Group 6 — Environment Variables & Secrets​

VariableDefaultDescription
environment_variables{SMTP_HOST="", SMTP_PORT="587", SMTP_USER="", SMTP_PASSWORD="", SMTP_SSL="false", EMAIL_FROM="ghost@example.com"}SMTP settings pre-populated for Ghost email delivery (use port 587 STARTTLS or 465 SSL — Google Cloud blocks outbound port 25). database__client=mysql is injected automatically.
secret_environment_variables{}Map of env var → Secret Manager secret name.
secret_propagation_delay30Replication wait after secret creation.
secret_rotation_period2592000sRotation notification frequency.

Group 7 — Backup & Restore​

VariableDefaultDescription
backup_schedule0 2 * * *Automated backup cron (UTC).
backup_retention_days7Retention; raise for production/compliance.
enable_backup_import / backup_source / backup_uri / backup_formatrestore optionsRestore from a backup on deploy.

Group 8 — CI/CD & Binary Authorization​

Standard App_CloudRun Cloud Build / Cloud Deploy integration — see App_CloudRun. Key inputs: enable_cicd_trigger, github_repository_url, github_token, enable_cloud_deploy, enable_binary_authorization, binauthz_evaluation_mode.

Group 9 — Custom SQL​

enable_custom_sql_scripts, custom_sql_scripts_bucket, custom_sql_scripts_path, custom_sql_scripts_use_root — run SQL from a GCS bucket after provisioning. See App_CloudRun.

Group 10 — Domain, CDN, Cloud Armor & Image Retention​

VariableDefaultDescription
application_domains[]Custom hostnames for the external load balancer. Ghost must know its public URL — ensure the domain matches.
enable_cdnfalseEnable Cloud CDN on the LB backend.
enable_cloud_armor / admin_ip_rangesoffAttach a WAF policy / restrict privileged access.
max_images_to_retain / delete_untagged_images / image_retention_days(set)Artifact Registry cleanup policy.

Group 11 — Storage & Filesystem​

VariableDefaultDescription
enable_nfstrueShared Filestore volume for Ghost content. Requires gen2.
nfs_mount_path/mnt/nfsMount path inside the container.
create_cloud_storage / storage_buckets / gcs_volumes(set)Additional buckets / GCS Fuse mounts. The ghost-content bucket is always provisioned automatically.
manage_storage_kms_iam / enable_artifact_registry_cmekfalseCMEK options.

Group 12 — Database Backend​

VariableDefaultDescription
database_typeMYSQL_8_0Ghost requires MySQL 8.0 — do not change.
db_nameghostMySQL database name. Immutable after first deploy.
db_userghostApplication user. Immutable after first deploy.
database_password_length32Generated password length (16–64).
enable_auto_password_rotation / rotation_propagation_delay_secoffDB password rotation.
db_host_env_var_name / db_name_env_var_name / db_user_env_var_name / db_port_env_var_name / service_url_env_var_name""Additional env var names for connection details.

Group 13 — Jobs & Scheduled Tasks​

VariableDefaultDescription
initialization_jobs[]Leave empty to use the built-in db-init job (mysql:8.0-debian).
cron_jobs[]Recurring jobs triggered by Cloud Scheduler.

Group 14 — Observability & Health​

VariableDefaultDescription
startup_probeHTTP / 90s initial delay, 10 failuresHTTP startup probe against Ghost's root path. Generous delay for first-boot migrations.
liveness_probeHTTP / 60s initial delayLiveness probe targeting Ghost's root path.
uptime_check_configdisabled, path /Cloud Monitoring uptime check; disabled by default.
alert_policies[]Metric alert policies.

Group 21 — Redis Cache​

VariableDefaultDescription
enable_redistrueUse Redis for Ghost page caching.
redis_host""Redis endpoint. Leave empty to use the NFS host IP.
redis_port6379Redis port.
redis_auth""Optional Redis auth password (sensitive).

Group 22 — VPC Service Controls & Audit Logging​

VariableDefaultDescription
enable_vpc_scfalseEnforce a VPC-SC perimeter (requires organization_id).
vpc_cidr_ranges / vpc_sc_dry_run(set)Access level CIDRs / dry-run mode.
enable_audit_loggingfalseDetailed Cloud Audit Logs.

5. Outputs​

Returned on a successful deployment — the quickest way to locate and explore the running resources.

OutputDescription
service_nameCloud Run service name.
service_urlDefault run.app URL of the service.
service_locationRegion the service runs in.
stage_servicesStage-specific service URLs (Cloud Deploy).
load_balancer_ip / load_balancer_urlExternal HTTPS load balancer IP / URL (when enabled).
database_instance_nameCloud SQL instance name.
database_name / database_userApplication database name / user.
database_password_secretSecret Manager secret holding the DB password.
database_host / database_portDB endpoint / port.
storage_bucketsCreated Cloud Storage buckets (includes the ghost-content bucket).
network_name / network_exists / regionsVPC network, presence, regions.
container_image / container_registryDeployed image and Artifact Registry repo.
monitoring_enabled / monitoring_notification_channels / uptime_check_namesMonitoring status, channels, uptime checks.
initialization_jobsNames of the setup jobs.
deployment_id / tenant_id / resource_prefixNaming identifiers.
project_id / project_numberProject identifiers.
cicd_enabled / github_repository_url / github_repository_owner / github_repository_name / cicd_configurationCI/CD status and details.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistry and build trigger.
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeVPC-SC status.
audit_logging_enabled / artifact_registry_cmek_enabledAudit logging and CMEK status.

6. Configuration Pitfalls & Sensible Defaults​

Risk: Critical (data loss / outage / security) — High (service degraded) — Medium (cost or partial degradation) — Low (minor).

SettingSensible valueRiskConsequence if wrong
database_typeMYSQL_8_0CriticalGhost requires MySQL 8.0; any other engine breaks startup.
db_name / db_userset onceCriticalImmutable after first deploy; renaming recreates the DB/user and destroys all data.
enable_nfstrueCriticalWithout shared storage, uploaded content is lost between instances/restarts.
container_port2368CriticalGhost's native port; mismatching it causes all health probes to fail.
enable_backup_importfalse unless restoringCriticalEnabling without a valid backup_uri fails the import job.
startup_probe initial_delay_seconds90HighReducing below 60 causes Cloud Run to kill Ghost before it finishes running migrations.
enable_redistrueHighWithout Redis, Ghost serves all pages without a cache, increasing database load.
redis_host"" (NFS) or explicitHighNo valid endpoint if Redis is on but NFS is off and no host is set.
memory_limit512Mi+HighToo little memory causes Node.js OOM during newsletter sends or theme compilation; raise beyond the 512Mi default for active membership/newsletter use.
environment_variables SMTP settingsreal SMTP serverHighNo email delivery means no member sign-ups, no password resets, no newsletters.
container_image_sourcecustomHighThe upstream Ghost image lacks the custom entrypoint that maps DB credentials and detects the service URL.
execution_environmentgen2HighNFS mounts require gen2; gen1 cannot mount Filestore.
min_instance_count / max_instance_count0 (default) or 1MediumKnown bug: main.tf's ghost_module local hardcodes min_instance_count = 0 and max_instance_count = 5, silently overriding these variables — setting them in tfvars and re-applying currently has no effect on the deployed service's scaling limits until the hardcoded override is removed from the module source.
enable_iap / enable_cloud_armorenable for admin-facingMediumThe Ghost admin panel (/ghost) is otherwise publicly reachable.
backup_retention_days7 (raise for prod)MediumToo short for compliance retention.

For the foundation behaviour referenced throughout — service identity, scaling and concurrency, ingress and load balancing, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, backups, and image mirroring — see App_CloudRun. Ghost-specific application configuration shared with the GKE variant is described in Ghost_Common.

Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.