You need Nmap.If you have Kali Linux or Parrot OS installed, you already have Nmap. If not,follow the nmap install guide.

The easiest way to install RustScan is to use one of the packages provided for your system, such as HomeBrew or Yay for Arch Linux.

The most universal way is to usecargo,Rust's built in package manager (think Pip but for Rust).Follow this guide to installing Rust & Cargo.

If you face any issues at all, please leave a GitHub issue. I have only tested this on Linux, so there may be issues for Mac OS or Windows.

Note: sometimes Rust doesn't add Cargo to the path. Please seethis issuefor how to fix that.

Docker is the recommended way of installing RustScan. This is because:

• It has a high open file descriptor limit, which is one of themain problemswith RustScan. Now you don't have to fiddle around trying to understand your OS.
• It works on all systems, regardless of OS. Even Windows, which we don't officially support.
• The Docker image uses the latest build from Cargo, our main source-of-truth package. This means that you will always be using the latest version.
• No need to install Rust, Cargo, or Nmap.

To install Docker,follow their guide.

Once Docker is installed, you can either build your own image using theDockerfile(alpine) provided in the repo, or alternatively, use the published Docker image like below (most convenient)

Please see ourDockerHubfor further our published versions. However, we recommend using our latestmajorrelease2.1.1

Stable and supported: rustscan/rustscan:2.1.1

Bleeding edge (run at your own risk!): rustscan/rustscan:latest

We strongly recommend using the2.1.1tag, as this is the latest major - stable - release of RustScan. This README uses the2.1.1image by default, however, note that thelatestimage is considered experimental. You can use all releases of Docker by visiting theDockerHub Tagsand replacing the command with the tag you desire. i.e.docker pull rustscan/rustscan:1.10.0can bedocker pull rustscan/rustscan:1.6.0

Simply run this command against the IP you want to target:

docker run -it --rm --name rustscan rustscan/rustscan:2.1.1<rustscan arguments here>

Note: this will scan the Docker's localhost, not your own (unless using the Host network driver).

Once done, you will no longer need to re-download the image (except when RustScan updates) and can use RustScan like a normal application.

You will have to run this command every time, so we suggest aliasing it to something memorable.

aliasrustscan='docker run -it --rm --name rustscan rustscan/rustscan:2.1.1'

Then we can scan:

rustscan --addresses 192.168.1.0/24 -t 500 -b 1500 -- -A

Download the repo:

git clone https://github /RustScan/RustScan.git

Ensure you navigate to the download location of the repo:

cd/path/to/download/RustScan

Build away!

docker build -t<yourimagename>.

Download the.deb file from the releases page:

https://github /RustScan/RustScan/releases

Run the commanddpkg -ion the file.

Note: sometimes you can double click the file to achieve the same result.

Docker is the recommended way of installing RustScan. This is because:

• It has a high open file descriptor limit, which is one of themain problemswith RustScan. Now you don't have to fiddle around trying to understand your OS.
• It works on all systems, regardless of OS. Even Windows, which we don't officially support.
• The Docker image uses the latest build from Cargo, our main source-of-truth package. This means that you will always be using the latest version.
• No need to install Rust, Cargo, or Nmap.

To install Docker,follow their guide.

Once Docker is installed, you can either build your own image using theDockerfile(alpine) provided in the repo, or alternatively, use the published Docker image like below (most convenient)

Please see ourDockerHubfor further info, however, note that we have two Docker images:

rustscan/rustscan:alpine

rustscan/rustscan:latest

We strongly recommend using thealpinetag, as this is the latest major - stable - release of RustScan. This README uses thealpineimage by default, however, note that thelatestimage is considered experimental.

Simply run this command against the IP you want to target:

docker run -it --rm --name rustscan rustscan/rustscan:alpine<rustscan arguments here><ip address to scan>

Note: this will scan the Docker's localhost, not your own.

Once done, you will no longer need to re-download the image (except when RustScan updates) and can use RustScan like a normal application.

You will have to run this command every time, so we suggest aliasing it to something memorable.

aliasrustscan='docker run -it --rm --name rustscan rustscan/rustscan:alpine'

Then we can:

rustscan 127.0.0.1 -t 500 -b 1500 -- -A

Download the repo:

git clone https://github /RustScan/RustScan.git

Ensure you navigate to the download location of the repo:

cd/path/to/download/RustScan

Build away!

docker build -t<yourimagename>.

Note for Mac usersMac OS has a very, very small ulimit size. This will negatively impact RustScan by a significant amount. Please use the Docker container, or tell RustScan to up the ulimit size on every run.

Tap the brew:

brew install rustscan

Termux user can installrustscanvia Package manager (pkg).

pkg install rustscan

1. Git clone the repo.
2. Install Rust. You can do this withcurl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | shwhich I took from the Rust websitehttps:// rust-lang.org/tools/install
3. cd into the Git repo, and runcargo build --release
4. The binary is located attarget/release/rustscan
5. Symlink to the binary or something. Whatever you want!

Here are all of RustScan's community distributions.

If you maintain a community distribution and want it listed here, leave an issue / pull request / Discord message or however you want to let us know.

• OpenSuse
• Fedora/CentOS