Deploy your first app

This guide takes a repository from GitHub to a live HTTPS address. Allow about ten minutes.

Before you start

• Your code is in a GitHub repository. Public or private both work.
• You have a project to put the app in.
• For a paid size, you have at least 72 hours of that size's price in credit. The free size needs none.

1. Create the app

Open App Platform → New app and fill in:

1. Project: where the app belongs.
2. App name: letters, numbers, - and _, starting and ending with a letter or number, for example my-landing.
3. Framework: choose Frontends or Backends, then your framework.
4. GitHub repository: owner/repo, the HTTPS URL or the SSH URL all work.
5. App size: the cheapest available size is preselected. See Sizes, free apps and billing.

Review the summary and create the app. Kubana opens the app's page.

2. Add the deploy key in GitHub

Kubana shows a public deploy key for this app.

1. In GitHub, open your repository → Settings → Deploy keys → Add deploy key.
2. Paste the key and give it a title, such as Kubana.
3. Leave Allow write access unchecked.
4. Back in Kubana, choose I've added the key, verify access.

The app status moves from Add deploy key to Verifying access, then shows that access is verified.

3. Finish the configuration

In the Configuration tab:

• Git branch: choose Load branches and pick the branch to deploy, usually main.
• Build directory (frontend apps only): the folder Kubana serves after the build, such as /dist for Vite or /build for Create React App. It must be an absolute path without spaces.
• Versions (Laravel only): pick the Laravel and PHP versions.

4. Deploy

Choose Deploy. Follow the build in the Deployments tab. When it finishes, choose Open app to visit your app's HTTPS address.

Next steps

• Deploy automatically on every push
• Use your own domain
• Something failed? See Fix common deploy problems