Skip to main content

Farcaster Hubble Installation Guide

Gereklilikler​

  1. Warpcast kullanıcı id'nizi (FID), Warpcast hesabınız yoksa buradan 5-6 dolar maliyetle bir hesap açabilirsiniz.
  2. Hubble 2281, 2282, 2283 ve 3000 (grafana) portlarını kullanacaktır. Sisteminizde bu portların kullanılmadığından emin olun.
  3. Ethereum ve Optimism RPC, Alchemy ya da Infura'dan bunları temin edebilirsiniz.

Warpcast FID Nerede? Farcaster

Sistemi Güncelleme​

apt update && apt upgrade -y

Gerekli Kütüphanelerin Kurulması​

apt install ca-certificates gnupg lsb-release make git curl screen -y < "/dev/null"

Docker Kurulumu​

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io
docker version

Docker Compose Kurulumu​

curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

Script ile Kurulum​

Aşağıdaki kodu çalıştırdığınızda sizden Ethereum ve Optimism RPC ile birlikte Warpcast FID isteyecek.

Farcaster

curl -sSL https://download.thehubble.xyz/bootstrap.sh | bash

Log Kontrol Etme​

cd $HOME/hubble 
./hubble.sh logs

Hubble'ı Durdurma​

cd $HOME/hubble 
./hubble.sh down

Hubble'ı Başlatma​

cd $HOME/hubble 
./hubble.sh up

Hubble Veritabanını Sıfırlama​

cd $HOME/hubble 
rm -rf .rocks

FID Kontrol Etme​

Senkronize olduktan sonra aşağıdaki kod ile Warpcast FID doğrumu kontrol edin.

docker logs hubble-hubble-1 2>&1 | grep "Hub Operator FID"

Güncelleme​

cd $HOME/hubble && ./hubble.sh upgrade

Docker ile Elle Kurulum​

Repoyu Klonlama​

git clone -c advice.detachedHead=false -b @latest https://github.com/farcasterxyz/hub-monorepo.git

Anahtar Çifti Oluşturma​

cd $HOME/hub-monorepo/apps/hubble
chmod -R 777 $HOME/hub-monorepo/apps/hubble/.hub
chmod -R 777 $HOME/hub-monorepo/apps/hubble/.rocks
docker compose run hubble yarn identity create

.env Dosyası Oluşturma​

Aşağıdaki kodda ETH_MAINNET_RPC_URL, OPTIMISM_L2_RPC_URL ve OPTIMISM_L2_RPC_URL bölümlerini kendi bilgilerinize doldurup çalıştırın.

tee $HOME/hub-monorepo/apps/hubble/.env > /dev/null << EOF
ETH_MAINNET_RPC_URL=https://mainnet.infura.io/v3/XXXXXXXXXXXXXXXXXXXXXXXXXXXX # Replace your Alchemy / Infura ETH Mainnet RPC
OPTIMISM_L2_RPC_URL=https://optimism-mainnet.infura.io/v3/XXXXXXXXXXXXXXXXXXXXXXXXXXXX # Replace your Alchemy / Infura Optimism Mainnet RPC
OPTIMISM_L2_RPC_URL=Warpcast_FID # Replace your FID
FC_NETWORK_ID=1
BOOTSTRAP_NODE=/dns/nemes.farcaster.xyz/tcp/2282
STATSD_METRICS_SERVER=statsd:8125
EOF

Hubble Çalıştırma​

cd $HOME/hub-monorepo/apps/hubble
docker compose up hubble -d

Log Kontrol Etme​

Çalıştırdıktan sonra aşağıdaki kod ile senktronizasyonu kontrol edin. Biraz uzun sürecektir.

cd $HOME/hub-monorepo/apps/hubble
docker compose logs -f hubble

FID Kontrol Etme​

Senkronize olduktan sonra aşağıdaki kod ile Warpcast FID doğru mu kontrol edin.

cd $HOME/hub-monorepo/apps/hubble
docker logs hubble-hubble-1 2>&1 | grep "Hub Operator FID"

Güncelleme​

cd $HOME/hub-monorepo/apps/hubble
git fetch --tags --force && git checkout @latest
docker compose stop && docker compose up -d --force-recreate --pull always

Grafana Monitör Ayarları (El ile kurulum için)​

Burada 3000 portunu kullanan sunucularda Grafana yapılandırılması anlatılmıştır.

Grafana Port Değiştirme​

Varsayılan olarak 3000 olan portu değiştirmek için aşağıdaki kodda müsait portunuzu yazın ve kodu çalıştırın.

GRAFANA_PORT=3005

Ardından aşağıdaki kodu çalıştırın.

sed -i.bak -e "s%:3000%:${GRAFANA_PORT}%g" $HOME//hub-monorepo/apps/hubble/docker-compose.yml
sed -i.bak -e "s%3000:3000%:${GRAFANA_PORT}:${GRAFANA_PORT}%g" $HOME//hub-monorepo/apps/hubble/docker-compose.yml

Grafana Klasör Oluşturma ve İzinleri Verme​

cd $HOME
mkdir -p /var/lib/grafana/plugins/
chmod -R 777 /var/lib/grafana/
chmod -R 777 /var/lib/grafana/plugins/

Grafana Çalıştırma​

cd $HOME/hub-monorepo/apps/hubble
docker compose up statsd grafana -d

Grafana Panele Erişim​

IP_ADRESI:30XX adresine gidin kullanıcı adı ve parola olarak admin ile giriş yapın.

Hubble Durumunu Kontrol Etme​

Aşağıdaki kodun çıksıtı false olmalı.

curl http://127.0.0.1:2281/v1/info?dbstats=1 | jq