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.

Azure Cloud Platform 

Azure Marketplace enables you to deploy pre-configured demo instances of the latest LTS releases of OroCRM and OroCommerce Community Editions with or without demo data.

To proceed with the installation, make sure you have registered with Azure marketplace and have a valid Azure portal account.

Deploy the Solution 

To deploy the solution, follow the steps below:

  1. Navigate to Azure Marketplace and search for the required Oro application (OroCRM VM or OroCommerce VM) in the search bar.

    OroCRM VM or OroCommerce VM in Azure Marketplace search dropdown
  2. Once you select the application type to deploy, click GET IT NOW under the application logo on your left.

  3. In the pop-up dialog, select the software plan – an instance with or without demo data. The application with demo data provides all the necessary information for you to test the application, such as a preconfigured list of customers, products, submitted orders, quotes, the structured master, and web catalogs.

    Select the software plan pop-up dialog
  4. Click Continue.

    You are redirected to Azure Portal to complete the installation. At this point, you are asked to log into Azure Portal if you have not already done so.

  5. Once again, select the type of application to deploy.

  6. Click Create.

    Create a virtual machine of the selected type
  7. Complete the required fields in the Basics tab:

    • Subscription - Select your subscription type

    • Resource Group - Create a new resource group, or select an existing one.

      A resource group is a container that holds related resources for an Azure solution. Resource group names only allow alphanumeric characters, periods, underscores, hyphens, and parentheses and cannot end in a period.

    • Virtual Machine Name - Provide a virtual machine name.

      Virtual machines in Azure have two distinct names: a virtual machine name used as the Azure resource identifier and the guest hostname. When you create a VM in the portal, the same name is used for both the virtual machine and host names. You cannot change the virtual machine name after the VM is created. You can change the hostname when you log into the virtual machine.

    Creating a VM - Basics tab
    • Region - Choose your region, e.g., (US) East US

    • Availability Options - Set to No infrastructure redundancy required

    • Image - Choose the base operating system or application for the virtual machine, e.g., OroCommerce with demo data VM

    • Size - Select a VM size to support the workload that you want to run. The size you choose determines factors such as processing power, memory, and storage capacity.

    • Authentication type - Choose whether to use a password or SSH public key for authentication.

      • For password, complete fields Username, Password, Confirm password

      • For SSH public key, complete fields Username and SSH public key

    Creating a VM - Basics tab (continued)
  8. Click Next:Disks. The fields in the next step are predefined with demo data.

    Creating a VM - Disks tab
  9. Click Next:Networking. The fields in the next step are predefined with demo data.

    Creating a VM - Networking tab
  10. Click Next:Management. The fields in the next step are predefined with demo data.

    Creating a VM - Management tab
  11. Click Next:Advanced. The fields in the next step are predefined with demo data.

    Creating a VM - Advanced tab
  12. Click Next:Tags. The fields in the next step are predefined with demo data.

    Creating a VM - Tags tab
  13. Click Next:Review+create. The fields in the next step are predefined with demo data.

    You should see Running Final Validation, followed by Validation Passed.

    Creating a VM - Validation
  14. Click Create at the bottom.

  15. Track the deployment process in the notification dialog.

    Tracking deployment progress in the notifications bar
  16. Make sure the deployment is completed successfully, and click Go to resource.

    Deployment complete notification
  17. Click DNS name: Configure, and fill DNS name label.

    Configure DNS
  18. Click Save.

    Save DNS config
  19. Return to the virtual machine and refresh the page.

    Click on the VM name to return to its details page
  20. Next to the DNS Name, click Copy to Clipboard.

    Copy DNS to the clipboard
  21. Paste the DNS into the address bar of a new browser window, and add /admin to the URL (e.g., http://<DNSprefix>.cloudapp.azure.com/admin).

    Paste the DNS into the address bar

    The Oro application interface should now be displayed.

    OroCommerce startup page

    Important

    OroCRM VM Demo Data: If you have deployed OroCRM VM with demo data, use admin as login and the password to access the back-office of the application. To access the application via SSH, specify your username and password/public key, and restart services (systemctl restart oro*).

    OroCommerce VM Demo Data: If you have deployed OroCommerce VM with demo data, use AmandaRCole@example.org both as your login and password to access the storefront (http://<DNSprefix>.cloudapp.azure.com). To access the back-office of the application (http://<DNSprefix>.cloudapp.azure.com/admin/admin), use admin as login and password. To access the application via SSH, specify your username and password or a public key, and restart services (systemctl restart oro*).

Configure Application URL 

For the demo applications to work correctly, you need to configure the application URL (for OroCRM and OroCommerce), and Secure URL and URL (for OroCommerce).

  1. Navigate to System Configuration > General Setup > Application Settings in the application back-office, and provide the Application URL (e.g., http://<DNSprefix>.cloudapp.azure.com, or a different domain).

    Change application URL in the configuration settings
  1. (For OroCommerce only) Navigate to System Configuration > Websites > Routing in the application back-office, and provide Secure URL and URL.

    Change secure url and url in the website routing configuration
  2. Return to the Azure Portal, and reboot the virtual machine.

    Restart VM

    Follow the restart progress in the notification bar on your top right.

  3. Copy and paste the DNS into the address bar of a new browser window and press Enter.

    The storefront should now be displayed if you have deployed the OroCommerce application.

    Note

    Due to Azure blocking port 25, we recommend configuring SMTP settings once you install the application if you would like to send messages from the Oro application you have deployed.

    DNS in the URL for storefront