---
title: Getting started
description: >-
  Create your account, deploy your first app from GitHub, and connect a Postgres
  database in five minutes.
sidebar:
  icon: rocket
---
You'll end up with an app online at `https://<tu-app>.olimpia.cc`, with HTTPS, connected to a Postgres database over the internal network, and redeploying automatically on every push.

:::tip[Want your agent to do it?]
Connect Claude Code, Codex, or Cursor and ask it to "deploy this folder to Olimpia". The guide is in [Connect your agent](/en/agentes/conectar).
:::

1. **Create your account**

    Go to [olimpia.dev/signup](https://olimpia.dev/signup) and sign up with your email or with GitHub. During early access, Olimpia is invite-only and doesn't ask for a card.

    When you sign in, you already have a project called `personal`. You can use it or create another one from the project selector.

2. **Connect GitHub**

    In **Apps → New app**, choose **Connect GitHub**. GitHub opens so you can install the Olimpia GitHub App: choose the account or organization and which repositories it can access. Olimpia only asks for read access to your code.

3. **Choose the repository**

    Select the repository and branch. If your app lives in a subfolder of a monorepo, fill in **Root folder** (for example `apps/web`).

    Olimpia detects the language with [Railpack](/en/apps/builds): Node, Bun, Deno, Python, Go, Rust, PHP, Ruby, Java, Elixir, or a static site. If there's a `Dockerfile`, it uses that.

4. **Check the port**

    Your app must listen on `0.0.0.0` and on the port in the `PORT` variable (3000 by default). If it listens on a different port, set it in **Port**.

    ```js server.js
    app.listen(process.env.PORT || 3000, "0.0.0.0");
    ```

5. **Deploy**

    Confirm and watch the build live. The first one usually takes between one and four minutes. When the status changes to **Online**, your app responds at `https://<subdominio>.olimpia.cc`.

6. **Create a Postgres database**

    In **Postgres → Create database**, choose a name. In a few seconds you have Postgres 18 ready, with a generated username and password.

7. **Connect it to your app**

    In your app, open **Variables** and add the project's database: Olimpia sets `DATABASE_URL` to the internal URL. Save and click **Deploy** to apply the change.

    ```js db.js
    import postgres from "postgres";

    export const sql = postgres(process.env.DATABASE_URL);
    ```

Done. From now on, every push to the branch you chose triggers a build and a zero-downtime deploy.

## Next steps [#siguientes-pasos]

**[Use your domain](/en/apps/dominios)**

Add a CNAME and a TXT record, and Olimpia issues the HTTPS certificate.

**[Schedule backups](/en/postgres/backups)**

Automatic copies of your database in your own S3 bucket.

**[Environment variables](/en/apps/variables)**

Encrypted secrets, available at build time and at runtime.

**[If something fails](/en/apps/problemas)**

The most common errors and how to fix them.
