Important

You are browsing documentation for version 5.1 of OroCommerce, supported until March 2026. 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.

VPN Connection 

This topic explains how to connect OroCloud VPN on various operating systems.

Note

If you are using different client software versions, ensure that you have OpenVPN version 2.4 or newer. Your OpenVPN configuration file (.ovpn) is sent to your e-mail. Save it in a secure place.

Username and password should be obtained using ORO ID Portal. Please be aware than username is not an email address.

MacOS X 

Used client software: Tunnelblick 3.7.8 build 5180

  1. Download the DMG file and open it as usual.

  2. Run Tunnelblick installer:

    ../../_images/mac_tunnelbrick_dwn.jpg

    Follow the installation wizard instructions.

    Select I have configuration files at the last step:

    ../../_images/mac_tunnelbrick_wizard.jpg

  3. Drag the ovpn configuration file and drop it on the Tunnelblick icon on panel. In the permissions popup, select Only Me.

    ../../_images/mac_tunnelbrick_install.jpg

  4. Click Tunnelblick icon and click ‘Connect OroCloud…’:

    ../../_images/connect_orocloud.jpg

  5. Input your username and password into the dialog that is displayed:

    ../../_images/mac_tunnelbrick_credentials.jpg

  6. You can now connect your environment using SSH.

Ubuntu 18.04 

Used client software: openvpn 2.4.x, network-manager-openvpn, network-manager-openvpn-gnome

  1. Install the required packages:

    sudo apt install network-manager-openvpn-gnome network-manager-openvpn openvpn

    Warning

    Ensure that you are using OpenVPN 2.4 or newer.

  2. Open Network Settings in Gnome Control CenTer and click «+» button for VPN section:

    ../../_images/ubuntu_gnome.png

  3. Select Import from file and open your ovpn configuration file.

  4. Verify the connection settings:

    ../../_images/connection_settings.png

  5. Disable User key password:

    ../../_images/disalble_user_key_password.png

    You may set NetworkManager to keep username and password in key storage, or input it every time.

  6. Click Done.

    Now you can connect using NetworkManager menu.

Windows 10 

Used client software: OpenVPN GUI 2.4.6

  1. Download and install OpenVPN GUI software. Accept installation for OpenVPN TAP driver.

  2. Launch OpenVPN GUI from desktop icon.

  3. Left click on tray icon and select Import file.

    ../../_images/import_file.png

  4. Navigate to your ovpn configuration file and open it:

    ../../_images/open_vpn_file.png

  5. Left click on tray icon and press ‘Connect’:

    ../../_images/connect_vpn.png

  6. Input username and password in connection dialog:

    ../../_images/vpn_connection_dialog.png

  7. Ensure you are connected to VPN:

    ../../_images/vpn_connected.png

  8. Now you are able to connect environment using SSH.