maurosoft1973/alpine-maxmind-geolite

By maurosoft1973

•Updated 6 months ago

Docker MaxMind GeoLite 2 image running on Alpine Linux

Image

10K+

Overview Tags

maurosoft1973/alpine-maxmind-geolite repository overview

⁠Docker MaxMind GeoLite 2 image running on Alpine Linux

The Docker images (maurosoft1973/alpine-maxmind-geolite)⁠ is based on the minimal Alpine Linux⁠.

⁠Alpine Version 3.21.0

⁠MaxMind GeoLite 2 Database Version 20260116 (Released 2026-01-16)

⁠Description

This image contains small rest application, write in go, for return the Geo Info for ip address.

The endpoint available:

⁠/:ip

⁠Return Geo IP Info

URL : /:ip/

URL Parameters : ip=[varchar] where ip is the ip address (v4)

Method : GET

Auth required : NO

⁠Success Response

Condition : If ip exist on database.

Code : 200 OK

Response example

{
 "City": {
     "GeoNameID": 3176959,
     "Names": {
       "de": "Florenz",
       "en": "Florence",
       "es": "Florencia",
       "fr": "Florence",
       "ja": "フィレンツェ",
       "pt-BR": "Florença",
       "ru": "Флоренция",
       "zh-CN": "佛罗伦萨"
     }
   },
   "Continent": {
     "Code": "EU",
     "GeoNameID": 6255148,
     "Names": {
       "de": "Europa",
       "en": "Europe",
       "es": "Europa",
       "fr": "Europe",
       "ja": "ヨーロッパ",
       "pt-BR": "Europa",
       "ru": "Европа",
       "zh-CN": "欧洲"
     }
   },
   "Country": {
     "GeoNameID": 3175395,
     "IsInEuropeanUnion": true,
     "IsoCode": "IT",
     "Names": {
       "de": "Italien",
       "en": "Italy",
       "es": "Italia",
       "fr": "Italie",
       "ja": "イタリア共和国",
       "pt-BR": "Itália",
       "ru": "Италия",
       "zh-CN": "意大利"
     }
   },
   "Location": {
     "AccuracyRadius": 50,
     "Latitude": 43.7686,
     "Longitude": 11.2509,
     "MetroCode": 0,
     "TimeZone": "Europe/Rome"
   },
   "Postal": {
     "Code": "50125"
   },
   "RegisteredCountry": {
     "GeoNameID": 3175395,
     "IsInEuropeanUnion": true,
     "IsoCode": "IT",
     "Names": {
       "de": "Italien",
       "en": "Italy",
       "es": "Italia",
       "fr": "Italie",
       "ja": "イタリア共和国",
       "pt-BR": "Itália",
       "ru": "Италия",
       "zh-CN": "意大利"
     }
   },
   "RepresentedCountry": {
     "GeoNameID": 0,
     "IsInEuropeanUnion": false,
     "IsoCode": "",
     "Names": null,
     "Type": ""
   },
   "Subdivisions": [
     {
       "GeoNameID": 3165361,
       "IsoCode": "52",
       "Names": {
         "de": "Toskana",
         "en": "Tuscany",
         "es": "Toscana",
         "fr": "Toscane",
         "ja": "トスカーナ州",
         "pt-BR": "Toscana",
         "ru": "Тоскана",
         "zh-CN": "托斯卡纳"
       }
     },
     {
       "GeoNameID": 3176958,
       "IsoCode": "FI",
       "Names": {
         "de": "Florenz",
         "en": "Province of Florence",
         "es": "Florencia",
         "fr": "Florence",
         "pt-BR": "Florença"
       }
     }
   ],
   "Traits": {
     "IsAnonymousProxy": false,
     "IsSatelliteProvider": false
   }
}

⁠/myip

⁠Return the remote ip address

URL : /myip/

URL Parameters : NO

Method : GET

Auth required : NO

⁠Success Response

Code : 200 OK

Response example

88.49.36.133

⁠Architectures

:aarch64 - 64 bit ARM
:armhf - 32 bit ARM v6
:armv7 - 32 bit ARM v7
:ppc64le - 64 bit PowerPC
:x86_64 - 64 bit Intel/AMD (x86_64/amd64)

⁠Tags

:latest latest branch based (Automatic Architecture Selection)
:aarch64 latest 64 bit ARM
:armhf latest 32 bit ARM v6
:armv7 latest 32 bit ARM v7
:ppc64le latest 64 bit PowerPC
:x86_64 latest 64 bit Intel/AMD
:test test branch based (Automatic Architecture Selection)
:test-aarch64 test 64 bit ARM
:test-armhf test 32 bit ARM v6
:test-armv7 test 32 bit ARM v7
:test-ppc64le test 64 bit PowerPC
:test-x86_64 test 64 bit Intel/AMD
:3.21.0 3.21.0 branch based (Automatic Architecture Selection)
:3.21.0-aarch64 3.21.0 64 bit ARM
:3.21.0-armhf 3.21.0 32 bit ARM v6
:3.21.0-armv7 3.21.0 32 bit ARM v7
:3.21.0-ppc64le 3.21.0 64 bit PowerPC
:3.21.0-x86_64 3.21.0 64 bit Intel/AMD
:3.21.0-20260116 3.21.0-20260116 branch based (Automatic Architecture Selection)
:3.21.0-20260116-aarch64 3.21.0 64 bit ARM
:3.21.0-20260116-armhf 3.21.0 32 bit ARM v6
:3.21.0-20260116-armv7 3.21.0 32 bit ARM v7
:3.21.0-20260116-ppc64le 3.21.0 64 bit PowerPC
:3.21.0-20260116-x86_64 3.21.0 64 bit Intel/AMD

⁠Layers & Sizes

Version	Size

⁠Environment Variables:

⁠Main MaxMind GeoLite 2 parameters:

LC_ALL: set locale (default en_GB.UTF-8)
TIMEZONE: set timezone (default Europe/Brussels)
LISTEN_IP: set listen ip (default 0.0.0.0 -> all)
LISTEN_PORT: set listen port (default 3001)

⁠List of locale Sets

When setting locale LC_ALL, also make sure to choose a locale otherwise it will be the default (en_GB.UTF-8).

+-----------------+
| Locale          |
+-----------------+
| fr_CH.UTF-8     |
| fr_FR.UTF-8     |
| de_CH.UTF-8     |
| de_DE.UTF-8     |
| en_GB.UTF-8     |
| en_US.UTF-8     |
| es_ES.UTF-8     |
| it_CH.UTF-8     |
| it_IT.UTF-8     |
| nb_NO.UTF-8     |
| nl_NL.UTF-8     |
| pt_PT.UTF-8     |
| pt_BR.UTF-8     |
| ru_RU.UTF-8     |
| sv_SE.UTF-8     |
+-----------------+

⁠Example of use

⁠1. Create Container with default parameters

docker run -d --name alpine-maxmind-geo -p 3001:3001 maurosoft1973/alpine-maxmind-geolite

curl http://localhost:3001/8.8.8.8
curl http://localhost:3001/myip

⁠2. Create Container with custom listen port (9002)

docker run -d --name alpine-maxmind-geo -p 9002:9002 -e LISTEN_PORT=9002 maurosoft1973/alpine-maxmind-geolite

curl http://localhost:9002/8.8.8.8
curl http://localhost:9002/myip

⁠Last Update 19.01.2026 05:21:36

Tag summary

Recent tags

Content type

Image

Digest

sha256:a4cb44a64…

Size

39.1 MB

Last updated

6 months ago

docker pull maurosoft1973/alpine-maxmind-geolite:20260116