Running the Shader Compiler on Amazon EC2 - Lumberyard User Guide

Running the Shader Compiler on Amazon EC2

Open 3D Engine (O3DE), the successor to Lumberyard, is now available in Developer Preview. Download O3DE or visit the AWS Game Tech blog, O3DE Discord, or O3DE GitHub to learn more. The Lumberyard forums have been deprecated. You may view past forum discussions in the archive.

Amazon Elastic Compute Cloud (Amazon EC2) provides a GPU instance that you can use to run the Lumberyard shader compiler for mobile (Android and iOS) and macOS development. For example, you can use the AWS device farm to test a build rather than hosting a PC on a public IP address. Amazon EC2 also provides a G2 instance type that supports advanced rendering features such as texturing, shadows, and anti-aliasing. For more information, see Amazon EC2 Instances.

To run the Lumberyard shader compiler, you must do the following:

  1. Set up the Amazon EC2 instance.

  2. Install virtual network computing (VNC) software.

  3. Connect to the shader compiler.


To run the Lumberyard shader compiler on Amazon EC2, you must have the following:

Setting Up the Amazon EC2 Instance

Before you can set up the Amazon EC2 instance, you must request a GPU instance using the Request to Increase Amazon EC2 Instance Limit link. When you are done, follow the steps below. For information about Windows GPU instances, see Windows Accelerated Computing Instances.

To set up the Amazon EC2 instance

  1. Open the Amazon EC2 console at

  2. From the console dashboard, choose Launch Instance.

  3. On the Amazon Machine Image (AMI) page, enter GPU.

  4. In the search results, select Windows Server 2012 R2 with NVIDIA GRID GPU Driver.

  5. On the Choose an Instance Type page, select the g2.2xlarge type.

  6. Choose Review and Launch to let the wizard complete the other configuration settings for you.

  7. On the Add Storage page, add a drive with sufficient space (512 GB minimum).

  8. On the Add Tags page, add a memorable tag for the computer. For example, ShaderCompilerMachine.

  9. On the Review Instance Launch page, create a new security group or use an existing one.

  10. Open port number 61453 for the shader compiler.

  11. On the Review Instance Launch page, click Launch.

  12. When prompted for a key pair, select Choose an existing key pair, and then select the key pair that you created when getting set up.

  13. When you are ready, select the acknowledgement check box, and then click Launch Instances.

  14. A confirmation page lets you know that your instance is launching. Click View Instances to close the confirmation page and return to the console.

Installing VNC Software

Once the Amazon EC2 instance is set up, you can install virtual network computing (VNC) software to run the shader compiler on the instance.

To install VNC software

  1. Using a remote desktop connection, log in to the Amazon EC2 instance.


    If you are using a Mac, you must download Remote Desktop App from the App Store.

  2. Download and install your preferred VNC software.

  3. On your Amazon EC2 instance, run the VNC server.

  4. Terminate the remote desktop session.

  5. On your local PC, install a VNC client.

  6. Using the VNC connection, run the shader compiler on the Amazon EC2 instance.

  7. Leave the VNC window open and then follow the steps in Connecting to the Shader Compiler.

Connecting to the Shader Compiler

Follow these steps to connect to the shader compiler.

To connect to the shader compiler

  1. On your computer, open the platform configuration file:

    • For Android, open the system_android_es3.cfg file (located in the lumberyard_version\dev directory).

    • For iOS, open the system_ios_ios.cfg file (located in the lumberyard_version\dev directory).

  2. Edit the configuration file to set r_ShaderCompilerServer to the public IP address of your Amazon EC2 instance. You can retrieve the IP address from the Amazon EC2 console.

  3. Run your game on your device to connect to the EC2 instance and compile the shaders.