Installation Notes

Go Up to Installation

This page provides important information that you must know before you install Delphi Rio, C++Builder Rio, or RAD Studio Rio. 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 links below for instructions on how to install the latest version of .NET Framework on your computer:

• Install .NET Framework on Windows 7 SP1 and Windows Server 2008 R2
• Install .NET Framework on Windows 8.1 and Windows Server 2012 R2
• 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.6 GHz or faster processor.
• 2 GB of RAM.
• Between 6 GB and 60 GB¹ of available disk space.
• DirectX 11 capable video card that runs at 1024x768 or higher resolution.

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 on the following versions of Windows:

• Windows 10
• Windows 8.1
• Windows 7 SP1

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.

Attention: If you’re installing Delphi, C++Builder, or RAD Studio 10.3 on a single core virtual machine, running Windows 7, and are encountering an operation error during the web based GetIt installation, increase to multiple cores and restart the installation.

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 8.1 Windows 10 Windows Server 2012 Windows Server 2016 A 64-bit PC or a 32-bit PC connected to a 64-bit PC.
macOS	A PC running Windows, connected to an Intel-based Mac with more than 2 GB of RAM running Windows in a VM or running any of the following versions of macOS: 10.12 Sierra 10.13 High Sierra 10.14 Mojave 10.15 Catalina
iOS	An iOS device running any of the following versions of iOS: iOS 10 iOS 11 iOS 12 iOS 13 All requirements for macOS support. Xcode, version 10.12 or later. Membership in the Apple Developer Program.
Android	An Android device that runs on an ARMv7 processor with NEON support. A 64-bit version of Windows for development. Android phones and tablets running any of the following versions of Android: Lollipop (5.1) Marshmallow (6) Nougat (7) Oreo (8) Pie (9) Android (10)
Linux (Delphi only)	64-bit Linux running any of the following distributions: Ubuntu Server (Ubuntu 14.04 LTS) Ubuntu Server (Ubuntu 16.04 LTS) Ubuntu Server (Ubuntu 18.04 LTS) RedHat Enterprise Linux (version 7)

Requirements for Other Features

Requirements for other features:

• You must install the Adobe Flash Player to:
  • 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.

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:

• Beyond Compare
• Internet Direct (Indy)

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, 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
	Installer	GetIt	Offline Installer
Windows 10 SDK				See Windows 10 SDK section.
Android SDK 25.2.5 - NDK (android-ndk-17b)				See Android JDK, SDK, NDK section.
Java Development Kit 1.8				See Android JDK, SDK, NDK section.
Boost (C++)
CodeSite Express 5.2
DUnit Unit Testing Frameworks (DUnit and DUnitX)
FastReport 5.0 (VCL)				See Dependency with TeeChart Feature section.
InterBase Express (IBX) Components
InterBase 2020 Developer Edition
TeeChart Standard
FastReport 5.0 (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.

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).
• Java Development Kit 1.8.

Note:

• You can install these features later with the Feature Manager.
• Even if you have a JDK already installed in your system, selecting Java Development Kit 1.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.

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:

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

Known Installation Issues

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)

PAServer on macOS Mojave and Catalina

RAD Studio 10.3.3: If you install PAServer on macOS Mojave or Catalina, you will see an error message, indicating that PAServer was signed with an expired certificate.

You can temporarily work around this issue by selecting the Open Anyway option in the Apple menu under System Preferences > Security & Privacy.

We recommend downloading the notarized version of PAServer here: http://altd.embarcadero.com/releases/studio/20.0/PAServer/Release3/2/PAServer20.0.pkg

Contacting Support

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

See Also

• Installation
• Release Notes
• What's New

• Hotfixes and Workarounds for Rio