# Deployment
To deploy a Sage theme you'll need to make sure two things are covered:
- Run
composer install
from the theme directory on the remote server - Copy over production theme assets (the
dist/
folder)
Generate production ready assets with yarn build:production
, which will build your assets with versioned filenames to the dist/
folder.
# Deploying Sage with Trellis
If you use Trellis (opens new window), you can build your assets locally (or on a CI server), then copy them to the remote server during deployment. See the build-before.yml
example hook (opens new window) in Trellis.
# Deploying Sage on Kinsta
Kinsta supports Bedrock and Trellis (opens new window), so deploying Sage with Trellis on Kinsta (opens new window) is possible by following a few extra steps.
# Deploying Sage on WP Engine
The Sage 9 on WP Engine (opens new window) thread on Roots Discourse covers how to work around limitations on WP Engine to deploy your theme.
We do not officially recommend or support this and suggest using a WordPress host that supports SSH, Git, Composer, and the latest PHP versions.
# Deploying Sage via FTP
If you don't have permission to run composer
on the production server and/or are using a shared hosting service, you may want to deploy Sage with FTP. To do so, compile your assets for production and run composer install --no-dev
in your theme directory. Upload all files and folders in your theme except the node_modules
directory to your host.