Skip to main content

Hasura on GKE Autopilot

Hasura on GKE Autopilot

Hasura is an open-source, Apache 2.0-licensed engine that gives you an instant, realtime GraphQL (and REST) API over a PostgreSQL database, with fine-grained role-based authorization, event triggers, and a built-in admin console. This module deploys the Hasura GraphQL Engine (hasura/graphql-engine) on GKE Autopilot on top of the App_GKE foundation, which provisions and manages the shared Google Cloud and Kubernetes infrastructure.

This guide focuses on the cloud services Hasura uses and how to explore and operate them from the Google Cloud Console and the command line. For the mechanics that are common to every GKE application — Workload Identity, ingress, autoscaling, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, backups, and the deployment lifecycle — refer to the App_GKE foundation guide rather than repeating them here.


What Hasura costs on RAD, and how that compares​

Running Hasura on GKE Autopilot pod in your own Google Cloud project costs about $104.74/month in Google Cloud charges, on top of a one-off 110-credit RAD module fee charged once at deploy time. Hasura's own commercial cloud product has pivoted away from hosting the classic open-source GraphQL Engine this module deploys — its current pricing page (checked 8 October 2026) only lists the newer "DDN" supergraph product, with no separate plan for the Community Edition engine, so that isn't a fair comparison to quote here. In a RAD-managed project the module fee drops to 99 credits (10% lower) and the running cost is metered hourly in credits instead of billed directly by Google — see Pause it for free below for the one RAD-managed advantage a self-hosted VPS cannot match — or see the Cloud Run guide for the lower-cost option.

What you pay on RAD​

Own projectRAD-managed project
Module fee (one-off)110 credits99 credits (10% lower)
Build time~3-6 credits per build, either way~3-6 credits per build, either way
Google Cloud running cost$104.74/month, billed by Google at list price~92 credits/day, metered at list price plus RAD's margin

Default running cost in your own project

ResourceUS$/month (Google list price, us-central1)
GKE Autopilot pod, 1x vCPU / 0.5 GiB$34.29
Cloud SQL for PostgreSQL, 1 vCPU / 3.75 GB, zonal, 10 GB SSD$51.02
NFS/cache file server (small VM)$13.43
Cloud NAT and networking$5.00
Cloud Storage (add-ons, backups)$1.00
GKE cluster management feeshared across every GKE app in the project; $0 if this is your only cluster, else ~73
Total$104.74

The GKE cluster management fee is excluded from the total above because it is shared across every GKE app in the project — $0 if this is the only one, otherwise roughly $73/month split across however many you run.

How it compares​

  • A self-managed comparison instead: Hetzner CPX22 (2 vCPU/4GB) runs about $24/mo, a DigitalOcean 2 vCPU/4GB Droplet is the same $24/mo, and a GCP Compute Engine e2-standard-2 (2 vCPU/8GB) is about $49/mo — enough to run Hasura's engine and its Postgres database together on one box.
  • The 1 vCPU/0.5 GiB engine itself is light; most of the running cost above is the dedicated Postgres instance GraphQL introspection needs to stay fast, which a self-managed box would need too.
  • As elsewhere, the VPS figures above are cheaper in cash terms but carry no managed backups, patching, or secret rotation — RAD's Cloud SQL, Secret Manager and monitoring cover that for you.

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

This is the headline advantage of a RAD-managed project, and it costs nothing while paused. Deleting a RAD-managed project unlinks its billing first, then asks Google to delete the project outright — Google's own 30-day recoverable soft delete. Unlike deleting one module, 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 credits (under US$1) in total for a typical 2-3-deployment chain.

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've customised Hasura 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​

In your own project, or once 30 days have passed on a RAD-managed one, there is no free pause — deleting removes the resources for good, and bringing Hasura back means redeploying from scratch. That costs about 113-116 credits (the 110-credit module fee plus a build).

Deleting only saves money once Hasura would otherwise sit unused long enough to clear that redeploy cost against its own running cost — for Hasura, that's about 4 days or more. Most of that running cost is usually the database (and, where this module uses one, the shared file-server VM or GKE cluster) — those stop only once nothing else in the project uses them, so deleting this app while something else shares the project saves only its own compute share.

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 documentation for the pause/restore claims.

1. Overview​

Hasura runs as a stateless Haskell web workload. The deployment wires together a focused set of Google Cloud services:

CapabilityGoogle Cloud serviceNotes
ComputeGKE AutopilotHaskell pods, 1 vCPU / 512 MiB by default, horizontally autoscaled
DatabaseCloud SQL for PostgreSQL 15Required — Hasura's metadata catalog and default data source both live in Postgres
Object storageNoneHasura is stateless; no bucket is provisioned
SecretsSecret ManagerAuto-generated HASURA_GRAPHQL_ADMIN_SECRET; database password
IngressCloud Load BalancingExternal LoadBalancer, optional custom domain + managed certificate

Sensible defaults worth knowing up front:

  • PostgreSQL 15 is mandatory. The database engine is fixed by the shared application layer; Hasura keeps its own metadata catalog in Postgres.
  • The admin secret gates everything sensitive. HASURA_GRAPHQL_ADMIN_SECRET is generated automatically, stored in Secret Manager, and materialised into the namespace via the Secret Store CSI driver. It protects the /console UI and the /v1/graphql and /v1/metadata APIs; /healthz stays public for probes.
  • Two connection URLs are assembled in-container. The custom image entrypoint builds HASURA_GRAPHQL_DATABASE_URL and HASURA_GRAPHQL_METADATA_DATABASE_URL from the injected DB_* variables. On GKE the Cloud SQL Auth Proxy sidecar listens on 127.0.0.1, so the entrypoint uses a plain loopback DSN with no sslmode (the proxy terminates TLS).
  • Stateless Deployment, no sticky routing. workload_type = "Deployment" and session_affinity = "None" — every pod is interchangeable because all state is in Postgres, so rolling updates are safe and no PVC/NFS is used.
  • Minimum 1 replica is maintained (GKE does not support scale-to-zero) so the API is always reachable; a PodDisruptionBudget (pdb_min_available = "1") preserves availability during node upgrades.
  • Exposed on a stable external IP. service_type = "LoadBalancer", reserve_static_ip = true, and enable_custom_domain = true by default.

2. Google Cloud Services & How to Explore Them​

All commands assume you have run gcloud container clusters get-credentials <cluster> --region <region> --project <project> and that PROJECT, REGION, and NAMESPACE are set. The namespace and other identifiers are reported in the deployment Outputs.

A. GKE Autopilot — the Hasura workload​

Hasura pods are scheduled on Autopilot, which bills for the CPU/memory the pods actually request. Horizontal Pod Autoscaling sizes the Deployment between the minimum and maximum replica counts.

  • Console: Kubernetes Engine → Workloads → select the Hasura workload to see pods, revisions, and events. Kubernetes Engine → Services & Ingress shows the external IP.
  • CLI:
    kubectl get pods,svc,hpa -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" deploy/<service-name> --tail=100
    kubectl describe hpa -n "$NAMESPACE" # current vs target utilisation

See App_GKE for how Autopilot, scaling, and the workload type are managed.

B. Cloud SQL for PostgreSQL 15​

Hasura stores its metadata catalog (tracked tables, relationships, permissions, event triggers) and your application data in a managed Cloud SQL for PostgreSQL 15 instance. Pods reach it privately through the Cloud SQL Auth Proxy sidecar over loopback; no public IP is exposed. On first deploy an initialization Job creates the application database and user; Hasura installs its metadata schema on first boot.

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

The instance name, database name, user, and the Secret Manager secret holding the password are all surfaced in the Outputs. For the connection model, automated backups, and password rotation, see App_GKE.

C. Secret Manager​

One cryptographic secret is generated automatically and stored in Secret Manager: HASURA_GRAPHQL_ADMIN_SECRET. It is materialised into the namespace via the Secret Store CSI driver and injected as an environment variable. The database password is managed separately by the foundation.

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

See App_GKE for the Secret Store CSI integration and rotation.

D. Networking & ingress​

By default the workload is exposed through an external Cloud Load Balancing IP, with a static IP reserved so the address survives redeploys and a Google-managed certificate for the custom domain.

  • Console: Network services → Load balancing; VPC network → IP addresses.
  • CLI:
    kubectl get ingress,svc -n "$NAMESPACE"
    gcloud compute addresses list --project "$PROJECT"

See App_GKE for custom domains, Cloud CDN, and static IP details.

E. Cloud Logging & Monitoring​

Pod stdout/stderr flow to Cloud Logging; GKE and Cloud SQL metrics flow to Cloud Monitoring. Optional uptime checks and alert policies are available.

  • Console: Logging → Logs Explorer; Monitoring → Dashboards / Alerting.
  • CLI:
    gcloud logging read 'resource.type="k8s_container" AND resource.labels.namespace_name="'"$NAMESPACE"'"' \
    --project "$PROJECT" --limit 50

3. Hasura Application Behaviour​

  • First-deploy database setup. An initialization Job runs create-db-and-user.sh using postgres:15-alpine. It connects through the Cloud SQL Auth Proxy and idempotently creates the application database and user and grants privileges. The job is safe to re-run.
  • Metadata catalog on start. Hasura installs and migrates its own metadata catalog schema in Postgres on startup, so upgrading the image version applies catalog changes without a separate migration step. Tracked-table metadata persists in the database across pod restarts and rolling updates.
  • Two connection URLs, assembled in-container. The entrypoint builds both HASURA_GRAPHQL_DATABASE_URL and HASURA_GRAPHQL_METADATA_DATABASE_URL from the injected DB_* variables. Because the Auth Proxy sidecar listens on 127.0.0.1, the DSN is plain loopback with no SSL.
  • Admin secret is the security boundary. Send it as the x-hasura-admin-secret header:
    ADMIN=$(gcloud secrets versions access latest --secret=<admin-secret-name> --project "$PROJECT")
    curl -s "http://${EXTERNAL_IP}/v1/graphql" \
    -H "x-hasura-admin-secret: $ADMIN" \
    -H 'Content-Type: application/json' \
    -d '{"query":"{ __schema { queryType { name } } }"}'
  • Health path. Startup and liveness probes target /healthz — the public, unauthenticated endpoint that returns 200 once the engine is up and connected to Postgres. Do not repoint probes at /v1/graphql or /console (both 401 without the admin secret), or pods never become Ready.
  • Console access. Reach the console at http://<external-ip>/console (or the custom domain) and paste the admin secret to track tables and run GraphQL queries.

4. Configuration Variables​

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

Group 1 — Project & Identity​

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

Group 2 — Deployment Environment​

VariableDefaultDescription
tenant_iddemoShort suffix; a -gke suffix is appended internally so the CloudRun and GKE variants never collide.
support_users[]Emails granted project access and monitoring alerts.
resource_labels{}Labels applied to all resources for cost/ownership tracking.

Group 3 — Application Identity​

VariableDefaultDescription
application_namehasuraBase name for resources. Do not change after first deploy.
application_display_nameHasuraHuman-readable name shown in the Console.
application_descriptionHasura GraphQL Engine on GKE AutopilotService description.
application_versionv2.36.0Hasura image tag; latest is remapped to a pinned v2.x tag at build time.
application_database_namehasuraPostgreSQL database name. Immutable after first deploy.
application_database_userhasuraApplication database user. Immutable after first deploy.

Group 4 — Runtime & Scaling​

VariableDefaultDescription
deploy_applicationtrueSet false to provision infrastructure only.
container_image_sourcecustomcustom builds a wrapper image that assembles the DSNs; prebuilt requires manual URL config.
container_resources{ cpu_limit="1000m", memory_limit="512Mi" }CPU/memory limits and requests.
min_instance_count1Minimum replicas; GKE requires ≥ 1 (no scale-to-zero).
max_instance_count10Maximum replicas. Hasura scales horizontally.
workload_typeDeploymentStateless — Hasura keeps all state in Postgres.
container_port8080Hasura binds HASURA_GRAPHQL_SERVER_PORT = 8080.
enable_cloudsql_volumetrueCloud SQL Auth Proxy sidecar for the Postgres connection.
enable_image_mirroringtrueMirror the Hasura image into Artifact Registry.

Group 5 — Access & Ingress Control​

VariableDefaultDescription
enable_iapfalseRequire Google sign-in in front of the Ingress (API included).
iap_authorized_users / iap_authorized_groups[]Who may access through IAP.

Group 6 — GKE Backend & Cluster​

VariableDefaultDescription
service_typeLoadBalancerHow the Kubernetes Service is exposed.
session_affinityNoneNo sticky routing — Hasura is stateless.
network_tags[]Node/pod network tags. Add nfsserver if you enable enable_nfs.
termination_grace_period_seconds30Seconds to wait after SIGTERM before SIGKILL.
enable_network_segmentationfalseCreate Kubernetes NetworkPolicy resources.

Group 7 — StatefulSet​

VariableDefaultDescription
stateful_pvc_enablednullLeave unset. Not recommended — Hasura stores all state in PostgreSQL.
stateful_pvc_size / stateful_pvc_mount_path10Gi / /dataOnly relevant if a StatefulSet is forced.

Group 8 — Environment Variables & Secrets​

VariableDefaultDescription
environment_variables{}Extra HASURA_GRAPHQL_* settings. Do not set the two *_DATABASE_URL values or the admin secret here — they are managed automatically.
secret_environment_variables{}Map of env var → Secret Manager secret name.
secret_propagation_delay30Seconds to wait after secret creation before proceeding.
secret_rotation_period2592000sSecret Manager rotation notification frequency.

Group 9 — Reliability Policies​

VariableDefaultDescription
enable_pod_disruption_budgettrueProtect availability during node upgrades.
pdb_min_available1Minimum pods available during voluntary disruptions.
enable_resource_quotafalseEnforce a namespace ResourceQuota (memory values need binary suffixes, e.g. 4Gi).

Group 10 — Observability & Health​

VariableDefaultDescription
startup_probe_configHTTP /healthz, failure_threshold=30Startup probe.
health_check_configHTTP /healthz, failure_threshold=3Liveness probe.
uptime_check_configdisabledOptional Cloud Monitoring uptime check.
alert_policies[]Optional metric alert policies.

Group 11 — Jobs & Scheduled Tasks​

VariableDefaultDescription
initialization_jobs[]Leave empty to use the built-in db-init job.
cron_jobs[]Scheduled Kubernetes CronJobs.
additional_services[]Sidecar or helper services deployed alongside Hasura.

Group 12 — CI/CD & GitHub Integration​

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

Group 13 — Filesystem (NFS)​

VariableDefaultDescription
enable_nfsfalseNot required for Hasura.
nfs_mount_path/mnt/nfsMount path inside the container.

Group 14 — Cloud Storage & Artifact Registry​

VariableDefaultDescription
create_cloud_storagetrueCreate GCS buckets defined in storage_buckets.
storage_buckets[]Empty — Hasura requires no file storage.
gcs_volumes[]GCS Fuse volume mounts via the CSI driver.
manage_storage_kms_iam / enable_artifact_registry_cmekfalseCMEK options.
max_images_to_retain / delete_untagged_images / image_retention_days7 / true / 30Artifact Registry cleanup policy.

Group 15 — Redis Cache & Queue​

VariableDefaultDescription
enable_redistrueDeclared for Foundation-variable mirroring but not forwarded to App_GKE in this module — Hasura does not require Redis, so this variable has no effect regardless of its value.
redis_host / redis_port"" / 6379Also inert for the same reason as enable_redis.

Group 16 — Database Backend​

VariableDefaultDescription
database_typePOSTGRESFixed — Hasura requires PostgreSQL.
database_password_length32Generated password length (16–64).
enable_auto_password_rotationfalseZero-downtime DB password rotation.
rotation_propagation_delay_sec90Seconds to wait after rotation before rolling-restarting pods.

Group 17 — Backup & Maintenance​

VariableDefaultDescription
backup_schedule0 2 * * *Automated backup cron (UTC).
backup_retention_days7Retention; raise to 30–90 for production/compliance.
enable_backup_importfalseRestore from a backup on deploy.

Group 18 — Custom SQL Scripts​

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_GKE.

Group 19 — Custom Domain, Static IP & Networking​

VariableDefaultDescription
enable_custom_domaintrueProvision Ingress for custom hostnames + managed certificate.
application_domains[]Hostnames to serve; empty uses the reserved IP's nip.io host.
reserve_static_iptrueStable external IP across redeploys.

Group 21 — Cloud Armor​

VariableDefaultDescription
enable_cloud_armorfalseAttach a Cloud Armor (WAF) policy to the Ingress backend.
admin_ip_ranges[]CIDRs allowed privileged access.
enable_cdnfalseEnable Cloud CDN on the GKE Ingress backend.

Group 22 — VPC Service Controls & Audit Logging​

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

5. Outputs​

These values are returned on a successful deployment and are the quickest way to locate and explore the running resources.

OutputDescription
service_nameKubernetes Service name.
namespaceNamespace the workload runs in.
service_cluster_ipIn-cluster ClusterIP.
stage_service_cluster_ipsMap of ClusterIPs for stage-specific services.
service_external_ipExternal LoadBalancer IP (when a static IP is reserved).
service_urlURL to reach Hasura.
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 (127.0.0.1 via the Auth Proxy) / port.
storage_bucketsCreated Cloud Storage buckets (empty for Hasura).
network_name / network_exists / regionsVPC network, presence, available regions.
container_image / container_registryDeployed image and Artifact Registry repo.
monitoring_enabled / monitoring_notification_channelsMonitoring status and channels.
initialization_jobs / db_import_jobNames of the setup and (optional) import jobs.
deployment_id / tenant_id / resource_prefixNaming identifiers.
project_id / project_numberProject identifiers.
cicd_enabled / cicd_configurationCI/CD status and details (repo, trigger, registry).
github_repository_url / github_repository_owner / github_repository_nameCI/CD GitHub details.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistry and build trigger.
kubernetes_readyWhether the cluster/workload is ready.
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).

Inherited plan-time validation. This module passes its configuration through the App_GKE foundation engine, which validates values and combinations at plan time — a read replica without its primary, IAP with no authorized identities, a gen1 runtime with NFS/GCS mounts, a database_type that does not match an enabled extension, an out-of-range redis_port/backup_retention_days. Invalid configuration fails the plan with a clear, named error before any resource is created, so most mistakes below are caught up front rather than at apply or runtime.

SettingSensible valueRiskConsequence if wrong
HASURA_GRAPHQL_ADMIN_SECRET (auto-generated)Keep in Secret Manager; rotate deliberatelyCriticalIt is the only guard on the GraphQL/metadata APIs and console — exposing it grants full read/write to every tracked table.
application_database_name / application_database_userSet onceCriticalImmutable after first deploy; renaming recreates the DB/user and orphans the metadata catalog and all data.
enable_backup_importfalse unless restoringCriticalEnabling without a valid backup file fails the import job.
quota_memory_requests / _limitsbinary units (4Gi, 8192Mi)CriticalBare integers are bytes and block all pod scheduling in the namespace.
startup_probe_config / health_check_config path/healthzHighPointing a probe at /v1/graphql or /console returns 401 — pods never become Ready even though the engine booted.
container_image_sourcecustomHighprebuilt skips the entrypoint that assembles the two *_DATABASE_URL values — the engine starts with no database and every request fails.
enable_cloudsql_volumetrueHighThe Auth Proxy sidecar is required for PostgreSQL connectivity; disabling it is blocked by a plan-time validation guard.
min_instance_count1HighGKE requires min ≥ 1; the validation guard rejects invalid values. Keeping 1 ensures the API is always reachable.
workload_type / stateful_pvc_enabledDeployment / unsetMediumForcing a StatefulSet gains nothing (state is in Postgres) and complicates rolling updates.
HASURA_GRAPHQL_ENABLE_CONSOLEfalse in productionMediumLeaving the console on widens the attack surface; manage metadata via the hasura CLI/migrations instead.
enable_pod_disruption_budgettrueMediumDisabling allows GKE to evict all pods simultaneously during maintenance.
backup_retention_days7 (raise for prod)MediumToo short for compliance retention.

For the foundation behaviour referenced throughout — IAM and Workload Identity, autoscaling, ingress and certificates, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, backups, and image mirroring — see App_GKE. Hasura-specific application configuration shared with the Cloud Run variant is described in Hasura_Common.

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