PoshC2_Python/README.md

# PoshC2
PoshC2 is a proxy aware C2 framework that utilises Powershell **and/or** equivalent (System.Management.Automation.dll) to aid penetration testers with red teaming, post-exploitation and lateral movement. Powershell was chosen as the base implant language as it provides all of the functionality and rich features without needing to introduce multiple third party libraries to the framework.

In addition to the Powershell implant, PoshC2 also has a basic dropper written purely in Python that can be used for command and control over Unix based systems such as Mac OS or Ubuntu.

The server-side component is written in Python for cross-platform portability and speed, a Powershell server component still exists and can be installed using the 'Windows Install' as shown below but will not be maintained with future updates and releases.


## Linux Install of [PoshC2_Python](https://github.com/nettitude/PoshC2_Python/)

Install using curl & bash
```
curl -sSL https://raw.githubusercontent.com/nettitude/PoshC2_Python/master/Install.sh | bash
```

Manual install

```
wget https://raw.githubusercontent.com/nettitude/PoshC2_Python/master/Install.sh
chmod +x ./Install.sh
./Install.sh
```

## Windows Install of [PoshC2](https://github.com/nettitude/PoshC2/)

```
powershell -exec bypass -c "IEX (New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/nettitude/PoshC2/master/C2-Installer.ps1')"
```

## Issues / FAQs

If you are experiencing any issues during the installation or use of PoshC2 please refer checkout the open issues tracking page within GitHub. If this page doesn't have what you're looking for please open a new issue and we will try to resolve the issue asap.

If you are looking for tips and tricks on PoshC2 usage and optimisation, you are welcome to join the slack channel below.

## License / Terms of Use

This software should only be used for **authorised** testing activity and not for malicious use.

By downloading this software you are accepting the terms of use and the licensing agreement.


## Documentation

We maintain PoshC2 documentation over at https://poshc2.readthedocs.io/en/latest/

Find us on #Slack - [poshc2.slack.com](poshc2.slack.com) (to request an invite send an email to labs@nettitude.com)
Initial Commit 2018-07-23 08:55:15 +00:00			`# PoshC2`
Updated README 2018-12-12 16:23:57 +00:00			`PoshC2 is a proxy aware C2 framework that utilises Powershell and/or equivalent (System.Management.Automation.dll) to aid penetration testers with red teaming, post-exploitation and lateral movement. Powershell was chosen as the base implant language as it provides all of the functionality and rich features without needing to introduce multiple third party libraries to the framework.`
Initial Commit 2018-07-23 08:55:15 +00:00
Updated README 2018-12-12 16:23:57 +00:00			`In addition to the Powershell implant, PoshC2 also has a basic dropper written purely in Python that can be used for command and control over Unix based systems such as Mac OS or Ubuntu.`
'PoshC2 Readme' 2018-07-23 10:03:33 +00:00
Updated README 2018-12-12 16:23:57 +00:00			`The server-side component is written in Python for cross-platform portability and speed, a Powershell server component still exists and can be installed using the 'Windows Install' as shown below but will not be maintained with future updates and releases.`


			`## Linux Install of [PoshC2_Python](https://github.com/nettitude/PoshC2_Python/)`

			`Install using curl & bash`
Minor changes to documentation 2018-09-26 16:20:58 +00:00			```
Updated README 2018-12-12 16:23:57 +00:00			`curl -sSL https://raw.githubusercontent.com/nettitude/PoshC2_Python/master/Install.sh \| bash`
Minor changes to documentation 2018-09-26 16:20:58 +00:00			```
'PoshC2 Readme' 2018-07-23 10:03:33 +00:00
Updated README 2018-12-12 16:23:57 +00:00			`Manual install`
'PoshC2 Readme' 2018-07-23 10:03:33 +00:00
Minor changes to documentation 2018-09-26 16:20:58 +00:00			```
Updated README 2018-12-12 16:23:57 +00:00			`wget https://raw.githubusercontent.com/nettitude/PoshC2_Python/master/Install.sh`
			`chmod +x ./Install.sh`
			`./Install.sh`
Minor changes to documentation 2018-09-26 16:20:58 +00:00			```
'PoshC2 Readme' 2018-07-23 10:04:48 +00:00
Updated README 2018-12-12 16:23:57 +00:00			`## Windows Install of [PoshC2](https://github.com/nettitude/PoshC2/)`
Initial Commit 2018-07-23 08:55:15 +00:00
Updated README 2018-12-12 16:23:57 +00:00			```
			`powershell -exec bypass -c "IEX (New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/nettitude/PoshC2/master/C2-Installer.ps1')"`
			```
Initial Commit 2018-07-23 08:55:15 +00:00
Updated README 2018-12-12 16:23:57 +00:00			`## Issues / FAQs`
Initial Commit 2018-07-23 08:55:15 +00:00
Updated README 2018-12-12 16:23:57 +00:00			`If you are experiencing any issues during the installation or use of PoshC2 please refer checkout the open issues tracking page within GitHub. If this page doesn't have what you're looking for please open a new issue and we will try to resolve the issue asap.`
Initial Commit 2018-07-23 08:55:15 +00:00
Updated README 2018-12-12 16:23:57 +00:00			`If you are looking for tips and tricks on PoshC2 usage and optimisation, you are welcome to join the slack channel below.`

			`## License / Terms of Use`

			`This software should only be used for authorised testing activity and not for malicious use.`

			`By downloading this software you are accepting the terms of use and the licensing agreement.`


			`## Documentation`

			`We maintain PoshC2 documentation over at https://poshc2.readthedocs.io/en/latest/`

			`Find us on #Slack - [poshc2.slack.com](poshc2.slack.com) (to request an invite send an email to labs@nettitude.com)`