Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Tag: v0.2-3
Fetching contributors…

Cannot retrieve contributors at this time

99 lines (90 sloc) 4.173 kB
###########################################################################
# mkPirateBox v0.2-3
# IPKG that installs PirateBox to your fresh OpenWRT router
# (C) 2011, Christiane Ruetten, cr@23bit.net
#
# Released under GPLv2, see http://www.gnu.org/licenses/gpl-2.0.html
FEATURES:
- Install this IPKG on your fresh OpenWRT "Backfire", and out comes
(hopefully) a ready-to-use PirateBox.
- Now supports devices with 4 MByte flash
- Tested on
- Asus WL-500gP (brcm47xx)
- Asus WL-500g (brcm47xx)
- Buffalo WZR-HP-G300NH (ar71xx)
TODO:
- Test other platforms
- Does not uninstall cleanly
- Better error checking
PLEASE HELP:
- I expect mkPirateBox v0.2+ to run on many or even most untested router
models. If something goes wrong, installation will most likely fail
during wireless setup. I usually can make it easily work if you help me
out. If you decide to try mkPirateBox on an untested router model,
please send send me feedback on how it went, including
- your router model
- output of the command
"cat /etc/openwrt_release /etc/config/wireless /etc/config/network".
- Thanks! :)
REQUIREMENTS:
- Decently powerful router with USB2.0 port which is supported by OpenWRT.
Minimum requirements are 125 MHz, 16 MByte RAM and 4 GByte flash, but I
recommand 250 MHz, 32 MByte RAM and 8 MByte flash. The following models
meet or exceed the recommendation and should work out of the box:
- Asus WL-500gP (brcm47xx, white, end-of-life)
- Buffalo WZR-HP-G300NH (ar71xx, hardwired antennas)
- D-Link DIR-825 (ar71xx, white)
- Linksys WRT160NL (ar71xx)
- 125 MHz systems work, but HTTP uploads may drop dramatically to
about 100 KByte/s.
- An external USB hard drive (UMS compatible) formattet with FAT32.
- Two ethernet cables
INSTALL:
- Install a fresh OpenWRT "Backfire" 10.03.1 onto your router.
I mean really fresh. Do not touch it after you flashed it!
If you already have an unclean install, do rm -rf /overlay/*
and reboot the router.
- Connect the WAN port to your gateway and a LAN port to your
computer. This ensures the router can download packages.
- Connect your USB drive. The script assumes a single partition
with a FAT32 file system.
- telnet into the router on 192.168.1.1.
- cd /tmp
- wget http://cr.23bit.net/piratebox/piratebox_0.2-3_all.ipk
(Sorry, github only supports https downloads.)
- opkg update && opkg install piratebox*
- When prompted, set a root password.
- Wait for the setup to finish which is when the open wireless
network "PirateBox" appears.
- Connect wirelessly and open any web page.
- If you see the PirateBox menu, you're done.
- You can disconnect the WAN connection now.
- To start over or completely uninstall, rm -rf /overlay/* and
reboot or reflash OpenWRT.
USAGE:
- /etc/piratebox.common has the global config on top. If you
decide to change the IP address or the ESSID, be sure to
activate it with the "setup" command as described below.
- Central tool for managing PirateBox is the init script
/etc/init.d/piratebox. It support the following commands:
- "setup" activates current USB and network configuration as
described in /etc/piratebox.common. Only required during
initial installation or after config changes.
- "init" mounts USB drive, and sets up swap and ext3 image
therein (for the huge python installation).
- "update" downloads the latest PirateBox files from David
Darts' website to USB disk.
- "nodns" disables local DNS redirection through dnsmasq
which is required for local maintenance work.
- "start" and "stop" the PirateBox service, of course. The
former also automatically calls "init" and "update" when
it detects an un-PirateBox-ified USB disk.
REFERENCES:
- The PirateBox project:
http://wiki.daviddarts.com/PirateBox_DIY
- OpenWRT - List of supported devices:
http://wiki.openwrt.org/toh/start
- OpenWRT documentation (look for tftp installation):
http://wiki.openwrt.org/doc/start
- OpenWRT "Backfire" 10.04.1-r4 images:
http://downloads.openwrt.org/backfire/10.03.1-rc4/
Jump to Line
Something went wrong with that request. Please try again.