🐳 Docker Compose files for the full Ocean Protocol stack
Go to file
Alex Coseru aac86be44a
Bump contracts to v2.0.4
2024-03-15 22:51:58 +02:00
.github Update CODEOWNERS 2021-02-18 17:48:56 +02:00
certs/registry c2d 2022-01-14 02:31:01 -08:00
compose-files yaml-cli2 -> latest 2024-01-16 19:47:55 +03:00
.banner add discord link 2020-09-08 18:04:08 +02:00
.gitignore cleanup 2020-10-13 10:47:00 +02:00
LICENSE Initial commit 2018-04-26 16:40:15 +01:00
README.md Merge branch 'main' into predictoor 2023-11-29 15:28:54 +02:00
Welcome_to_Ocean_Protocol.png update version options docs 2019-06-05 14:21:31 +02:00
cleanup.sh add three predictoors 2023-07-26 17:54:58 +03:00
start_ocean.sh Bump contracts to v2.0.4 2024-03-15 22:51:58 +02:00




🐳 Docker Compose files for the full Ocean Protocol stack running locally for development.


We recommend running Barge inside a Linux machine.

Get Started

If you're new to Barge, it's best to start with the defaults:

git clone git@github.com:oceanprotocol/barge.git
cd barge


This will run the current default versions of Aquarius, Provider, and Ganache with our contracts deployed to it.

Welcome to Ocean Protocol


To clean up your environment, you can run


This will stop & remove any ocean related containers, then delete any volumes and networks created by barge.


If your code using Barge hits KeyError: "development", this is a Barge issue: Barge couldn't deploy the contracts and update address.json in ~/.ocean/. Further cleanup is needed. Further cleanup can fix other issues too. Here are tactics.

Tactic: clean up old Docker containers

docker system prune -a --volumes

Tactic: delete Ocean cache, or a sub-directory of it. (This is not part of cleanup.sh in case you want to preserve parts of ~/.ocean/.)

# delete whole cache
rm -rf ~/.ocean

# OR, delete sub-directory
# (find the sub-directory, and rm -rf it)

Tactic: Kill redis or postgres processes. Why: they usually have autostart enabled and can interfere with Barge.

# use ps. Do as superuser to ensure you see the process.
sudo ps aux | grep redis
sudo ps aux | grep postgresql

# If you see unwanted processes, kill them by process id. -9 to force
kill -9 <pid>

Tactic: reboot your computer. Why: will stop any other unwanted process.

Startup Options

The startup script comes with a set of options for customizing various things.

Component Versions and exposed ports

The default versions are always a combination of component versions which are considered stable.

Component name Required by Version IP Address Ports exposed
ganache ocean-contracts latest 8545 -> 8545
ocean-contracts v2.0.2
Aquarius v5.1.4 5000 -> 5000
Elasticsearch Aquarius 8.5.1
Provider v2.1.3 8030 -> 8030
Provider2 v2.1.3 8030 -> 8030
RBAC Server main 3000 -> 3000
GraphNode graphprotocol/graph-node:v0.28.2 9000 -> 8000 ,9001 -> 8001 , 9020 -> 8020, 9030 -> 8030, 9040 -> 8040
Graphipfs ipfs/go-ipfs:v0.4.23 5001 -> 5001
Graphpgsql postgres 5432 -> 5432
Dashboard portainer/portainer 9100 -> 9000
Redis bitnami/redis:latest 6379 -> 6379
C2d multiple components, 31000 -> 31000

You can override the Docker image tag used for a particular component by setting its associated environment variable before calling start_ocean.sh:


For example:

export AQUARIUS_VERSION=v2.0.0

Log levels

You can specify what type of logs barge should display for Aquarius, Provider or Subgraph by exporting the following environment variables.


Currently, they are all set to INFO.

For example:


All Options

Option Description
--no-aquarius Start up Ocean without the aquarius Building Block.
--no-elasticsearch Start up Ocean without the elasticsearch Building Block.
--no-provider Start up Ocean without the provider Building Block.
--no-ipfs Start up Ocean without the ipfs Building Block
--with-provider2 Runs a 2nd provider, on port 8031. This is required for ocean.js/ocean.py integration tests. 2nd Provider will use the same image and parameters (log_level, ipfs gateway, compute gateway, etc) as provider1, but has a different private key
--no-dashboard Start up Ocean without the dashboard Building Block.
--with-rbac Start up Ocean with RBAC Server
--with-thegraph Start up Ocean with graphnode,postgresql and deploys ocean-subgraph
--skip-subgraph-deploy Will skip deployment of ocean-subgraphs
--skip-deploy Start up Ocean without deploying the contracts. Useful when ethereum node already has contracts.
--force-pull Force pulling the latest revision of the used Docker images.
--purge Removes the Docker containers, volumes, artifact folder and networks used by the script.
--exposeip Binds the components to that specific ip. Example: ./start_ocean.sh --exposeip
--with-c2d Runs a local C2D Cluster

Docker Building Blocks

Barge consists of a set of building blocks that can be combined to form a local test environment. By default all building blocks will be started by the start_ocean.sh script.


By default it will start two containers (one for Aquarius and one for its database engine). By default, Barge will use Elasticsearch for its database engine.

This Building Block can be disabled by setting the --no-aquarius flag.

Hostname External Port Internal URL Local URL Description
aquarius 5000 http://aquarius:5000 http://localhost:5000 Aquarius
elasticsearch The Elasticsearch used by Aquarius


Hostname External Port Internal URL Local URL Description
provider 8030 http://provider:8030 http://localhost:8030


Hostname External Port Internal URL Local URL Description
ganache 8545 http://ganache:8545 http://localhost:8545


Hostname External Port Internal URL Local URL Description
graphnode 9000 http://graphnode:9000 http://localhost:9000


  • Deploy all smart contracts from the ocean-contracts repo
  • Export artifacts files (.json) to default shared folder between all containers
  • Create address file (address.json) that has the address of each deployed smart contract that is required by the ocean library. This file is saved to the same folder with the artifacts files

The accounts can be accessed with this seed phrase:

taxi music thumb unique chat sand crew more leg another off lamp

Alternatively, you can pass your own mnemonic with GANACHE_MNEMONIC.


This will start a portainer dashboard with the following admin credentials and connects to the local docker host. This Building Block can be disabled by setting the --no-dashboard flag.

  • User: admin
  • Password: oceanprotocol
Hostname External Port Internal URL Local URL Description
dashboard 9100 http://dashboard:9100 http://localhost:9100 Portainer

RBAC Server

Hostname External Port Internal URL Local URL Description
rbac 3000 http://rbac:3000 http://localhost:3000

The following addresses are preconfigured for testing: (first 10 addresses from the default mnemonic)

Address Roles
0xe2DD09d719Da89e5a3D0F2549c7E24566e947260 ["user","publisher","consumer"]
0xBE5449a6A97aD46c8558A3356267Ee5D2731ab5e ["user","publisher","consumer"]
0xA78deb2Fa79463945C247991075E2a0e98Ba7A09 ["user","publisher","consumer"]
0x02354A1F160A3fd7ac8b02ee91F04104440B28E7 ["user","publisher","consumer"]
0xe17D2A07EFD5b112F4d675ea2d122ddb145d117B ["user","publisher","consumer"]
0xA32C84D2B44C041F3a56afC07a33f8AC5BF1A071 ["user","publisher","consumer"]
0xFF3fE9eb218EAe9ae1eF9cC6C4db238B770B65CC ["user"]
0x529043886F21D9bc1AE0feDb751e34265a246e47 ["consumer"]
0xe08A1dAe983BC701D05E492DB80e0144f8f4b909 ["publisher"]
0xbcE5A3468386C64507D30136685A99cFD5603135 ["consumer","publisher"]


See the page titled "Ways to Contribute" in the Ocean Protocol documentation.


Several building blocks on barge are going to require some time until they are ready. Watch for the following files to be created:

Building block File Condition
ocean-contracts ${OCEAN_HOME}/ocean-contracts/artifacts/ready
c2d ${OCEAN_HOME}/ocean-c2d/ready
c2d ${OCEAN_HOME}/ocean-c2d/imagesready Only if WAIT_FOR_C2DIMAGES == 'yeah'


Registry certs were created using the following commands:

openssl genrsa 2048 > registry.key
openssl req -new -x509 -nodes -sha1 -days 3650 -key registry.key -out registry.crt -addext 'subjectAltName = IP:'


Copyright 2023 Ocean Protocol Foundation

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at


Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.