Nodes/ripple/localhost/installation

ripple

XRP Ledger(rippled) Ubuntu/Debian 설치 가이드

5분 읽기 · localhost/installation

list목차(16)

XRP Ledger(rippled) Ubuntu/Debian 설치 가이드

Ripple에서 제공하는 사전 컴파일된 rippled 바이너리를 Ubuntu/Debian에 설치하는 방법입니다.
출처: Install on Ubuntu or Debian Linux.

지원 환경

  • Ubuntu 22.04 (Jammy), Ubuntu 24.04 (Noble) on x86_64 — 가장 잘 지원·테스트됨
  • Debian 12 (Bookworm), Debian 11 (Bullseye) — 패키지 제공

다른 apt 기반 배포판에서도 적용할 수 있으나, 공식 지원은 위 환경만 해당합니다.

사전 요구사항

System Requirements를 충족해야 합니다. 요약:

  • 최소(테스트용): RAM 16GB+, SSD/NVMe 50GB+, x86_64 4+ 코어
  • 프로덕션 권장: RAM 64GB, SSD 10,000+ IOPS, x86_64 8+ 코어 3GHz+
  • 시스템 시간: NTP(ntpd 또는 chrony) 사용 권장

설치 단계

1. 저장소 업데이트

sudo apt -y update

2. 유틸리티 설치

sudo apt -y install apt-transport-https ca-certificates wget gnupg

3. Ripple GPG 키 추가

sudo install -m 0755 -d /etc/apt/keyrings && \
  wget -qO- https://repos.ripple.com/repos/api/gpg/key/public | \
  sudo gpg --dearmor -o /etc/apt/keyrings/ripple.gpg

4. GPG 키 지문 확인 (권장)

gpg --show-keys /etc/apt/keyrings/ripple.gpg

Ripple 항목이 있어야 하며, 지문은 다음과 유사해야 합니다:

pub rsa3072 2019-02-14 [SC] [expires: 2026-02-17]
 C0010EC205B35A3310DC90DE395F97FFCCAFD9A2
uid TechOps Team at Ripple

두 번째 줄의 C001... 지문이 일치하는지 확인하세요.

5. Ripple APT 저장소 추가

OS 버전에 맞는 코드네임으로 추가합니다.

Ubuntu 24.04 (Noble):

echo "deb [signed-by=/etc/apt/keyrings/ripple.gpg] https://repos.ripple.com/repos/rippled-deb noble stable" | \
  sudo tee -a /etc/apt/sources.list.d/ripple.list

Ubuntu 22.04 (Jammy): 위에서 noble → jammy
Debian 12 (Bookworm): noble → bookworm
Debian 11 (Bullseye): noble → bullseye

개발/프리릴리스용:

  • stable 대신 unstable(release 브랜치) 또는 nightly(develop 브랜치) 사용 가능. 프로덕션에는 stable만 사용하세요.

6. rippled 설치

sudo apt -y update && sudo apt -y install rippled

7. 서비스 상태 확인

systemctl status rippled.service

자동으로 시작되지 않았다면:

sudo systemctl start rippled.service

8. (선택) 권한 있는 포트 바인딩

API를 80/443에서 제공하려면:

sudo setcap 'cap_net_bind_service=+ep' /opt/ripple/bin/rippled

이 경우 설정 파일에서 해당 포트로 리스닝하도록 수정해야 합니다.

9. (선택) 코어 덤프 설정 (디버깅용)

ulimit -c unlimited
sudo systemctl edit rippled

에디터에서 다음 추가:

[Service]
LimitCORE=infinity

저장 시 /etc/systemd/system/rippled.service.d/override.conf가 생성됩니다. 코어 덤프는 /var/lib/apport/coredump/ 등에 저장될 수 있으며, rippled-dbgsym 패키지가 있으면 분석에 활용할 수 있습니다.

설치 후 확인

  1. 네트워크와 동기화되는 데 수 분이 걸릴 수 있으며, 그동안 로그에 경고가 나올 수 있습니다.
    자세한 내용: Understanding Log Messages.

  2. 동기화 여부 확인:

    rippled server_info

    응답의 server_state가 full 또는 proposing이면 동기화 완료입니다.
    새로 설치한 서버는 보통 15분 이내에 동기화되며, 기존 ledger 히스토리가 있으면 더 걸릴 수 있습니다.

  3. 동기화가 완료되면 트랜잭션 제출 및 API 접근이 가능합니다.
    Client Libraries, HTTP/WebSocket APIs 참고.

설정 파일

  • 기본 경로: /etc/opt/ripple/rippled.cfg
  • 기타 경로: $HOME/.config/ripple/rippled.cfg, $HOME/.local/ripple/rippled.cfg, 또는 실행 디렉터리의 설정 파일

설정 변경 후에는 rippled를 재시작해야 적용됩니다.
옵션 설명: rippled-example.cfg, Capacity Planning.

업데이트

참고

ripple 다른 챕터