# Deploy with the CLI

> `openrail up` uploads the current directory, builds it on your hosts and streams the logs until the deploy is live.

`openrail up` uploads the current directory, builds it on your hosts and streams the logs until the deploy is live.

## Steps

1. Install the CLI: `curl -fsSL https://openrail.app/install.sh | sh -s -- --cli`.
2. Log in: `openrail login https://console.example.com`.
3. In your app's directory, create or link a project: `openrail init -n my-app` or `openrail link`.
4. Deploy: `openrail up --new` the first time, `openrail up` afterwards.

```
$ openrail up
Uploaded 3.2 MB
... build log ...
... first deploy log lines ...
Deployed: https://my-app-k3x9.203-0-113-10.sslip.io
```

## What is uploaded

The directory is packed as a gzipped tar, skipping `.git` and files matched by `.gitignore` and `.5050ignore`. Uploads over 500 MB are refused. `--no-gitignore` includes ignored files; `--path-as-root PATH` uploads only `PATH` as the root.

## From CI

```sh
export OPENRAIL_URL=https://console.example.com
export OPENRAIL_TOKEN=5050_xxxxxxxx
openrail up -c -s api -e production -m "$GIT_COMMIT_MESSAGE"
```

`-c` streams the build log and exits non-zero if the build or deploy fails. For CI, create an environment token in the project's **Project Settings**, **Tokens**. See [Set up the CLI](https://openrail.app/docs/guides/cli-setup#tokens-for-servers-and-ci).

## Next steps

- [CLI reference: up](https://openrail.app/docs/cli/up)
- [Config as code](https://openrail.app/docs/guides/config-as-code)