-
Notifications
You must be signed in to change notification settings - Fork 845
Getting Started
If you're reading this, then you've likely been sent here by Recon-ng v4 in search of guidance for upgrading to the latest version. Upgrading can only be done for source installs of Recon-ng. Recon-ng installs through Linux distributions with their own repositories (i.e Kali) must be handled by the distribution.
Since Recon-ng v5 is hosted in a new repository on a different provider, the normal source upgrade procedure of git pull won't work. The repository must be migrated to the new source. There are several ways to to do this:
- Remove the old version completely and replace it with the new version. From the Recon-ng install directory:
cd .. rm -rf recon-ng git clone https://github.com/lanmaster53/recon-ng.git - Update the remote URL of the current repository. From the Recon-ng install directory:
git remote set-url https://github.com/lanmaster53/recon-ng.git git pull
From this point, upgrading a source installation is as simple as navigating to the Recon-ng install directory and issuing the git pull command.
Keys used by the framework are stored in an independent SQLite3 database at "~/.recon-ng/keys.db". When installing a new instance of Recon-ng on the same machine, no migration is necessary. The new Recon-ng instance will recognize and use the existing key database. However, in order to access the key database on another system, the key database must me manually moved to the same location on the new machine, where it can be recognized and used by any instance of Recon-ng running there.
- Install Recon-ng
apt-get update && apt-get install recon-ng
Note: Kali repositories may not be updated to the latest version.
- Clone the Recon-ng repository.
git clone https://github.com/lanmaster53/recon-ng.git
- Change into the Recon-ng directory.
cd recon-ng
- Install dependencies.
pip install -r REQUIREMENTS
- Launch Recon-ng.
./recon-ng
- Use the "-h" switch for information on runtime options.
./recon-ng -h
- Read the Features page to familiarize yourself with the interface.
All 3rd party dependencies must be installed prior to use. The above guidance only installs dependencies for the framework core. Modules may have additional dependencies that must be met. Due to the open nature of the marketplace, module dependencies are not installed by the framework. While modules are reviewed prior to acceptance into the marketplace, users are responsible for anything that happens as a result of installing and using the modules and their dependencies. See the Module Marketplace section of the Features page for more information.
Recon-ng has an official Slack workspace. For additional help, information, or general discussion about the framework, join by completing the self-registration form at https://goo.gl/forms/IJrxxWpglWu0Eyzl2.