Next Whois

Next Whois is a fast and modern WHOIS/RDAP search tool built with Next.js. It supports searching for domains, IPv4, IPv6, ASN, and CIDR, prioritizing RDAP with a fallback to WHOIS. Key features include:

• Dynamic OG Images: Generated via /api/og using Satori.
• Responsive UI: Built with Shadcn UI and Tailwind CSS, including PWA support.
• Search Capabilities: Local history with search/filtering, EPP status descriptions, and registrar/NS branding detection.
• Performance: Server-side caching with Redis and Cache-Control headers.
• Extensibility: Open API for programmatic access and Moz metric integration (DA/PA/Spam Score).

You can deploy Next Whois using managed platforms, Docker, or by running the source code locally.

Managed Platforms (Recommended)

One-click deployment is available for:

• Vercel
• Netlify
• Zeabur

Docker

Run the pre-built image using Docker:

docker run -d -p 3000:3000 programzmh/next-whois-ui

Local Development

To run the project from source, use pnpm:

git clone https://github.com/zmh-program/next-whois-ui
cd next-whois-ui
pnpm install
pnpm dev

To run the application in a containerized environment, use the following command to start the service on port 3000:

docker run -d -p 3000:3000 programzmh/next-whois-ui

To run the application in a containerized environment, use the following command:

docker run -d -p 3000:3000 programzmh/next-whois-ui

You can deploy Next Whois to supported platforms using one-click templates:

• Vercel: Deploy Template
• Netlify: Deploy Template
• Zeabur: Deploy Template

To run the project locally for development or custom builds, clone the repository and use pnpm to install dependencies and start the development server.

git clone https://github.com/zmh-program/next-whois-ui
cd next-whois-ui
pnpm install
pnpm dev

You can deploy Next Whois quickly using one-click templates for supported platforms:

• Vercel: Deploy Template
• Netlify: Deploy Template
• Zeabur: Deploy Template

You can run Next Whois as a containerized application using Docker. This will expose the service on port 3000 by default.

docker run -d -p 3000:3000 programzmh/next-whois-ui

To set up the development environment from the source code, follow these steps:

1. Clone the repository.
2. Navigate to the directory.
3. Install dependencies using pnpm.
4. Start the development server.

git clone https://github.com/zmh-program/next-whois-ui
cd next-whois-ui
pnpm install
pnpm dev

Use the following environment variables to configure site metadata, history limits, Moz metrics, and Redis caching.

| Variable | Description | Default |
|----------|-------------|---------|
| `NEXT_PUBLIC_SITE_TITLE` | Site title | Next Whois |
| `NEXT_PUBLIC_SITE_DESCRIPTION` | Site description | — |
| `NEXT_PUBLIC_SITE_KEYWORDS` | Site keywords | — |
| `NEXT_PUBLIC_HISTORY_LIMIT` | Max history items (-1 = unlimited) | -1 |
| `NEXT_PUBLIC_MAX_WHOIS_FOLLOW` | Max domain WHOIS follow depth | 0 |
| `MOZ_ACCESS_ID` | Moz API Access ID | — |
| `MOZ_SECRET_KEY` | Moz API Secret Key | — |
| `REDIS_HOST` | Redis host (empty = cache disabled) | — |
| `REDIS_PORT` | Redis port | 6379 |
| `REDIS_PASSWORD` | Redis password | — |
| `REDIS_DB` | Redis database index | 0 |
| `REDIS_CACHE_TTL` | Cache TTL in seconds | 3600 |

Use the following environment variables to customize the site behavior, SEO, Moz integration, and Redis caching.

NEXT_PUBLIC_SITE_TITLE      # Site title (Default: Next Whois)
NEXT_PUBLIC_SITE_DESCRIPTION # Site description
NEXT_PUBLIC_SITE_KEYWORDS    # Site keywords
NEXT_PUBLIC_HISTORY_LIMIT     # Max history records (-1 = unlimited, Default: -1)
NEXT_PUBLIC_MAX_WHOIS_FOLLOW # Max WHOIS follow depth (Default: 0)
MOZ_ACCESS_ID                 # Moz API Access ID
MOZ_SECRET_KEY                # Moz API Secret Key
REDIS_HOST                    # Redis host (Leave empty to disable caching)
REDIS_PORT                    # Redis port (Default: 6379)
REDIS_PASSWORD                # Redis password
REDIS_DB                      # Redis database index (Default: 0)
REDIS_CACHE_TTL               # Cache TTL in seconds (Default: 3600)

Use the following environment variables to customize the site behavior, SEO, and integrations.