Shipping - Bay

bay ship

bay ship

Ships the current folder. Returns as soon as the URL exists — the build runs behind it, and the URL serves the Room until the app answers for itself.

flag

Stay attached and stream the build: clone → detect stack → build → run. Prints the live URL when the app is actually serving it.

string

default:"the folder's name"

What to call the app.

flag

Ship from your git origin, or from any public repository URL, instead of uploading the folder.

string

How to run it in production, when you already know. For example --run "uvicorn main:app --host 0.0.0.0 --port $PORT".

flag

Do not carry .env up. By default Bay sets the variables your app does not have yet.

flag

The old path: build locally and upload the result.

bay deploy is the same command and always will be. Every flag here works with either name.

bay reship <app>      # rebuild from the app's source
bay rollback <app>    # back to the previous version

Images are deployed by digest, so “the new version” is a fact rather than a tag, and a rollback is a real return to bytes that ran.

bay diagnose <app>          # a fix-prompt for your own coding agent
bay patch <app>             # the repair agent's fix, to pipe into git apply

bay patch <app> | git apply

bay delete <app> --yes

Deleting an app keeps its database and its bucket. The data outlives the app on purpose — a delete is not a way to lose it.

⌘I