자체 호스팅: 단계별 가이드

01 inferenced CLI 설치

사용 중인 OS용 CLI 아카이브(v0.2.16 이상)를 다음에서 다운로드하세요 GitHub releases.

# inferenced CLI 다운로드 및 설치
wget https://github.com/gonka-ai/gonka/releases/download/release/v0.2.16-post1/inferenced-linux-amd64.zip
unzip inferenced-linux-amd64.zip
chmod +x inferenced
sudo mv inferenced /usr/local/bin/inferenced

02 콜드 월렛 키 생성

콜드 월렛은 노드 관리 및 보상 수령에 사용됩니다.

inferenced keys add cold-wallet

니모닉 구문을 안전한 곳에 보관하세요!

03 리포지토리 클론 및 설정

git clone https://github.com/gonka-ai/gonka.git -b main
cd gonka/deploy/join
cp config.env.template config.env
# config.env 편집 — 파라미터를 입력하세요

04 모델 가중치 다운로드

활성 네트워크 모델 — MoE FP8 (현재 MiniMax M2.7, DeepSeek V4 Flash 및 GLM-5.3 Flash; 세트는 governance에 의해 정의됨). HuggingFace CLI를 통한 가중치 로드. 자세히 보기 →

pip install -U "huggingface_hub[cli]"
# use the current model id from the network config / governance (example: MiniMax M2.7)
huggingface-cli download MiniMaxAI/MiniMax-M2.7

05 Docker 서비스 실행

docker compose -f docker-compose.yml -f docker-compose.mlnode.yml pull
source config.env && docker compose up tmkms node -d --no-deps

06 온체인 등록

서버에서 운영(웜) 키를 생성하고 호스트를 등록한 다음, 콜드 키가 있는 로컬 머신에서 웜 키에 서비스 트랜잭션 권한을 부여하세요.

# 서버에서 api 컨테이너 안에서: 운영(웜) 키 생성
docker compose run --rm --no-deps -it api /bin/sh
printf '%s\n%s\n' "$KEYRING_PASSWORD" "$KEYRING_PASSWORD" | inferenced keys add "$KEY_NAME" --keyring-backend file

# 같은 위치에서: 네트워크에 호스트 등록
inferenced register-new-participant \
    $DAPI_API__PUBLIC_URL \
    $ACCOUNT_PUBKEY \
    --node-address $DAPI_CHAIN_NODE__SEED_API_URL

# 로컬 머신에서: 웜 키에 권한 부여 (수수료 0.002 GNK)
inferenced tx inference grant-ml-ops-permissions \
    cold-wallet <warm-key-address> \
    --from cold-wallet \
    --gas 2000000 --gas-prices 1ngonka \
    --node <seed-api-url>/chain-rpc/

2026년 10월(네트워크 업데이트 v0.2.16)부터 권한 부여는 유료입니다. --gas-prices 없이 실행하면 네트워크가 insufficient fee 오류와 함께 트랜잭션을 거부합니다. --gas 2000000, gas당 1 ngonka 가격이면 수수료는 0.002 GNK입니다. 콜드 월렛에 GNK 잔액을 남겨 두세요. 웜 키의 수수료도 이 지갑에서 차감됩니다. 공식 가이드는 10 GNK로 시작할 것을 권장합니다.

07 SSL 설정 및 실행

DNS 설정(Cloudflare/AWS/GCP/Azure/DO/Hetzner), SSL 인증서 발급, 전체 네트워크 실행 및 등록 확인.

source config.env && \
docker compose -f docker-compose.yml -f docker-compose.mlnode.yml up -d

# 노드 상태 확인
curl http://<PUBLIC_IP>:8000/chain-rpc/status

# 등록 확인
curl http://node2.gonka.ai:8000/v2/participants/<cold-wallet-address>