Deploy an app

Use the Apps API when you want deploys from CI/CD, internal tools, or your own control panel. Two paths: upload a ready ZIP or point to a connected GitHub repository.

Choose a deploy source

Source	Best for
ZIP	Build artifacts produced by CI
GitHub	Source code in a connected repo, with auto deploy

Deploy from a ZIP

Package your app

Create a ZIP with the files Hyze should run: your app’s 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 use auto) and Hyze detects the right command. Override only if needed: -F "startupCommand=node server.js".

Verify the result

Poll GET /api/apps/:appId until status: running, then open the 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"
  }
}

With autoDeploy: true, pushes to the branch trigger new deploys automatically.

Runtimes

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 the artifact when possible.
`python`	Yes	Include your dependency file in the ZIP.

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

With an exposed port, pass the full host as the subdomain (e.g. my-api.hyzecloud.app), not just the prefix.

Common problems

Deploy finishes but the app doesn't respond

Check exposePort and that your server listens on 0.0.0.0. Read the logs to rule out a boot crash.

Wrong start command

Pass startupCommand to override (e.g. node server.js) or leave it out for default detection.

Deploy

Operate

Choose a deploy source

Deploy from a ZIP

Deploy from GitHub

Runtimes

Common problems

Next steps

Apps reference

App backups

​Choose a deploy source

​Deploy from a ZIP

​Deploy from GitHub

​Runtimes

​Common problems

​Next steps

Apps reference

App backups

Choose a deploy source

Deploy from a ZIP

Deploy from GitHub

Runtimes

Common problems

Next steps