# Deploy your first app

<TLDR>
In your project open **Deploy**. If it is not set up yet, ask the AI to set it up. Choose a free address, select **Deploy**, and open it when live. **Roll back** returns to any earlier deploy; **Add domain** adds your own name.
</TLDR>

## What you will build [#what-you-will-build]

A live app at its own free address, built from your <Term id="project">project</Term>'s code. You will <Term id="deploy">deploy</Term> it, check it, and learn to roll back, take it offline and add a domain.

## Before you start [#before-you-start]

- A project with an app in it. See [Your first project](/docs/guides/first-project).
- <Term id="credits">Credits</Term>: a live app is paid for with credits while it runs.
- Optional: the project linked to a GitHub repository, so each push ships a new build.

<Callout type="warn" title="Deploying needs Pro">
The free trial builds and runs everything in <Term id="studio">Studios</Term>; deploying apps comes with Pro. See [Billing](/docs/workspace/billing).
</Callout>

## Steps [#steps]

<Steps>
<Step>
### Open Deploy [#open-deploy]
Open your project and its **Deploy** tab, or go to <AppLink to="deploy" />.

<Screenshot src="/docs/_media/dashboard-project-page-not-running.png" alt="A project's Deploy tab before setup, showing This project is not set up to deploy yet" />
</Step>
<Step>
### Set the project up to deploy [#set-the-project-up-to-deploy]
If you see **This project is not set up to deploy yet**, describe what the app should run and select **Set this project up to deploy**. The AI reads your repository and sets up each part the cheapest way. Each part then shows in the deploy settings.
</Step>
<Step>
### Choose how it runs [#choose-how-it-runs]
For each part, pick a run setting:

- **Sleeps when idle**: starts on a visit and costs nothing while idle. The first visit after a quiet spell takes a few seconds.
- **Always on, lower price**: keeps running at a lower price, and may restart now and then.
- **Always on**: keeps running and is never interrupted.

Each shows the most it can cost per hour at full load. See [Run settings](/docs/deploy/run-settings).
</Step>
<Step>
### Choose your app's free address [#choose-your-apps-free-address]
Under **Your app's free address**, choose a name of 3 to 30 lowercase letters, digits and single dashes. It is free and keeps working after you add your own domain.
</Step>
<Step>
### Deploy [#deploy]
<ForEveryone>
Select **Deploy**. It builds from the latest commit and shows each step until live.
</ForEveryone>

<ForDevelopers>
From a terminal in the project, or anywhere with your API key set:

```bash
klarety deploy --project <project-id>
```

It deploys the linked GitHub branch, or the current commit if none is linked, and prints the `deploy_id`. Inside a Studio, `--project` is not needed. From Python:

```python
from klarety import Nexus

nx = Nexus.connect()
deploy_id = nx.projects.deploy("<project-id>")
```
</ForDevelopers>

If the deploy was asked for by an AI, it waits for a person: select **Approve and deploy**, or **Reject**. See [Approvals](/docs/deploy/approvals).
</Step>
<Step>
### Open your app [#open-your-app]
When the deploy is live, the project overview shows **Live at** your address. Open it.
</Step>
</Steps>

<Screenshot src="/docs/_media/project-deployed-filtered-live-domains-deployment-history.png" alt="The Deploy tab with a live deploy, its free address and the deploy list" />

## Check that it worked [#check-that-it-worked]

- Your address answers in the browser.
- The deploy list shows the deploy as live, with how long it took.
- The project's **Activity** shows the live deploy.

## Common variations [#common-variations]

- **Redeploy.** **Redeploy** builds the latest version and replaces the live app once ready.
- **Roll back.** Choose **Roll back to this deploy** on any earlier deploy. Nothing is rebuilt, and you can switch back the same way.
- **Take it offline.** **Take offline** stops the app at once, so it costs nothing. Name, data and deploys stay; roll back or deploy to bring it back.
- **Use your own domain.** Select **Add domain** and choose **Buy a new domain** (paid with credits, set up for you), **Connect an external domain** (free, add two DNS records where you manage it), or **Use a connected domain**. See [Domains](/docs/deploy/domains).

<Callout type="warn" title="Buying a domain costs credits">
A bought domain is charged in credits right away for one year, and renews every year while renewal is on.
</Callout>

## If something goes wrong [#if-something-goes-wrong]

A failed deploy shows what went wrong in plain words, with what your app printed. **Fix with AI** has the Studio's AI find and fix the cause.

<Accordions>
<Accordion title="Your app did not start answering on the port in time">
Your app must listen on the `PORT` variable on `0.0.0.0`. If it is slow to start, load large libraries on first use instead of at start.
</Accordion>
<Accordion title="A dependency could not be found">
Check its name and version in your app's dependency file.
</Accordion>
<Accordion title="Your app ran out of memory">
Give that part of the app more memory, or make it use less as it starts. Ask the AI to change the deploy setup.
</Accordion>
<Accordion title="The new version failed too many requests">
Klarety sends visitors back to the version before. Read your app's logs, fix the errors and deploy again. See [Logs](/docs/deploy/logs).
</Accordion>
<Accordion title="Deploy says Deploy with Pro">
Deploying apps comes with Pro. Start Pro from <AppLink to="settings.billing" />.
</Accordion>
</Accordions>

## Next steps [#next-steps]

- [Deploy an app](/docs/deploy/deploy-an-app): every deploy option.
- [Domains](/docs/deploy/domains): buy or connect your own domain.
- [Run settings](/docs/deploy/run-settings): cost and speed for each part of your app.
- [Logs](/docs/deploy/logs): see what your live app prints.