sqlmap README

The project's README from github.com/sqlmapproject/sqlmap. As one markdown file: README.md.

sqlmap

.github/workflows/tests.yml Python 2.7|3.x License x

sqlmap is an open source penetration testing tool that automates the process of detecting and exploiting SQL injection flaws and taking over of database servers. It comes with a powerful detection engine, many niche features for the ultimate penetration tester, and a broad range of switches including database fingerprinting, over data fetching from the database, accessing the underlying file system, and executing commands on the operating system via out-of-band connections.

Screenshots

Screenshot

You can visit the collection of screenshots demonstrating some of the features on the wiki.

Installation

You can download the latest tarball by clicking here or latest zipball by clicking here.

Preferably, you can download sqlmap by cloning the Git repository:

git clone --depth 1 https://github.com/sqlmapproject/sqlmap.git sqlmap-dev

sqlmap works out of the box with Python version 2.7 and 3.x on any platform.

Usage

To get a list of basic options and switches use:

python sqlmap.py -h

To get a list of all options and switches use:

python sqlmap.py -hh

You can find a sample run here. To get an overview of sqlmap capabilities, a list of supported features, and a description of all options and switches, along with examples, you are advised to consult the user's manual.

Translations

sqlmap (sqlmapproject/sqlmap)

detection
Searching Database…

38.7K ·GitHub
What is this?sqlmap is an open-source penetration testing tool that automates detecting and exploiting SQL injection flaws and taking over the underlying database server.
Is this a GUI application or a command-line tool?It is a pure command-line tool: you run the Python script directly and pass switches for targets, techniques, and output.
How do I get it running?Clone the Git repository (or download the tarball/zip), then run 'python sqlmap.py -h' for basic options or '-hh' for the full switch list.
Do I need anything installed besides Python?No extra dependencies are required — sqlmap works out of the box on Python 2.7 and 3.x on any platform.
Who is this built for?It is aimed at penetration testers and security researchers who need to detect and exploit SQL injection during authorized security assessments.
Does it only run on Linux, or can I use it on Windows and macOS too?Since it's a Python script, it runs on any platform that has Python 2.7 or 3.x, including Windows, macOS and Linux.
What can sqlmap actually do once it finds a SQL injection flaw?Beyond detection, it can fingerprint the database, dump data from it, access the underlying file system, and even execute operating system commands via out-of-band connections.
Is there a quick way to see sqlmap in action before using it on a real target?Yes, the README links to a sample run so you can see typical output and workflow before trying it yourself.
Does sqlmap support getting shell-level access to the server, not just database data?Yes — its feature set includes executing commands on the operating system through out-of-band connections, effectively giving it a path to OS-level access.
Size
95.7 MB
Stars
38.7K
Age
14y
Commits · 90 Days