Findomain Installation and Usage Guide: Platform-Specific Instructions & Configuration Tips

Welcome to our comprehensive guide on installing and using Findomain, a powerful tool designed for domain discovery and subdomain enumeration. Whether you're a cybersecurity professional, a developer, or just a tech enthusiast, Findomain offers robust features that help you uncover hidden subdomains and monitor domain changes.

This guide will walk you through the installation process for various platforms, including Linux, Windows, MacOS, and Android. We'll also cover how to build Findomain from source, update it, and configure it for optimal performance.

Findomain is available for multiple platforms, each with specific installation instructions. We've included step-by-step guidance to ensure you can set up Findomain on your preferred system with ease. By following this guide, you'll be able to leverage Findomain’s full potential and enhance your domain monitoring capabilities.

Ready to dive in? Let's get started with the installation process tailored to your operating system.

Supported Platforms

Findomain is designed to be versatile and compatible with a wide range of platforms. Below, you'll find instructions for installing Findomain on the most commonly used systems. Each platform requires slightly different steps, so make sure to follow the guide specific to your operating system.

Linux

Findomain provides precompiled binaries for 64-bit Linux systems. You can also build the tool from source if you prefer.

Windows

For Windows users, Findomain offers a precompiled binary that can be easily installed and run on your system.

MacOS

Findomain supports MacOS with options for installation via Homebrew or manually from a provided ZIP file.

Aarch64

Findomain is available for Aarch64 architecture, making it suitable for devices with ARMv8 processors.

ARMv7

Support for ARMv7 architecture ensures compatibility with older ARM-based devices.

NixOS

Findomain can be installed on NixOS, catering to users of this unique Linux distribution.

Docker

For those who prefer containerized environments, Findomain can be run within Docker containers, with options for both pulling prebuilt images and building from source.

If you need to run Findomain on a platform not listed here, please refer to the official documentation for additional guidance.

Prerequisites

Before installing Findomain, ensure that you have the necessary prerequisites in place. These requirements vary slightly depending on the platform you are using.

General Requirements

To fully utilize Findomain's features, you'll need the following:

• Google Chrome or Chromium: Required for screenshot functionality. These browsers ensure that Findomain can capture and manage screenshots effectively.
• PostgreSQL: Essential for subdomains monitoring. PostgreSQL is used to store and manage subdomain data. Refer to the Subdomains Monitoring section for additional details on setting this up.

Additional Tools for 32-bit Systems

If you are working with a 32-bit system or an alternative platform, make sure you have the following tools installed:

• Rust: A programming language required for building Findomain from source.
• Make: A build automation tool needed for compiling the source code.
• Perl: A scripting language used in various build processes.

Make sure to verify that these tools are installed and properly configured before attempting to build Findomain from source.

Installation Instructions

Findomain can be installed on various platforms using either precompiled binaries or by building from source. Below are detailed instructions for each supported platform.

Linux

Findomain offers an easy installation process for Linux users, both via precompiled binaries and from source.

Using Precompiled Binary

$ curl -LO https://github.com/findomain/findomain/releases/latest/download/findomain-linux.zip
$ unzip findomain-linux.zip
$ chmod +x findomain
$ sudo mv findomain /usr/bin/findomain
$ findomain --help
    

Building from Source

To build Findomain from source on Linux, follow these steps:

• Ensure that Rust, Make, and Perl are installed on your system.
• Clone the repository or obtain the release source code.
• If you downloaded a compressed file, extract the release source code.
• Navigate to the directory containing the source code.

$ cargo build --release
        

• Your binary will be located at target/release/findomain and is ready for use.

Android (Termux)

To install Findomain on Android using Termux, follow these steps:

$ pkg install rust make perl
$ cargo install findomain
$ cd $HOME/.cargo/bin
$ ./findomain
    

Aarch64

For Aarch64 systems, use the following commands:

$ curl -LO https://github.com/findomain/findomain/releases/latest/download/findomain-aarch64.zip
$ unzip findomain-aarch64.zip
$ chmod +x findomain
$ sudo mv findomain /usr/bin/findomain
$ findomain --help
    

Windows

Windows users can install Findomain as follows:

• Download the binary from Findomain Releases.
• Extract the ZIP file.
• Open CMD shell and navigate to the directory containing findomain.exe.

$ findomain.exe --help
        

MacOS

Findomain can be installed on MacOS in two ways:

Using Homebrew

$ brew install findomain
$ findomain
    

Manually

To install Findomain manually:

$ curl -LO https://github.com/findomain/findomain/releases/latest/download/findomain-osx.zip
$ unzip findomain-osx.zip
$ chmod +x findomain.dms
$ ./findomain.dms --help
    

Docker

For Docker users, Findomain can be installed using the following methods:

Using Dockerhub

$ docker pull edu4rdshl/findomain:latest
$ docker run -it edu4rdshl/findomain:latest /bin/bash
$ findomain
    

Building the Docker Image

For instructions on building the Docker image, refer to the official documentation.

Updating Findomain

Keeping Findomain up to date ensures you have the latest features, bug fixes, and security improvements. Below are the methods for updating Findomain based on your installation type.

Precompiled Binary

To update Findomain when using precompiled binaries:

• Download the latest binary from the Findomain Releases page.
• Replace the old binary with the newly downloaded version, following the installation instructions for your platform.

ArchLinux or Arch-based Distro

For ArchLinux or Arch-based distributions, update Findomain using the following command:

$ pacman -Syu
    

Cloned Repository and Compiled from Source

If you compiled Findomain from the source code, update it as follows:

• Navigate to the directory where you cloned the repository.
• Pull the latest changes from the repository:

$ git pull
        

• Rebuild Findomain with the updated code:

$ cargo build --release
        

Cargo Install

If you installed Findomain using Cargo, update it with the following command:

$ cargo install findomain
    

Always ensure that you’re using the latest version of Findomain to take advantage of the most recent improvements and fixes.

Access Tokens Configuration

To enhance Findomain’s functionality, you can configure access tokens for various services. These tokens allow Findomain to interact with external APIs, such as Facebook, Virustotal, and SecurityTrails, for additional features and data. Below are the steps to configure these tokens:

Facebook

To configure Facebook access tokens:

• Go to the Facebook Developers site and log in.
• Create a new app or use an existing one.
• Navigate to the app's settings and generate an access token.
• Follow the provided instructions to configure the token in Findomain.

Virustotal

For Virustotal integration:

• Visit the Virustotal API page.
• Sign up or log in to your account.
• Generate an API key from your account dashboard.
• Enter the API key into Findomain’s configuration settings.

SecurityTrails

To set up SecurityTrails access:

• Go to the SecurityTrails API page.
• Log in or create an account.
• Obtain an API key from your SecurityTrails account.
• Configure the API key in Findomain according to the provided instructions.

Ensure that you store and manage your access tokens securely to prevent unauthorized access to your accounts and data.

Subdomains Monitoring Examples

Findomain provides powerful features for monitoring subdomains. You can configure it to send notifications or store data using various methods. Below are some examples to help you get started with subdomains monitoring.

Discord Webhook

To set up a Discord webhook for receiving notifications:

• Create a webhook in your Discord server settings.
• Copy the webhook URL.
• Configure Findomain to use this URL for sending notifications about detected subdomains.

Slack Webhook

For Slack notifications:

• Create a webhook URL in your Slack workspace.
• Paste the URL into Findomain's configuration settings to receive updates.

Telegram Webhook

To receive updates via Telegram:

• Set up a bot using the BotFather on Telegram.
• Obtain the bot token and configure Findomain to use this token for sending notifications.

PostgreSQL Configuration

To monitor subdomains using PostgreSQL:

• Install and set up PostgreSQL on your system.
• Configure Findomain to connect to your PostgreSQL database.
• Ensure that subdomain data is correctly stored and managed in the database.

For detailed configuration steps and advanced options, refer to Findomain’s official documentation.

Usage Examples

Findomain offers various commands to help you search for subdomains, export data, and query the database. Below are some practical examples to demonstrate its capabilities:

Search for Subdomains and Print Info

To search for subdomains and display the information in the terminal:

$ findomain -t example.com
    

Replace example.com with your target domain to perform the search.

Search and Export Data to a File

If you want to search for subdomains and save the results to a file:

$ findomain -t example.com -o
    

The results will be saved in a file. Ensure you specify the desired file format in your command options.

Query Findomain Database

To query Findomain’s database for specific information:

$ findomain -t example.com --query-database
    

Ensure that Findomain is correctly configured to connect to the database for accurate queries.

For a full list of options and variations, use findomain --help or refer to the official documentation for detailed usage instructions.

Conclusion

Findomain is a powerful tool for discovering and monitoring subdomains across various platforms. Whether you are using precompiled binaries, source code, or containerized environments like Docker, Findomain provides flexible options to suit your needs. By keeping your installation up to date and configuring access tokens and monitoring settings, you can maximize the tool’s effectiveness and stay informed about your domain's subdomain activity.

Remember to follow the installation and update instructions carefully to ensure smooth operation of Findomain on your system.

For further assistance or advanced configurations, consult the official Findomain documentation or community forums.

FQAs

What platforms does Findomain support?

Findomain supports various platforms including Linux, Windows, MacOS, Aarch64, ARMv7, NixOS, and Docker. For running Findomain on other platforms, refer to the documentation.

How do I update Findomain?

To update Findomain, download the latest binary from the Findomain Releases page, or if using a cloned repository, pull the latest changes and rebuild. For ArchLinux or Cargo installations, use the respective update commands.

How can I configure access tokens?

Configure access tokens for services like Facebook, Virustotal, and SecurityTrails by generating tokens from their respective developer platforms and entering them into Findomain’s configuration settings.

What are some usage examples for Findomain?

Usage examples include searching for subdomains with findomain -t example.com, exporting data to a file with findomain -t example.com -o, and querying the Findomain database with findomain -t example.com --query-database.