Flask_Whois

Flask_Whois

Flask_Whois is a web application that allows you to look up domain names and IP addresses, providing detailed WHOIS information, including expiration dates and raw data.

Features

• Domain/IP Lookup: Enter a domain or IP address to fetch its WHOIS information.
• Formatted Dates: Expiration dates are displayed with ordinal indicators for enhanced readability.

Getting Started

Prerequisites

• Python 3.x
• Flask
• Python whois package
• whois command installed on the system for domain lookup (see below for Docker support)
• Docker (for containerized deployment)

Installation

1. Clone the repository

   git clone https://github.com/yourusername/flask_whois.git
   cd flask_whois

2. Create a virtual environment

   python3 -m venv venv
   source venv/bin/activate

3. Install the dependencies

   pip install -r requirements.txt

4. Ensure whois is installed (if you're not using docker)

   On Linux and macOS, you can install the whois command using your package manager.

   • Linux (Debian-based):

     sudo apt-get install whois

   • macOS (with Homebrew):

     brew install whois

   On Windows, you will need to install whois manually, such as from Microsoft Sysinternals.

   Note: If the whois command is not available on your system, you can deploy and run the app using Docker.

Usage

1. Run the application

   python app.py

2. Access the app

   Open your browser and navigate to http://127.0.0.1:5000/.

Docker Support

Flask_Whois can be deployed using Docker, which comes pre-configured with the whois command to avoid system-specific installations.

1. Build the Docker image

   docker build -t flask_whois .

2. Run the Docker container

   docker run -p 8000:8000 flask_whois

3. Access the app

   Open your browser and navigate to http://127.0.0.1:8000/.

Docker Compose

To run the application using Docker Compose, use the following docker-compose.yml:

services:
  flask_whois:
    build: .
    ports:
      - "8000:8000"
    restart: always

1. Run the application with Docker Compose

   docker-compose up -d --build

2. Access the app

   Open your browser and navigate to http://127.0.0.1:8000/.

Important Notes

• If you are not using Docker, ensure that the whois command is installed on your system to perform domain lookups.
• For a smoother setup, consider using Docker, which includes the whois command in the container.

Contributing

Contributions are welcome! Please open an issue to discuss your ideas or submit a pull request with your changes.

License

This project is licensed under the MIT License. See the LICENSE file for details.

About Me

I am Monazir Muhammad Doha, on a mission to bring my ideas to life. Check my website HoundSec