Prerequisites
- An Akua account and a Workspace.
- Your coding agent set up with the Quickstart prompt, or the latest
akuaCLI installed and signed in. - An application you can publish as a Package. To receive a public URL, it must expose an HTTP service.
- A place to run it: a Linux server you own, the free trial Akua server, or a Kubernetes cluster you already manage.
Deploy with your coding agent
1
Choose the Workspace
Paste the setup prompt into your coding agent and approve sign-in in your browser. Choose
the Workspace that will own the Install.
2
Publish the application
Tell the agent which application to deploy. Ask it to follow the
Package publishing instructions and wait for
publication to succeed.
3
Choose where it runs
For a Linux server you own, create a hosted Cluster and
join the server. To let Akua run the server,
add an Akua server to the hosted Cluster. For a
Kubernetes cluster you already manage, attach the cluster. Wait for a ready server before
you install.
4
Create the Install
Ask the agent to create an Install of the published version with your
settings. It discovers the exact request with
akua commands and follows the returned
Operation with akua operations wait.5
Open the URL
Wait for the Install to report
healthy and a nonempty url. Open that address and check
that your application responds.Deploy from the dashboard
You can also install a published Package from the dashboard:- On Home, click Install an app.
- Under Choose an app, select your app. Under Where should it run?, select the Cluster.
- Check the settings, continue to Review and install, and click Install.
- When the Install shows Running, click Open app.

A running Install in the dashboard. Open app opens its public address; the address is hidden in this example.
Next steps
Share your app with a customer
Give a customer their own Install through an invite link.
Update an Install
Move the Install to a newly published version.
How Akua works
Packages, Installs, Products and Offers in one picture.