GeoIP & DNS

GEOIP performs IP geolocation using the MaxMind GeoLite2 database. In site mode the visitor’s IP is automatically available. DNS queries any record type for any domain using the system resolver.

GEOIP

Verb	Returns
`GEOIP ADDRESS SET ?ip`	Visitor’s IP address string
`GEOIP CITY SET ?city`	City name
`GEOIP COUNTRY SET ?country`	Country name
`GEOIP REGION SET ?region`	State / province
`GEOIP LAT SET ?lat`	Latitude (number)
`GEOIP LON SET ?lon`	Longitude (number) — `LNG` accepted as alias
`GEOIP ALL SET ?geo`	Full object: {ip, city, country, region, lat, lon}
`GEOIP "1.2.3.4" SET ?geo`	Look up a specific IP — returns the full object

Client IP — in site mode

GEOIP ADDRESS SET ?ip
AFTER GEOIP CITY    SET ?city
AFTER GEOIP COUNTRY SET ?country
AFTER EMIT ?ip & " — " & ?city & ", " & ?country

Full geo object

GEOIP ALL SET ?geo
AFTER EMIT ?geo

Look up a specific IP

GEOIP "8.8.8.8" SET ?geo
AFTER EMIT ?geo("city") & ", " & ?geo("country")
AFTER EMIT ?geo("lat") & " / " & ?geo("lon")

Ocalt Nameservers

Pointing a domain at Ocalt normally means editing an A record at whoever provides your DNS. If you own a domain but have no DNS service at all — no provider, no zone to edit — Ocalt runs nameservers you can delegate the whole domain to instead.

Nameserver
`dns1.ocalt.com`
`dns2.ocalt.com`

Set those as your domain’s nameservers at your registrar. Nothing else is required: the zone is created and served by Ocalt, and it resolves to 41.61.20.37. Once delegation propagates, DOMAIN "tld.com" TO "subdomain.ocalt.site" succeeds — see Subdomains, Site Mode & Hosting.

These nameservers are closed. They serve Ocalt-hosted domains and nothing else — they are not a general-purpose DNS host, and they are not a public resolver. There are no arbitrary records to manage: a domain delegated here resolves to Ocalt, which is the whole job. If you need MX, TXT or arbitrary record control, keep your own DNS provider and use an A record instead.

Check Delegation Took Effect

DNS "tld.com" AS "NS" SET ?ns
AFTER EMIT ?ns
AFTER DNS "tld.com" AS "A" SET ?a
AFTER EMIT ?a
(* NS should list dns1.ocalt.com and dns2.ocalt.com; A should be 41.61.20.37 *)

DNS

Query any DNS record type for any domain. Returns structured results with name, ttl, type, and value. Uses the system resolver.

Verb	Description
`DNS "domain" SET ?r`	Query A records (default)
`DNS "domain" AS "A" SET ?r`	IPv4 address records
`DNS "domain" AS "AAAA" SET ?r`	IPv6 address records
`DNS "domain" AS "MX" SET ?r`	Mail exchange records
`DNS "domain" AS "TXT" SET ?r`	Text records (SPF, DKIM, etc.)
`DNS "domain" AS "CNAME" SET ?r`	Canonical name records
`DNS "domain" AS "NS" SET ?r`	Nameserver records
`DNS "domain" AS "SOA" SET ?r`	Start of authority record
`DNS "domain" AS "ALL" SET ?r`	All record types at once

A record lookup

DNS "ocalt.com" AS "A" SET ?r
AFTER EMIT ?r

Mail and TXT records

DNS "ocalt.com" AS "MX" SET ?r
AFTER EMIT ?r

DNS "ocalt.com" AS "TXT" SET ?r
AFTER EMIT ?r