Quickstart

Get started with Ghosty.

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.

Setup happens once, in the control tower. You describe your company, point us at your GitHub organization, and submit. Ghosty 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}.getghosty.dev when it's active.

Sign in to the control tower

Go to ct.getghosty.dev and sign in with Google.

Create your company

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

Set your sign-in domains

Choose which email domains may sign in to your apps, for example yourcompany.com. Only people on those domains get into your environment.

Choose your branding

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

Connect your GitHub organization

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

Invite co-admins optional

Add teammates by email if you want help managing the company. Co-admins can manage settings and see everyone's apps.

Submit and watch it provision

Submit your company for provisioning. Ghosty 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}.getghosty.dev.

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.

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 your work email's domain to the sign-in list.

01

Install the CLI

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

$ npm install -g ghosty-cli
02

Sign in

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

$ ghosty login --company your-company-slug
03

Create an app

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

$ ghosty init
04

Provision it

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

$ ghosty provision
05

Run it locally

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

$ ghosty dev
06

Ship it

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

$ git push deployed

Where everything lives

Find all of your company's apps in the catalog at {your-company-slug}.getghosty.dev. 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.

Command What it does
ghosty login Browser sign-in (loopback OAuth). --company <slug> or --admin-url <url>; --no-browser prints the URL.
ghosty whoami Show the signed-in builder, GitHub username, and apps.
ghosty init Scaffold a new app (interview; all answers available as flags; --yes for defaults).
ghosty dev Run frontend + backend locally with your personal dev database.
ghosty provision Create everything the app needs on the platform and wait until it's ready.
ghosty deploys Inspect production deploy history for this app.
ghosty logs Stream and inspect production logs.
ghosty redeploy Trigger a fresh production deploy.
ghosty profile --github <username> Record your GitHub username (grants push access on app repos).
ghosty preflight Check 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.

Stuck, or want a company set up?

We're onboarding early-access companies now and happy to help you get going.

Talk to us — hello@getghosty.dev