Skip to main content

​
Deploy to Gora

Use this page when you already have a Gora app folder and a Gora endpoint. For the full VM-to-local flow, start with Devnet quickstart.

​
Prerequisites

You need:
  • the gora CLI
  • an app folder with gora.app.json and policy.json
  • a Gora endpoint, such as https://gora-dev.ngrok.app
  • an API token if the endpoint requires one

​
Set the endpoint

From your app folder: 
gora config set node.url https://gora-dev.ngrok.app
If required: 
gora config set api.token YOUR_TOKEN
Check health: 
curl https://gora-dev.ngrok.app/health
You can also pass --node on individual commands instead of saving config. If your app targets a chain gateway or app contract, link that metadata before deploy: 
gora contract doctor --chain <chain> --node https://gora-dev.ngrok.app
gora contract build --chain <chain>
gora contract deploy --chain <chain> --node https://gora-dev.ngrok.app
gora contract link --chain <chain>
This writes local metadata under: 
.gora/contracts/<chain>/latest.json
and updates gora.app.json with a contract binding. Skip this step for off-chain-only apps.

​
Validate and package

gora build
gora validate
gora package
Validation catches missing artifacts, invalid JSON, unknown execution modes, missing policies, and obvious secrets. Packaging writes: 
.gora/package/package.json

​
Deploy

gora deploy
Or explicitly: 
gora deploy --node https://gora-dev.ngrok.app
Deploy uploads:
  • app artifact bytes or source
  • manifest JSON
  • policy JSON
  • deterministic package metadata
  • optional contract bindings
The receipt is written to: 
.gora/deployments/dev.json

​
Invoke after deploy

gora invoke --app my_agent --input fixtures/request.json --wait
If you did not save node.url: 
gora invoke \
  --node https://gora-dev.ngrok.app \
  --app my_agent \
  --input fixtures/request.json \
  --wait

​
Inspect

gora inspect request <request-id>
gora inspect result <request-id>
gora inspect attestation <request-id>
gora inspect app my_agent
Inspect outputs are saved under: 
.gora/inspect/

​
What deploy does not do

gora deploy does not:
  • deploy smart contracts
  • submit chain transactions
  • sign with user keys
  • pay chain gas
It registers the Gora app package. Chain effects happen later through a gateway, wallet, contract, mobile signing flow, or submitter. Next: Test with mobile.