How to Install Metasploit in Kali Linux [Tutorial]

Written by

Reviewed by

Last updated: June 3, 2024

Expert verified

SVG Image


To install Metasploit on Kali Linux, you can follow this step-by-step guide:

  1. Execute sudo apt update to ensure access to the latest package versions and dependencies.
  2. Run sudo apt install git ruby ruby-dev libpq-dev libpcap-dev postgresql for necessary dependencies.
  3. Use git clone to obtain the Metasploit Framework.
  4. Change directory with cd metasploit-framework to access the framework files.
  5. Execute sudo gem install bundler and sudo bundle install to install the required gems and dependencies for Metasploit.

Metasploit is an open-source framework that provides a comprehensive suite of tools for security testing and penetration testing. It enables you to identify, exploit, and validate vulnerabilities in target systems, making it an invaluable asset in the field of cybersecurity. Metasploit simplifies the process of performing complex attacks, allowing security professionals to enhance the security of their systems. In this comprehensive guide, I will explore the step-by-step guide to install Metasploit on Kali Linux, exploring metasploit capabilities, and common errors that can occur when installing and using Metasploit.

How to Install Metasploit in Kali Linux

To install Metasploit in Kali Linux, start by opening your terminal. Then, run the command sudo apt-get update to ensure your package list is up-to-date. Following that, execute sudo apt-get install metasploit-framework to install Metasploit. This process automatically retrieves and installs Metasploit along with its dependencies. Once the installation is complete, you can launch Metasploit by typing msfconsole in your terminal.

Detailed Instructions:

Before you install Metasploit in Kali Linux, ensure your system meets the minimum requirements, including Kali Linux 2.0 or later (64-bit version), a 1.4 GHz or faster processor, at least 2 GB of RAM, 1 GB of disk space, and an active network connection. Having a more powerful system can enhance Metasploit’s performance and capabilities.

  1. Open your Terminal window.
opening terminal 13
  1. Execute the following command:
sudo apt update
  1. This command updates the package repositories on your system, ensuring you have access to the latest package versions and dependencies.
updating system packages 1
  1. Now upgrade your system by running the following command:
sudo apt upgrade
  1. The command will upgrade the system packages.
upgrading system to the latest version
  1. To install required dependencies run the following command:
sudo apt install git ruby ruby-dev libpq-dev libpcap-dev postgresql
  1. After execution the command Installs the required dependencies for Metasploit, including Git, Ruby, development libraries, and PostgreSQL.
installing metasploit repository
  1. To clone the clone the Metasploit repository enter the command:
git clone
  1. The command downloads the Metasploit Framework from the official repository.
cloning metasploit repository
  1. Navigate to the Metasploit directory by running the following command:
cd metasploit-framework
  1. It will change the current directory to the Metasploit framework directory.
navigating to directory 4
  1. Install the necessary gems by entering the following command:
sudo gem install bundle
  1. The command will install the Bundler gem, which is used for managing Ruby gems.
installing necessary gems for metasploit
  1. Install required dependencies and gems by executing the following command:
sudo bundle install
  1. It installs the required gems and dependencies for Metasploit.
installing bundle for metasploit
  1. To Initialize the Metasploit database run the command:
sudo msfdb init
  1. Initializes the PostgreSQL database and sets it up for use with Metasploit.
initializing metasploit database
  1. Start the Metasploit console by executing the following command in the Terminal:
  1. The command will metasploit console.
starting metasploit consloe
  1. Now configure the database for Metasploit by entering the command:
  1. The command will check the status of the Metasploit database and ensures it is properly configured and connected.
checking database status

4 Metasploit’s Key Capabilities

Metasploit offers a wide range of powerful capabilities that empower security professionals to conduct effective penetration testing and vulnerability assessments. These capabilities serve as essential tools in identifying, exploiting, and validating vulnerabilities within target systems. Here are four key capabilities of Metasploit:

  • 🎯 Scanning and Enumeration: Metasploit provides comprehensive scanning and enumeration techniques to identify potential vulnerabilities in target systems. With port scanning, it detects open ports and services running on the target, enabling further analysis. Service enumeration helps gather detailed information about discovered services, such as version numbers and potential vulnerabilities. Additionally, SNMP enumeration allows for enumerating SNMP services to uncover potential attack vectors. These scanning and enumeration capabilities equip security professionals with valuable insights to prioritize and target their penetration testing efforts effectively.
  • Exploitation and Payloads: Metasploit’s extensive collection of exploits and payloads empowers security professionals to leverage vulnerabilities and gain unauthorized access to target systems. Remote exploits are employed to exploit known vulnerabilities and gain remote control over compromised systems. Client-side exploits target vulnerabilities in client applications, while web application exploits focus on weaknesses in web-based applications. Metasploit also offers a variety of payloads to deliver malicious code to compromised systems, providing options for controlling and extracting information from the target environment.
  • 🔐 Post-Exploitation Techniques: Post-exploitation activities are crucial for maintaining access and maximizing control over compromised systems. Metasploit enables security professionals to pivot and establish connections to other systems within the target network, expanding their reach. Privilege escalation capabilities help elevate user privileges, enabling further access to sensitive resources. Data exfiltration techniques allow for extracting valuable information from compromised systems. By mastering post-exploitation techniques, security professionals can achieve persistence within the target environment, ensuring continued access and control for further analysis and evaluation.
  • 🛡️ Maintaining Persistence: Maintaining persistence is vital to ensure continued access to compromised systems even after reboots or system changes. Metasploit provides capabilities to establish persistence, enabling security professionals to maintain their foothold within the target environment. By leveraging various techniques, such as modifying startup configurations, creating scheduled tasks, or installing backdoors, security professionals can ensure their continued access to the compromised system. Maintaining persistence allows for further exploration, analysis, and validation of vulnerabilities, ultimately enhancing the effectiveness of the penetration testing process.

4 Common Errors When Installing and Using Metasploit

While installing and using Metasploit, it is not uncommon to encounter certain errors that can hinder the smooth operation of the framework. Understanding these errors and their resolutions is crucial for effectively utilizing Metasploit’s capabilities. Here are four common errors that you may encounter when installing and using Metasploit:

  • Dependency Issues: Dependency issues can occur during the installation process, causing conflicts with required libraries or dependencies. These errors may arise due to outdated packages, incompatible versions, or missing dependencies. To resolve such errors, it is essential to ensure that all necessary libraries and dependencies are up to date and properly installed. This can be achieved by checking the official Metasploit documentation for specific requirements and following the recommended steps for dependency management.
  • 🚫 Firewall and Antivirus Interference: Firewalls and antivirus software can sometimes interfere with Metasploit’s operation, blocking necessary network traffic or flagging its activities as malicious. This can lead to connection issues, false positives, or even complete blockage of Metasploit’s functionality. To address this, it is crucial to configure firewalls and antivirus settings to allow Metasploit’s traffic and exclude it from any real-time scanning. Additionally, using Metasploit in controlled environments or virtualized systems can help mitigate interference from security software.
  • ⚠️ Module Compatibility: Metasploit consists of numerous modules that provide different functionalities for exploitation and post-exploitation activities. However, errors can occur when using incompatible or outdated modules with the current version of Metasploit. These errors may manifest as crashes, failed exploits, or incorrect results. To mitigate this, it is important to keep Metasploit modules up to date, ensure compatibility between modules and the installed version of Metasploit, and regularly check for module updates from reliable sources.
  • 📂 Database Connection Issues: Metasploit utilizes a database to store and manage information related to exploits, payloads, and sessions. Errors related to database connectivity, such as failed connections, authentication issues, or corrupt databases, can hinder Metasploit’s operation. To address these issues, it is essential to ensure that the database service is running properly, credentials are correctly configured, and any necessary database migrations or updates are performed. Regular backups of the Metasploit database can also help mitigate potential data loss and facilitate recovery in case of database-related errors.

In a Nutshell

I hope this guide has provided you with a clear understanding of how to install Metasploit on Kali Linux. Once installed, Metasploit equips you with powerful capabilities for scanning, exploitation, post-exploitation, and maintaining persistence. Remember to exercise caution, obtain proper authorization, and adhere to legal and ethical guidelines when utilizing Metasploit’s key capabilities.

To further enhance your expertise in Metasploit and penetration testing, consider exploring the following articles: Advanced Exploitation Techniques, Web Application Security, and Post-Exploitation Best Practices. Continuously expanding your knowledge and staying updated with the latest trends in cybersecurity will empower you to become a proficient ethical hacker and strengthen the security of systems in an ever-evolving digital landscape.

Frequently Asked Questions

What Is Metasploit?

Metasploit is a comprehensive framework for developing, testing, and executing exploits. It offers a collection of tools for penetration testing, security research, and IDS signature development. This open-source project assists security and IT professionals in identifying security vulnerabilities in networks and systems. Metasploit provides an extensive database of public exploits and payloads that can be tailored to exploit specific vulnerabilities, making it an essential tool in ethical hacking and cybersecurity defenses.

What is msfconsole?

msfconsole is the primary command-line interface to Metasploit. It provides a powerful and flexible foundation for launching exploits, managing payloads, performing reconnaissance, and conducting security assessments. Within msfconsole, users can access various commands and utilities to configure and execute their security tasks, making it an essential tool for penetration testers and security professionals working with the Metasploit Framework.

Can I use Metasploit on a different Linux distribution besides Kali Linux?

While Metasploit is primarily designed for use on Kali Linux, it can be installed and used on other Linux distributions as well. However, it may require additional manual configuration and setup to ensure compatibility with the different distribution’s package manager and dependencies. You would need to ensure that the required dependencies and libraries are installed on your chosen Linux distribution. Additionally, some features or modules specific to Kali Linux may not be available on other distributions. It is recommended to refer to the official Metasploit documentation and community resources for guidance on installing and using Metasploit on specific Linux distributions.

Are there graphical user interface (GUI) options available for using Metasploit?

Yes, there are GUI options available for using Metasploit. Armitage is a popular GUI that provides a visual representation of targets, exploits, and sessions within Metasploit. It offers a user-friendly interface that simplifies the process of conducting penetration tests. Armitage allows users to visually manage their targets, select exploits, and interact with the Metasploit Framework. It provides a more intuitive approach for those who prefer a graphical interface over the command-line interface. Armitage enhances the accessibility and usability of Metasploit, particularly for users who are more comfortable with visual representations and point-and-click interactions.

Yes, Metasploit is a legal and widely-used tool for conducting authorized penetration testing and vulnerability assessments. However, it is crucial to ensure that you are using Metasploit within legal boundaries and with proper authorization from the target system owner. Using Metasploit without proper authorization can be illegal and may result in serious legal consequences. It is important to obtain explicit permission from the owner or administrator of the system being tested before conducting any penetration testing activities. Additionally, it is essential to adhere to local laws, regulations, and ethical guidelines that govern the use of such tools.

Can I install Metasploit on a virtual machine instead of directly on Kali Linux?

Yes, you can install Metasploit on a virtual machine (VM) if you prefer to keep your host system separate from your testing environment. Installing Metasploit on a VM allows for isolation and containment, ensuring that any activities performed within the VM do not impact the host system. To install Metasploit on a VM, you would first need to set up a virtualization software such as VirtualBox or VMware, and then create a VM with the desired operating system (in this case, Kali Linux). Follow the installation instructions provided by the Metasploit documentation to set up Metasploit within the VM, ensuring that the VM has sufficient resources allocated for optimal performance.



Ojash is a skilled Linux expert and tech writer with over a decade of experience. He has extensive knowledge of Linux's file system, command-line interface, and software installations. Ojash is also an expert in shell scripting and automation, with experience in Bash, Python, and Perl. He has published numerous articles on Linux in various online publications, making him a valuable resource for both seasoned Linux users and beginners. Ojash is also an active member of the Linux community and participates in Linux forums.



Akshat is a software engineer, product designer and the co-founder of Scrutify. He's an experienced Linux professional and the senior editor of this blog. He is also an open-source contributor to many projects on Github and has written several technical guides on Linux. Apart from that, he’s also actively sharing his ideas and tutorials on Medium and Attirer. As the editor of this blog, Akshat brings his wealth of knowledge and experience to provide readers with valuable insights and advice on a wide range of Linux-related topics.

Share this article
Shareable URL
Prev Post

How to install Docker Debian [3 Best Methods ]

Next Post

How to Install AWS CLI on Ubuntu[3 Proven Methods]

Leave a Reply

Your email address will not be published. Required fields are marked *

Read next