Installation Notes

Go Up to Installation

This page provides important information that you must know before you install Delphi Athens, C++Builder Athens, or RAD Studio Athens. You can find the most recent version of this page here.

Note: This document, as the rest of the documentation, uses the term "RAD Studio" to describe any of the products listed above.

System Requirements

Attention: You need to have .NET Framework 4.5 or later installed on your computer to successfully install RAD Studio. If the installer cannot find .NET Framework 4.5 or later installed on your computer, it prompts you to download and install it to continue with the RAD Studio installation.

Follow the link below for instructions on how to install the latest version of .NET Framework on your computer:

Install .NET Framework on Windows 10 and Windows Server 2016 and later

The following are requirements of RAD Studio itself:

For supported target platforms of RAD Studio projects, see Supported Target Platforms and FireMonkey Platform Prerequisites.
For supported database systems, see FireDAC Core Features.

Hardware Requirements

RAD Studio requires at least:

1.8 GHz or faster dual-core processor. Quad-core or better recommended. Single-core is not supported.
3 GB of RAM. 8GB of RAM is recommended.
Between 6 GB and 60 GB¹ of available disk space. Using a solid-state drive (SSD)is strongly recommended.
DirectX 11 capable video card that runs at 1440x900; a 1080 vertical resolution screen is recommended.
Windows 10 Anniversary Edition is recommended and required for development for the Windows 10 store.

1. Depends on your RAD Studio edition and the features selected during the installation. For more information, see Estimated Required Space.

Operating System Requirements

You can run RAD Studio Athens on the following versions of Windows:

Windows 10 (64-bit only)
Windows 11

Tip: You can also install RAD Studio on a virtual machine running one of the supported versions of Windows in a non-Windows environment (e.g., macOS). To develop FireMonkey projects, your virtualization software must provide direct access to the host GPU.

Your Windows system must be configured as follows:

The user that installs RAD Studio must be the system administrator or be on the administrator privileges list.
The length of your PATH environment variable must be 1830 characters or less.
The installation of RAD Studio adds up to 218 characters to your PATH environment variable. If the length of your PATH environment variable goes beyond 2048 characters, your system will misbehave.

Note: 32-bit versions of Windows are no longer supported as of operating systems for installing RAD Studio 10.4 and above.

Requirements for Supported Target Platforms

Requirements to develop projects for supported target platforms:

Target Platform	Requirements
Windows	PCs and tablets with Intel/AMD processors running any of the following versions of Windows Windows 7 (SP1+) Windows 10 Windows 11 Windows Server 2019 Windows Server 2022 A 64-bit or 32-bit PC
macOS (Delphi only) (includes iOS simulator support on ARM only)	An Intel-based or ARM-based Mac running any of the following versions of macOS: 12 Monterey 13 Ventura 14 Sonoma
iOS (Delphi only)	An iOS device running: iOS 16 iOS 17 All requirements for macOS support. Xcode, version 10.12 or later. Membership in the Apple Developer Program. (Required to deploy iOS apps to physical devices)
Android (Delphi only)	An Android device that runs AArch64 processors or ARMv7 processors with NEON support. A 64-bit version of Windows for development. Android phones and tablets running any of the following versions of Android: Android (10) Android (11) Android (12) Android (13)
Linux (Delphi only)	64-bit Linux running any of the following distributions: Ubuntu Server (Ubuntu 20.04 LTS) Ubuntu Server (Ubuntu 22) RedHat Enterprise Linux (version 8) Windows 11 computer with WSL2 (Windows Subsystem for Linux)

Requirements for Other Features

Requirements for other features:

See interactive content in generated modeling documentation.
For FireMonkey 3D support, your system must allow resources greater than 4 GiB in size while keeping indices of all resources at 32 bits.
To import models in IBM Rational Rose (MDL) format, you must install the Java Runtime Environment.

Tip: The JRE is installed automatically if you choose to install support for the Android target platform.

Technical Advice

Advice on Android development

Android devices can be connected directly and are considerably faster than using the Android emulator.

Advice on macOS and iOS development

In most countries, developing for iOS and macOS requires Apple hardware to code sign native applications. This is due to EULA restrictions on the macOS that require it to run on Apple hardware. It’s not uncommon for a team of developers to share an Apple device and use VNC access or to rent a Mac in the cloud.

If developing from a laptop, many developers get a MacBook Pro and run a virtual machine for Windows (e.g., VMWare Fusion or Parallels). It is then possible to install a PA Server on the Mac and run a fast local connection to enable access to the iOS Simulator, to run and test iOS and macOS builds, and code sign applications on the Apple hardware.

Additional Software

The RAD Studio installation includes some additional software. RAD Studio also allows you to install other additional software after the installation. For details about RAD Studio additional software, see Third Party Software Add-Ins.

Additional Software Always Installed

The following additional software is always installed with RAD Studio:

If your RAD Studio installation includes C++ support, the RAD Studio installation also includes the Dinkumware Standard C++ Library.

Optional Additional Software

The additional software listed in the table below is included in some editions of RAD Studio. Most of it can be installed after the RAD Studio installation using the Feature Manager Dialog, GetIt Package Manager, or downloading the software from CodeCentral. Some of it can also be installed during the RAD Studio installation.

Software	Availability			Important Notes
Software	Installer	GetIt	Offline Installer	Important Notes
Windows 10 SDK				See Windows 10 SDK section.
Android SDK 25.2.5 - NDK (android-ndk-17b)				See Android JDK, SDK, NDK section.
AdoptOpenJDK 8				See Android JDK, SDK, NDK section.
Boost (C++)
CodeSite Express 5.2
DUnit Unit Testing Frameworks (DUnit and DUnitX)
FastReport 2021 (VCL)				See Dependency with TeeChart Feature section.
InterBase Express (IBX) Components
InterBase 2020 Developer Edition
TeeChart Standard
FastReport 2.8 (FMX Embarcadero edition for FireMonkey)
IP*Works!

Windows 10 SDK

If you choose to install C++ or Delphi support for RAD Studio, the RAD Studio installer eventually opens the Windows 10 SDK installer, which is required for Desktop Bridge support.

You need to install the Windows 10 SDK to have the complete Windows API header files.

If you do not want to install the Windows 10 SDK, close the Windows 10 SDK installer when it opens.

Note: Installing the Windows 10 SDK requires an internet connection.

Android JDK, SDK, NDK

If your RAD Studio installation includes Android support, the RAD Studio installer also offers additional software required for Android development in the Additional Selection Page:

Android SDK 25.2.5 - NDK (android-ndk-17b).
AdoptOpenJDK 8.

Note:

You can install these features later with the Feature Manager Dialog.
Even if you have a JDK already installed in your system, selecting AdoptOpenJDK 8 installs this version of JDK and modifies the current JDK path.
If you choose to install the Android development tools, you are prompted to accept the corresponding licenses.

Note: Installing the Android SDK requires an internet connection.

FastReport (VCL) and TeeChart Standard Dependency

FastReport uses some components of TeeChart Standard. Select TeeChart Standard together with FastReport to install both features in RAD Studio to take advantage of all the functionality of FastReport.

Registration Notes

Update Subscription Plan

If you have an active Update Subscription Plan:

If you have a previous version of RAD Studio installed on your machine with that Update Subscription Plan, the installation wizard automatically detects your license.
Otherwise, you can register your new RAD Studio installation using the same serial number as your previous version of RAD Studio that is part of your Update Subscription Plan.

Network Licenses

If you purchased a Network License (managed by the Embarcadero License Center, FLEXnet or AppWave), copy the network license file (named*.slip or concurrent*.slip) received from the license server administrator to the system where you want to install RAD Studio.

During the RAD Studio installation, when prompted to input your license information:

Choose "I have a valid license file (*.slip or reg*.txt) to import".
On the Embarcadero Product Registration tool that opens, select Import.
Locate and select your registration file, and select Open.
When your registration file is imported, select OK to close the Embarcadero Product Registration tool.
Follow the remaining steps of the installation wizard to complete your offline installation of RAD Studio.

Known Installation Issues

Migrating settings to RAD 12.1 package error

When migrating RAD Studio 12.0 settings to a RAD Studio 12.1 installation, users will see an error that the package win64xdebugide290.bpl is missing ("Can't load package C:\Programs\Embarcadero\Studio\23.0\Bin\win64xdebugide290.bpl”). This package is no longer used and shipped by RAD Studio 12.1, and the error only appears due to settings migration. Select the option No so the IDE does not attempt to load the package again.

JDK Install Sequence when using ISO installer

The Android SDK settings may not be configured correctly when installing RAD Studio 12 using the offline installation (the GOF image). This is because the Android SDK installation requires the Java JDK, which is installed later.

The workaround is to defer the installation of the Android SDK, which can be done later by opening the Manage Features dialog box. This issue only applies to the offline installation. The installation order is correct when using the online getit server.

iOS 17.4 Simulator

FireMonkey apps may crash when executed on the iOS Simulator with a target of iOS 17.4. This is due to an OpenGL incompatibility. The workaround is to enable the Metal rendering engine or target a previous iOS version in the iOS Simulator.

IDE Views - Focus

On High DPI screens, editor-docked windows and split views may show the title bar with the wrong background color.

Installation performed with Offline Installer results in missing subdirectories

Delphi

When using the offline installer, the Browsing path for Delphi/64bit Linux lacks various directories.

To fix this, go to Tools > Options > Delphi > Library , select 64-bit Linux, and paste the following string into the Browsing path field:

$(BDS)\source\rtl\common;$(BDS)\source\rtl\sys;$(BDS)\source\rtl\linux;$(BDS)\source\ToolsAPI;$(BDS)\source\IBX;$(BDS)\source\Internet;$(BDS)\source\Property Editors;$(BDS)\source\soap;$(BDS)\source\xml;$(BDS)\source\Indy10\Core;$(BDS)\source\Indy10\system;$(BDS)\source\Indy10\Protocols;$(BDS)\source\fmx;$(BDS)\source\databinding\components;$(BDS)\source\databinding\engine;$(BDS)\source\databinding\graph;$(BDS)\source\data;$(BDS)\source\data\ado;$(BDS)\source\data\cloud;$(BDS)\source\data\datasnap;$(BDS)\source\data\dbx;$(BDS)\source\data\dsnap;$(BDS)\source\data\Test;$(BDS)\source\data\vclctrls;$(BDS)\source\rtl\posix;$(BDS)\source\rtl\posix\linux;$(BDS)\source\data\datasnap\connectors;$(BDS)\source\data\datasnap\proxygen;$(BDS)\source\DataExplorer;$(BDS)\source\Experts;$(BDS)\source\indy\abstraction;$(BDS)\source\indy\implementation;$(BDS)\source\indyimpl;$(BDS)\source\Property Editors\Indy10;$(BDS)\source\soap\wsdlimporter;$(BDS)\source\Visualizers;;$(BDS)\source\data\rest;$(BDS)\source\data\firedac;$(BDS)\source\tethering;$(BDS)\source\DUnitX;$(BDS)\source\data\ems;$(BDS)\source\rtl\net

C++ Builder

When using the offline installer, the System include path for C++ / 32-bit Windows is missing the FMX subfolder.

To fix this, Click Tools > Options > C++ > Paths and Directories > 32-bit Windows , select the Compiler tab, and paste the following string into the System include path field:

$(BDSINCLUDE);$(BDSINCLUDE)\dinkumware64;$(BDSINCLUDE)\windows\crtl;$(BDSINCLUDE)\windows\sdk;$(BDSINCLUDE)\windows\rtl;$(BDSINCLUDE)\windows\vcl;$(BDSINCLUDE)\windows\fmx;$(BDSCOMMONDIR)\hpp\$(Platform)

Contacting Support

Open a support case if you encounter any problems during the RAD Studio installation.