Skip to main content

Simple self hosting solution based on docker for bug hunters.

Project description

PwnMachine

PwnMachine is a self hosting solution based on docker aiming to provide an easy to use pwning station for bughunters.

The basic install include a DNS server, a reverse proxy and a webserver.

Requirements

On your home computer

  • docker-machine
  • sshfs (optional)
  • python3
  • docker-compose

You need to create a docker-machine for your server.

docker-machine create \ 
 --driver generic \
 --generic-ip-address=0.0.0.0 \
 --generic-ssh-user=root \
 --generic-ssh-key=/home/user/.ssh/id_rsa \
 your_machine_name

For more information: https://docs.docker.com/machine/drivers/generic/

On your server

required available port:

  • tcp: 80 443 53
  • udp: 53

On a fresh Ubuntu server installation systemd listen on port 53 you will need to shut the service down and change your dns.

systemctl disable --now systemd-resolved.service
echo "nameserver 208.67.222.222" > /etc/resolv.conf #opendns servers

DNS

You must set your host as your authoritative nameserver. You must wait for the DNS propagation or the domain verification by let's encrypt will fail.

Installation

First install the pm client.

pip install pwn-machine

or for a cutting edge build:

git clone https://github.com/yeswehack/pwn-machine/
cd pwn-machine
pip install .

On your first run you need to setup PwnMachine with

pm setup

This will start an interactive installer. The installer will create the configuration directory and add the required environment variable and autocompletion to your shell init file.

Then you can build and start all your services.

pm service build
pm service start

You can check that everything is running with

pm ps

Check the wiki for more informations.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pwn-machine-1.1.2.tar.gz (19.3 kB view details)

Uploaded Source

File details

Details for the file pwn-machine-1.1.2.tar.gz.

File metadata

  • Download URL: pwn-machine-1.1.2.tar.gz
  • Upload date:
  • Size: 19.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.0 requests-toolbelt/0.9.1 tqdm/4.47.0 CPython/3.8.3

File hashes

Hashes for pwn-machine-1.1.2.tar.gz
Algorithm Hash digest
SHA256 54afd6186509ce3b1b5d428e4e741167f2d5d5042963f1f4f85193db789e5ae3
MD5 eb82145a90a250697405d55cd0d2acfd
BLAKE2b-256 74aaedc19e021201ccfc2c3f342ff30fc0ae52051ebb9de0cd8084ff3d0d582f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page