ikhwan17/ntp-server repository overview

⁠⏱️ ikhwan17/ntp-server

A lightweight and secure NTP (Network Time Protocol) server container based on Debian. Ideal for time synchronization in local development environments or isolated networks. This container can be used alongside an API bridge (e.g. with Express.js) to fetch time via HTTP.

⁠📦 Features

• Provides accurate time synchronization using NTP.
• Can be accessed via port 123/udp.
• Lightweight and easy to deploy with Docker or Docker Compose.
• Ideal for pairing with a backend API bridge for frontend time display.
• Built for learning, demos, and internal development use.

⁠🐳 Docker Usage

⁠Run directly

docker run -d --name ntp-server \
  -p 123:123/udp \
  ikhwan17/ntp-server

⁠With Docker Compose

version: '3'
services:
  ntp-server:
    image: ikhwan17/ntp-server:latest
    ports:
      - "123:123/udp"
    restart: unless-stopped

Then run:

docker-compose up -d

⁠🧪 Test NTP Server (Optional)

docker run --rm --network host debian:stable-slim \
  bash -c "apt update && apt install -y ntpdate && ntpdate -q 127.0.0.1"

⁠🌐 Use With API Bridge

You can use this container with an Express.js API bridge to expose NTP time to the browser via HTTP.

⁠Sample Response (via API):

{
  "ntp_date": "2025-04-16",
  "ntp_time": "14:55:00"
}

⁠🛠 Built With

• Debian (slim)
• ntpd (Network Time Protocol daemon)

⁠🧑‍💻 Maintainer

• Muhammad Ikhwan Fathulloh
• GitHub: @Muhammad-Ikhwan-Fathulloh⁠