IN THIS ARTICLE
O3DE System Requirements
Open 3D Engine (O3DE) has a minimum set of hardware and software requirements for development, as outlined in the following sections. In the Software prerequisites and configuration section, each prerequisite is listed along with any specific configuration steps required.
Minimum hardware requirements for development include the following:
- Windows 10 64-bit version 1809 or Ubuntu 20.04 LTS
- Quad-core Intel or AMD processor, 2.5 GHz or faster
- 8 GB RAM
- DirectX 12, Vulkan-compatible, or Metal-compatible video card with 2 GB VRAM minimum
- 4 GB VRAM recommended
- NVIDIA GeForce GTX 1060 or better, driver version 471.11 or later recommended
- AMD Radeon Pro 560 or better
- Intel HD 630 or better
- Shader Model 6.2 (or Shader Model 6.3 to use raytracing features)
- 40 - 100 GB of free disk space
- 1366 x 768 px screen resolution
Note:RAM and free disk space requirements are dependent on the options that you select when configuring your project in O3DE.
Creating new projects or using the advanced development features of O3DE requires several software components depending on the operating system you are using.
At this time, Microsoft Windows is the primary platform for using the O3DE editor and for building source. Specifically, Windows 10 version 1809 (10.0.17763) or later is required.
- Microsoft Visual Studio 2019 version 16.9.2 through version 16.11.x are supported with O3DE. You can use any Microsoft Visual Studio license, including the Community edition.
The default Visual Studio installation might not include all of the features that are required by O3DE. The following steps describe how to ensure that the necessary Visual Studio features are enabled:
Launch the Visual Studio Installer.
Choose Modify on the version of Visual Studio that you’ll use with O3DE.Note:Make sure you are modifying an installation of Visual Studio [Community, Enterprise, Professional] and not a different product, such as Visual Studio Build Tools.
On the Workloads tab:
- Select Game development with C++.
- In the Installation details panel on the right, select at least one Windows 10 SDK.
- Select Desktop development with C++.
- Select Game development with C++.
Once you’ve completed your changes, choose the Install button in the lower right hand corner, selecting your preferred download option.Note:If you’ve made changes to an existing installation, you might see a Modify button in the lower right corner of the options window instead.
After the install completes, you might be prompted to restart your system.
You will also need the Visual C++ Redistributable for Visual Studio 2019 .
After installing the C++ redistributable, you might be prompted to restart your system.
CMake 3.20.5 or later is required to configure and build O3DE projects. We strongly recommend that you install the Latest Release from the CMake download page instead of a Release Candidate. During installation, select one of the options that adds CMake to the system PATH. This will save you from having to do this later.
Several O3DE CLI scripts require the
cmake.exe command line tool to be available from a command line window. To see if this tool is on the system path, open a command prompt and use the
If the current CMake version was not returned because CMake cannot be found, locate the
bin folder in the CMake installation directory and add the path to that folder to the front of your Windows system
PATH environment variable by doing the following:
Open the Windows Start menu.
Type “env” to search for environment variables. Choose Edit system environment variables.
Choose the Environment Variables button.
Select Path under System variables.
Choose the Edit… button.
Choose New to add a new path to the list and enter the full path to the CMake
(Recommended) Choose Move Up to move the path to the top of the list.
Choose OK to save your changes and close the windows that were opened.
cmakeis on the system path by opening a new command line window and running
The primary Linux distribution for using the O3DE Editor is Ubuntu 20.04 LTS. The following instructions describe how to retrieve and install the required software packages through Ubuntu’s
apt-get command-line utility.
As with the other operating systems, CMake 3.20.5 or later is required to configure and build O3DE projects. We strongly recommend that you install the Latest Release of CMake rather than the default one provided by your current Linux distribution. If CMake is already installed, but does not match the minimum version, you will need to remove it with the following command.
sudo apt-get remove cmake
In order to get the latest version of CMake for Ubuntu, you can add the Kitware APT repository to your Ubuntu package list and run
apt-get to install it. Refer to
Kitware APT Page for more information.
wget -O - https://apt.kitware.com/keys/kitware-archive-latest.asc 2>/dev/null | gpg --dearmor - | sudo tee /usr/share/keyrings/kitware-archive-keyring.gpg >/dev/null echo 'deb [signed-by=/usr/share/keyrings/kitware-archive-keyring.gpg] https://apt.kitware.com/ubuntu/ focal main' | sudo tee /etc/apt/sources.list.d/kitware.list >/dev/null sudo apt-get update sudo apt-get install cmake
Once installed, verify that the version meets the minimum version criteria.
O3DE requires Clang to compile all of the native C++ code.
sudo apt-get install clang-12
After clang-12 is installed, it needs to be added to
/etc/environment as two new environment variables.
In addition to the minimum hardware requirements for video cards for O3DE, Linux requires that the latest drivers for the video card are installed and enabled. Refer to the video card manufacturer’s support page for instructions on how to do this.
O3DE’s local python package, Python 3.7, depends on an earlier version of
libffi , which Ubuntu 20.04 LTS does not support. You will need to manually install an older version of libffi onto Ubuntu 20.04 LTS in order for O3DE’s Python package to run properly. The steps below demonstrate how to create a temp folder under
/tmp to download and manually install the specific debian package for libffi.
pushd /tmp LIBFFI_PACKAGE_NAME=libffi6_3.2.1-8_amd64.deb LIBFFI_PACKAGE_URL=http://mirrors.kernel.org/ubuntu/pool/main/libf/libffi/ curl --location $LIBFFI_PACKAGE_URL/$LIBFFI_PACKAGE_NAME -o $LIBFFI_PACKAGE_NAME sudo apt install ./$LIBFFI_PACKAGE_NAME popd
To download the debian package for libffi, you must install Curl:
sudo apt-get install curl
O3DE also requires some additional library packages to be installed:
You can download and install these packages through
sudo apt-get install libglu1-mesa-dev libxcb-xinerama0 libxcb-xinput0 libxcb-xinput-dev libxcb-xfixes0-dev libxcb-xkb-dev libxkbcommon-dev libxkbcommon-x11-dev libfontconfig1-dev libcurl4-openssl-dev libsdl2-dev zlib1g-dev mesa-common-dev libssl-dev
By default, CMake uses Unix Makefiles for building O3DE. O3DE supports multiple build configurations (debug, profile, and release), which you specify when building O3DE. Unix Makefiles only supports single-configuration builds, so you must determine which configuration you want to build when you generate the project. All project builds are based on that configuration. In order to change the build configuration, you need to regenerate the project with the different configuration. This process restricts O3DE’s support for multiple-configuration builds and slows down building workflows.
The Ninja build system is an alternative to Linux’s default Unix Makefiles. The Ninja build system makes it easier to generate, configure, and build your project. With the Ninja build system, specifically
Ninja Multi-Config , you can generate the project once and determine which configuration to build during build time. We recommend that you use this generator for O3DE development. You can install the Ninja build tool through
sudo apt-get install ninja-build
Support for developing on macOS is in an experimental stage. At a minimum, you need macOS Big Sur, Intel x86_64, XCode 12.1 or later, and a Metal-compatible video card that meets the hardware requirements above.