Skip to content

Commit 15cdc23

Browse files
add instructions on how to download GeoLite2ASN data
1 parent 5e68a3a commit 15cdc23

File tree

1 file changed

+22
-0
lines changed

1 file changed

+22
-0
lines changed

README.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,3 +33,25 @@ Check that it was installed correctly with:
3333
```shell
3434
zannotate --help
3535
```
36+
37+
# Acquiring Datasets
38+
39+
> [!NOTE]
40+
> URLs and instructions may change over time. These are up-to-date as of September 2025.
41+
42+
Below are instructions for getting datasets from the below providers.
43+
44+
### GeoLite2-ASN
45+
1. [Sign-up form](https://www.maxmind.com/en/geolite2/signup) for MaxMind GeoLite Access
46+
2. Login to your account
47+
3. Go to the "GeoIP / GeoLite" > "Download files" section where you should see a list of available databases
48+
4. Download the `.mmdb` files for GeoLite ASN
49+
5. Unzip the downloaded file and test with:
50+
51+
```shell
52+
echo "1.1.1.1" | zannotate --geoasn --geoasn-database=/path-to-downloaded-file/GeoLite2-ASN_20250923/GeoLite2-ASN.mmdb
53+
```
54+
55+
```shell
56+
{"ip":"1.1.1.1","geoasn":{"asn":13335,"org":"CLOUDFLARENET"}}
57+
```

0 commit comments

Comments
 (0)