Skip to main content
Learn how to deploy your Appz projects using the appz deploy CLI command. The appz deploy command deploys Appz projects and can be executed from the project’s root directory or by specifying a path. The command appz operates without needing the ‘deploy’ subcommand. This document will use ‘appz’ to refer to appz deploy. Usage
terminal
Using the appz command from the root of an Appz project directory.

Extended Usage

terminal
Using the appz command and supplying a path to the root directory of the Appz project.
terminal
Using the appz command to deploy a prebuilt Appz project, typically with appz build. See appz build for more details.

Standard Output Usage

When deploying, stdout is always the Deployment URL.
terminal
Using the appz command to deploy and write stdout to a text file.

Deploying to a Custom Domain

Example bash script for a CI/CD workflow to alias all preview deployments to a custom domain. Note that defining the scope may be necessary when using appz alias.
deployDomain.sh
The script deploys your project and assigns the deployment URL saved in stdout to the custom domain using appz alias.

Standard Error Usage

Example script to check for errors during deployment, useful in CI/CD workflows:
checkDeploy.sh

Unique Options

These options only apply to the appz command.

Build Env

terminal
Using the appz command with the --build-env option.

Yes

terminal
Using the appz command with the --yes option to skip questions when setting up a new Appz project.

Env

terminal
Using the appz command with the --env option to provide runtime environment variables.

Prod

terminal
Using the appz command with the --prod option to create a deployment for a production domain specified in the Appz project dashboard.

Skip Domain

terminal
Using the appz command with the --skip-domain option to disable the automatic promotion of relevant domains to a new production deployment.

No Wait

terminal
Using the appz command with the --no-wait option to not wait for a deployment to finish before exiting.

Global Options

These general options can be applied when using the appz deploy command:
  • --cwd
  • --debug
  • --global-config
  • --help
  • --local-config
  • --no-color
  • --scope
  • --token
For detailed information on these global options and their applications, refer to the options section.