Skip to content

Getting Started

This guide walks you through installing the Astrolift CLI and deploying your first application.

Install the CLI

Download the astro binary for your platform:

# macOS (Apple Silicon)
curl -fsSL https://astrolift.dev/install.sh | sh

# Or via Homebrew
brew install astrolift/tap/astro

Authenticate

astro auth login

This opens a browser window to complete authentication.

Create an app from a template

astro app new --template python-web my-first-app
cd my-first-app

This creates a new directory with a working application and an astrolift.toml manifest.

Deploy

astro deploy

The platform builds your container image, provisions any declared managed services, and rolls out your application. Once complete, the CLI prints your app's URL.

What's next

  • Edit astrolift.toml to add managed services, configure scaling, or set up preview environments.
  • Run astro app status to check your deployment.
  • Run astro logs to stream application logs.