Skip to content

Weather Service

Welcome to the official documentation for Weather Service.

Weather Service is a production-grade weather API providing global weather forecasts, severe weather alerts, earthquake data, moon phase information, and hurricane tracking. Built with Go for performance and reliability.

Features

  • Global Weather Forecasts - 16-day forecasts for any location worldwide via Open-Meteo
  • Severe Weather Alerts - Real-time alerts from US, Canada, UK, Australia, Japan, and Mexico
  • Earthquake Tracking - Live USGS earthquake data with interactive maps
  • Hurricane Tracking - Active storm tracking with NOAA advisories and forecasts
  • Moon Phases - Detailed lunar information including phases, illumination, rise/set times
  • GeoIP Location - Automatic location detection via IP address
  • Real-Time Notifications - WebSocket-powered notification system
  • Mobile Responsive - Optimized for desktop, tablet, and mobile
  • Single Static Binary - No external dependencies, all assets embedded

Quick Start

docker run -d \
  --name weather \
  -p 64580:80 \
  -v ./rootfs/config:/config:z \
  -v ./rootfs/data:/data:z \
  ghcr.io/apimgr/weather:latest

# Download latest release
curl -q -LSsf -O https://github.com/apimgr/weather/releases/latest/download/weather-linux-amd64
chmod +x weather-linux-amd64
sudo mv weather-linux-amd64 /usr/local/bin/weather

# Run the server
weather

services:
  weather:
    image: ghcr.io/apimgr/weather:latest
    ports:
      - "64580:80"
    volumes:
      - ./rootfs/config:/config:z
      - ./rootfs/data:/data:z
    restart: unless-stopped

Next Steps