Skip to content

hivepod deploy

hivepod deploy packs up a folder and deploys it with Drone, DockHive’s AI deploy agent. Drone reads your code, builds your app and deploys it, fixing problems along the way.

Terminal window
hivepod deploy # the current folder
hivepod deploy ./web # another folder
Option Meaning
--name NAME Name for a new app.
--env KEY=VALUE Set an environment variable (repeatable).
--root SUBDIR Deploy a subfolder of the upload (for monorepos).
--framework ID Use a framework preset instead of Drone, for example nextjs or static. See Drone and frameworks.
--new Create a new app instead of updating the one linked to this folder.
--app ID Deploy to a specific existing app.
--no-wait Return right after uploading; the build continues in the background.
--timeout SECONDS How long to wait for the deploy (default 900).
-v, --verbose Show the full build log.

The first deploy links the folder to the new app. Running hivepod deploy again from the same folder updates the same app, in the same region. Use --new for a separate app.

  • .gitignore and .dockhiveignore in the folder’s root are respected (*, **, !negation and so on).
  • Version control, dependency and cache folders are always left out, as are dist/ and build/ folders over 20 MB.
  • Secrets are never uploaded, even if your ignore files don’t mention them: .env files (except .env.example, .env.sample and .env.template), *.pem, *.key, SSH keys, *.p12 and *.pfx. Pass secrets with --env instead.

The upload is limited to 50 MB compressed. If it’s too large, add folders you don’t need to .dockhiveignore.

✓ Uploaded 42 files (1.2 MB) — deploying my-app
left out: node_modules, .env
drone Reading your code
drone Building your app
✓ Live https://brave-space-k3x9.dockhive.app

If the deploy fails, the CLI prints Drone’s summary, any environment variables your app needs (“Deploy again with –env NAME=value for each”) and the last lines of the build log.

If the folder isn’t a web app (for example a command-line tool or a library), you’ll see Not deployable as an app with suggestions. Nothing was built, so no build minutes were used. See When Drone can’t deploy your code.