Command line

Run the CLI from the repository

The current CLI ships in the Upferry repository. Use an authorized checkout with Node.js 22 or newer and its pnpm dependencies installed. A public npm installation is not assumed in this guide.

git clone https://github.com/vlad-grigoryan/upferry.git
cd upferry
pnpm install --frozen-lockfile
export UPFERRY_API_URL=https://api.upferry.com
node apps/cli/bin/upferry.mjs --help

For convenience, define an alias using the actual absolute checkout path:

alias upferry='node /ABSOLUTE/PATH/upferry/apps/cli/bin/upferry.mjs'
export UPFERRY_API_URL=https://api.upferry.com
upferry login
upferry whoami

The default API address is local development, so set UPFERRY_API_URL for the hosted platform. Login displays a code to approve in the panel. Do not share the resulting token. CI can use UPFERRY_TOKEN through its secret store. UPFERRY_LANG=en, es, or ru selects CLI language.

Link and deploy a local application

Change to the application folder before linking. The project and service must already exist.

The current CLI does not expose an environment selector and these commands use the production target. Use the panel for staging and preview environment operations.

upferry link --project YOUR_PROJECT --service YOUR_SERVICE
upferry status
upferry up .
upferry logs --build
upferry logs

upferry up . --detach returns without following deployment progress. Uploading source is not a persistent data import. Check the linked target carefully before deploying.