WHAT YOU'LL LEARN
  • how to deploy all applications or individual ones
  • how environments work and when to use them
  • how to tear down an environment you no longer need

Overview
anchor

Webiny deploys three applications to AWS: Core (shared infrastructure like databases and file storage), API (backend Lambda functions and GraphQL), and Admin (the frontend management interface). You can deploy all three at once or target them individually. Webiny also supports multiple isolated environments — so you can maintain separate setups for development, staging, production, and even short-lived feature branches.

Deploy All Applications
anchor

To deploy everything in one step:

This deploys Core, API, and Admin to the dev environment by default. If this is your first deployment, it takes 5–15 minutes while AWS provisions all the necessary resources. Subsequent deployments are significantly faster because only the changes are applied.

After the deployment finishes, retrieve your application URLs with:

Deploy Individual Applications
anchor

You do not always need to deploy everything. If only one part of the system changed, deploy just that application:

Some common scenarios:

  • Added or changed a content model or API extensionyarn webiny deploy api
  • Updated the Admin UI or brandingyarn webiny deploy admin
  • Changed infrastructure configurationyarn webiny deploy core (and then api or admin if they depend on the change)

Targeting individual applications keeps deployments fast and focused.

Environments
anchor

Webiny supports multiple environments, each with its own isolated set of AWS resources. No data or configuration is shared between environments.

Long-Lived Environments
anchor

These are persistent environments maintained over the life of the project:

  • dev — daily development (the default when no --env flag is provided)
  • staging — pre-production testing
  • prod — production

Short-Lived Environments
anchor

Create temporary environments for feature branches, pull request previews, or experimentation:

When you are done, destroy the environment to stop incurring costs:

Production Environments
anchor

By default, all environments use a development-optimized infrastructure template — smaller, cheaper, and faster to deploy. For environments that need production-grade infrastructure (high availability, backups, auto-scaling), declare them in webiny.config.tsx:

webiny.config.tsx

Any environment listed here will be deployed with the production template. All other environments use the development template.

Destroy an Environment
anchor

To permanently remove an environment and all its AWS resources:

This action is irreversible

Destroying an environment deletes all deployed infrastructure, databases, files, and data associated with that environment. Make sure you no longer need the environment before running this command.

You can check what is currently deployed in any environment with: