Installing Orion

> :warning: If you plan to run orion in production, also read the information about high availability and performance tuning.


The recommended procedure is to install using the official Orion docker container at Dockerhub. Full detail is provided in this document.

However, if you don't have a docker-ized infrastructure, the recommended procedure is to install building from sources, check this document.


In the case you install using the official Orion docker container at Dockerhub, you need to have the following:

In the case you are installing Orion building from sources you need:

  • Operating system: Debian. The reference operating system is Debian 11.2 but it should work also in any later Debian 11 version.
  • Database: MongoDB is required to run either in the same host where Orion Context Broker is to be installed or in a different host accessible through the network. The recommended MongoDB version is 4.4 (Orion may work with older versions but we don't recommend it at all!).

For system resources (CPUs, RAM, etc.) see these recommendations.

Upgrading from a previous version

From a software point of view, Orion upgrading is as easy as replace the old container or contextBroker by the new one. However, if you also want to migrate existing data you should pay attention to this section.

You only need to pay attention to this if your upgrade path crosses 0.14.1, 0.19.0, 0.21.0, 1.3.0, 1.5.0 and 2.2.0. Otherwise, you can skip this section. You can also skip this section if your DB are not valuable (e.g. debug/testing environments) and you can flush your DB before upgrading.

If your upgrade cover several segments (e.g. you are using 0.13.0 and want to upgrade to 0.19.0, so both "upgrading to 0.14.1 and beyond from a pre-0.14.1 version" and "upgrading to 0.19.0 and beyond from a pre-0.19.0 version" applies to the case) you need to execute the segments in sequence (the common part are done only one time, i.e. stop CB, remove package, install package, start CB). In the case of doubt, please ask using StackOverflow (remember to include the "fiware-orion" tag in your questions).