Local Development on Apple Silicon Macs (M1/M2/M3/M4)

As of Engine 4.1, you no longer need to apply this special tag in the releases. All releases from 4.1 and above are published as universal images contain CPU-architecture-specific contents in the same image. Read more about this in PageBuilder Engine Universal Docker Images.

Note

A known issue requires Apple Silicon Mac users to continue using the -arm prefix in order to run your local environment. If you’ve logged an issue with Arc XP Client Support, they’ll notify you when the issue is resolved. We’ll also update this documentation when the -arm prefix is no longer required.

When using Apple Silicon Macs (M1/M2/M3/M4 - arm CPU) architecture hardware for development environments, you must add a small special instruction to environment variables.

The PageBuilder Engine team creates separate docker images with Apple Silicon Macs support for each engine version for local development. To run Fusion on Apple Silicon Macs, you must choose and define which engine version you’re using on your local development environment. This means, when there is a new Engine release, updating this environment variable is necessary to start using new features and fixes coming with the new version of Engine releases. Set the following in your .env file:

FUSION_RELEASE=[engine-version]-arm

Pick and set [engine-version] in this example like 3.3.4-arm Ensure you don’t have duplicate FUSION_RELEASE set anywhere else in your .env file.