? What is Grass?

Grass is a decentralized data network built on Solana. It works by routing web requests through your node — essentially sharing your unused internet bandwidth to help collect public web data for AI training.

In return, you earn Grass points which convert to $GRASS tokens at airdrop time. Season 1 distributed tokens to early participants, and Season 2 is currently active.

The key thing: your node acts as a relay for encrypted data packets. Grass cannot see your personal data or activity — it only uses your IP address to relay public web requests.

1 Requirements

Grass is one of the lightest nodes you can run. Minimum requirements:

• OS
  Ubuntu 20.04 or 22.04 LTS (recommended) — also works on Windows/Mac for desktop use
• 💻
  1 CPU core, 1GB RAM, 10GB storage — very lightweight, can share a VPS with other nodes
• 🌐
  Residential IP strongly recommended — datacenter IPs earn significantly fewer points. Home internet is ideal. VPS + residential proxy works well for 24/7 uptime.
• 🐳
  Docker — for the VPS/headless setup method (we'll install this below)
• 👛
  Solana wallet — Phantom or Solflare recommended. You'll connect this to your Grass account for airdrop eligibility.

2 Create Your Grass Account

First, register at the Grass website. Using a referral link gives you a small bonus on signup.

• 1
  Go to app.grass.io and register with your email and create a password
• 2
  Verify your email — check your inbox for the confirmation link
• 3
  Connect your Solana wallet — go to Settings → Wallet and connect Phantom or Solflare. This is required for airdrop eligibility.
• 4
  Note your User ID — you'll need this for the VPS setup. Find it in your dashboard or via browser dev tools (F12 → Application → Local Storage → grass link)

3 Option A — Desktop / Home Internet Setup

If you're running Grass on your home PC or Mac, this is the easiest method and earns the most points since you're using a residential IP.

• 1
  Download the Grass desktop app from app.grass.io — available for Windows, Mac, and Linux
• 2
  Install and log in with your Grass account credentials
• 3
  Click Connect — your node will start automatically and begin earning points. That's it!
• 4
  Keep it running — earnings are based on uptime. Leave it running in the background 24/7 for maximum points.

4 Option B — VPS / Headless Setup (24/7)

For 24/7 uptime without leaving your PC on, run Grass on a VPS using Docker. Remember — you'll need a residential proxy to earn meaningful points on a datacenter IP.

Step 1 — Update your VPS and install Docker:

sudo apt update && sudo apt upgrade -y
sudo apt install docker.io -y
sudo systemctl enable docker
sudo systemctl start docker

Step 2 — Pull and run the Grass Docker image:

sudo docker run -d \
  --name grass-node \
  --restart unless-stopped \
  -e GRASS_USER_ID=YOUR_USER_ID \
  -e DISPLAY=:99 \
  ghcr.io/mrcolorrain/grass:latest

Step 3 — Check your node is running:

sudo docker logs grass-node --tail 50

Step 4 — Verify in your dashboard: Log into app.grass.io and check that your node shows as connected. It may take a few minutes to appear.

5 Useful Commands

Stop your node:

sudo docker stop grass-node

Restart your node:

sudo docker restart grass-node

Update to latest version:

sudo docker pull ghcr.io/mrcolorrain/grass:latest
sudo docker stop grass-node && sudo docker rm grass-node
# then re-run the original docker run command

6 Tips to Maximise Earnings

7 Season 2 Airdrop Info

Grass Season 2 is currently live and accumulating points for the next distribution. Here's what we know:

• ✓
  Season 1 was real — $GRASS tokens were distributed to participants. The project has delivered on its promises.
• 📊
  Points → Tokens — your accumulated Grass points will convert to $GRASS tokens at distribution. Higher uptime = more points = more tokens.
• 👛
  Connect your wallet now — make sure your Solana wallet is connected to your Grass account before the snapshot. Don't leave this until last minute.
• 📢
  Follow official channels — @getgrass_io on X for Season 2 snapshot and TGE announcements.