Skip to main content

Simple self hosting solution based on docker for bug hunters.

Project description


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.


On your home computer

  • docker-machine
  • sshfs (optional)
  • python3

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

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

For more information:

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" > /etc/resolv.conf #opendns servers


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.


First install the pm client.

pip install pwn-machine

On your first run you need to setup PwnMachine with

pm setup

Then you can build and start all your services.

pm service build
pm service start

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.

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.0.tar.gz (19.1 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page