Deploying an application on Varo Cloud takes just a few steps — you can trigger a deployment directly from the dashboard at varo.cloud or programmatically through the API. This guide walks you through both paths, shows you how to monitor progress in real time, and explains how to roll back if something goes wrong.
Before you begin
Make sure you have the following ready before starting your first deployment:
- A Varo Cloud account with at least one project created
- An API key generated from Settings → API Keys
- Your application code pushed to a Git repository, or a container image ready to deploy
Deploy from the dashboard
The Varo Cloud dashboard gives you a visual interface to configure and launch deployments without writing any code or commands.
Open your project
Log in to varo.cloud/auth and select the project you want to deploy from the Projects list on your home screen. Click New Deployment
Inside your project, navigate to the Deployments tab and click the New Deployment button in the top-right corner.
Select an environment
Choose the target environment for this deployment — for example, production, staging, or development. Environments are configured under Project → Settings → Environments.
Choose your source
Select how Varo Cloud should retrieve your application code:
- Git repository — provide your repo URL and branch name
- Container image — provide a registry URL and image tag
If you have already connected a GitHub account, your authorized repositories will appear in a dropdown. Click Deploy
Review your configuration and click Deploy. Varo Cloud immediately queues a build and begins streaming logs on the deployment detail page. You can watch progress in real time under the Logs tab, and the deployment status updates from queued → building → active (or failed).
Deploy via the API
You can also trigger a deployment with a single API call. This is useful for CI/CD pipelines, scripts, or any automation that runs outside the dashboard.
curl -X POST https://inference.varo.cloud/v1/deployments \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"project_id": "proj_abc123",
"environment": "production",
"source": {
"type": "git",
"repo": "https://github.com/your-org/your-app",
"branch": "main"
}
}'
{
"id": "dep_xyz789",
"status": "queued",
"environment": "production",
"created_at": "2024-01-15T10:30:00Z"
}
id field — you will need it to poll for status updates and to trigger a rollback.
Monitor deployment progress
Once a deployment is underway, you can follow its progress from the dashboard or the API.
From the dashboard: Navigate to Deployments, click the deployment you want to inspect, and open the Logs tab. Logs stream in real time and are colour-coded by severity. You can filter by log level or search for specific strings using the toolbar above the log viewer.
From the API: Poll the deployment endpoint to check status and retrieve build output:
curl https://inference.varo.cloud/v1/deployments/dep_xyz789 \
-H "Authorization: Bearer YOUR_API_KEY"
{
"id": "dep_xyz789",
"status": "active",
"environment": "production",
"created_at": "2024-01-15T10:30:00Z",
"deployed_at": "2024-01-15T10:32:14Z"
}
Rollback a deployment
If a deployment introduces a problem, you can instantly roll back to the previous stable version.
From the dashboard: Open the deployment you want to revert to under Deployments, then click Roll Back to This Version in the top-right action menu. Varo Cloud re-activates that version without requiring a new build.
From the API: Send a POST request to the rollback endpoint, referencing the deployment ID you want to restore:
curl -X POST https://inference.varo.cloud/v1/deployments/dep_xyz789/rollback \
-H "Authorization: Bearer YOUR_API_KEY"
Set up a webhook to receive real-time notifications when deployments complete, fail, or are rolled back — no polling required. Head to Settings → Webhooks in your dashboard to configure an endpoint, or see the API Reference for full webhook event details.
