Skip to content

Go to the docs contents

Data projects

A project with no web address, made of databases and scheduled jobs: a data warehouse that other projects read, nightly processing.

Updated November 21, 2026.

View as Markdown

Data project with no website: a warehouse of PostgreSQL databases and nightly jobs

You, to your AI: Set up a data warehouse that loads our sales every night.

What your agent writes

Your agent writes it in while.yaml, at the root of your app:

while.yaml
apiVersion: while/v1
project: my-app
crons:
  - name: ingestion
    schedule: "30 5 * * *"
    command: [node, ingestion.js]
    source: .

What your app receives

Your app receives these environment variables at every deployment:

VariableWhat it holds
DATABASE_URLThe address of the project’s database.
WHILE_CRONThe job’s name.
WHILE_TRIGGERHow this run was started.

When to use it

For data and processing without a screen: nightly loads, a project that other projects read.

How it works

A data project gathers databases and tasks, with no web address: a data warehouse, nightly processing. Its health is its databases and the runs of its tasks.

What to know

The while.yaml has no services. Each task is built from its sources (source, dockerfile) or starts from an image, with 100 mCPU and 128 MiB by default (resources). A rollback gives the tasks back the image of the target version.

Pricing

These prices are the same on every plan, excluding VAT:

ResourcePriceDetails
CPU and memory€17 per vCPU per month, €8.50 per GiB per monthtools by usage, caches by reservation

Your agent’s MCP tools

Your agent handles it with the deploy_app, list_tasks and run_task tools.

Guides

Give your AI the message, and it takes care of the rest

Give this to your AI

Read while.sh/agents and help me get started with while.

Copy the message

In 3 minutes, with no sign-up, the tool has its own address. To keep it, create your account.

For a company project, write to the while team: hello@while.sh