Back to Dashboard

Installation Guide

Deploying your own secure RentOps infrastructure.

Why Self-Host?

RentOps interacts with your wallet's private keys to reclaim rent. Running the infrastructure on your own machine or private server ensures maximum security. Your keys never leave your control.

01. Preparation

Before we touch any code, let's get the keys you'll need.

A. Get a Solana RPC Key

We use Helius to scan the blockchain. Their free tier is generous and perfect for RentOps.

  1. Go to dev.helius.xyz and sign up.
  2. On the Dashboard, look for "API Key".
  3. Copy this key. It starts with a UUID like 4f9a....

B. (Optional) Get a Telegram Bot Token

If you want mobile alerts for rent detection:

  1. Open Telegram and search for @BotFather.
  2. Send the message /newbot.
  3. Follow the prompts to name your bot (e.g., "MyRentOpsBot").
  4. BotFather will give you a token like 123456:ABC-DEF.... Copy this.

02. Setup

Clone the Repository

Open your terminal and run:

git clone https://github.com/rentops/ui.git rentops
cd rentops

Install Dependencies

We use pnpm for speed, but npm works too.

npm install -g pnpm
pnpm install

03. Configuration

Create a secret environment file to store your keys.

cp .env.example .env

Open .env in your text editor and fill in the blanks:

# .env file

HELIUS_RPC_API_KEY=your_helius_key_here

// Paste the key from Step 1A

TELEGRAM_BOT_TOKEN=your_bot_token_here

// Paste the token from Step 1B

04. Launch

Run Locally

Start the dashboard on your machine:

pnpm dev

Open your browser to http://localhost:3000.

Deploy to Production (Vercel)

To keep the bot running 24/7 without your laptop:

  1. Install Vercel CLI: npm i -g vercel
  2. Login: vercel login
  3. Deploy: vercel deploy --prod
  4. Go to your Vercel Dashboard -> Settings -> Environment Variables and add your keys there.