Quickstart

From a fresh terminal to a live URL in under two minutes.

You’ll need a Halo account. Sign up at halo.example.com/signup — the free tier covers everything in this guide.

1. Install the CLI

npm

bash

npm install -g @halo/cli

bun

bash

bun add -g @halo/cli

brew

bash

brew install halo

bash

halo login

A browser window opens. Approve, and the CLI stores a token at ~/.halo/credentials.

From any project root:

bash

halo deploy

The CLI detects your framework, builds, and uploads. You’ll see something like:

[halo] detected: next@15.1
[halo] uploading 412 files (1.8 MB)
[halo] building on iad1...
[halo] deployment ready: https://my-app-x7k2qz.halo.app

That URL is live, served from the edge POP nearest each visitor.

bash

halo alias my-app.com

Halo provisions a TLS cert (Let’s Encrypt) and aliases the deployment. Done.

Auto-deploy on every push.

Point DNS, get HTTPS.

Last updated 3 d ago Edit this page