Go to file
Matthias Strubel f937190375 Upgrade opt/piratebox image from ext3 to ext4 and 50MB file 2014-01-16 22:53:42 +01:00
BuildScripts Remember cleaning up the leftovers 2013-06-07 13:25:57 +02:00
image_stuff Upgrade opt/piratebox image from ext3 to ext4 and 50MB file 2014-01-16 22:53:42 +01:00
piratebox deliver sample configuration of minidlna within PirateBox release 2013-11-29 17:46:20 +01:00
.gitignore added stuff for cleaner repository 2013-04-09 07:54:34 +02:00
AUTHORS Added new directory-Design to CHANGELOG and David Brooks to Authors 2013-11-29 17:44:03 +01:00
CHANGELOG updated Changelog for mising points 2013-11-29 17:46:20 +01:00
Makefile Upgrade opt/piratebox image from ext3 to ext4 and 50MB file 2014-01-16 22:53:42 +01:00
README Merge branch 'mime_type_issues' into development 2013-07-10 16:05:48 +02:00

README

# PirateBoxScripts with Modifications for running in a Webserver
#  (c) 2013 Matthias Strubel   licenced under GPL-3
#           matthias.strubel@aod-rpg.de
#
#  Maintained by Matthias Strubel
#  	    	 	matthias.strubel@aod-rpg.de
# 		 Cale Black
# 		 	cablack@rams.colostate.edu
# 
# Sources for Running PirateBox with Webserver lighttpd 
#    Contains:  Shoutbox, Forum
#
#                
PirateBox is a collection of scripts / programs that allows you to use your wireless card
as a local network to share files and chat anonymously. For more information please visit
http://daviddarts.com/

----- Info -----
Packages contains only scripts based PirateBox scripts with running lighttpd webserver.

PirateBox scripts can:
   * Setup WLAN Interface via iw
   * Setup hotspot functionality (hostapd)
   * Setup IP Adresses of wlan interface
   * Proping until USB-WLAN is available
   * Can add wlan interface to an existing bridge
   * Sets Up a DHCP Server with redirect to wlan-interface IP
   * Upload landing page  (via iframe droopy)
   * Browse Uploaded files
   * Announce "Internet yes" for iOS
   * Announce "Internet yes" for MS devices
   * ShoutBox
   * Optional small python Forum
   * Optional imageboard
   * Optional Station counter
   * Optional Inihibit starting upload-script
   * Optional Timesave script (for devices without RTC)  - can be found in piratebox/bin/timesave.sh 
   * Optional Poll for WLAN device until it available (for USB wifi cards)


More information can be found ont http://piratebox.aod-rpg.de
Installation-HowTo und current Download-Link: http://piratebox.aod-rpg.de/dokuwiki/doku.php/piratebox_lighttpd

Is supported by mkPirateBox > v0.5 for OpenWRT Systems https://github.com/MaStr/mkPirateBox
and by PirateBox Manager https://github.com/TerrorByte/PirateBox-Manager

----- Installation -----
PirateBox should be in most common repositories soon, but in the mean time you can use this method:


##### For alpha testing

Download the package:
https://github.com/MaStr/PirateBoxScripts_Webserver/archive/master.zip

Unzip the package:
$unzip master.zip

Run the installer in the unzipped folder:
$ cd PirateBoxScripts_Webserver/piratebox
$ sudo ./install.sh default #Default can be substituted with 'board' if you want an image board on your PB

Starting / Stopping PirateBox
WARNING: Some major distributions have changed from init.d to systemd which means you should use the 
commands that are labeled under your distribution or what your distribution is based on. It should 
also be noted that as of recently Ubuntu has systemd enabled but not set as the default init system
which means that you may have to use the systemctl commands.

Newest versions of Ubuntu, Fedora, Arch, OpenSUSE, Mageia, and Mandriva:
$ systemctl start piratebox
$ systemctl start piratebox
$ systemctl restart piratebox

Older Ubuntu (xubuntu, lubuntu, etc), Mint, Debian, most Debian based distros: 
$ service piratebox start
$ service piratebox stop
$ service piratebox restart