# Quickstart

> Get your first application deployed on Tarout in under 5 minutes

# Quickstart

This guide walks you through deploying your first application on Tarout. You can start from the dashboard, or hand the job to a coding agent.

## Prerequisites

- A [Tarout account](https://tarout.sa/auth/login)
- Application code in a local project directory, GitHub repository, or GitLab repository

## Fast path: agent or CLI

From the project root, run:

```sh
curl -fsSL https://tarout.sa/install.sh | sh
tarout deploy --wait --plan free --database none
```

Tarout prompts for login, app creation or linking, the deployment source (your GitHub repo when the folder has one, so every push redeploys), and deployment status when needed.

If you use Claude Code, Cursor, Codex, or another coding agent, paste this prompt:

```text
https://tarout.sa/docs/for-ai/start.md - fetch this page (don't web-search) and follow it exactly to deploy this project to Tarout.
```

If you do not have a project yet, the onboarding guide includes a generated sample app that can be deployed with the same local-upload flow.

Prefer the dashboard? Continue below.

## Step 1: Sign Up

Create your account at [tarout.sa](https://tarout.sa). An organization is created for you automatically.

## Step 2: Connect Your Git Provider

1. Go to **Settings → Git Providers** in the dashboard.
2. Click **Connect GitHub** or **Connect GitLab**.
3. Authorize Tarout to access your repositories.

## Step 3: Create an Application

1. Go to **Applications** in the dashboard and start a new application.
2. Choose a plan, enter a name (optional) and a description (optional).
3. Click **Create Application**. Tarout opens the new app's page.
4. On the **General** tab, choose your source: pick the repository and branch from GitHub or GitLab, upload your files, or use a Docker Hub image pinned by digest.

Tarout auto-detects your framework (Next.js, React, Node.js, etc.) and configures the build settings when it builds.

## Step 4: Deploy

Creating the app does not deploy it. Click **Deploy** on the **General** tab to start the first deployment, and track its progress in real time from the dashboard. After that, apps connected to GitHub or GitLab redeploy on every push to the configured branch.

Once deployed, your app is available at `https://your-app.tarout.app`.

## Step 5: Add a Custom Domain (Optional)

Custom domains need a paid plan (Starter or above). The free `*.tarout.app` address works on every plan.

1. Go to your application's **Domains** tab.
2. Click **Add Domain** and enter your domain name.
3. Add the DNS records exactly as shown.
4. Tarout provisions an SSL certificate automatically.

See [Domains](https://tarout.sa/docs/applications/domains) for root domains and the details of each record.

## Next Steps

- [Environment Variables](https://tarout.sa/docs/applications/environment-variables) - Configure secrets and settings.
- [Databases](https://tarout.sa/docs/databases) - Add a database to your application.
- [CLI](https://tarout.sa/docs/cli) - Manage deployments from your terminal.

---

## Every Tarout agent guide

- [Start Here (Agents)](https://tarout.sa/docs/for-ai/start.md)
- [Overview](https://tarout.sa/docs/for-ai.md)
- [Deploying an app](https://tarout.sa/docs/for-ai/deploy.md)
- [Databases](https://tarout.sa/docs/for-ai/database.md)
- [Object storage](https://tarout.sa/docs/for-ai/storage.md)
- [Custom domains](https://tarout.sa/docs/for-ai/domains.md)
- [Plans and upgrades](https://tarout.sa/docs/for-ai/billing.md)
- [Troubleshooting](https://tarout.sa/docs/for-ai/troubleshoot.md)
- [Agent Onboarding](https://tarout.sa/docs/for-ai/onboarding.md)
- [CLI Reference](https://tarout.sa/docs/for-ai/cli-reference.md)
- [CLI JSON Schema](https://tarout.sa/docs/for-ai/cli-json-schema.md)

Whole corpus in one file: https://tarout.sa/llms-full.txt · index: https://tarout.sa/llms.txt
Any docs page is raw markdown at the same URL + `.md`. Short link to the entry point: https://tarout.sa/deploy.md