PirateBox 1.0 DIY

You can build a PirateBox 1.0 for as little as US$35! And with the new Box Installer, you can have your PirateBox up and running in just a few minutes.

PirateBox 1.0 image

PirateBox 1.0 Features

Responsive design for ease of use with phones and tablets; UPnP Media Server for local streaming of movies and songs; Image and Message Board for 4chan-like functionality; chat room for anonymous communications; browser-based file sharing system!

PirateBox 1.0 OpenWrt DIY

PirateBox is an anonymous offline mobile file-sharing and communications system built with free software and inexpensive off-the-shelf hardware. You can use it to transform any space into a free and open offline communications and file sharing network. Learn more about PirateBox on our FAQ page!

Install PirateBox 1.0

The following instructions are for installing PirateBox 1.0 on a new TP-Link router (MR3020 or MR3040) or GliNet router which is running the factory installed firmware. Note: If you have already installed OpenWrt on your router or if you are already running an older version of PirateBox on your router, skip to the Upgrade PirateBox section below.

For support, be sure to check out the PirateBox OpenWrt page and the OpenWrt discussion board on our PirateBox Forum.

Stuff You'll Need

1. Wireless router (one of the following):

2. USB Flash Drive (formatted FAT32 with a single partition). The Kingston DT 16GB works well: (Amazon) (Newegg)

Note: a better-performing USB 2.0 flash drive is recommended, as a USB 3.0 drive may draw too much current, and a slower USB 2.0 drive may result in your PirateBox locking up during moderate-to-heavy or long-term use.

3. Ethernet cable (this may come with your wireless router)

4. Computer with ethernet port

5. 5V/USB Battery (optional)

Auto-Installation

1. Download Software

Download the following two files to your computer:

a) A copy of install_piratebox.zip.

b) A customized copy of OpenWrt (be sure to download the “*squashfs-factory.bin” file that corresponds with your specific device) http://stable.openwrt.piratebox.de/auto

Important: Be sure to use one of the OpenWrt images linked above! They are customized to work together with the install.zip. If you use a different image-file, you won't be able to use this automatic installation!

2. Prepare USB Flash Drive

a) Extract the install_piratebox.zip file (double click on it) and drag the “install” folder over to your USB flash drive.

b) Now SAFELY REMOVE your USB drive from your computer and plug the USB stick into your OpenWrt router.

3. Prepare your Router

a) Set the toggle switch located beside the LAN/WAN port on the router to 3G mode, if a switch is available.

b) Connect the router via ethernet cable to your computer and power up the router. (Make sure the router is connected to a power supply.)

4. Install Software

a) Once the router is running and you're connected to it via ethernet cable, open a web browser and visit the following address:

b) Enter the default username & password (admin & admin). Note: For the GLiNet router you will need to select a language, time zone, and password.

c) Navigate to System Tools > Firmware Upgrade and select the OpenWRT firmware that you downloaded to your computer during the first step above. Note: For the GLiNet router you should navigate to: Firmware > Upload Firmware

d) Select upgrade. Note: For the GLiNet router, you must make sure the flag “keep settings” is not ticked.

e) After the upgrade completes, the router will restart.

Important: You should wait 15-20 minutes for the installation to complete (for slower USB flash drives, it may take up to 45 minutes – be patient!). Your device will reboot a couple of times during the installation.

Note: The Web Admin page for your router will “time out” during the installation process. This is normal and happens because the IP address for OpenWrt defaults to 192.168.1.1 which differs from the original Web Admin IP address for your router. Please do not try to visit 192.168.1.1 during the installation process as PirateBox is not shipped with a default Web Admin page and visiting this IP could interfere with the installation.

5. Next Steps

a) Once the installation is complete, open a terminal window (for OS X, go to Applications > Utilities > Terminal; for Windows, install and open PuTTY, make sure Telnet is selected for Connection Type), and telnet to the device:

telnet 192.168.1.1

b) You can now follow the Post-Installation instructions below to finish the installation.


Upgrade PirateBox

If you're currently running an 1.0.* version of PirateBox on your router, these instructions should get you up and running in a flash (literally!). Please Note: The instructions below are specifically for the TP-Link MR3020, TP-Link MR3040, and the GLiNet routers.

Note: If you're currently running a PirateBox on your router with version 0.6 and below, you should follow the Update a very old PirateBox-HowTo.

1. Download Software

Download the following two files to your computer:

a) A copy of install_piratebox.zip.

b) A customized copy of OpenWrt (be sure to download the “*squashfs-factory.bin” file that corresponds with your specific device) http://stable.openwrt.piratebox.de/auto

Important: Be sure to use one of the OpenWrt images linked above! They are customized to work together with the install.zip. If you use a different image-file, you won't be able to use this automatic installation!

2. Install Custom OpenWrt

a) Drag the “*squashfs-factory.bin” file to your USB flash drive (you don't need to extract this file first!).

b) Now SAFELY REMOVE your USB drive from your computer and plug the USB stick into your OpenWrt router.

c) Connect your router via ethernet cable to your computer and power up the router.

d) Once the router is running, open a terminal window (for OS X, go to Applications > Utilities > Terminal; for Windows, install and open PuTTY) and log in with ssh:

ssh root@192.168.1.1 

Note: If you haven't set up a password yet, use the telnet command instead of ssh:

telnet 192.168.1.1

e) Navigate to the /mnt/usb directory:

cd /mnt/usb

f) Install the customized version of OpenWrt and PirateBox 1.0 with:

sysupgrade -n openwrt<TAB>

Note: Use your “tab” key at the end of “openwrt” to autocomplete the full file name of the firmware.

Note: If sysupgrade refuses the upgrade and you are sure it is the correct file, then you can trigger the flash with the following command

mtd write -r openwrt<TAB> firmware

g) After the upgrade completes, the router will restart twice. Wait patiently!

3. Install PirateBox

a) Turn off the router and plug the USB flash drive into your computer.

b) Extract the install_piratebox.zip file (double click on it) that you downloaded earlier and drag the “install” folder over to your USB flash drive.

c) Now SAFELY REMOVE your USB drive from your computer and plug the USB stick into your OpenWrt router.

d) Power the router on. This will trigger the installation of the new packages. Note: You should wait 15-20 minutes for the installation to complete (depending upon your USB flash drive, it may take up to 45 minutes - be patient!). Your device will reboot a couple of times during the installation.

4. Next Steps

a) Once the installation is complete, you can use telnet to connect to the device:

telnet 192.168.1.1

b) You can now follow the Post-Installation instructions below to finish the installation.


Post-Installation

Once you have installed or upgraded PirateBox, you can follow these final steps to set a password, activate the Kareha Image and Discussion Board and configure and start the UPnP media server.

1. Setup

a) If you're not already connected to your PirateBox, join the “PirateBox: Share freely” wireless network, open a terminal window (for OS X, go to Applications > Utilities > Terminal; for Windows, install and open PuTTY) and telnet into your PirateBox:

telnet 192.168.1.1

b) Run the following command to start the setup-menu

box_init_setup.sh

c) Create a password for the administrative root access. Choose “Option 1”, then enter your password twice. Notice: It is not shown while entering it.

Note: Once you have created a password for your PirateBox, telnet will be disabled. This means that in the future you will need to use the following command to access your PirateBox from the terminal:

ssh root@192.168.1.1

d) Activate the “timesave function” by selecting “Option 2” and entering the current date and time.

2. Kareha Image and Discussion Board

a) Activate the Kareha Image and Discussion Board by using the vi text editor (vi cheat sheet) to change the admin username and password (ADMIN_PASS and SECRET). Don't forget to remove a leading # in the both lines, if it exists:

vi /opt/piratebox/www/board/config.pl

b) Once you have updated the Kareha config.pl file, point your web browser to http://piratebox.lan/board/kareha.pl to activate it.

3. UPnP Media Server

a) Activate the UPnP Media Server by copying over the config file:

cp /opt/piratebox/src/openwrt.example.minidlna /mnt/ext/etc/config/minidlna

Note: Optionally, you can edit the config file (change the display name, etc) with:

vi /etc/config/minidlna

b) Start the UPnP Media Server with:

/etc/init.d/minidlna start
/etc/init.d/minidlna enable  

Note: Any media files uploaded to your PirateBox will now automatically stream across your PirateBox wireless network. You will need a UPnP client in order to play these files. Check out our Streaming Media page for more info.

4. Next Steps

Your PirateBox 1.0 should be ready to use! Be sure to also check out the PirateBox OpenWrt page and the OpenWrt discussion board on our PirateBox Forum for more info and support.