diff --git a/pivilion-manual-setup.md b/pivilion-manual-setup.md index ee2f2ed..2bd51af 100644 --- a/pivilion-manual-setup.md +++ b/pivilion-manual-setup.md @@ -67,15 +67,15 @@ php5-cgi is a PHP to CGI interpreter. CGI (Common Gateway Interface ) offers a s Apt will install all required dependencies. -### Install Hostapd. +### Install Hostapd sudo apt-get install hostapd -Hostapd (Host access point daemon) is a user space software access point capable of turning normal network interface cards into access points and authentication servers. We use it, in conjuction with dnsmaq, to turn the Rpi into an access point. +Hostapd (Host access point daemon) is a user space software access point capable of turning normal network interface cards into access points and authentication servers. We use it, in conjuction with dnsmaq, to turn the Rpi into a Wifi access point. ### Install Dnsmasq -sudo apt-get install dnsmaq +sudo apt-get install dnsmasq Dnsmasq is a Domain Name System (DNS) forwarder and Dynamic Host Configuration Protocol (DHCP) server for small computer networks. We use it to provide the clients connected to our access point with IP addresses. @@ -87,7 +87,7 @@ sudo apt-get install git. Git (/ɡɪt/) is a version control system (VCS) that i sudo apt-get install tor -You can now chose to either pull the Pivilion scripts and Tor / Rpi configuration (if so skip to here) from our Gitlab or make the next step manually and make your own Tor hidden service without Pivilion. +You can now choose to either pull the Pivilion scripts and Tor / Rpi configuration (if so skip to here) from our Gitlab or make the next step manually and make your own Tor hidden service without Pivilion. ### Configure Tor @@ -97,9 +97,10 @@ sudo nano /etc/tor/torrc Uncomment RunAsDeamon 1 -In the section intended for hidden services only, uncomment the two lines +In the section intended for hidden services only, uncomment (remove the leading # (hash) symbol) the two lines HiddenServiceDir /var/lib/tor/hidden_service + HiddenServicePort 80 127.0.0.1:80 In order to setup additional services, simply add their port's to this list, followed by your localhost IP (always 127.0.0.1). Eg. for SSH via Tor we would add @@ -108,21 +109,21 @@ HiddenServicePort 22 127.0.0.1:22 Note that hidden service ports don't need to be the same as their local ports. It is reccomended to run services on high ports (1024-65535) for (not much) added security. The port for the http service is left at the default port 80, because otherwise we need to input the port in the URL, i.e. 7j4kxhmso6yhz2df.onion:1337 tp access the website on port 1337. +Write your changes to the file with Ctrl + O. Exit nano with Ctrl + X. + Now restart tor sudo systemctl restart tor Tor will generate a hostname. to view your hostname run -sudo cat /var/lib/tor/hostname/hidden_service/hostname - -Will output your onion domain. +sudo cat /var/lib/tor/hidden_service/hostname Check if your hidden service works by opening Tor Browser and navigating to your onion domain. You should see the same lighttpd placeholder page as before. -Cloning Pivilion settings and scripts via Git +## Cloning Pivilion settings and scripts via Git Our script assumes that your user is named pi. It will create direcotries in pi's home dir (/home/pi) and use scripts that reference that directory.