Getting started

Welcome to wess.dev — push your code and it's live. This guide takes you from nothing to a deployed app in about two minutes.

1. Install the CLI

curl -fsSL https://wess.dev/install.sh | sh

This installs the wess command for macOS or Linux. Verify with wess --help.

2. Sign in

wess login

Use the email and password for your wess.dev account. Your session is saved locally, so you only do this once per machine.

3. Create an app

wess create myapp

App names are lowercase letters and digits (3–31 characters). Your app's home on the internet is reserved immediately: https://myapp.wess.dev.

4. Deploy

There are two ways to get code running. Pick whichever fits your project:

Push with git (build from source — most projects want this):

git remote add wess https://wess.dev/git/myapp.git
git push wess main

Your repo needs a Dockerfile at the root — that's how wess.dev knows how to build your app. The build runs while you push and you watch it live in your terminal. See Deploying with git.

Deploy a prebuilt image (already published to a registry):

wess deploy myapp --image docker.io/library/nginx:alpine --port 80

5. You're live

wess open myapp        # opens https://myapp.wess.dev
wess status myapp      # machines, database, url
wess logs myapp -f     # follow your app's logs