> For the complete documentation index, see [llms.txt](https://satuchain.gitbook.io/satuchain-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://satuchain.gitbook.io/satuchain-docs/developer/run-node-testnet.md).

# Run Node Testnet

## Run a SATUCHAIN Node (Testnet) — RPC Node

This guide sets up a **SATUCHAIN Testnet RPC node** on a Linux server (Ubuntu recommended). It covers install, run, and basic health checks.

SATUCHAIN Testnet\
RPC: [https://rpc-testnet.satuchain.com](https://rpc-testnet.satuchain.com/)\
Chain ID: 17081945

***

### 1) Server Requirements

Minimum (testnet / light usage)

* CPU: 4 vCPU
* RAM: 8 GB
* Disk: 200 GB SSD
* OS: Ubuntu 22.04

Recommended (stable RPC)

* CPU: 8 vCPU
* RAM: 16–32 GB
* Disk: 500 GB+ NVMe SSD

***

### 2) Install System Packages

```bash
sudo apt update && sudo apt -y upgrade
sudo apt -y install curl wget jq unzip ca-certificates gnupg lsb-release
```

***

### 3) Create a Dedicated User

```bash
sudo useradd -r -m -s /bin/bash satuchain
sudo mkdir -p /var/lib/satuchain
sudo chown -R satuchain:satuchain /var/lib/satuchain
```

***

### 4) Download Node Binary

Replace the URL below with your official release link (Linux amd64).\
(If you already have the binary name, keep it consistent.)

```bash
sudo -u satuchain bash -c '
cd /home/satuchain
wget -O satuchain-node.tar.gz <YOUR_NODE_RELEASE_URL>
tar -xzf satuchain-node.tar.gz
chmod +x satuchain
'
```

Move binary to PATH:

```bash
sudo mv /home/satuchain/satuchain /usr/local/bin/satuchain
sudo chmod +x /usr/local/bin/satuchain
```

Check:

```bash
satuchain --version
```

***

### 5) Create a Node Config Directory

```bash
sudo -u satuchain mkdir -p /var/lib/satuchain/data
```

***

### 6) Run the Node (Testnet)

Example command (standard RPC + WS). Adjust flags to match your node client:

```bash
sudo -u satuchain /usr/local/bin/satuchain \
  --network testnet \
  --datadir /var/lib/satuchain/data \
  --http --http.addr 0.0.0.0 --http.port 8545 \
  --ws --ws.addr 0.0.0.0 --ws.port 8546
```

If your node requires bootnodes / seeds / genesis, add the flags from your SATUCHAIN release notes.

***

### 7) Run as a Service (systemd)

Create file:

```bash
sudo nano /etc/systemd/system/satuchain.service
```

Paste:

```ini
[Unit]
Description=SATUCHAIN Node (Testnet)
After=network-online.target
Wants=network-online.target

[Service]
User=satuchain
Group=satuchain
Type=simple
Restart=always
RestartSec=3
LimitNOFILE=1048576

ExecStart=/usr/local/bin/satuchain \
  --network testnet \
  --datadir /var/lib/satuchain/data \
  --http --http.addr 0.0.0.0 --http.port 8545 \
  --ws --ws.addr 0.0.0.0 --ws.port 8546

WorkingDirectory=/var/lib/satuchain
Environment=NODE_ENV=production

[Install]
WantedBy=multi-user.target
```

Enable + start:

```bash
sudo systemctl daemon-reload
sudo systemctl enable satuchain
sudo systemctl start satuchain
```

Logs:

```bash
sudo journalctl -u satuchain -f --no-pager
```

***

### 8) Basic Health Checks

Check block number:

```bash
curl -s -X POST http://127.0.0.1:8545 \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}' | jq
```

Check chain ID:

```bash
curl -s -X POST http://127.0.0.1:8545 \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}' | jq
```

Expected chain ID (hex) for 17081945 is:

* `0x104a4e9`

***

### 9) Secure Your RPC (Required)

Do not expose `8545/8546` publicly without protection.

Minimum firewall example (allow only your IP):

```bash
sudo ufw allow OpenSSH
sudo ufw allow from <YOUR_PUBLIC_IP> to any port 8545
sudo ufw allow from <YOUR_PUBLIC_IP> to any port 8546
sudo ufw enable
```

***

### 10) Update the Node

When a new release is published:

* Stop service
* Replace binary
* Start service again

```bash
sudo systemctl stop satuchain
# replace /usr/local/bin/satuchain
sudo systemctl start satuchain
```

***