Skip to content
Open Source implementation of advanced blockchain features extending the Bitcoin protocol
Branch: master
Clone or download
Pull request Compare This branch is 990 commits ahead, 5688 commits behind ElementsProject:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
build-aux/m4 build: force a c++ standard to be specified Feb 23, 2017
contrib add terms and conditions to dockerfile and compose Feb 18, 2019
doc Custom terms and conditions and asset mapping directories per chain Feb 18, 2019
images Add launch in AWS icon Aug 18, 2018
share Debugging. Feb 4, 2019
src Challenge asset and labels (#92) Mar 22, 2019
.gitattributes Separate protocol versioning from clientversion Oct 29, 2014
.travis.yml Debugging. Feb 4, 2019 Debugging. Feb 4, 2019
COPYING [Trivial] Update license year range to 2017 Jan 23, 2017
Dockerfile Added commerceblock/base version tag Mar 13, 2019 Debugging. Feb 4, 2019 Update Feb 13, 2019 Add MIT license to and share/ Sep 21, 2016 Debugging. Feb 4, 2019 Unify package name to as few places as possible without major changes Dec 14, 2015

Launch Ocean in your AWS account

AWS Region Short name
US East (Ohio) us-east-2 cloudformation-launch-button
US East (N. Virginia) us-east-1 cloudformation-launch-button
US West (Oregon) us-west-1 cloudformation-launch-button
EU (London) eu-west-2 cloudformation-launch-button
EU (Ireland) eu-west-1 cloudformation-launch-button

Run Ocean node with Docker


Docker engine release: 18.02.0 or latest docker-compose: 1.20.0 or latest

Download docker-compose.yml

from commerceblock/ocean/contrib/docker/docker-compose.yml or

curl -O

Download image and start

docker-compose -p ocean up -d

Check status

docker-compose -p ocean ps


    Name                  Command               State                         Ports
ocean_node_1   / elem ...   Up>18332/tcp,>7042/tcp

Check logs and see if node is synching

docker-compose -p ocean logs --follow

Hit ctrl+c to stop following

Check if connected to CommerceBlock testnet

docker-compose -p ocean exec node ocean-cli -rpcport=18332 -rpcuser=ocean -rpcpassword=oceanpass getpeerinfo

Should see: ""

Check block count

docker-compose -p ocean exec node ocean-cli -rpcport=18332 -rpcuser=ocean -rpcpassword=oceanpass getblockcount

Once synched, block count should be the same as in:

Data persistence

mkdir ~/ocean_full_node

edit: docker-compose.yml, adding:

    image: commerceblock/ocean:latest
      - /home/your_username/ocean_full_node:/home/bitcoin/.bitcoin

Dig deeper

As root

docker-compose -p ocean exec node bash As bitcoin

docker-compose -p ocean exec -u bitcoin node bash

Then: ocean-cli / ocean-tx available from within inside of container.

Note: if running as root, need to specify: -datadir=/home/bitcoin/.bitcoin

Execute shell commands

docker-compose -p ocean exec node ip a

Scale containers


docker-compose -p ocean scale node=2


docker-compose -p ocean scale node=1


docker-compose -p ocean stop

Remove stack

docker-compose -p ocean rm -f

You can’t perform that action at this time.