Cosmos Hub 호스트 설치 가이드
Ubuntu 22.04 기준 gaiad 바이너리 설치·실행 개요입니다. 공식 문서: https://hub.cosmos.network/main/hub-tutorials/join-mainnet.html.
시스템 요구사항
| 항목 | 권장 |
|---|---|
| CPU | 4 vCPU 이상 |
| RAM | 16 GB 이상 |
| Disk | 1 TB SSD (기본 pruning). 아카이브는 수 TB |
| Network | 대칭 100 Mbps 이상 |
빌드 or 바이너리
A. 릴리스 바이너리
VERSION=v21.0.0
wget https://github.com/cosmos/gaia/releases/download/${VERSION}/gaiad-${VERSION#v}-linux-amd64
chmod +x gaiad-${VERSION#v}-linux-amd64
sudo mv gaiad-${VERSION#v}-linux-amd64 /usr/local/bin/gaiad
gaiad version
B. 소스 빌드
# Go 1.22+
git clone https://github.com/cosmos/gaia.git
cd gaia
git checkout v21.0.0
make install
gaiad version
초기화 & Genesis
MONIKER="my-cosmos-node"
CHAIN_ID="cosmoshub-4"
gaiad init "$MONIKER" --chain-id $CHAIN_ID
# mainnet genesis
curl -L https://github.com/cosmos/mainnet/raw/master/genesis/genesis.cosmoshub-4.json.gz \
| gunzip > ~/.gaia/config/genesis.json
# seed/peers 설정 (config.toml)
sed -i.bak \
-e 's|^seeds *=.*|seeds = "ade4d8bc8cbe014af6ebdf3cb7b1e9ad36f412c0@seeds.polkachu.com:14956"|' \
-e 's|^minimum-gas-prices *=.*|minimum-gas-prices = "0.0025uatom"|' \
~/.gaia/config/config.toml
Pruning / App 설정
대부분은 Full 노드 용도로 pruning을 활성화합니다.
# ~/.gaia/config/app.toml
pruning = "custom"
pruning-keep-recent = "100"
pruning-interval = "10"
min-retain-blocks = "0"
systemd 서비스
# /etc/systemd/system/gaiad.service
[Unit]
Description=Cosmos Hub (gaiad)
After=network-online.target
[Service]
User=cosmos
ExecStart=/usr/local/bin/gaiad start --home /home/cosmos/.gaia
Restart=on-failure
LimitNOFILE=65535
[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now gaiad
journalctl -u gaiad -f
상태 조회
gaiad status 2>&1 | jq '.SyncInfo | {latest_block_height, catching_up}'
curl -s http://localhost:26657/status | jq .result.sync_info