Important

You are browsing documentation for version 5.0 of OroCommerce, supported until January 2025. Read the documentation for version 6.0 (the latest LTS version) to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Get the Oro Application Source Code

You can obtain the application source code and the required dependencies in one of the following ways:

Create a project with composer.
Clone the GitHub repository and install dependencies.
Download the source code archive.

These methods are detailed below.

Method 1: Create a Project with Composer

Make sure you use PHP >=8.1 and have Composer installed. If you do not, use the Composer installation process described in the Composer installation documentation.

Create your new Oro application project with Composer by running one of the commands below, depending on the base application you want to install:

# OroCommerce Community Edition
composer create-project oro/commerce-crm-application my_project_name 5.0.0
# OroCommerce Enterprise Edition
composer create-project oro/commerce-crm-enterprise-application my_project_name 5.0.0 --repository=https://satis.oroinc.com
# OroCRM Community Edition
composer create-project oro/crm-application my_project_name 5.0.0
# OroCRM Enterprise Edition
composer create-project oro/crm-enterprise-application my_project_name 5.0.0 --repository=https://satis.oroinc.com
# OroPlatform Community Edition
composer create-project oro/platform-application my_project_name 5.0.0
# OroCommerce Community Edition for Germany
composer create-project oro/commerce-crm-application-de oroapp my_project_name 5.0.0
# OroCommerce Enterprise Edition for Germany
composer create-project oro/commerce-crm-enterprise-application-de my_project_name 5.0.0 --repository=https://satis.oroinc.com
# OroCommerce Enterprise Edition (without CRM)
composer create-project oro/commerce-enterprise-application my_project_name 5.0.0 --repository=https://satis.oroinc.com

Replace the 5.0.0 with the version to download.
This command creates a new directory called my_project_name/ that contains an empty project.

Method 2: Use the GitHub Repository

Clone the Oro application GitHub repository by running one of the commands below:

# OroCommerce Community Edition
git clone -b 5.0.0 https://github.com/oroinc/orocommerce-application my_project_name
# OroCommerce Enterprise Edition
git clone -b 5.0.0 https://github.com/oroinc/orocommerce-enterprise-application my_project_name
# OroCRM Community Edition
git clone -b 5.0.0 https://github.com/oroinc/crm-application my_project_name
# OroCRM Enterprise Edition
git clone -b 5.0.0 https://github.com/oroinc/crm-enterprise-application my_project_name
# OroPlatform Community Edition
git clone -b 5.0.0 https://github.com/oroinc/platform-application my_project_name
# OroCommerce Community Edition for Germany
git clone -b 5.0.0 https://github.com/oroinc/orocommerce-application-de my_project_name
# OroCommerce Enterprise Edition for Germany
git clone -b 5.0.0 https://github.com/oroinc/orocommerce-enterprise-application-de my_project_name
# OroCommerce Enterprise Edition (without CRM)
git clone -b 5.0.0 https://github.com/oroinc/orocommerce-enterprise-nocrm-application my_project_name

Replace the 5.0.0 with the version to download.
my_project_name is the directory into which you need to clone the application source files.

Run the composer install command with --prefer-dist --no-dev parameter to install all Oro application dependencies:
```
$ cd <application-root-folder>
$ composer install --prefer-dist --no-dev
```
Note that you are prompted to enter the installation environment configuration options that are saved into the config/parameters.yml file. You can find the description for every parameter in the Infrastructure-related Oro Application Configuration article.

Method 3: Download the Source Code Archive

Download the latest version of the application source code from the download section on the website:
Click the download zip, download tar.gz, or download tar.bz2 link to download the archive.

Note

You can also download the virtual machine to quickly deploy the application in the virtual sandbox environment.

Then extract the source files. For example, on a Linux-based OS run:
```
$ cd <application-root-folder>
$ tar -xzvf crm-application.tar.gz
```
All required dependencies are already installed in the vendor folder in the extracted archive.

Warning

Unlike when cloning from the GitHub repository, you are not prompted to enter the configuration parameter values. Default values are used instead. If necessary, update the configuration parameters in the config/parameters.yml file once the command execution is complete.