Quickstart
Deploy your first app to Cloud Run in under 5 minutes.
1. Install
Download the binary from GitHub Releases and add it to your PATH. See Installation for details.
2. Authenticate
advncd login
Your browser opens. Approve the login. The CLI saves credentials locally.
3. Set project and region
advncd init
The CLI lists your GCP projects — pick one. Then pick a region from the menu (or enter a custom one).
This saves your defaults and creates an advncd.yaml in the current directory:
version: 1
service:
name: my-app
port: 8080
deploy:
project: my-gcp-project
region: europe-west1
allow_service_rename: false
build:
strategy: buildpacks
You can skip the interactive flow with flags:
advncd init --project my-gcp-project --region europe-west1
4. Enable required APIs
If this is a new project, enable the required GCP APIs:
advncd apis enable
Enables: Cloud Run, Cloud Build, Artifact Registry, Cloud Monitoring.
5. Detect your stack
advncd detect --path .
advncd inspects your project and prints the detected runtime, build strategy, port, and confidence level. Example output:
runtime: nodejs
framework: nextjs
strategy: buildpacks
port: 3000
confidence: high
If confidence is not high, the CLI will ask for confirmation before deploying.
6. Deploy
advncd deploy --path . --name my-app
advncd builds and deploys your app to Cloud Run using Buildpacks — no Dockerfile needed.
When complete, you'll see the service URL:
✓ Deployed: https://my-app-abc123-ew.a.run.app
7. Inspect your services
advncd services
Lists all Cloud Run services in your configured project and region.
advncd services describe my-app
Shows the URL, image, and condition states.
advncd services open my-app
Opens the service URL and Cloud Console page in your browser.