Deploy an app

Use the Apps API when you want deployments from CI/CD, internal tooling, or your own control panel.

Choose a deployment source

ZIP upload

Best for build artifacts generated by CI.

GitHub repository

Best when Hyze Cloud should pull source from a connected repository.

Deploy from a ZIP

Package your app

Create a ZIP with the files Hyze Cloud should run. Include your app entrypoint and dependency manifest.

Send the deploy request

curl -X POST https://api.hyzecloud.com/api/apps/deploy \
  -H "Authorization: Bearer hyze_your_key" \
  -F "file=@app.zip" \
  -F "name=my-api" \
  -F "runtime=node" \
  -F "memoryMB=512" \
  -F "exposePort=3000"

startupCommand is optional. Omit it (or pass auto) so Hyze detects the right start command. Override only when needed: -F "startupCommand=node server.js".

Watch logs

curl "https://api.hyzecloud.com/api/apps/app_001/logs?tail=200&timestamps=true" \
  -H "Authorization: Bearer hyze_your_key"

Deploy from GitHub

Use POST /api/apps/deploy-from-repo after connecting GitHub in the Dashboard.

{
  "name": "my-api",
  "runtime": "node",
  "memoryMB": 512,
  "exposePort": 3000,
  "autoDeploy": true,
  "repository": {
    "id": "repo_001",
    "owner": "hyzecloud",
    "name": "my-api",
    "branch": "main"
  }
}

Set autoDeploy to true when you want Hyze Cloud to redeploy after pushes to the selected branch. Omit startupCommand (or set "auto") unless you need a custom start command.

Runtime checklist

Runtime	Auto detect	Notes
`node`	Yes (API, static site, Vite, Next…)	Expose the same port your server listens on.
`bun`	Yes	Keep the lockfile in your artifact when possible.
`python`	Yes	Include your dependency file in the ZIP.

Optional override examples: node server.js, bun run start, python main.py.

Apps reference

Deployment, lifecycle, logs, settings, and build history.

App backups

Create, restore, download, and delete app backups.

How-to

Examples

Choose a deployment source

ZIP upload

GitHub repository

Deploy from a ZIP

Deploy from GitHub

Runtime checklist

Apps reference

App backups

​Choose a deployment source

ZIP upload

GitHub repository

​Deploy from a ZIP

​Deploy from GitHub

​Runtime checklist

​Related endpoints

Apps reference

App backups

Choose a deployment source

Deploy from a ZIP

Deploy from GitHub

Runtime checklist

Related endpoints