Skip over navigation

Prepare Installation Environment

Before you can start OroCRM, prepare the physical or virtual environment that will host your OroCRM deployment.


It is recommended to host application server and database server on separate servers.

Prepare the Application Server

  1. Allocate physical or virtual machine and the necessary network resources.

  2. Install one of the supported operation systems.

  3. Install and Configure a Web Application Server(s) (Apache or nginx).

  4. Install the recommended version of PHP, configure PHP runtime environment and take into account hints on performance optimization.

  5. OroCRM uses Composer to manage package dependencies. Install it globally to simplify running the commands. Symfony documentation provides detailed instructions on installing Composer globally.


    If Composer has been installed globally, it is enough to type composer in the console, in order to execute it.

  6. Optional: To efficiently use the assets shipped with the OroCRM, it is recommended to install node.js. Detailed installation instructions are available in the node.js installation document.


Please ensure that all the system requirements are met by the installation environment.

Prepare Other Servers and Systems

Install and configure the following, if necessary:

  • Mail server
  • Message Queue (Rabbit MQ)
  • Cache (Redis, APCu, or memcached)
  • Search Engine (Elastic Search)


Consider using scalability recommendations for OroCRM deployment if you plan heavy load on the storage due to the large amount of data or on the servers due to the extremely frequent requests.

Prepare the Database Server

  1. Allocate physical or virtual machine and the necessary network resources.
  2. Install the operation system and recommended version of the database management software (PostgreSQL or MySQL).
  3. Create the database that will be used to store Oro application data.

Configure Network

  • Add a record to your DNS Server to map Oro application hostname (e.g., with the IP address it runs on.


    For local deployment, update the hosts file (e.g.,

Once you have prepared the environment, you may proceed with downloading OroCRM files and required packages.

Related Topics

Browse maintained versions:

You will be redirected to [title]. Would you like to continue?

Yes No
Back to top