Skip to content

CLI reference

ry apps

Markdown

Manage apps.

ry apps [options] [command]

List apps.

ry apps list [options]

Options:

  • -l, --label <key=value...>: Only apps carrying this label; repeat for AND, e.g. –label customer=acme –label role=db.

Example:

ry apps list
ry apps list --label role=api

Create an app.

ry apps create [options] <name>

Options:

  • -l, --label <key=value...>: Attach labels right away, e.g. –label customer=acme role=agent (labels are visible in every listing - never put a secret in one - and do not reach the machine).

Example:

ry apps create web

Show or change the labels of an app: key=value sets, key- removes (labels are visible in every listing - never put a secret in one - and do not reach the machine).

ry apps label [options] <name> [changes...]

Example:

ry apps label web role=api team=core

Protect an app: a password, or –link for an invitation-only view.

ry apps protect [options] <name>

Options:

  • --link: No password - the app is reachable only through a share link.
  • --generate: Generate the password instead of asking, and print it once.
  • --label <label>: With –link: create the first share link right away.

Example:

ry apps protect web

Make an app public again (alias of ry protect off).

ry apps unprotect [options] <name>

Options:

  • -y, --yes: Skip confirmation (required for automation).

Example:

ry apps unprotect web

Destroy an app and all its machines.

ry apps destroy [options] <name>

Options:

  • -y, --yes: Confirm without asking (automation, and the way back after consent).

Example:

ry apps destroy web --yes