Skip to main content

Running Oracle Node


We are not onboarding new Data Providers at the moment, but we will be doing so in the near future. Thank you for your interest!

This guide will teach you how to run a RedStone node with Docker. It will fetch data from main public APIs, sign them with your private keys and broadcast to the streamr network and redstone Data Distribution Layer (DDL).

Running from source

You can run RedStone oracle node using source code, but it's recommended to run it with Docker. We continuously build and deploy the code from our Github repository, so you don’t need a complete development environment to run a node.

Data availability

RedStone consumers will be able to use the data published by your node on all supported chains. You can learn more about the RedStone Oracles architecture here.

1. Running a node locally​


  • Make sure to have enough resources to launch a RedStone oracle node, as explained in the requirements page.
  • Install Docker. You will run the oracle node in a Docker container.

Node configuration​

RedStone oracle node should be configured using environment variables. You can configure them in any preferred way, e.g. using a local .env file.

Quick start configuration

We've prepared a simple .env file and a bash script so you can quickly run your first oracle node. You can find them here.

More env variables

The table below contains the main environment variables required for running a node. To see all the supported environment variables (including optional), please take a look at this file.

ParamDescriptionExample value
OVERRIDE_DIRECT_CACHE_SERVICE_URLSYour personal private URLs of gateways to the RedStone Data Distribution Layer (DDL). For running a local node you can simply put OVERRIDE_DIRECT_CACHE_SERVICE_URLS=[""]. But for production node running you should request them from the RedStone team.OVERRIDE_DIRECT_CACHE_SERVICE_URLS=["",""]
OVERRIDE_MANIFEST_USING_FILEPath to your manifest file. Manifest is a public JSON file that defines the provider's obligation regarding the data that they provide. It sets fetching interval, tokens, sources and other public technical details for the provided data. You can check available manifests here.OVERRIDE_MANIFEST_USING_FILE=./manifests/dev/dev.json
LEVEL_DB_LOCATIONPath to the level DB. Each RedStone oracle node relies on a single-level DB. It is used to store recently fetched values from the last 15 minutes. These values are used for checking value deviations, filtering outliers and preventing price manipulation attacks.

You don't need to create a Level DB instance manually, it will be created automatically at the specified path during the first node launch.

Launch using Docker​

Be sure to put your environment variables in the .env file using the instruction above.

Then, you can launch the RedStone oracle node using the following command:

docker run --env-file .env -d --restart=always -v redstone-oracle-node:/oracle-node-level-db --name redstone-oracle-node
Docker image tags

Each docker image has a tag (e.g. 6c5e4bf), which is a short commit hash from the redstone monorepo. It allows quickly identifying the version of source code for a given docker image.

Custom local manifest

If you want to run oracle-node from Docker with your custom manifest you should mount the manifest file from your local system to the docker container and update the OVERRIDE_MANIFEST_USING_FILE env variable.

2. Running a production node​

Reach out to the RedStone team​


Currently, we manually check and validate external data providers making sure that they fully understand the requirements and responsibilities. The process might be automated by smart-contracts in the future.

Please send your ethereum address and public key to the RedStone team. Your address and public key will be added to the data providers registry. We'll also top up your ethereum wallet on Polygon with the small amount of MATIC tokens required for a one-time streamr streams creation, which will be started after your first node execution with a non-zero MATIC balance.

You can use this script for obtaining your address and public key from your private key, but we strongly recommend using your own trusted infrastructure for interacting with your private keys.

We will also send you personal private gateways to the RedStone Data Distribution Layer (DDL), which should be specified using the OVERRIDE_DIRECT_CACHE_SERVICE_URLS environment variable.

Deploy your node​

Follow best practices

Before deploying your oracle node to production environment please take a look at the best practices for the nodes operation.

Once you are added to the data providers registry and received your private gateway URLs, you can deploy the oracle node using Docker to any server or cloud provider you prefer. The deployment configuration should be very similar to the local node run.