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) which is running the stock TP-Link 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)

3. Ethernet cable

4. Computer with ethernet port

5. 5V/USB Battery (optional)

Auto-Installation

Installing PirateBox has never been easier thanks to the box-installer.

1. First download a copy of install_piratebox.zip and a customized copy of OpenWrt for the MR3020, WR703N or MR3040 to your computer from: http://stable.openwrt.piratebox.de/auto (be sure to download the “*squashfs-factory.bin” file that corresponds with your specific device). Be sure to use one image from our served files, because 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. Extract the install_piratebox.zip file and drag the “install” folder over to your USB flash drive.

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

4. Set the toggle switch located beside the LAN/WAN port on the router to 3G mode.

5. Connect the router via ethernet cable to your computer and power up the router. Once the router is running, open a web browser to http://192.168.0.254 for the MR3020, http://192.168.0.1 for MR3040 and http://192.168.1.1 for the WR703N to access the router's admin page (Check the “Quick Installation Guide” for your router if you're unsure).

6. Enter the default username & password (admin & admin).

7. Navigate to System Tools > Firmware Upgrade and select the OpenWRT firmware that you downloaded to your computer during the first step above.

Note: The WR703N firmware text is in Chinese. To flash OpenWrt from the web interface, select the last menu item on the left, and then the third submenu item. More info in this Village Telco post.

8. After the upgrade completes, the router will restart. 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.

9. Once the installation is complete, open a terminal window (for OS X, go to Applications > Utilities > Terminal; for Windows, install and open PuTTY) and telnet to the device:

telnet 192.168.1.1

10. You can now follow Post-Installation instructions below for finishing you installation.


Upgrade PirateBox

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.

If you're currently running an 1.0.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, WR703N, and MR3040.

1. First download a copy of install_piratebox.zip and a customized copy of OpenWrt for the MR3020, WR703N or MR3040 to your computer from: http://stable.openwrt.piratebox.de/auto (be sure to download the “*squashfs-factory.bin” file that corresponds with your specific device). Be sure to use one image from our served files, because 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. Drag the “*squashfs-factory.bin” to your USB flash drive (you don't need to extract this file first!).

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

4. Connect the router via ethernet cable to your computer and power up the router. 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

5. Navigate to the /mnt/usb directory:

cd /mnt/usb

6. 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

7. After the upgrade completes, the router will twice restart.

8. Turn off the router and take the USB flash drive to your computer.

9. Extract the install_piratebox.zip file and drag the “install” folder over to your USB flash drive.

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

11. Power the router on. That 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.

12. Once the installation is complete, you can use telnet to connect to the device:

telnet 192.168.1.1

13. You can now follow Post-Installation instructions below for finishing you installation.


Post-Installation

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

0. (You can skip this step, when you are connected via telnet.) Power up your PirateBox and join the SSID “PirateBox: Share freely” network. Then open a terminal window (for OS X, go to Applications > Utilities > Terminal; for Windows, install and open PuTTY) and ssh into your PirateBox:

ssh root@192.168.1.1

1. Run the following command to fire up a simple setup-menu

box_init_setup.sh

2. Setup a password for the administrative root access. Choose Option 1 , then enter your password twice. Notice: It is not shown while entering it. Since that point you have to use ssh root@192.168.1.1 to login into your PirateBox.

3. Activate the “timesave functionality” once. Choose Option 2 , enter the current date and time. Then you are done with that step.

4. 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 exists:

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

5. Point your browser to http://piratebox.lan/board/kareha.pl for the first initialization.

6. 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

7. Finally, start the UPnP Media Server with:

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

8. 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.