SLV RPC Skill
Ansible playbooks and Jinja2 templates for deploying and managing Solana RPC nodes (mainnet, testnet, devnet).
Supported RPC Types
| Type | Description |
|---|
| --- | --- |
RPC | Standard RPC node |
Index RPC | Full-index RPC node (with Old Faithful/yellowstone-faithful) |
Geyser gRPC | RPC with Geyser gRPC streaming |
Index RPC + gRPC | Full-index + gRPC streaming |
Directory Structure
ansible/
mainnet-rpc/ — Mainnet RPC playbooks
testnet-rpc/ — Testnet RPC playbooks
devnet-rpc/ — Devnet RPC playbooks
cmn/ — Shared common playbooks
jinja/
mainnet-rpc/ — Mainnet Jinja2 templates
testnet-rpc/ — Testnet Jinja2 templates
devnet-rpc/ — Devnet Jinja2 templates
cmn/ — Shared templates
CLI Command ↔ Playbook Mapping
The slv r CLI commands map directly to these playbooks. {net} = mainnet-rpc, testnet-rpc, or devnet-rpc.
| CLI Command | Playbook | Description |
|---|
| --- | --- | --- |
slv r deploy | {net}/init.yml | Full RPC node initialization and deployment |
slv r start | {net}/start_node.yml | Start RPC node |
slv r stop | {net}/stop_node.yml | Stop RPC node |
slv r restart | {net}/restart_node.yml | Restart RPC node |
slv r build:solana | {net}/install_solana.yml | Build Solana from source |
slv r install:solana | cmn/install_solana.yml | Install Solana binary (deprecated, prefer build) |
slv r setup:firedancer | {net}/setup_firedancer.yml | Setup Firedancer |
slv r update:firedancer | cmn/update_firedancer.yml | Update Firedancer binary |
slv r update:script | {net}/update_startup_config.yml | Update start-validator.sh from template |
slv r update:geyser | {net}/update_geyser.yml | Update Geyser plugin |
slv r get:snapshot | {net}/wget_snapshot.yml | Download snapshot via aria2c |
slv r cleanup | cmn/rm_ledger.yml | Remove ledger/snapshot files |
slv r list | (no playbook) | List RPC nodes (CLI only) |
slv r update:allowed-ips | (no playbook) | Update allowed IPs (CLI only) |
slv r init | (no playbook) | Interactive wizard (CLI only) |
All Playbooks
Mainnet RPC (mainnet-rpc/)
| Playbook | Description |
|---|
| --- | --- |
init.yml | Full RPC node initialization |
init_richat_geyser.yml | Initialize Richat Geyser configuration |
restart_node.yml | Restart RPC node |
start_node.yml | Start RPC node |
stop_node.yml | Stop RPC node |
install_solana.yml | Build Solana from source |
install_agave.yml | Build Agave from source |
install_jito.yml | Build Jito from source |
install_rust.yml | Install Rust toolchain |
install_package.yml | Install system packages |
install_richat.yml | Install Richat gRPC plugin |
install_of1.yml | Install Old Faithful (yellowstone-faithful) |
install_of1_service.yml | Setup Old Faithful systemd service |
geyser_build.yml | Build Yellowstone gRPC from source |
geyser_richat_build.yml | Build Richat gRPC plugin from source |
update_geyser.yml | Update Geyser plugin |
update_startup_config.yml | Update start-validator.sh from template |
update_ubuntu.yml | Update Ubuntu packages |
setup_firedancer.yml | Setup Firedancer for RPC |
setup-solv-service.yml | Setup systemd service |
start-solv-service.yml | Start systemd service |
setup_ufw.yml | Configure UFW firewall |
setup_logrotate.yml | Setup log rotation |
setup_norestart.yml | Disable auto-restart |
configure_hugetlbfs.yml | Configure hugepages for Firedancer |
fail2ban_solana_rate_limit.yml | Setup fail2ban rate limiting |
fail2ban_sshd.yml | Setup fail2ban for SSH |
allow_ufw.yml | Add UFW allow rules |
add_solv.yml | Add solv user |
copy_keys.yml | Copy node keys |
create-start-validator-sh.yml | Generate start script from template |
create-symlink.yml | Create version symlinks |
mount_disks.yml | Mount and format disks |
optimize_system.yml | Optimize system settings |
run_restarter.yml | Run restarter script |
run_snapshot_finder.yml | Find and download best snapshot |
Testnet RPC (testnet-rpc/)
| Playbook | Description |
|---|
| --- | --- |
init.yml | Full testnet RPC initialization |
restart_node.yml | Restart node |
start_node.yml / stop_node.yml | Start/stop node |
install_solana.yml | Build Solana from source |
install_agave.yml / install_jito.yml | Build client from source |
install_richat.yml | Install Richat plugin |
geyser_build.yml | Build Yellowstone gRPC |
geyser_richat_build.yml | Build Richat plugin from source |
update_geyser.yml | Update Geyser plugin |
update_firedancer.yml | Update Firedancer |
update_startup_config.yml | Update start script |
setup_firedancer.yml | Setup Firedancer |
setup_solv_service.yml | Setup systemd service |
create-start-validator-sh.yml | Generate start script |
wget_snapshot.yml | Download snapshot |
Devnet RPC (devnet-rpc/)
| Playbook | Description |
|---|
| --- | --- |
init.yml | Full devnet RPC initialization |
restart_node.yml | Restart node |
start_node.yml / stop_node.yml | Start/stop node |
install_solana.yml | Build Solana from source |
install_agave.yml / install_jito.yml | Build client from source |
install_richat.yml | Install Richat plugin |
geyser_build.yml | Build Yellowstone gRPC |
geyser_richat_build.yml | Build Richat plugin from source |
update_geyser.yml | Update Geyser plugin |
update_startup_config.yml | Update start script |
setup_firedancer.yml | Setup Firedancer |
setup_solv_service.yml | Setup systemd service |
create-start-validator-sh.yml | Generate start script |
Shared Common (cmn/)
| Playbook | Description |
|---|
| --- | --- |
build_solana.yml | Build Solana from source (dispatches to build_agave/build_jito) |
build_agave.yml | Build Agave from GitHub source |
build_jito.yml | Build Jito from GitHub source |
install_solana.yml | Install Solana binary (deprecated) |
install_package.yml | Install system packages |
install_rust.yml | Install Rust toolchain |
mount_disks.yml / mount-disks.yml | Mount and format disks |
optimize_system.yml | Optimize system settings |
disable_swap.yml | Disable swap |
setup_logrotate.yml | Configure log rotation |
setup_node_exporter.yml | Setup Prometheus node exporter |
setup_norestart.yml | Disable auto-restart |
setup_unstaked_identity.yml | Setup unstaked identity keypair |
restart_solv.yml | Restart solv service |
start_solv.yml / stop_solv.yml | Start/stop solv service |
start_firedancer.yml / stop_firedancer.yml | Start/stop Firedancer |
copy_restart_sh.yml | Copy restarter script |
copy_rpc_keys.yml | Copy RPC keys |
update_ubuntu.yml | Update Ubuntu packages |
wget_snapshot.yml | Download snapshot |
add_solv.yml | Add solv user |
fix_permissions.yml | Fix file permissions |
Key Variables (extra_vars)
| Variable | Description | Default |
|---|
| --- | --- | --- |
rpc_type | RPC node type (RPC, Index RPC, Geyser gRPC, Index RPC + gRPC) | RPC |
validator_type | Client type (agave, jito, firedancer-agave, firedancer-jito) | — |
solana_version | Solana/Agave version | — |
jito_version | Jito version | — |
firedancer_version | Firedancer version | — |
yellowstone_grpc_version | Yellowstone gRPC version | — |
richat_version | Richat plugin version (e.g. richat-v8.1.0) | — |
snapshot_url | Snapshot download URL | — |
tpu_peer_address | TPU peer address (for Index RPC transaction forwarding) | — |
limit_ledger_size | Ledger size limit | 200000000 (Index), 100000000 (others) |
dynamic_port_range | Port range | 8000-8025 |
port_rpc | RPC port | 8899 |
port_grpc | gRPC port | 10000 |
Geyser Plugin Sources
Both plugins are built from source (no binary downloads):
- Yellowstone gRPC: https://github.com/rpcpool/yellowstone-grpc
- Richat: https://github.com/lamports-dev/richat
Usage
ansible-playbook -i inventory mainnet-rpc/init.yml \
-e '{"rpc_type":"Index RPC","solana_version":"3.1.8","snapshot_url":"https://..."}'
No versions.yml required — all variables can be passed via extra_vars.
Interactive Deployment Flow
See AGENT.md for the full step-by-step flow and examples/inventory.yml for output format.
Required Variables
| Variable | Prompt | Validation |
|---|
| --- | --- | --- |
server_ip | "Target server IP?" | Valid IPv4 |
network | "mainnet, testnet, or devnet?" | mainnet, testnet, devnet |
region | "Server region?" | String |
rpc_type | "RPC type?" | RPC, Index RPC, Geyser gRPC, Index RPC + gRPC |
validator_type | "Underlying client?" | agave, jito, jito-bam, firedancer-agave |
solana_version | "Solana version? (default: 3.1.8)" | Semver |
identity_account | "Node identity pubkey?" | Base58 pubkey |
snapshot_url | "Snapshot URL? (auto for ERPC)" | URL (cannot be empty for init) |
Conditionally Required Variables
| Variable | Default | When Required |
|---|
| --- | --- | --- |
jito_version | Matches solana_version | jito/jito-bam types |
firedancer_version | — | firedancer types |
yellowstone_grpc_version | — | Yellowstone gRPC plugin |
richat_version | — | Richat plugin |
of1_version | — | Index RPC (Old Faithful) |
epoch | — | Index RPC (faithful service) |
faithful_proxy_target_url | — | Index RPC |
Optional Variables
| Variable | Default | When Required |
|---|
| --- | --- | --- |
ssh_user | solv | Always |
port_rpc | 8899 (ERPC: 7211) | Always |
limit_ledger_size | 100000000 | Always |
dynamic_port_range | 8000-8025 | Always |
port_grpc | 10000 | gRPC types only |
tpu_peer_address | — | Index RPC (tx forwarding) |
allowed_ssh_ips | — | Strongly recommended (UFW) |
allowed_ips | — | Optional (UFW) |
expected_shred_version | Epoch-dependent | Testnet only |
Optional: Reference RPC
| Variable | Description | Default |
|---|
| --- | --- | --- |
reference_rpc_url | Reference RPC endpoint for slot sync comparison (e.g., ERPC) | — |
ERPC API keys are free at https://erpc.global — enables full slot sync monitoring during deployment and updates.
Pre-flight: Fresh Server Setup
ansible-playbook -i inventory.yml cmn/add_solv.yml \
-e '{"ansible_user":"ubuntu"}' --become
Deployment Command
All paths relative to skill's ansible/ directory:
cd /path/to/slv-rpc/ansible/
ansible-playbook -i inventory.yml {network}-rpc/init.yml \
-e '{"rpc_type":"<type>","solana_version":"<version>"}'