[PR #415] [CLOSED] feat: reef chain bootstrap #3211

Closed
opened 2026-04-25 18:00:41 -05:00 by GiteaMirror · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/Dokploy/templates/pull/415
Author: @anukulpandey
Created: 10/3/2025
Status: Closed

Base: canaryHead: reef-chain


📝 Commits (10+)

📊 Changes

22 files changed (+1047 additions, -0 deletions)

View changed files

blueprints/reef-bootnode/docker-compose.yml (+48 -0)
blueprints/reef-bootnode/reef.svg (+68 -0)
blueprints/reef-bootnode/template.toml (+37 -0)
blueprints/reef-dev-cluster/docker-compose.yml (+43 -0)
blueprints/reef-dev-cluster/reef.svg (+68 -0)
blueprints/reef-dev-cluster/template.toml (+57 -0)
blueprints/reef-eth-rpc/docker-compose.yml (+13 -0)
blueprints/reef-eth-rpc/reef.svg (+68 -0)
blueprints/reef-eth-rpc/template.toml (+13 -0)
blueprints/reef-keygen/docker-compose.yml (+38 -0)
blueprints/reef-keygen/reef.svg (+68 -0)
blueprints/reef-keygen/template.toml (+11 -0)
blueprints/reef-rpc/docker-compose.yml (+39 -0)
blueprints/reef-rpc/reef.svg (+68 -0)
blueprints/reef-rpc/template.toml (+29 -0)
blueprints/reef-spec-gen/docker-compose.yml (+37 -0)
blueprints/reef-spec-gen/reef.svg (+68 -0)
blueprints/reef-spec-gen/template.toml (+9 -0)
blueprints/reef-validator/docker-compose.yml (+40 -0)
blueprints/reef-validator/reef.svg (+68 -0)

...and 2 more files

📄 Description

Added Reef chain node to dokploy template for setting up a cluster

Can read more about reef chain here - https://reef.io

🌊 Reef Cluster – Dokploy Deployment Guide

A Reef validator cluster can be deployed in two different ways on Dokploy:

A single deployment handles bootnode + all validators + RPC.

🔵 Method 2: Multiple Templates (Bootstrap + Individual Validators)

You deploy bootstrap + validators separately for more control.


📑 Table of Contents

  1. Method 1 – Single Template

  2. Method 2 – Multiple Templates



🟢 Method 1: Single Template – Full Cluster Setup


Step 1: Generate Validator Keys

  1. Go to Create Service

  2. Select Template from the menu.

  3. Add template repo URL at the top-right:

    https://d1633d6c.templates-70k.pages.dev/
    
  4. Search for “Reef”

  5. Click Create on Reef Chain – Keys Generator, then confirm.

  6. Deploy the service.

  7. Visit the port http://reef.host:48765 or your IP address / hostname at port 48765

  8. Copy all address + seed pairs, they will be needed later.


Step 2: Deploy Custom Spec Generator

  1. Go to Templates and search for:

Reef Chain – Custom Spec Generator

  1. Deploy it.

  2. It runs on port 8000 by default:

    http://reef.host:8000
    
  3. You can change the port in environment variables if needed.

This service is used by the validators to automatically fetch the custom chain spec.


Step 3: Deploy the Complete Cluster

  1. From templates, search for:

Reef Chain – Dev Cluster

  1. Open the environment tab and paste your seeds & addresses you have copied in step 1:
  1. You may configure:

    • specgenurl → URL of your custom spec generator
    • default: http://reef.host:8000
  2. Deploy the service.

  3. Logs should show successful bootnode + 3 validators starting:

🎉 The cluster is now running!


Adding More Validators

Generate more validators using Reef Chain – Keys Generator.

Fill in the new keys → Deploy.


Deploy Ethereum RPC

Search template:

Reef Chain – ETH RPC

Deploy → It will use the default substrate RPC:

http://reef.host:9944

ETH RPC runs at:

http://reef.host:8545

🎉 Your full cluster (bootnode + validators + RPC + ETH RPC) is now live.



🔵 Method 2: Multiple Templates – Bootstrap & Validators


Step 1: Generate Validator Keys (Same as Method 1)

👉 Jump to: Generate Validator Keys


Step 2: Deploy Bootnode Validator

Create service → choose template:

Reef Chain – Bootnode Validator

Fill in:

  • v1sec, v2sec, v3sec
  • v1addr, v2addr, v3addr
  • PORT=8000 → exposes custom spec
  • P2P_PORT=30335 → bootnode peer port

Bootnode starts → no peers yet (expected).


Step 3: Deploy Additional Validators

Use:

Reef Chain – Validator

Deploy 2 or more validators → finalize blocks.


Deploy ETH RPC (Method 2)

Same template:

Reef Chain – ETH RPC

ETH RPC default port:

http://reef.host:8545

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/Dokploy/templates/pull/415 **Author:** [@anukulpandey](https://github.com/anukulpandey) **Created:** 10/3/2025 **Status:** ❌ Closed **Base:** `canary` ← **Head:** `reef-chain` --- ### 📝 Commits (10+) - [`50cc1bc`](https://github.com/Dokploy/templates/commit/50cc1bc779759c3f3f6d7fc7483c16c4c53b851f) feat: reef chain bootstrap - [`f5949cb`](https://github.com/Dokploy/templates/commit/f5949cb2048d5f55ecde51535bd1d59b8a5a2c9c) fix: missing doc field - [`91653cd`](https://github.com/Dokploy/templates/commit/91653cddb3a068dab6a97a583c42d178bc020d59) feat: reef rpc - [`41920f4`](https://github.com/Dokploy/templates/commit/41920f451cf1fb562b85d6c05399d5b2bdff8b37) fix: meta - [`72b2109`](https://github.com/Dokploy/templates/commit/72b210923629dab03d60182b699b15ee5b5dbd1a) feat: toml changes - [`8869a34`](https://github.com/Dokploy/templates/commit/8869a34d506645bab2bad417fac2d5dde5a49380) fix: var in rpc - [`35bfe1c`](https://github.com/Dokploy/templates/commit/35bfe1ccf350244cdfa13f45576ec1d799a267db) feat: minimal rpc - [`bba1445`](https://github.com/Dokploy/templates/commit/bba1445886816e8d52ccaa8a51de3a50787c2b93) feat: default envs - [`f63563f`](https://github.com/Dokploy/templates/commit/f63563fe64cb0aa7b456edd8a9733435b397f7ad) bootnode toml - [`2971695`](https://github.com/Dokploy/templates/commit/297169572debc0c49857c44c453ea59f97c3d9e7) feat: icon ### 📊 Changes **22 files changed** (+1047 additions, -0 deletions) <details> <summary>View changed files</summary> ➕ `blueprints/reef-bootnode/docker-compose.yml` (+48 -0) ➕ `blueprints/reef-bootnode/reef.svg` (+68 -0) ➕ `blueprints/reef-bootnode/template.toml` (+37 -0) ➕ `blueprints/reef-dev-cluster/docker-compose.yml` (+43 -0) ➕ `blueprints/reef-dev-cluster/reef.svg` (+68 -0) ➕ `blueprints/reef-dev-cluster/template.toml` (+57 -0) ➕ `blueprints/reef-eth-rpc/docker-compose.yml` (+13 -0) ➕ `blueprints/reef-eth-rpc/reef.svg` (+68 -0) ➕ `blueprints/reef-eth-rpc/template.toml` (+13 -0) ➕ `blueprints/reef-keygen/docker-compose.yml` (+38 -0) ➕ `blueprints/reef-keygen/reef.svg` (+68 -0) ➕ `blueprints/reef-keygen/template.toml` (+11 -0) ➕ `blueprints/reef-rpc/docker-compose.yml` (+39 -0) ➕ `blueprints/reef-rpc/reef.svg` (+68 -0) ➕ `blueprints/reef-rpc/template.toml` (+29 -0) ➕ `blueprints/reef-spec-gen/docker-compose.yml` (+37 -0) ➕ `blueprints/reef-spec-gen/reef.svg` (+68 -0) ➕ `blueprints/reef-spec-gen/template.toml` (+9 -0) ➕ `blueprints/reef-validator/docker-compose.yml` (+40 -0) ➕ `blueprints/reef-validator/reef.svg` (+68 -0) _...and 2 more files_ </details> ### 📄 Description Added Reef chain node to dokploy template for setting up a cluster Can read more about reef chain here - https://reef.io # 🌊 **Reef Cluster – Dokploy Deployment Guide** A Reef validator cluster can be deployed in **two different ways** on Dokploy: ### 🟢 **[Method 1: Single Template (Full Cluster Setup)](#method-1-single-template---full-cluster-setup)** [RECOMMENDED] A single deployment handles bootnode + all validators + RPC. ### 🔵 **[Method 2: Multiple Templates (Bootstrap + Individual Validators)](#method-2-multiple-templates---bootstrap--validators)** You deploy bootstrap + validators separately for more control. --- # 📑 **Table of Contents** 1. [Method 1 – Single Template](#method-1-single-template---full-cluster-setup) * [1. Generate Validator Keys](#step-1-generate-validator-keys) * [2. Deploy Spec Generator](#step-2-deploy-custom-spec-generator) * [3. Deploy Full Cluster](#step-3-deploy-the-complete-cluster) * [4. Adding More Validators](#adding-more-validators) * [5. Deploy ETH RPC](#deploy-ethereum-rpc) 2. [Method 2 – Multiple Templates](#method-2-multiple-templates---bootstrap--validators) * [1. Generate Validator Keys](#step-1-generate-validator-keys-method-2) * [2. Deploy Bootnode Validator](#step-2-deploy-bootnode-validator) * [3. Deploy Individual Validators](#step-3-deploy-additional-validators) * [4. Deploy ETH RPC](#deploy-eth-rpc-method-2) --- --- # 🟢 **Method 1: Single Template – Full Cluster Setup** --- ## **Step 1: Generate Validator Keys** 1. Go to **Create Service** <img width="1348" height="767" src="https://github.com/user-attachments/assets/61ffc1b3-7601-4fa0-a8c9-37dd91fe5f0c"> 2. Select **Template** from the menu. 3. Add template repo URL at the top-right: ``` https://d1633d6c.templates-70k.pages.dev/ ``` 4. Search for **“Reef”** <img width="1345" height="760" src="https://github.com/user-attachments/assets/0a73fe6e-7e5d-4553-bcd7-0dca6fc2a831"> 5. Click **Create** on **Reef Chain – Keys Generator**, then confirm. <img width="1352" height="768" src="https://github.com/user-attachments/assets/2a8cae47-6ad4-4d82-aa79-3f7dfb9599ff"> 6. Deploy the service. <img width="1352" height="760" src="https://github.com/user-attachments/assets/82aa445a-c1b7-46de-aa20-abbecc5b79ba"> 7. Visit the port `http://reef.host:48765` or your IP address / hostname at port `48765` <img width="1352" height="803" src="https://github.com/user-attachments/assets/6566a708-3d07-4c90-8dba-26a123dc8514"> 8. Copy all **address + seed pairs**, they will be needed later. <img width="1352" height="805" src="https://github.com/user-attachments/assets/1efb99f2-aa24-4ff4-8326-da8a79104afd"> --- ## **Step 2: Deploy Custom Spec Generator** 1. Go to Templates and search for: ### **Reef Chain – Custom Spec Generator** <img width="1352" height="808" src="https://github.com/user-attachments/assets/990a8521-7a7e-43ae-aaa1-72b1ac253a13"> 2. Deploy it. 3. It runs on port **8000** by default: ``` http://reef.host:8000 ``` 4. You can change the port in environment variables if needed. This service is used by the validators to automatically fetch the **custom chain spec**. --- ## **Step 3: Deploy the Complete Cluster** 1. From templates, search for: ### **Reef Chain – Dev Cluster** <img width="1352" height="762" src="https://github.com/user-attachments/assets/33337aa2-a40e-4d91-9b4a-a77881844222"> 2. Open the environment tab and paste your seeds & addresses you have copied in step 1: <img width="1352" height="767" src="https://github.com/user-attachments/assets/7c05a2e1-ec86-48c2-8015-9909fa44b0fc"> 3. You may configure: * `specgenurl` → URL of your custom spec generator * default: `http://reef.host:8000` 4. Deploy the service. 5. Logs should show successful bootnode + 3 validators starting: <img width="1352" height="765" src="https://github.com/user-attachments/assets/dabf1beb-900b-4627-a656-78d94cb2771b"> 🎉 **The cluster is now running!** --- ## **Adding More Validators** Generate more validators using **Reef Chain – Keys Generator**. Fill in the new keys → Deploy. --- ## **Deploy Ethereum RPC** Search template: ### **Reef Chain – ETH RPC** <img width="1352" height="765" src="https://github.com/user-attachments/assets/e3644fdf-4465-4fc8-967b-10f9d93513bc"> Deploy → It will use the default substrate RPC: ``` http://reef.host:9944 ``` ETH RPC runs at: ``` http://reef.host:8545 ``` <img width="977" height="505" src="https://github.com/user-attachments/assets/6d6a5b02-8c8b-4926-a635-a6829c2c2c4d"> <img width="1352" height="755" src="https://github.com/user-attachments/assets/3d66ed43-4e6c-48c5-953a-ca12cfede6db"> 🎉 **Your full cluster (bootnode + validators + RPC + ETH RPC) is now live.** --- --- # 🔵 **Method 2: Multiple Templates – Bootstrap & Validators** --- ## **Step 1: Generate Validator Keys (Same as Method 1)** 👉 Jump to: [Generate Validator Keys](#step-1-generate-validator-keys) --- ## **Step 2: Deploy Bootnode Validator** Create service → choose template: ### **Reef Chain – Bootnode Validator** <img width="1349" height="768" src="https://github.com/user-attachments/assets/dd42462e-22c9-44f9-8625-01cad45a77d6"> Fill in: * `v1sec`, `v2sec`, `v3sec` * `v1addr`, `v2addr`, `v3addr` * `PORT=8000` → exposes custom spec * `P2P_PORT=30335` → bootnode peer port <img width="1342" height="756" src="https://github.com/user-attachments/assets/eb2a26a8-bc5c-4d54-aade-b47086c9fd89"> Bootnode starts → no peers yet (expected). --- ## **Step 3: Deploy Additional Validators** Use: ### **Reef Chain – Validator** <img width="1352" height="766" src="https://github.com/user-attachments/assets/98c57f34-d1f6-48e4-a11b-09a514817e0f"> Deploy 2 or more validators → finalize blocks. --- ## **Deploy ETH RPC (Method 2)** Same template: ### **Reef Chain – ETH RPC** <img width="1352" height="765" src="https://github.com/user-attachments/assets/e3644fdf-4465-4fc8-967b-10f9d93513bc"> ETH RPC default port: ``` http://reef.host:8545 ``` --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
GiteaMirror added the pull-request label 2026-04-25 18:00:41 -05:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/templates#3211