Skip to main content
nowrun deploy is the command that publishes your APK or web bundle to nowrun and returns a live URL. It takes an Android .apk or an HTML5 .zip web bundle. Your AI agent runs this after building, no Android device, emulator, or app store required on the recipient’s end.

​
Usage

-f is required: the path to an Android .apk, or a .zip web bundle for HTML5. Version name and code are read from the APK, so -av and -vc are optional. Add --wait to block until the app is live and print the URL. The agent discovers the rest from nowrun deploy -h.

​
Prerequisites

Before running nowrun deploy, make sure you have:
  • The nowrun CLI installed (pip install nowrun)
  • Completed nowrun login successfully so your credentials are saved
  • A build ready to upload: an Android .apk, or a .zip web bundle for HTML5

​
What it does

When your agent runs nowrun deploy, it:
  1. Locates the APK or web bundle (the agent specifies the path with -f).
  2. Uploads it to nowrun.
  3. nowrun streams the app at a unique, browser-accessible URL.
  4. Returns the live URL, share it with anyone, no installation needed.

​
Exploring options

Because the CLI is agent-driven and evolves over time, use the built-in help to discover all current flags and options:
Your agent runs this itself to stay up to date with the latest available options.
Each deploy creates a new version. Your previous live URL stays active until you explicitly remove it or the app is deleted.

​
Managing deployed apps

After deploying, you can manage your live apps — including viewing, updating, and removing them. See Managing Apps for details.