Skip to content

Getting Started

Zephyr is a self-hosted Solana trading terminal. It runs as a single binary on your machine — no third-party dashboard, no shared infrastructure.

Requirements

  • Linux VPS (Ubuntu recommended)
  • Solana RPC endpoint (Helius recommended)
  • Yellowstone gRPC endpoint (Helius LaserStream or Shyft)

Quick Start

1. Download

bash
curl -O https://releases.solanazephyr.com/releases/latest/zephyr
chmod +x zephyr

2. Configure

Create a config.toml file in the same directory as the binary. Copy the full example from the Configuration page and fill in your details:

  • private_key — your wallet's base58-encoded private key
  • rpc_url — your Solana RPC endpoint
  • grpc_url / grpc_token — your Yellowstone gRPC credentials
  • access_code — password for the web UI (leave empty to disable)
  • Enable the processors you have access to and add their API keys/auth tokens
bash
./zephyr --generate-nonces 40

Creates 40 nonce accounts on-chain (~0.056 SOL rent, reclaimable). Reduces wasted transaction fees when multiple processors are enabled.

4. Run

bash
./zephyr

Open http://your-server-ip:8080 in your browser. Access is protected by the access_code you set in config.toml.

Two Front-Ends

Zephyr ships with two front-ends that share the same backend:

  • Built-in terminal — served at http://localhost:8080. Full trading terminal with live chart. Navigate to TRADE, WRAP, or SETTINGS pages.
  • Browser extension — floating widget that injects on axiom.trade, gmgn.ai, and trade.padre.gg. Same commands, same state. See Extension Setup.

Both are fully interchangeable — use whichever you prefer.