Dawnrose
Log in Start free Menu
/

Docs Getting started

Quickstart

This guide deploys an app from a GitHub repository with a Postgres database. First with an AI agent, then the same steps in the dashboard.

1. Create an account

Go to https://app.dawnrose.ai/signup and sign up with Google or GitHub. You start on the Trial plan with $5 of usage credit, and no card. GitHub accounts younger than 30 days don’t get the trial credit. It’s also limited each day, so on a very busy day a new account may start without it.

You can also sign up with an email and password (at least 8 characters). That account gets no trial credit, and needs credit or a plan from Settings → Billing before it can deploy. While online payments are closed, it can’t deploy yet.

After sign-up, a short setup walks you through three steps: Connect GitHub, Create a project and Connect your agent. You can skip any of them and come back later.

Connect GitHub if you want to deploy private repositories or have pushes deploy automatically. You can also do it later under Account, under Connected accounts.

2. Connect your agent

  1. Choose Connect agent in the sidebar.
  2. Click Create agent token and copy the token. It is shown only once.
  3. Pick your agent in the list and copy the setup it shows, with the token already filled in.

For Claude Code, the setup is one command:

claude mcp add --transport http dawnrose \
    https://app.dawnrose.ai/mcp \
    --header "Authorization: Bearer YOUR_TOKEN"

Setups for other clients are in Connect your agent.

3. Ask for a deploy

In your agent, ask for what you want, for example:

Deploy owner/repo with a Postgres database and give me the URL

A typical run looks like this:

  1. The agent creates a project (or reuses one) and adds Postgres from the database template.
  2. It creates a service from your repository and sets DATABASE_URL=${{ Postgres.DATABASE_URL }} so the app finds the database.
  3. Dawnrose builds and deploys the app. The agent waits for the deployment and, if it fails, reads the logs, fixes the problem and deploys again.
  4. It sends a test request to the running app, makes sure the app has a public URL and reports back.

While this happens, the project canvas in the dashboard shows the services appear and highlights the one the agent is working on.

Your app must listen on the port in the PORT environment variable, on 0.0.0.0. Dawnrose sets PORT for every service.

4. Check the URL

Open the project in the dashboard and click the app’s service. Its public URL is at the top of the service panel. The Deployments tab shows the build and deploy logs, and the Logs tab shows what the app prints while it runs.

From a terminal, dawn status in a linked directory lists the services and their URLs. See dawn CLI.

The same deploy in the dashboard

  1. On Projects, click New project, enter a name, pick a region (there’s one for now) and click Create project.
  2. On the project canvas, click Create (or press N) and choose GitHub repository. Pick a repository from your connected GitHub account, or enter a repository URL and branch and click Deploy repository. The service starts building right away.
  3. Click Create again, choose Database and pick PostgreSQL.
  4. Open your app’s service, go to the Variables tab and click New variable. Enter DATABASE_URL as the name and ${{ Postgres.DATABASE_URL }} as the value, then click Save changes.
  5. Variable changes are staged. A banner at the top of the canvas says the service has changes; click Deploy in it.
  6. When the deployment succeeds and the app answers HTTP, Dawnrose generates a public domain for it. Open it from the top of the service panel. You can also add one yourself in Settings → Networking with Generate domain.

The same deploy from a terminal

To deploy the folder you are in instead of a repository, install the dawn CLI (Node.js 22 or later):

npm install -g https://dawnrose.ai/sdk/dawnrose-cli-0.1.0.tgz

To check the download before installing, fetch it, check its SHA-256, then install the file you checked. On Linux, use sha256sum -c in place of shasum -a 256 -c.

curl -fLO https://dawnrose.ai/sdk/dawnrose-cli-0.1.0.tgz
echo "b97bef28ebc1e74d16e595740a2dc091710ee6e4dc02c20af2c85006c65a518b  dawnrose-cli-0.1.0.tgz" | shasum -a 256 -c
npm install -g ./dawnrose-cli-0.1.0.tgz

Then create an API token under Account → Tokens and run:

dawn login --url https://app.dawnrose.ai --token drt_…
dawn init my-app
dawn add --database postgres
dawn up
dawn vars set DATABASE_URL='${{ Postgres.DATABASE_URL }}'

dawn up asks which service to deploy to; choose the new service. It uploads the folder, streams the build and prints the URL when the app is live. dawn vars set then redeploys the app with the database URL.

Next steps