Skip to content
vfrdirk edited this page Apr 20, 2020 · 5 revisions

Installation

1) Server Installation

Download the project from Github either through git or download a zip.

Make sure you have Python (3.6 or greater) installed.

// Install Python requirements
pip install -r requirements.txt

// Start the server
sudo python server.py

The PicoBrew Server and UI will run under http://localhost:5000 (Port 5000 is used by default. This can be edited in server.py)

2) Connect the PicoBrew machine

This is the tricky part. You have to fool the machine into believing the url www.picobrew.com belongs to your server. (DNS spoofing) There is several ways to do this:

  • Connect the machine to your computer through an ad-hoc network and modify the hosts files.
  • Some router allows you to configure your DNS settings accordingly:
    • Either you can specify a new DNS server (e.g. dnsmasq) that you can custom configure
    • or you can list a single domain and the IP address it should resolve too

OSX

  1. Start the PicoBrew server
  2. Use the Internet Sharing feature of OSX. Either share your Wifi or Ethernet connection
  3. Modify your hosts file under etc/hosts and add the following line to the end:
192.168.2.1    www.picobrew.com

The IP address must match the Mac's internet sharing bridge (check ifconfig)

  1. Connect the PicoBrew machine through the above network interface.
  2. If everything works correctly, you will see incoming requests logged to the terminal.
Clone this wiki locally