Skip to main content
This page walks you through the full deploy process — from installing the CLI to having a live, shareable browser URL. By the end, your app will be running in the cloud and accessible to anyone with the link.

​
Before you start

You need a nowrun account with a verified card (a free plan is available at no charge) and Python 3.8 or later on your machine.

​
Install the CLI

Install the nowrun CLI from PyPI:

​
Authenticate and set up the skill

Run nowrun login. Your browser opens, you approve the device, and the CLI authenticates. It also installs the nowrun skill and MCP server that your AI agent uses:
Make sure the following are ready before deploying:
  • The nowrun CLI is installed and nowrun login has completed successfully.
  • An Android .apk file is built and ready on your machine.

​
Create the app

A deploy needs an app to deploy to. Your agent creates one the first time:
-f reads the package name straight from the APK so it cannot be mistyped, and --bind writes the app’s id to nowrun.json in the current directory, so later commands find it automatically. For an HTML5 web app, use --type h5 and skip -f.
Only the first deploy needs this. After --bind, nowrun deploy knows which app it is updating.

​
Tell your agent to deploy

You don’t need to memorize any commands. Simply ask your AI agent to deploy the app — it already knows what to do from the nowrun skill installed during nowrun login. Example prompt:
“Deploy my app to nowrun.”
The agent will run the deploy command on your behalf:
-f points at the build. --wait blocks until the app is live and prints the URL. The agent discovers the exact flags and options it needs by consulting nowrun help. You can run that command yourself at any time to see all available commands, or use nowrun <command> -h for help on a specific command. When the deploy finishes, the agent shares a live URL with you. That URL opens directly in any browser and streams your Android app — no installation, no app store, nothing to download. You can share it with testers, clients, or anyone you choose.

​
Viewing in the dashboard

Log in at nowrun.io to see all your deployed apps in one place. The dashboard shows each app’s live URL, version history, and current status.
The first deploy may take a moment while nowrun provisions your app. Subsequent deploys are faster.
Now that your app is live, see Managing Apps to learn how to update, share, and manage your deployments from the dashboard.