Quickstart

Get started with White Ghost.

Two paths, depending on where you sit. Admins set the company up once in the control tower. Builders install the CLI and ship apps from their laptop. Pick yours below.

AFor companiesSet up your isolated environment BFor buildersShip your first app

For companies — the admin setup

Setup happens once, in the control tower. You describe your company, point us at your GitHub organization, and submit. White Ghost then provisions a dedicated environment for you — your own cloud project, database, domains, and CI/CD. Provisioning is reviewed by us before it goes live, so this isn't instant; you'll watch the status move in your dashboard and your company goes live at {slug}.whiteghost.ai when it's active.

Sign in to the control tower

Go to ct.whiteghost.ai and sign in with Google.

Create your company

Pick a name and a short URL slug — the slug becomes {slug}.whiteghost.ai — and a contact email we can reach you at.

Choose your branding

Set the product name your employees will see, a primary color, and an optional logo. This is how White Ghost shows up inside your company.

Connect your GitHub organization

Install the White Ghost GitHub App into your org. Your application source code stays in your own GitHub organization — White Ghost creates and manages repositories there, but never takes custody of your code.

Invite your team optional

Add teammates by email from your Team settings — they get an email and can sign in right away. Members build apps; admins also help manage the company. You can do this any time, before or after your workspace goes live.

Submit and watch it provision

Submit your company for provisioning. White Ghost stands up an isolated environment — its own cloud project, database, domains, and CI/CD. Track the status in your dashboard; when it's active, your company is live at {slug}.whiteghost.ai.

Why isolation matters

Every company gets its own dedicated environment — separate infrastructure, separate database, separate domains. Your apps never share a wall with another customer's. And because your code lives in your own GitHub organization, you can leave whenever you like and take everything with you: the code, the data, and the history.

For builders — ship your first app

Once your company is active, you don't touch cloud consoles, credentials, or pipelines. You install one CLI, answer a short interview, and push. Everything below assumes your admin has set your company up and added you to the team.

Install the CLI

One global install. Works on macOS, Linux, and Windows.

$ npm install -g ghosty-cli

Sign in

Pass your company slug. The CLI opens your browser; sign in with your work Google account.

$ ghosty login --company your-company-slug

Create an app

A short interview — name, what it does, backend language, whether it needs a database — scaffolds a complete, working app.

$ ghosty init

Provision it

Create the repo, build pipeline, database, and live URL for your app, and wait until everything is ready.

$ ghosty provision

Run it locally

Frontend and backend on your machine, against your own personal dev database.

$ ghosty dev

Ship it

A plain git push builds and deploys automatically. Your app goes live at {app}.{your-company-slug}.whiteghost.ai.

$ git push✓ deployed

Where everything lives

Find all of your company's apps in the catalog at {your-company-slug}.whiteghost.ai. From the console there you manage environment variables, logs, deploys, and your database — no cloud console required.

CLI reference

Every command supports --json for machine-readable output, and long-running commands end with a single parseable ready / READY line. Interactive prompts only appear on a TTY when a required value is missing — every prompt can be skipped with flags.

CommandWhat it does

ghosty loginBrowser sign-in (loopback OAuth). --company <slug> or --admin-url <url>; --no-browser prints the URL.

ghosty whoamiShow the signed-in builder, GitHub username, and apps.

ghosty initScaffold a new app (interview; all answers available as flags; --yes for defaults).

ghosty devRun frontend + backend locally with your personal dev database.

ghosty provisionCreate everything the app needs on the platform and wait until it's ready.

ghosty deploysInspect production deploy history for this app.

ghosty logsStream and inspect production logs.

ghosty redeployTrigger a fresh production deploy.

ghosty profile --github <username>Record your GitHub username (grants push access on app repos).

ghosty preflightCheck Node, git, sign-in, and platform reachability.

Credentials live in ~/.ghosty/profiles.json with owner-only permissions, one profile per company — so a single laptop can talk to more than one company.

Guides — every capability, explained

Creating an appCreate a new app in a few answers — name, address, what it should do, and who can use it.Signing inHow to sign in to Ghosty — a one-time email link, your Google account, your GitHub account, or a passkey. No passwords, ever.Your teamInvite teammates to your workspace, choose their role, and remove access when someone leaves.Working with AI assistantsEvery app comes with starter instructions for an AI assistant — copy them, paste them into your assistant, and tell it what you'd like to build.Company workspacesCreate a company workspace in three steps, see it being set up, and give your team a design guide your coding assistant follows.Who can use your appThe four access modes — public, invite only, workspace members, and your own sign-in — and how to pick the right one.IntegrationsConnect third-party services — AI models, payments, email, messaging — to your apps without ever putting a key in your code.App analyticsSee how your app is doing — requests per day, deploy health, and integration activity, all on one tab.Custom domainsServe your apps from your own domain — register it once, then point any subdomain at any app.File storagePrivate file storage for every app — uploads, downloads, and expiring share links, with zero setup.Your app's environmentEvery environment variable your app runs with, who sets it, and how to see the list from the console, the CLI or your assistant.Secrets and local developmentHow a secret reaches your published app, why it doesn't reach your laptop on its own, and the one line that fixes that.Keeping the CLI up to dateHow the ghosty CLI notices new versions, what coding agents see, and how to turn the check off.Collaborate on an appGive a teammate full development access to one of your apps — from the console, the CLI, or your coding assistant.Database updatesHow Ghosty applies your app's database updates safely on every deploy.Passkeys and our new web addressWhy passkeys created before the move to whiteghost.ai need to be added again — and how to do it in under a minute.Getting help when something breaksRun one command and Ghosty diagnoses what went wrong — with fix steps you can hand to your coding assistant.How your apps are protectedThe protection every app gets at the edge of the Ghosty platform — and what it deliberately leaves to you.Connect your coding assistantLet your coding assistant inspect, diagnose, and operate your Ghosty apps directly — no copy-pasting.

Ready to ship something?

Create your account and go from idea to live app today.