CLI: Apps

An app is a Procfile application built with buildpacks and served over HTTPS at a generated hostname. Where an artifact serves static files, an app runs processes. Create an app, then run valet deploy from the linked directory to build and run it. The URL is live (failing closed) before the first deploy.

Create an app

valet apps create [name] [--org <org>]

The app gets a generated hostname under the platform's shared apps domain. The current directory is linked to the new app so valet deploy builds and releases it. The app name is optional — if omitted, the server generates one. App, artifact, and agent names share one namespace within an org.

$ valet apps create my-app
Creating app... done, my-app
Linking directory... done
URL: https://bright-prism-1937.valet.run
Run "valet deploy" to build and run this directory.

Deploy

valet deploy

Run from the linked directory. The deploy builds the app with buildpacks from its Procfile, creates a release with its process types, and runs it.

Scale processes

valet ps scale <type>=<count>... [-a <app>] [--org <org>]

Pass one or more <type>=<count> pairs naming process types from the app's Procfile. Apps scale by count only; container sizes are not yet supported. Counts run from 0 up to the platform's per-type maximum. Scaling bounces affected containers; scale changes never redeploy surviving processes.

$ valet ps scale web=2 worker=1
Scaling my-app app in acme org... done, web=2 worker=1

List apps

valet apps [--org <org>]

NAME — the app name
URL — the app's public URL
VERSION — the current release version

Link a directory

valet apps link <name> [--org <org>] [--force]

Creates a .valet/config.json that maps this directory to the named app. Subsequent valet deploy runs publish this directory to the linked app. Use --force to replace an existing link.

Destroy an app

valet apps destroy <name> [--org <org>]

Permanently destroys the app and all its releases. The hostname stops serving within seconds and is never reused. Cannot be undone.