Getting started

Install the CLI, log in through your browser, and ship your first app to a real Ubuntu container — about sixty seconds end to end.

1. Install the CLI

One command. It detects your OS and architecture, drops the nebula binary on your PATH, and stores config under ~/.config/nebula/.

$ curl -fsSL https://nebula.spaceport.host/install | sh

No package manager required. Re-run it any time to upgrade.

2. Log in

nebula login opens your browser, where you approve the device while signed in to the dashboard. The CLI waits, then saves a token — nothing to copy or paste.

$ nebula login
→ opening https://nebula.spaceport.host/cli/auth?code=WXYZ-1234
→ waiting for approval…
✓ logged in as jeremy

On a headless box or CI runner, use nebula login --token <token> with a token generated from the dashboard instead.

3. Deploy your first app

Point nebula deploy at any GitHub repo. Nebulae provisions a container, clones the code, detects a Spaceport app, builds it, and hands back a live HTTPS URL.

$ nebula deploy github.com/jeremy/hello-spaceport
→ provisioning nebula…
→ cloning repository…
→ config.spaceport detected → starting service
✓ live at https://hello-spaceport.jeremy.spaceport.host

That's the whole loop. From here:

Learn what a nebula, a plan, and a pool actually are in Concepts.
Go deeper on push-to-deploy in Deploy from the CLI.
Prefer to live on the box? See Work over SSH.