GRBL Usage Guide

How to check if an IP is listed, request delisting, and interact with the API via curl.

Checking an IP

Look up whether an IP address is listed in the RBL.

Via the Website

Go to rbl.gnoppix.org, enter the IPv4 address and click Lookup.

Via DNS Proxy (curl)

curl -s "https://rbl.gnoppix.org/dns-proxy?ip=1.234.56.78"

Rate-limited: 12 req/min, burst 10.

Response (listed)

{ "listed": true, "answers": ["127.0.0.2"] }

Response (not listed)

{ "listed": false, "answers": [] }

Delisting Flow

Request removal from the blocklist by proving domain ownership.

1

Enter IP & Domain

Go to the delist page and enter your listed IP and domain name (must match the PTR record). Click Request Challenge.

Alternatively, use curl:

curl -s -X POST https://rbl.gnoppix.org/api/delist/request \ -H "Content-Type: application/json" \ -d '{"ip": "1.2.3.4", "domain": "example.com"}'
2

Add TXT Record

Add the following TXT record to your DNS zone:

gnoppix-rbl.example.com TXT "a1b2c3d4e5f6g7h8"

Wait for DNS propagation (usually a few minutes).

3

Verify

Click Verify Now on the website, or use curl:

curl -s "https://rbl.gnoppix.org/api/delist/verify?ip=1.2.3.4"
{ "status": "delisted", "ip": "1.2.3.4", ... }
4

Probation

If verified successfully, the IP is removed and enters probation:

  • With valid PTR record: 14-day probation
  • Without PTR record: 30-day probation
  • If re-listed during probation, the IP is flagged as a repeat offender

Check Delist Status

curl -s "https://rbl.gnoppix.org/api/delist/status?ip=1.2.3.4"

Command Line (curl)

All API endpoints available via curl for scripting and automation.

Health Check

curl -s https://rbl.gnoppix.org/api/health

Lookup an IP

curl -s "https://rbl.gnoppix.org/dns-proxy?ip=1.234.56.78"

Request Delisting

curl -s -X POST https://rbl.gnoppix.org/api/delist/request \ -H "Content-Type: application/json" \ -d '{"ip": "1.2.3.4", "domain": "example.com"}'

Verify Delisting

curl -s "https://rbl.gnoppix.org/api/delist/verify?ip=1.2.3.4"

Check Delist Status

curl -s "https://rbl.gnoppix.org/api/delist/status?ip=1.2.3.4"

Direct DNS query (dig)

Query the RBL DNS server directly on port 53:

dig @104.218.52.140 -p 53 237.64.241.1.rbl.gnoppix.org +short # Expected output: 127.0.0.2 (if listed)