nager/nager-date repository overview

⁠Nager.Date

Nager.Date is a simple, lightweight, and scalable open-source solution to query public holidays for over 200 countries.

The project provides a REST interface to retrieve the data. This Docker container provides a web api with a web interface that allows you to query the holidays.

⁠🚀 Quick Start

docker run -p 8080:8080 -e LICENSE_KEY=YOUR_LICENSE_KEY nager/nager-date

Once running, access the Web Interface at: 👉 http://localhost:8080

⁠🛠️ Configuration & Environment Variables

⁠🐳 Docker Compose Example

Easily spin up the service using docker-compose.yml:

services:
  nager-date:
    image: nager/nager-date:latest
    container_name: nager-date
    ports:
      - "8080:8080"
    environment:
      - LICENSE_KEY=YOUR_LICENSE_KEY
    restart: unless-stopped

⁠💡 Key Features

• 🌎 Global Coverage: Support for over 200 countries and regions.
• 🚀 High Performance: Built with C# / .NET for fast response times.
• 📖 Interactive Docs: Includes OpenAPI documentation out of the box.
• 🛠️ Seamless Integration: Easy to run as a microservice or standalone holiday service.

⁠🔗 Useful Links

• 🌐 Getting Started Guide: nagerholidays.com/integration/getstarted⁠
• 📑 Change Log: nagerholidays.com/changelog⁠
• 🐙 GitHub Repository: github.com/nager/Nager.Date⁠
• 🔑 Get a License Key: GitHub Sponsor⁠