Deploy Your First App

This guide walks you through deploying a real application end-to-end.

1. Install the CLI

npm install -g @lumbox/cli

lumbox login

This opens your browser to authenticate with your Lumbox account. Your credentials are stored locally and never sent to a third party.

Inside your application directory, initialise a Lumbox project:

lumbox init

The CLI detects your framework automatically (Node.js, Bun, static sites, Docker) and writes a lumbox.json config file.

lumbox deploy

Lumbox builds your app, pushes the container image to the EU registry, and routes live traffic to the new deployment within seconds.

Your app is available at:

https://<your-project>.lumbox.eu

Pass secrets at deploy time without committing them to version control:

lumbox env set DATABASE_URL="postgres://..." API_SECRET="..."
lumbox deploy

Variables are encrypted at rest and injected into your runtime environment only.