Waypoint

Waypoint

A self-hosted IP geolocation service

Waypoint is a self-hosted IP geolocation service that provides geographic information for any IP address including City, Country, ASN, Organization, and more using MaxMind GeoIP databases.

🚀 Key Features

• REST API: Fast and reliable IP geolocation lookup
• Web UI: Clean and intuitive dashboard for IP lookups and history
• API Key Management: Secure API key generation and revocation
• User Authentication: OIDC support for secure access
• Automatic Updates: MaxMind database auto-update
• API First: Fully featured REST API for seamless integration

📁 Project Structure

Waypoint/
├── cmd/             # Executable entry points (Server, CLI)
├── internal/        # Core business logic
│   ├── config/      # Configuration management
│   ├── db/          # Database layer
│   ├── handlers/    # API request handlers
│   └── maxmind/     # MaxMind client
├── web/             # Vue.js frontend application
└── compose.yml      # Docker Compose configuration

📖 Documentation

• Getting Started: Installation, configuration, and first steps.
• API Reference: Overview of available REST endpoints.
• Configuration: Configuration options and environment variables.

License

MIT