Quickstart

Log in

pier login

Opens the browser for a one-time code and stores a session. pier whoami shows the workspace the session is in.

Create the project

mkdir hello && cd hello
pier config init --name hello

Creates project hello in your workspace and writes pier.yaml in the current directory. The file is what ties this directory to the project: every later command run here resolves the project from it.

Declare an app

version: 1
project: hello
environments:
  prod:
    apps:
      - name: web
        targets:
          - name: primary
            image: traefik/whoami:v1.10.1
            port: 80
            plan: app-s

environments.prod is the environment, web is the app and primary is its target: the instance that runs and has a URL. A single-target app is addressed by the app name alone. See Concepts.

Apply, then deploy

pier apply
pier deploy

apply converges the platform to pier.yaml: it creates web and never rolls a workload. deploy builds and rolls what changed. deploy implies apply, so a script needs only the second command. Both print a plan and ask for confirmation; -y skips it.

Reach it

pier info web

The output includes the target's hostname, https://<id>.app.pier.run:

curl -sS https://<id>.app.pier.run/

Hostnames are keyed by a random id, not the app name, so renaming web later does not change its URL. pier add domain attaches a custom domain.