Deploy a new release

How to deploy a new Magento or Shopware release on Webscale Essentials.

Follow these steps to deploy a new application release.

Prerequisites

  • SSH Connect access to the Essentials server
  • The branch/tag or build you want to deploy

1. Open SSH Connect and dev shell

Webscale CP > Accordion Menu (top left) > SSH Connect

Find the instance you want to connect to and open a terminal session by clicking on the instance link.

Then run:

dev

to jump to php-fpm container.

2. Go to the web root

cd /var/www/html

3. Update the code

Example: Git-based deployment

git fetch origin
git checkout <branch-or-tag>
git pull origin <branch-or-tag>

4. Run deployment tasks (example)

Magento

php bin/magento maintenance:enable && \
rm -rf generated/* \
var/view_preprocessed/* \
var/di/* \
var/cache/* \
var/page_cache/* \
pub/static/frontend/* \
pub/static/adminhtml/* && \
php bin/magento setup:upgrade && \
php bin/magento cache:clean && \
php bin/magento cache:flush && \
php bin/magento cache:enable && \
php bin/magento setup:di:compile && \
php -d memory_limit=2G bin/magento setup:static-content:deploy en_US -f --jobs=4 && \
php bin/magento maintenance:disable

Shopware

# Run once to install the deployment helper if it is not installed yet
composer require --no-audit shopware/deployment-helper

# Deployment commands
vendor/bin/shopware-deployment-helper run --skip-asset-install --skip-theme-compile
php bin/console database:migrate --all
php bin/console theme:compile --sync
php bin/console theme:refresh
php bin/console cache:clear
php bin/console cache:warmup

5. Verify the deployment

  • Load the site in a browser
  • Optionally check versions:
php bin/magento --version
# or
php bin/console --version

6. When to contact Webscale

Contact Webscale support if:

  • Database migrations fail
  • Deployment completes but the site shows errors

Last modified February 6, 2026