Deploy to Gora

Package and deploy a local Gora app to a Gora Devnet or network endpoint.

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.

Link contract metadata first, if needed

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.