Skip to main content
This topic details the onboarding process between you and the Oro customer support team before your Oro application deployment begins.

Welcome onboard

After you have signed an agreement with Oro Inc. or an Oro-authorized partner, you will receive a Welcome to Oro Enterprise email that guides you through the steps to get your application live. This email includes:
  • Your license key (required for support requests of any type)
  • Contacts for the financial department (invoices and payments)
  • Link to the Oro Inc. Support Desk (technical questions, deployment, configuration)
  • Links to training and documentation resources

Onboarding steps

1

Create a support desk account

The Oro Inc. Support Desk is the main point of contact for all questions and issues related to your OroCloud environment.Create an account at the Oro Inc. Support Desk using the link in your welcome email.
In all support requests, include your company name, license key (if applicable), and application version.
2

Get access to Enterprise source code

Once you purchase an Oro application license, your welcome email will link to the Oro application Enterprise Edition source code on GitHub.To access, clone, or fork the repository, submit a request via the Oro Inc. Support Desk with:
  • GitHub usernames
  • First and last names
  • Email addresses
Use only Long Term Support (LTS) versions for production environments. Review the Release and Support Cycle article for the list of LTS versions.
3

Deploy your OroCloud environment

If you are deploying a custom Oro application from a forked or private repository, provide the following to the support team:
  • Custom repository address in SSH format (e.g., [email protected]:org/app.git)
  • The tag, branch, or commit to use for installation
The support team will:
  1. Generate SSH keys and share the public key with you
  2. Add the key as a deployment key to your custom repository
  3. Prepare the environment in standard configuration
  4. Install the Oro application
  5. Create the first administrator account using your onboarding details
For customized installations, ensure your custom source code is fully functional and does not disrupt the application installation flow.
Once installation is complete, the support team will notify you and remind you of the VPN details and guidance on available maintenance tools.
4

Request further deployment and configuration services

Beyond the initial deployment, you may need additional services before going live. Submit requests to Oro Inc. Support Desk for:
  • Configuring basic authentication for your OroCloud instance
  • Configuring your back-office URL
  • Migrating your database
  • Installing non-out-of-the-box software
  • Whitelisting email domains (for staging environments)
  • Granting access to application logs
  • Configuring message queues
  • Configuring application resources
See the full deployment and configuration checklist for task delivery estimates and required information.

Domain name and SSL

Options for configuring your domain and SSL certificate.

SSH access

Set up SSH access to your OroCloud environment.

SMTP configuration

Configure SMTP for email sending from OroCloud.

What’s next

Build docs developers (and LLMs) love