> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stablenet.network/llms.txt
> Use this file to discover all available pages before exploring further.

# 시작하기

## 목적 및 범위

이 문서는 StableNet 설치, 노드 구성, 최초 실행 과정을 안내합니다. 시스템 요구사항부터 초기 시작까지 노드를 운영 가능한 상태로 만드는 필수 단계를 다룹니다.

상세 정보는 다음 문서를 참조하세요:

* [핵심 아키텍처](/ko/core-architecture/index)
* [Anzeon WBFT 합의 프로토콜](/ko/consensus-and-block-production/4.1-anzeon-wbft-consensus-protocol)
* [설치 및 빌드](/ko/getting-started/2.1-installation-and-building)
* [노드 구성](/ko/getting-started/2.2-node-configuration)
* [제네시스 설정 및 네트워크 초기화](/ko/getting-started/2.3-genesis-setup-and-network-initialization)

## 사전 요구사항

StableNet은 Go로 빌드되며 다음이 필요합니다:

| 요구사항 | 최소 버전      | 비고                                  |
| ---- | ---------- | ----------------------------------- |
| Go   | 1.22.x     | 소스 빌드 시 필수                          |
| 디스크  | 200+ GB    | Full Sync 기준; 네트워크에 따라 상이           |
| RAM  | 8 GB       | 검증자 노드는 16 GB 권장                    |
| CPU  | 2코어 이상     | 4코어 이상 권장                           |
| 네트워크 | 25 Mbps 이상 | P2P 동기화에 필요; 초기 동기화 시 50 Mbps 이상 권장 |

## 설치 개요

StableNet은 여러 방법으로 설치할 수 있습니다:

### 소스에서 빌드

주요 빌드 방법은 CI 빌드 스크립트를 사용합니다:

```bash theme={null}
git clone https://github.com/stable-net/go-stablenet
cd go-stablenet

# Build gstable binary
go run build/ci.go install ./cmd/gstable

# Binary will be in build/bin/gstable
./build/bin/gstable version
```

빌드 시스템은 `build/ci.go` 스크립트를 통해 크로스 컴파일과 정적 링크를 지원하며, 모든 빌드 플래그와 의존성을 처리합니다.

### 릴리스 바이너리 사용

사전 빌드된 바이너리는 [GitHub Releases](https://github.com/stable-net/go-stablenet/releases)에서 다운로드할 수 있습니다:

```bash theme={null}
# 릴리스 페이지에서 다운로드
tar -xzf gstable-linux-amd64-<version>.tar.gz

# 바이너리를 PATH에 추가
sudo mv gstable /usr/local/bin/

# 설치 확인
gstable version
```

플랫폼별 상세 설치 절차는 [설치 및 빌드](/ko/getting-started/2.1-installation-and-building)를 참조하세요.

## 네트워크 선택

StableNet은 여러 네트워크 구성을 지원합니다:

| 네트워크    | 플래그                                                | ChainID |
| ------- | -------------------------------------------------- | ------- |
| Mainnet | `--mainnet`                                        | 8282    |
| Testnet | `--testnet`                                        | 8283    |
| 커스텀     | `--genesis /path/to/genesis.json --networkid <id>` | 사용자 지정  |

커스텀 네트워크 설정은 [제네시스 설정 및 네트워크 초기화](/ko/getting-started/2.3-genesis-setup-and-network-initialization)를 참조하세요.

## 기본 구성

노드는 명령줄 플래그, TOML 설정 파일 등으로 구성할 수 있습니다. `--datadir`, `--http`, `--port` 등 주요 옵션은 [노드 구성](/ko/getting-started/2.2-node-configuration)을 참조하세요.

## 첫 번째 노드 실행

1. **데이터 초기화**: 첫 실행 시 네트워크 플래그를 지정하지 않을 경우 Mainnet으로 초기화됩니다. 커스텀 네트워크는 [제네시스 설정 및 네트워크 초기화](/ko/getting-started/2.3-genesis-setup-and-network-initialization)를 참조하세요.
2. **노드 시작**: 노드는 기본적으로 합의에 참여하지 않는 일반 노드로 시작하며, 검증자 모드로 합의에 참여하려면 `--mine` 옵션을 지정해야 합니다. 실행 명령과 플래그는 [노드 구성](/ko/getting-started/2.2-node-configuration)을 참조하세요.
3. **동작 확인**: RPC, JavaScript 콘솔, 피어 연결 확인 방법은 [노드 구성](/ko/getting-started/2.2-node-configuration)을 참조하세요.

문제 발생 시 [노드 구성](/ko/getting-started/2.2-node-configuration)과 [노드 모니터링 및 유지보수](/ko/operations-guide/11.3-node-monitoring-and-maintenance)를 참조하세요.

## 다음 단계

첫 번째 노드를 성공적으로 실행한 후:

* [노드 구성](/ko/getting-started/2.2-node-configuration) — 프로덕션 구성 옵션
* [검증자 작업](/ko/operations-guide/11.2-validator-operations) — 검증자 노드 운영
* [제네시스 설정 및 네트워크 초기화](/ko/getting-started/2.3-genesis-setup-and-network-initialization) — 커스텀 네트워크 생성
* [노드 모니터링 및 유지보수](/ko/operations-guide/11.3-node-monitoring-and-maintenance) — 모니터링 및 로깅
* [핵심 아키텍처](/ko/core-architecture/index) — StableNet 컴포넌트 개요
* [Anzeon WBFT 합의 프로토콜](/ko/consensus-and-block-production/4.1-anzeon-wbft-consensus-protocol) — 합의 프로토콜 상세