Run an OCN Node


The Open Charging Network is a decentralized implementation of the OCPI 2.2 hub concept. Unlike traditional, centralized hub architecture, the OCN does not rely on a centralized server - the network is made up of a distributed network of server nodes. Anybody can run an OCN node.

Why Run a Node?

In the context of OCN, running a node means running and hosting an instance of the OCN node software.

There are several benefits to running your own node of the network.

  • From an individual perspective, running a node makes you less dependent on external service providers

  • From a network perspective, the Open Charging Network becomes more reliable the more nodes that are running

The following steps below help you to successfully set up and run your own OCN Node:

Access the full OCN technical documentation here.

1. Setup and Configuration

Before running a node and connecting it to a local, test or production environment, it is recommended to become acquainted with how the network operates first.

For this, a demonstration of a network simulation with two OCN Nodes and mock parties (CPO and eMSP) has been provided. Please visit this page to learn more and to find the necessary repositories for running the demo: Examples

If you are familiar with the concept behind the Open Charging Network you can start the setup and configuration of your OCN Node. We recommend first running the node on the Test Environment before moving to Production.

Visit the OCN Node README page in the GitHub repository for a step-by-step guide and all necessary resources: OCN Node Repository

2. Administration of Node and Connected Parties

After you have set up and configured your OCN Node, you can now set up administration and access restrictions, and allow others to access your node using the OCN Node APIs.

The HTTP API Documentation for the OCN Node describes the available endpoints which can be used by administrators and parties.

Outside of the full OCPI v2.2 API, OCN Nodes provide additional features, such as the custom OCPI module, OcnRules, as well as ways for admins to restrict use and users to query the OCN Registry.

3. Keep your OCN Node up to date

Every OCN Node is a crucial part of the overall Open Charging Network. As soon as you run your own node, you are responsible for keeping it up to date. This helps to keep the Open Charging Network efficient and secure.

The Energy Web Foundation is steering the development of all Open Charging Network Open Source components, and will release regular updates.

The release date of an update will be announced on our Gitter community at least two weeks before it will come into effect (be pushed from its DEVELOP BRANCH to the MASTER BRANCH). It is planned to keep the components downwards compatible at least one version, but this may not always be possible. Please make sure that you update your OCN Node within 24 hours after the publication of a new release.

Last updated