This is a self-hosted ocean api (https://ocean.defichain.com) that you can deploy for your own usage. It is based on the official DefiChain full node and the original Jellyfish Whale code base.
- Linux VPS (Tested on 2 CPU, 4 GB Ram)
- Docker installed
- Docker Compose installed
- Minimum 200 GB free storage
- Domain name pointing to the Linux VPS
- Git installed
- Allow your normal user to access docker
usermod -aG docker your_user
You can find the docker engine setup here https://docs.docker.com/engine/install/.
As your normal user:
First clone this git repository
git clone https://github.com/defichain-pond/pond-deploy.git
cd pond-deploy
Then, run the following script.
. ./setup.sh EMAIL DOMAIN
DOMAIN is your custon domain that needs to point to your servier. Something like pond.example-domain.com
You can verify if the domain name is pointing to your server using following command: nslookup -type=A domain_name
EMAIL the email is required for the SSL certificate generation. You will get notified when this certificate is being expired. Although the mechanism will automatically renew it for you.
The rpc username and password are generated automatically in setup.sh, then will be injected into docker-compose.
We upload regular snapshots for the defichain node as well as whale DB to https://snapshots-eu.sanc.ch/
You can monitor your Pond environment my checking the url https://your_domain.com/_actuator/probes/readiness. This will return a 2xx return code if all is file. It will fail if pond-node or pond-whale or traeffik or the whole server is down. You can use a service such as UptimeRobot to monitor your service.
Depending on the issue Traefik service will automatically failover to the proper Ocean. This will not work if either Traefik or the whole server is down
- Is pond-node running?
docker logs -f pond-node --tail 50
- Is pnod-whale running and no errors?
docker logs -f pond-whale --tail 50
For users who want to deploy Pond on AWS they can simply use the AWS Cloudfromation template and deploy it on AWS (Currently we are supporting only eu-central-1 Frankfurt region).
To deploy Pond on AWS you can follow the steps mentionned in Cloudformation-deploy
The estimated monthly price of Pond deployment including t3.medium EC2 instance will be 58$. A summary of the Pricing calculator can be found in the Pricing page.
The price can be brought down substancially if you want a reserved instance with 1 year upfront payment. It goes down to $247 USD / year or $19 USD / month.
If you are facing any issues feel free to open either a Github Issue or join us on Telegram
- @sancag
- @laghao
MIT