diff --git a/pivilon-manual-setup.md b/pivilon-manual-setup.md index 5615872..1d14dc0 100644 --- a/pivilon-manual-setup.md +++ b/pivilon-manual-setup.md @@ -1,46 +1,36 @@ -Pivilion manual setup +# Pivilion manual setup You can chose to download one of our pre-installed images or follow this guide to install Pivilion on your Raspberry Pi from scratch and use it as a portable darknet gallery. It installs Tor with Lighttpd as a hidden service and runs a simple php based gallery system. Tor is free software for enabling anonymous communication and censorship circumvention. However, Pivilion doesn't use Tor for its anonimity features. Tor is used to host a HTTP server as a hidden service. We make extensive use of its NAT punching capabilites to enable us to host a gallery behind NATs and firewalls. Keep in mind that this may or may not be legal in your country. -Checklist +## Checklist -Raspbian image +#### Raspbian image https://www.raspberrypi.org/downloads/raspbian/ - -Tor Browser +#### Tor Browser https://www.torproject.org/download/download-easy.html.en - -Windows only - -Putty SSH client - +### Windows only +#### Putty SSH client http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html - +#### Preparing the SD card with the image First we need to put a fresh Rasbpian image on our RPi's SD card. - You can use either the full or the lite image, it’s up to you. - -Rpi installing images - +###Rpi installing images https://www.raspberrypi.org/documentation/installation/installing-images/README.md Choose your system. We’ll be using Linux + dd. -Once that’s done, connect your RPi to a DHCP network with an ethernet cable and power it on. - -Depending on your network configuration, you can login to your RPi using it's hostname "raspberry", or use a network discovery tool to find it's IP address. - +Once that’s done, connect your RPi to a DHCP network with an ethernet cable and power it on. Depending on your network configuration, you can login to your RPi using it's hostname "raspberry", or use a network discovery tool to find it's IP address. We will use nmap to scan our DHCP IP range for all hosts that are up. Replace 10.0.0.1/24 with your IP address range. You can also check you router's settings to see all devices connected to your network and their IPs. nmap 10.0.0.1/24 Login to your pi using SSH with username: pi password: raspberry. -Upgrade your system. +### Upgrade your system. sudo apt-get update && sudo apt-get upgrade -Expand your filesystem. +### Expand your filesystem. sudo raspi-config (select the first option from the menu). @@ -58,9 +48,15 @@ You can now navigate to your Rpi's IP (or hostname - raspberry) using a browser. You will see lighttpd's placeholder page. -Install php-gd. +Install php and modules. -sudo apt-get install php5-gd +sudo apt-get install php5-cgi php5-gd + +PHP (Hypertext Preprocessor) is a server-side scripting language designed primarily for (but not limited to) web development. We use it to run our basic gallery generation script. + +The GD library (php5-gd) is a graphics drawing library that provides tools for manipulating image data. + +php5-cgi is a PHP to CGI interpreter. CGI (Common Gateway Interface ) offers a standard protocol for web servers to interface with executable programs running on a server that generate web pages dynamically. The interpreter is how Lighty handles PHP. Apt will install all required dependencies.