# Introduction

> Tarout is a Saudi platform-as-a-service. Deploy applications, managed databases, object storage, and domains from one dashboard, priced in SAR.

Tarout is a Platform-as-a-Service (PaaS) built for the Saudi and MENA market. Ship your code from GitHub or GitLab, provision managed databases, and manage domains and object storage - all from one dashboard, with prices in SAR. Cloud servers and the AI Gateway draw from a prepaid SAR balance.

## Quickstart

If you already have a project on your machine, this is the whole thing:

```sh
npm install -g @tarout/cli
tarout login
tarout deploy --wait
```

Tarout detects your framework, builds the app, and returns a live HTTPS URL on a `*.tarout.app` subdomain.

> [!TIP]
> Working with a coding agent? Point it at the [agent guide](https://tarout.sa/docs/for-ai/start.md) and it can do the whole deployment itself. Every docs page is available as raw markdown at the same URL plus `.md`.

## What You Can Do

- **Applications** - Connect a Git repository and Tarout builds, deploys, and renews SSL for you. The free tier includes one app; the Starter subscription covers 5 shared apps, and Pro plans run apps on your own dedicated server.
- **Databases** - Managed **PostgreSQL** with connection pooling, from a free 2 MB database to paid add-on tiers. Paid tiers can schedule backups to your own S3-compatible storage.
- **Cloud Servers** - CPU virtual machines with full root access in Dammam, billed hourly from a prepaid wallet, when you need full control over your workload. (GPU servers are not available yet.)
- **Object Storage** - S3-compatible buckets for files, uploads, and static assets - a free 50 MB bucket, then metered at 0.12 SAR/GB/month.
- **Domains** - Buy new domains or bring your own. DNS verification and SSL are automated.
- **AI Gateway** - One OpenAI-compatible key (`https://tarout.sa/api/ai/v1`) for every model: five open-weight flagships on Global plus fast inference on the Saudi Arabia route. Pick the model per request, pay per token in SAR, and set an optional monthly credit limit on each key.
- **CLI** - Manage apps, databases, domains, and deployments from your terminal with `@tarout/cli`.

## Organizations and Projects

When you sign up, Tarout creates an **organization** for you and a **Default** project inside it. Apps, databases and storage belong to a project, so you can group a product's pieces together and keep unrelated work apart. Cloud Servers belong to the organization as a whole.

A project also fixes **where** its resources run: you pick a cloud provider and region once, when you create the project, and everything inside it inherits that placement. Environment variables are configured per application.

Invite teammates as **owner**, **admin**, or **member** from **Settings → Members**.

## How It Works

1. **Sign up** at [tarout.sa](https://tarout.sa). Your organization and default project are created automatically.
2. **Connect a Git provider** (GitHub or GitLab) from **Settings → Git Providers**.
3. **Create an application** - Tarout auto-detects your framework and configures the build.
4. **Deploy** - your app goes live on a `*.tarout.app` subdomain with SSL.
5. **Add a custom domain** - point DNS to Tarout and SSL is issued for you.

## Billing

Tarout uses **subscription billing** - a free tier, a flat **Starter** plan (19 SAR/month with 5 shared apps included), and dedicated **Pro** tiers (399 / 849 / 1,599 SAR/month), plus add-ons for databases, email, and metered object storage. The **Billing** page shows your subscription, invoices, and usage analytics.

> [!NOTE]
> All prices are in **SAR** (Saudi Riyals) and shown before checkout. Annual billing gets you 2 months free.

See the [Billing](https://tarout.sa/docs/billing) section for plan details and limits.

## Next Steps

- [Quickstart](https://tarout.sa/docs/getting-started/quickstart) - deploy your first app in a few minutes.
- [Deploy Your First App](https://tarout.sa/docs/getting-started/deploy-first-app) - step-by-step deployment walkthrough.
- [CLI](https://tarout.sa/docs/cli) - install `@tarout/cli` and manage Tarout 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