docs · quickstart

Ship your first app
in about two minutes.

The fastest way to learn Qeau is the sandbox — it runs this exact flow on a pre-wired host, no setup. This is the same flow on your own VM.

Quickstart

Real workspaces deploy to a VM you own over SSH. Here's the whole loop.

Connect your Git

Authorize GitHub or GitLab (OAuth — Qeau never sees your Git password), then pick the org, repo, and branch to deploy.

Add your host

Enter the VM's IP, the SSH user, and a private key. Qeau connects outbound over SSH and runs as that user — no inbound port, no root required.

Configure the build

Pick a platform and Qeau auto-fills the run/build commands and port — edit if your setup differs. Add a custom domain to get an NGINX vhost.

Deploy

Qeau clones, builds (with a content-hash cache), starts your app under PM2, and does a zero-downtime blue-green swap. Rollback is instant.

# Prefer to just see it? Launch the sandbox → and run steps 1–4 on a demo host.

Supported stacks

Anything that builds and runs on a Linux VM. Platform presets auto-fill sensible defaults; everything is editable.

Node.js

npm/yarn/pnpm build · PM2 process · any port.

Go

go build · single binary · systemd or PM2.

Python

pip/poetry · gunicorn/uvicorn workers.

Static / SPA

build dir served via NGINX with TLS.

Containers

your image, your registry — run on the host.

Custom

bring your own build + run command.

Secrets at runtime

Launch your app through the on-host agent and secrets are pulled into memory at start — never written to disk.

# in your pm2 / systemd unit qeau-agent -- node server.js
More on the access model and hardening: Security & Trust →

Next steps

# Full reference docs (API, CLI, Terraform) are on the way. Need something specific now? Email support@qeau.tech.