Docs

Local Development

Run your entire stack locally with one command.

Starting a Dev Session

alien dev

This is the all-in-one local workflow. It starts a local server, builds your app, and deploys it.

Every cloud resource gets a local equivalent:

Cloud ResourceLocal Equivalent
S3 / Cloud Storage / Blob StorageFilesystem
DynamoDB / Firestore / Table StorageSQLite (embedded database)
SQS / Pub/Sub / Service BusSQLite (persistent queue)
Workers / DaemonsNative process extracted from the built image
ContainersDocker container
PostgresEmbedded native Postgres
VaultPlaintext local files

No cloud credentials needed. No accounts. Docker is required only for builds and Container resources.

Server-Only Mode

If you want just the local server without the full build-deploy-watch cycle:

alien dev server

Then drive it manually with explicit commands:

alien dev release
alien dev deploy --name preview
alien dev deployments ls

This is useful when you want more control over the build-release-deploy cycle, or when integrating with other tools.

Agent-Friendly

For AI agents and automated tooling that need to read state programmatically:

alien dev --status-file .alien/dev-status.json

The status file is a JSON document that updates as the dev session progresses — no terminal output parsing required. Agents can poll this file to know when resources are ready, get endpoint URLs, and monitor health.

On this page