Theta 호스트 설치 가이드 (Guardian Node)
Ubuntu 22.04 기준 theta 소스 빌드·실행 개요입니다.
- 공식 문서: https://docs.thetatoken.org/docs/install-theta-node-on-ubuntu
- 소스: https://github.com/thetatoken/theta-protocol-ledger
시스템 요구사항
| 항목 | 권장 |
|---|---|
| CPU | 4+ vCPU |
| RAM | 8 GB+ |
| Disk | 500 GB SSD |
| Network | 100 Mbps+ |
빌드
sudo apt update && sudo apt install -y git build-essential
# Go 1.21+
wget https://go.dev/dl/go1.21.13.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.21.13.linux-amd64.tar.gz
export PATH=$PATH:/usr/local/go/bin
git clone https://github.com/thetatoken/theta-protocol-ledger.git
cd theta-protocol-ledger
git checkout release
make install
theta version
설정
공식 저장소 integration/mainnet/guardian/config.yaml 템플릿을 복사해 사용합니다.
mkdir -p ~/.theta
cp integration/mainnet/guardian/config.yaml ~/.theta/config.yaml
cp integration/mainnet/guardian/genesis ~/.theta/genesis
지갑 준비
thetacli key new --password=<WALLET_PASSWORD>
# 출력된 주소를 스테이킹 대상으로 설정
실행
theta start \
--config=$HOME/.theta/config.yaml \
--password=<WALLET_PASSWORD>
systemd 서비스
# /etc/systemd/system/theta-guardian.service
[Unit]
Description=Theta Guardian Node
After=network-online.target
[Service]
User=theta
Environment="PASSWORD=<wallet password>"
ExecStart=/bin/bash -c '/usr/local/bin/theta start --config=/home/theta/.theta/config.yaml --password="$PASSWORD"'
Restart=on-failure
LimitNOFILE=65535
[Install]
WantedBy=multi-user.target
비밀번호를 systemd 환경변수에 두는 건 권장되지 않습니다. 프로덕션은 HSM/시크릿 매니저 연동 또는 대화형 실행을 고려하세요.
스냅샷
공식 Guardian Node 스냅샷 다운로드:
wget https://theta-snapshots.s3.amazonaws.com/guardian_snapshot_latest
# 설정에 따라 ~/.theta/data/snapshot 에 배치
자세한 절차: https://docs.thetatoken.org/docs/snapshot.