Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 99 lines (90 sloc) 4.173 kB
d0354fa @cr documentation added
cr authored
1 ###########################################################################
7763246 @cr version bumped to v0.2-2
cr authored
2 # mkPirateBox v0.2-2
aa0405c @cr much improved IPKG version added
cr authored
3 # IPKG that installs PirateBox to your fresh OpenWRT router
d0354fa @cr documentation added
cr authored
4 # (C) 2011, Christiane Ruetten, cr@23bit.net
5 #
6 # Released under GPLv2, see http://www.gnu.org/licenses/gpl-2.0.html
7
8 FEATURES:
aa0405c @cr much improved IPKG version added
cr authored
9 - Install this IPKG on your fresh OpenWRT "Backfire", and out comes
10 (hopefully) a ready-to-use PirateBox.
11 - Now supports devices with 4 MByte flash
8201704 @cr recommendations updated
cr authored
12 - Tested on
13 - Asus WL-500gP (brcm47xx)
14 - Asus WL-500g (brcm47xx)
15 - Buffalo WZR-HP-G300NH (ar71xx)
d0354fa @cr documentation added
cr authored
16
17 TODO:
aa0405c @cr much improved IPKG version added
cr authored
18 - Test other platforms
0b273cd @cr doc update
cr authored
19 - Does not uninstall cleanly
1dfd0a6 @cr doc updated
cr authored
20 - Better error checking
d0354fa @cr documentation added
cr authored
21
72607fe @cr please help...
cr authored
22 PLEASE HELP:
d3963c4 @cr small fixes
cr authored
23 - I expect mkPirateBox v0.2+ to run on many or even most untested router
24 models. If something goes wrong, installation will most likely fail
25 during wireless setup. I usually can make it easily work if you help me
26 out. If you decide to try mkPirateBox on an untested router model,
72607fe @cr please help...
cr authored
27 please send send me feedback on how it went, including
28 - your router model
29 - output of the command
30 "cat /etc/openwrt_release /etc/config/wireless /etc/config/network".
31 - Thanks! :)
32
d0354fa @cr documentation added
cr authored
33 REQUIREMENTS:
34 - Decently powerful router with USB2.0 port which is supported by OpenWRT.
d3963c4 @cr small fixes
cr authored
35 Minimum requirements are 125 MHz, 16 MByte RAM and 4 GByte flash, but I
36 recommand 250 MHz, 32 MByte RAM and 8 MByte flash. The following models
37 meet or exceed the recommendation and should work out of the box:
8201704 @cr recommendations updated
cr authored
38 - Asus WL-500gP (brcm47xx, white, end-of-life)
39 - Buffalo WZR-HP-G300NH (ar71xx, hardwired antennas)
40 - D-Link DIR-825 (ar71xx, white)
41 - Linksys WRT160NL (ar71xx)
42 - 125 MHz systems work, but HTTP uploads may drop dramatically to
0b273cd @cr doc update
cr authored
43 about 100 KByte/s.
d0354fa @cr documentation added
cr authored
44 - An external USB hard drive (UMS compatible) formattet with FAT32.
2710584 @cr doc update
cr authored
45 - Two ethernet cables
d0354fa @cr documentation added
cr authored
46
47 INSTALL:
48 - Install a fresh OpenWRT "Backfire" 10.03.1 onto your router.
49 I mean really fresh. Do not touch it after you flashed it!
7c92200 @cr minor doc update
cr authored
50 If you already have an unclean install, do rm -rf /overlay/*
51 and reboot the router.
d0354fa @cr documentation added
cr authored
52 - Connect the WAN port to your gateway and a LAN port to your
53 computer. This ensures the router can download packages.
54 - Connect your USB drive. The script assumes a single partition
55 with a FAT32 file system.
56 - telnet into the router on 192.168.1.1.
57 - cd /tmp
7763246 @cr version bumped to v0.2-2
cr authored
58 - wget http://cr.23bit.net/piratebox/piratebox_0.2-2_all.ipk
aa0405c @cr much improved IPKG version added
cr authored
59 (Sorry, github only supports https downloads.)
60 - opkg update && opkg install piratebox*
61 - When prompted, set a root password.
0b273cd @cr doc update
cr authored
62 - Wait for the setup to finish which is when the open wireless
63 network "PirateBox" appears.
64 - Connect wirelessly and open any web page.
d0354fa @cr documentation added
cr authored
65 - If you see the PirateBox menu, you're done.
aa0405c @cr much improved IPKG version added
cr authored
66 - You can disconnect the WAN connection now.
7c92200 @cr minor doc update
cr authored
67 - To start over or completely uninstall, rm -rf /overlay/* and
68 reboot or reflash OpenWRT.
d0354fa @cr documentation added
cr authored
69
d698668 @cr added usage section
cr authored
70 USAGE:
71 - /etc/piratebox.common has the global config on top. If you
72 decide to change the IP address or the ESSID, be sure to
73 activate it with the "setup" command as described below.
74 - Central tool for managing PirateBox is the init script
75 /etc/init.d/piratebox. It support the following commands:
76 - "setup" activates current USB and network configuration as
77 described in /etc/piratebox.common. Only required during
78 initial installation or after config changes.
79 - "init" mounts USB drive, and sets up swap and ext3 image
80 therein (for the huge python installation).
81 - "update" downloads the latest PirateBox files from David
82 Darts' website to USB disk.
83 - "nodns" disables local DNS redirection through dnsmasq
84 which is required for local maintenance work.
85 - "start" and "stop" the PirateBox service, of course. The
86 former also automatically calls "init" and "update" when
87 it detects an un-PirateBox-ified USB disk.
88
d0354fa @cr documentation added
cr authored
89 REFERENCES:
90 - The PirateBox project:
91 http://wiki.daviddarts.com/PirateBox_DIY
92 - OpenWRT - List of supported devices:
93 http://wiki.openwrt.org/toh/start
94 - OpenWRT documentation (look for tftp installation):
95 http://wiki.openwrt.org/doc/start
96 - OpenWRT "Backfire" 10.04.1-r4 images:
97 http://downloads.openwrt.org/backfire/10.03.1-rc4/
98
Something went wrong with that request. Please try again.