Installation

Via the Press.js CLI

If you have the press CLI installed, install the cloud CLI with a single command:

press install cloud

This downloads the press-cloud-cli binary from GitHub releases and installs it to ~/.press-js/cloud/bin/. Run the same command again to upgrade the managed cloud CLI to the latest GitHub release.

The press CLI also checks for updates in the background when you run Cloud commands. Automatic updates are enabled by default, run at most once per day, and do not block the command you are running.

Options

Flag	Description
--force	Force reinstall instead of treating an existing binary as an upgrade
--url <url>	Custom download URL (supports file://, local paths, and HTTP/HTTPS)

Automatic updates

Automatic updates use the same managed install directory as press install cloud. They do not replace a binary supplied with PRESSJS_CLOUD_CLI_PATH.

Check or change the setting:

press update config
press update config --auto false
press update config --auto true

Settings are stored in ~/.press-js/settings.json.

Uninstall

Remove the managed cloud CLI installed by press install cloud:

press uninstall cloud

This removes the managed binary and manifest from PRESSJS_CLOUD_INSTALL_DIR. It does not delete a binary referenced through PRESSJS_CLOUD_CLI_PATH.

Standalone installation

The cloud binary can also be downloaded and used directly, without the press CLI. This is useful for CI/CD pipelines and automation.

Download the latest release for your platform from the releases page.

# Example: Linux x86_64
VERSION="$(curl -fsSL https://api.github.com/repos/press-js/press-cloud-cli/releases/latest | grep -m1 '"tag_name"' | cut -d '"' -f 4 | sed 's/^v//')"
curl -OL "https://github.com/press-js/press-cloud-cli/releases/latest/download/press-cloud-cli-${VERSION}-x86_64-unknown-linux-gnu.tar.gz"
tar -xzf "press-cloud-cli-${VERSION}-x86_64-unknown-linux-gnu.tar.gz"
chmod +x press-cloud-cli
./press-cloud-cli --help

Environment variables

Variable	Description
PRESS_CLOUD_TOKEN	API key for automated cloud authentication (prefix pcak_)
PRESS_CLOUD_API_BASE	Override the Press.js Cloud API base URL
PRESSJS_CLOUD_INSTALL_DIR	Installation directory (default: ~/.press-js/cloud)
PRESSJS_CLOUD_CLI_PATH	Direct path to the cloud binary (bypasses install directory lookup)
PRESS_CLOUD_CLI_DOWNLOAD_URL	Custom cloud CLI archive or binary URL override

Verify installation

# Via press CLI
press whoami

# Standalone
./press-cloud-cli whoami

Next step: authenticate and deploy your first PDF.