geo

geo estimates the location and network ownership of a public IP through a remote provider or, when available, a local GeoIP database.

NetworkVersion 1.2.3Stable
lil-terminal

Overview

Use geo for IP geolocation and network ownership. Common operations stay short; specialized forms add detail only when needed, so repeated work remains easy to understand, repeat and place in lil-terminal scripts.

IP geolocation is context, not identity

Public IP geolocation can be shifted by VPNs, proxies, mobile networks, CDNs and provider routing. -local avoids the remote lookup, but only works when the hosting environment provides a compatible GeoIP extension and database.

Syntax

lil-terminal
geo [host|ip|me] [options]

Reference

geo

show provider and local GeoIP status

geo me

use the current visitor address

geo 8.8.8.8

show a brief IP location and network summary

geo example.com -a

show all available location and network fields

geo -db

show local GeoIP database details

-c

show country and continent

-r

show region, city, postal code and coordinates

-tz

show timezone details

-asn | -isp | -org | -dom

show selected network details

-type

show the IP family

-json

show the provider response as formatted JSON

-4 | -6

resolve a hostname through IPv4 or IPv6

-local

use the local GeoIP extension only

Interactive sandbox preview

Run the prepared examples directly on the page. Their results are prebuilt and shown in the browser; no terminal command is executed on the server.

Check the provider, then inspect an IP

Install and manage

Install the current compatible version. Choose Base for the complete feature set or Minimum for the reduced package; use upgrade to update a module that is already installed.

Base and Minimum are two packages of the same current module release, not separate command versions.

Base package

Install the complete package with local command reference and every published mode.

install geo
Minimum package

Install the reduced package. Local reference is omitted; help <cmd> -i opens the current server reference.

install geo -m
Exact public version

Install exactly this published version.

install geo -v 1.2.3
Check or update

Ask upgrade to check compatibility and replace the installed block only when needed.

upgrade geo
Remove module

Remove the extension block while leaving the core and unrelated modules intact.

install geo -u

Examples

Examples are copyable command lines, not actions executed by this website. Review paths, permissions and destructive flags before running them on a real project.

Check the provider, then inspect an IP
geo | geo 8.8.8.8
Remote       ipwho.is
HTTPS        yes
Local GeoIP  no

IP       8.8.8.8
Source   ipwho.is
Type     IPv4
Country  United States (US)
Region   California
City     Mountain View
Show a brief IP location and network summary
geo 8.8.8.8
IP       8.8.8.8
Source   ipwho.is
Type     IPv4
Country  United States (US)
Region   California
City     Mountain View
Show all available location and network fields
geo example.com -a
Target        example.com
IP            93.184.216.34
Country       United States (US)
Region        California
City          Los Angeles
Coordinates   34.05, -118.24
ASN           AS15133
ISP           Example Network
Organization  Example Inc.
Show country and continent
geo example.com -c -r
Country      United States (US)
Region       California
City         Los Angeles
Postal code  90001
Coordinates  34.05, -118.24
Show selected network details
geo example.com -asn -isp -org
Target        example.com
IP            93.184.216.34
Country       United States (US)
Region        California
City          Los Angeles
Coordinates   34.05, -118.24
ASN           AS15133
ISP           Example Network
Organization  Example Inc.
Show the provider response as formatted JSON
geo example.com -json
{
  \"ip\": \"93.184.216.34\",
  \"country\": \"US\",
  \"asn\": \"AS15133\"
}
Show local GeoIP database details
geo -db
Local GeoIP database unavailable
Reject an address without public geolocation
geo 127.0.0.1
Public IP address required

Related documentation

What network diagnostics are available? →What if repo.lil.dog is unavailable? →

Current public release

v1.2.32026-08-10

Language synchronization

Finalizes Local and Server Help synchronization and localization safety for geo.

# Version history