> For the complete documentation index, see [llms.txt](https://docs.yaeris.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yaeris.com/software/yaeris-launchpad/the-launchpad-cli.md).

# launchpad-cli: Deploy from Your Terminal

Deploy, view logs, and manage environment variables from the command line with launchpad-cli, a dependency-free Node.js script for CI pipelines.

launchpad-cli lets you deploy, view logs, and manage environment variables from your terminal or a CI pipeline, without opening the dashboard.

## Getting a token

From Settings -> CLI tokens, click Create token and give it a label (e.g. "My laptop" or "CI pipeline"). The token is shown to you exactly once -- copy it immediately, as it can't be retrieved again afterward. A token authenticates as your whole team, so treat it like a password, and revoke it from the same page if it's ever compromised.

## Installing

The CLI is a dependency-free Node.js script -- no npm install required, just Node 18 or newer.

```
node launchpad-cli.js login <your-token>
```

This saves your token to \~/.launchpad/config.json (created with restricted file permissions, the same sensitivity as an SSH key).

## Commands

| Command                         | What it does                                            |
| ------------------------------- | ------------------------------------------------------- |
| launchpad-cli login             | Save a CLI token                                        |
| launchpad-cli deploy            | Trigger a deploy of the project's tracked branch        |
| launchpad-cli logs              | Print the last 300 lines of runtime logs                |
| launchpad-cli env ls            | List environment variable keys (values are never shown) |
| launchpad-cli env set KEY=value | Set an environment variable                             |

### Example

```
launchpad-cli login lp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
launchpad-cli deploy my-strapi-site
launchpad-cli logs my-strapi-site
launchpad-cli env set my-strapi-site DATABASE_URL=postgres://...
```

A project's slug is the name shown in its dashboard URL (hosting.yaeris.com/dashboard/).

deploy triggers the exact same build pipeline as a real git push or clicking Redeploy in the dashboard -- there's no separate, different deploy path for the CLI.