View source | Discuss this page | Page history | Printable version   

ERP 2.50:Openbravo ERP Installation/Community Appliance

Bulbgraph.png   This document refers to outdated appliances based on rPath and is most likely not what you are looking for.
  • If you are using current appliances based on Ubuntu, go here.
  • If you are using appliances based on rPath, it is required to migrate to the latest appliances because rPath appliance is end of life.


A virtual appliance is a minimally preinstalled and preconfigured application and operating system, designed to run under VMware, Xen or any other virtualization technology. The Openbravo ERP project provides virtual appliances to simplify the evaluation process. For that purpose, these appliances include a sample database client called BigBazaar.

The appliance images are available at the SourceForge download area.

General information

Included software

The appliances include the following software:

Minimum requirements and image details

Bulbgraph.png   The RAM allocated for the virtual machine is 1024MB, however for a single concurrent user and without a system rebuild (e.g. installing modules) 512MB is enough.

In some cases the rebuild process of Openbravo 3 requires more RAM memory. It is recommended to run the virtual appliances with at least 1.5GB of RAM. We plan to review and solve this issue.

VMware appliance

Xen appliance

QEMU appliance

Parallels appliance

VirtualBox appliance

Login into Openbravo ERP

  1. At the end of the boot process, a message appears indicating the IP address you need to launch Openbravo ERP. In your chosen web browser, type that IP address into the address box. The login screen appears.
  2. In the Username box, type Openbravo
  3. In the Password box, type openbravo
    Both the username and password are case sensitive.

Linux passwords

Note that these passwords are not used to login to Openbravo ERP, but in Linux.

Direct database access

Open the PostgreSQL client (e.g. PgAdmin3), specify the following connection settings and click OK:


The Manager username is admin and the password openbravo.

Installation and usage

Common steps

In general, the process of running Openbravo ERP on a virtual appliance are as follows:

  1. Download a virtualization program. See below for specific instructions on VMware, Xen, QEMU, Parallels and VirtualBox.
  2. Download the virtual appliance and open it with the virtualization program.
  3. The following message is shown at the end of the boot process, indicating the URL to access Openbravo ERP with your web browser:
    Welcome to Openbravo ERP Community
    To login to Openbravo ERP use your web browser to go to http://<IP_ADDRESS>


Use VMware Player (freeware) to run pre-built virtual machines on your desktop. To run the Openbravo appliance, follow these steps:

  1. Download and install VMware Player. There are versions for Microsoft Windows and Linux. VMware Fusion is the Macintosh version.
  2. Download the latest version of the Openbravo VMware image and unpack the files.
  3. Run VMware Player (or VMware Fusion on a Mac).
  4. Select the decompressed .vmx file.

If there is DHCP on your network, no further steps are required. The final boot message within the virtual machine play window will show the URL to access Openbravo ERP from your browser.

If your network does not have DHCP you can either:

To create an internal subnet:

  1. Launch the VMware player.
  2. Change the network adapter options from Bridged to NAT.
  3. Restart the virtual machine.

To set a fixed IP address and gateway:

  1. Log in as root (passwordless)
  2. Type the following commands to set a specific ip IP_ADDRESS and a gateway IP_GATEWAY:
    $ /sbin/ifconfig eth0 IP_ADDRESS netmask up
    $ /sbin/route add default gw IP_GATEWAY
  3. Finally to make the IP address available to the Internet, assign some DNS servers to it:
    $ echo "nameserver IP_DNS1" >> /etc/resolv.conf
    $ echo "nameserver IP_DNS2" >> /etc/resolv.conf
  4. To launch Openbravo ERP, launch your chosen web browser and type 'http://<IP_ADDRESS>' into the address box, where 'IP_ADDRESS' is the IP address you specified in step 2.
Bulbgraph.png   If your Openbravo ERP VMware virtual machine hangs when restoring its previous state, just follow this simple trick.

Xen appliance

Xen is an open source and free virtualization software. To run the Openbravo ERP appliance within Xen, follow these steps.

Running on Amazon EC2

To deploy the Xen appliance into Amazon EC2, follow these steps. Make sure all the environment variables are correctly configured:

  1. Bundle the image using the following command:
    $ ec2-bundle-image -i OpenbravoERP-3.0PR23Q4-x86.ext3 -r i386 -k $EC2_PRIVATE_KEY -c $EC2_CERT -u $EC2_USER_ID
  2. Upload the image into a Amazon S3 bucket:
    $ ec2-upload-bundle -b OpenbravoERP -m /tmp/OpenbravoERP-3.0PR23Q4-x86.fs.manifest.xml -a $EC2_ACCESS_KEY -s $EC2_SECRET_KEY
  3. Register the image:
    $ ec2-register OpenbravoERP/OpenbravoERP-3.0PR23Q4-x86.fs.manifest.xml
  4. Use the ami-xxxxxx returned by this command to run the instance:
    $ ec2-run-instance ami-xxxxxx

QEMU appliance

The installation and its networking configuration are out of the scope of this document. Assuming it is ready, run the following command:

$ qemu -hda OpenbravoERP-3.0PR23Q4-x86.qemu-parallels -m 1024 -net tap -net nic

Parallels appliance

Decompress OpenbravoERP-3.0PR23Q4-x86.qemu-parallels.gz.

Open Parallels. Click on Create New Virtual Machine. Install from "continue Without disc".


Choose "Other Linux" as operating system.


Choose a name for your virtual machine and click on "Customize settings before installation".


Click on the Hardware tab, and the Hard Disk 1 menu. Then in the source field, choose the .hdd file decompressed from OpenbravoERP-3.0PR23Q4-x86.qemu-parallels.gz


Click on OK and let the virtual machine run.

VirtualBox appliance

In order to use Openbravo ERP it is necessary to access the virtual appliance through the network. There are two options here:

$ VBoxManage setextradata "Openbravo ERP Community" "VBoxInternal/Devices/pcnet/0/LUN#0/Config/guesthttpd/HostPort" 8000
$ VBoxManage setextradata "Openbravo ERP Community" "VBoxInternal/Devices/pcnet/0/LUN#0/Config/guesthttpd/GuestPort" 80
$ VBoxManage setextradata "Openbravo ERP Community" "VBoxInternal/Devices/pcnet/0/LUN#0/Config/guesthttpd/Protocol" TCP

Where "Openbravo ERP Community" matches with the name given to the appliance in its creation.

Afterwards it is necessary to shut down VirtualBox and start the appliance again. Then, to access Openbravo ERP enter http://localhost:8000 in a web browser.

Parallels appliance

Using Openbravo ERP

Navigate to the Openbravo ERP installation guide to discover how to use Openbravo ERP.

Retrieved from ""

This page has been accessed 183,260 times. This page was last modified on 20 April 2015, at 16:17. Content is available under Creative Commons Attribution-ShareAlike 2.5 Spain License.