{"registry_version":"2026.1025.387","generated_at":"2026-10-25T06:27:00Z","content_sha256":"089d16f627d9365e3d0663cc8069203706d7cb23a76c332226e29686968811a5","signed":true,"signature":{"key_id":"ed25519:74ca19268e364242","algorithm":"ed25519","expires_at":"2026-11-24T06:27:09Z","expired":false,"manifest":"/registry/manifest.json"},"id":"planetscale/database","name":"PlanetScale database (Postgres or Vitess)","vendor":"PlanetScale","status":"researched","last_verified":null,"last_researched":"2026-10-25","summary":"Create a PlanetScale organization and database in a chosen region and cluster size, create a role and password, and optionally a service token for the API.","account_model":{"summary":"A PlanetScale user creates or joins an organization; databases (with branches) belong to the organization, which is billed.","accounts":[{"name":"PlanetScale user","kind":"personal","owned_by":"the person","required":true},{"name":"Organization","kind":"billing","parent":"PlanetScale user","required":true}]},"prerequisites":[],"identity_requires":[],"have_ready":[{"kind":"payment_card","description":"A card for the organization.","why":"The pricing page lists only paid cluster sizes (from $5/month); no free plan is listed.","needed_for":["create-database"],"auto_check":"none","source_url":"https://planetscale.com/pricing"}],"steps":[{"id":"sign-up","title":"Create an account and organization","summary":"The person signs up at PlanetScale and is prompted to create an organization. verapli never creates the account.","route":"guided","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":[],"optional":false,"url":"https://app.planetscale.com/","lead_time":null,"preflight":[],"captures":null},{"id":"create-database","title":"Create the database","summary":"Choose New database, pick Postgres (or Vitess), name it, choose the primary region close to the app, pick cluster size and CPU architecture, and create it.","route":"copilot","gate":"human_payment","human_only":true,"gate_label":"You add payment details","depends_on":["sign-up"],"optional":false,"url":"https://app.planetscale.com/new","lead_time":null,"preflight":[],"captures":null},{"id":"create-role","title":"Create a role and copy the connection string","summary":"Open the database, click Connect, create the default role (or run pscale role reset-default <db> <branch>), and copy host, username and password, or a framework connection string. The password is shown once; verapli captures the connection string into DATABASE_URL.","route":"copilot","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":["create-database"],"optional":false,"url":"https://app.planetscale.com/","lead_time":null,"preflight":[],"captures":"DATABASE_URL"},{"id":"create-service-token","title":"Create a service token (optional)","summary":"In organization Settings, Service tokens, New service token, name it, then grant only the database permissions needed. Copy the token ID and the token.","route":"guided","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":["sign-up"],"optional":true,"url":null,"lead_time":null,"preflight":[],"captures":null}],"gates":[{"step":"sign-up","gate":"human_submit","label":"You press submit"},{"step":"create-database","gate":"human_payment","label":"You add payment details"},{"step":"create-role","gate":"human_submit","label":"You press submit"},{"step":"create-service-token","gate":"human_submit","label":"You press submit"}],"lead_times":[],"outputs":[{"name":"DATABASE_URL","description":"Postgres connection string including the role password. PlanetScale docs do not fix an env var name; DATABASE_URL is the common convention chosen by verapli.","secret":true,"example_format":"postgresql://postgres.<branch-id>:<password>@<host>.horizon.psdb.cloud:5432/postgres?sslmode=verify-full","environments":null},{"name":"PLANETSCALE_SERVICE_TOKEN_ID","description":"Service token ID (first half of the API Authorization header). Name chosen by verapli.","secret":false,"example_format":null,"environments":null},{"name":"PLANETSCALE_SERVICE_TOKEN","description":"Service token secret (second half of the API Authorization header). Name chosen by verapli.","secret":true,"example_format":null,"environments":null}],"renewals":[],"estimated_minutes":null,"guide_url":"https://verapli.com/guides/planetscale/database"}