---
title: "Deploy geoip-api"
description: "A self-hosted IP Geo API and Python package that works completely offline!"
category: "Other"
url: https://railway.com/deploy/6zn6HZ
---
# Deploy geoip-api
A self-hosted IP Geo API and Python package that works completely offline!
**[Deploy geoip-api on Railway](https://railway.com/template/6zn6HZ)**
- **Creator:** Malith Rukshan's Projects
- **Category:** Other
- **Total deploys:** 4
## Template content
### malithrukshan/geoip-api
- **Image:** malithrukshan/geoip-api
- **Health check:** http://localhost:8000/api/v1/geoip/lookup/8.8.8.8
- **Public domain:** Yes
## Documentation
GeoIP API
[](https://fastapi.tiangolo.com/)
[](https://hub.docker.com/r/malithrukshan/geoip-api)
✨ A self-hosted REST API for IP geolocation that works completely offline! 🚀
- Deploy your own private GeoIP service with complete control over your data and infrastructure -
Powered by MaxMind's GeoLite2 databases ツ
---
---
## ✨ Features
- 🌍 Fast and reliable IP geolocation lookups via a REST API
- 🔒 Self-hosted solution with no external API dependencies
- 🐳 Easy deployment with Docker and cloud platforms
- 📊 Get country, city, coordinates, timezone, ISP, and ASN data
- 🎨 Beautiful, interactive demo UI for testing available at the root endpoint
- 🚀 Built with FastAPI for high performance
- 📦 Automatic GeoLite2 database downloads and updates
## 🛠️ Usage
The GeoIP API provides simple endpoints to perform IP lookups.
### REST API Endpoints
```
# Simple path parameter
[https://your-domain.com/8.8.8.8](https://your-domain.com/8.8.8.8)
# Query parameter
[https://your-domain.com/?ip=8.8.8.8](https://your-domain.com/?ip=8.8.8.8)
```
#### Standard API Endpoint
```
[https://your-domain.com/api/v1/geoip/lookup/8.8.8.8](https://your-domain.com/api/v1/geoip/lookup/8.8.8.8)
````
#### Response Format
```json
{
"ip": "8.8.8.8",
"code": "US",
"country": "United States",
"city": "Mountain View",
"lat": 37.4056,
"lon": -122.0775,
"tz": "America/Los_Angeles",
"isp": "Google LLC",
"asn": 15169
}
````
## 📦 Deployment Options
### 🚀 Cloud Deployment
One-click deployment to popular platforms, ideal for quickly getting your own instance running:
[](https://railway.app/template/geoip-api)
[](https://heroku.com/deploy)
[](https://app.netlify.com/start/deploy?repository=https://github.com/Malith-Rukshan/geoip-api)
[](https://render.com/deploy?repo=https://github.com/Malith-Rukshan/geoip-api)
## 🌐 Use Cases
- **Security & Compliance**: Enhance security systems with IP-based threat detection while maintaining data sovereignty
- **Content Localization**: Deliver region-specific content based on visitor location without sharing user data
- **Analytics**: Analyze traffic patterns and user demographics with geographic data that remains within your infrastructure
- **Fraud Prevention**: Identify suspicious login attempts based on geographic anomalies
- **Development Environment**: Use a local GeoIP service in your development environment without external API dependencies
## 📜 License
This project is licensed under the MIT License - see the [LICENSE](https://www.google.com/search?q=LICENSE) file for details.
## ⚠️ Database License Notice
This project uses GeoLite2 data created by MaxMind, available from [https://www.maxmind.com](https://www.maxmind.com). The GeoLite2 databases are licensed under the Creative Commons Attribution-ShareAlike 4.0 International License.
## 🔧 Acknowledgements
- GeoLite2 databases provided by [MaxMind](https://www.maxmind.com)
- Mirror of GeoLite2 databases maintained by [P3TERX](https://github.com/P3TERX/GeoLite.mmdb)
- Built with [FastAPI](https://fastapi.tiangolo.com/) and [Python](https://www.python.org/)
- Powered by [geoip2](https://github.com/maxmind/GeoIP2-python) library
## 🤝 Contributing
Contributions are welcome\! Please feel free to submit a Pull Request.
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
## 🌟 Support and Community
If you found this project helpful, please give it a ⭐ on GitHub. This helps more developers discover the project\! 🫶
## 📬 Contact
If you have any questions, feedback, or just want to say hi, you can reach out to me:
- Email: [hello@malith.dev](mailto:hello@malith.dev)
- GitHub: [@Malith-Rukshan](https://github.com/Malith-Rukshan)
🧑💻 Built with 💖 by [Malith Rukshan](https://github.com/Malith-Rukshan)
## Similar templates
- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — A Self-Hosted & Modern Roleplaying Platform
- [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy.
Open this page in a browser: https://railway.com/deploy/6zn6HZ