Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
openwrt:diy [2015/07/23 17:01]
matthias [Auto-Installation] added note about the switch
openwrt:diy [2019/06/09 11:33]
matthias [Stuff You'll Need] Updated article links
Line 1: Line 1:
 <​html>​ <​html>​
 <div class="​jumbotron">​ <div class="​jumbotron">​
-  <​h1>​PirateBox 1.DIY</​h1>​ +  <​h1>​PirateBox 1.DIY</​h1>​ 
-  <​p>​You can build a <​b>​PirateBox 1.0</b> for as little as <​b>​US$35!</​b>​ And with the new Box Installer, you can have your PirateBox up and running in just a few minutes.</​p>​+  <​p>​You can build a <​b>​PirateBox 1.1</b> for as little as <​b>​US$35!</​b>​ And with the new Box Installer, you can have your PirateBox up and running in just a few minutes.</​p>​
    
 <img src="/​_media/​pbx26.jpg?​w=800&​tok=afb10a"​ class="​img-responsive img-rounded"​ alt="​PirateBox 1.0 image">  ​ <img src="/​_media/​pbx26.jpg?​w=800&​tok=afb10a"​ class="​img-responsive img-rounded"​ alt="​PirateBox 1.0 image">  ​
Line 10: Line 10:
 </​html>​ </​html>​
    
-====== PirateBox 1.OpenWrt DIY ======+====== PirateBox 1.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. **[[:​faq|Learn more about PirateBox on our FAQ page!]]** **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. **[[:​faq|Learn more about PirateBox on our FAQ page!]]**
  
-===== Install PirateBox 1.====== +===== Install PirateBox 1.====== 
-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 **[[openwrt:​diy#​Upgrade PirateBox]]** section below.+The following instructions are for installing **PirateBox 1.1** 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 **[[openwrt:​diy#​Upgrade PirateBox]]** section below
 + 
 +  * If you have OpenWRT on a device other than the above routers, you can try your luck with the [[openwrt:​manual|Manual]] method.
  
 For support, be sure to check out the **[[:​openwrt|PirateBox OpenWrt page]]** and the **[[http://​forum.piratebox.cc/​list.php?​8|OpenWrt discussion board]]** on our **[[http://​forum.piratebox.cc|PirateBox Forum]]**. For support, be sure to check out the **[[:​openwrt|PirateBox OpenWrt page]]** and the **[[http://​forum.piratebox.cc/​list.php?​8|OpenWrt discussion board]]** on our **[[http://​forum.piratebox.cc|PirateBox Forum]]**.
Line 20: Line 22:
 ==== Stuff You'll Need ==== ==== Stuff You'll Need ====
 <​html><​span style="​font-size:​125%;"><​b>​1.</​b></​span></​html>​ **Wireless router (one of the following):​** <​html><​span style="​font-size:​125%;"><​b>​1.</​b></​span></​html>​ **Wireless router (one of the following):​**
-  ​***TP-Link MR3020** ** [[amazon>​B006DEBXD0|(Amazon)]] ** **[[http://​www.newegg.com/​Product/​Product.aspx?​Item=N82E16833704127&​cm_re=mr3020-_-33-704-127-_-Product|(Newegg)]]** **[[https://​www.ebay.com/​sch/​i.html?​_odkw=mr+3020+OR+3040&​_osacat=0&​_from=R40&​_trksid=p2045573.m570.l1313.TR0.TRC0.H0.Xmr+3020&​_nkw=mr+3020&​_sacat=0|(eBay)]]**  + 
-  ***TP-Link MR3040** **[[amazon>​B0088PPFP4|(Amazon)]]** **[[https://​www.newegg.com/​Product/​Product.aspx?​Item=N82E16833704138&​cm_re=TP-LINK_MR3040-_-33-704-138-_-Product|(Newegg)]]** **[[https://​www.ebay.com/​sch/​i.html?​_odkw=WR703N&​_osacat=0&​_from=R40&​_trksid=p2045573.m570.l1313.TR11.TRC1.A0.H0.Xmr3040&​_nkw=mr3040&​_sacat=0|(eBay)]]** +  ​*<del>**TP-Link MR3020** ** [[amazon>​B006DEBXD0|(Amazon)]] ** **[[http://​www.newegg.com/​Product/​Product.aspx?​Item=N82E16833704127&​cm_re=mr3020-_-33-704-127-_-Product|(Newegg)]]** **[[https://​www.ebay.com/​sch/​i.html?​_odkw=mr+3020+OR+3040&​_osacat=0&​_from=R40&​_trksid=p2045573.m570.l1313.TR0.TRC0.H0.Xmr+3020&​_nkw=mr+3020&​_sacat=0|(eBay)]]** ​</​del>​ Newer MR3020 Models aren't possible to be flashed with PirateBox anymore. 
-  ***GLiNet Router** **[[amazon>​B00JKFE0FW|(Amazon)]] , GliNet Router **with external antenna** **  **[[amazon>​B00RP24DW2|(Amazon)]]**+ 
 +  *<del>**TP-Link MR3040** **[[amazon>​B0088PPFP4|(Amazon)]]** **[[https://​www.newegg.com/​Product/​Product.aspx?​Item=N82E16833704138&​cm_re=TP-LINK_MR3040-_-33-704-138-_-Product|(Newegg)]]** **[[https://​www.ebay.com/​sch/​i.html?​_odkw=WR703N&​_osacat=0&​_from=R40&​_trksid=p2045573.m570.l1313.TR11.TRC1.A0.H0.Xmr3040&​_nkw=mr3040&​_sacat=0|(eBay)]]** ​(Be careful:!: only v1 & v2 models are supported)</​del>​ 
 + 
 +  ***GLiNet Router** **[[amazon>​B015CYDVG8|(Amazon)]] , GliNet Router **with external antenna** **  **[[amazon>​B01FJ4S9JK|(Amazon)]]** 
   ***Other** You can find additional supported hardware on our [[openwrt:​hardware|Hardware Recommendations]] page but please note that this hardware is not covered under this HowTo and thus your mileage may vary.    ***Other** You can find additional supported hardware on our [[openwrt:​hardware|Hardware Recommendations]] page but please note that this hardware is not covered under this HowTo and thus your mileage may vary. 
  
Line 42: Line 48:
 **a)** A copy of [[http://​stable.openwrt.piratebox.de/​auto/​install_piratebox.zip|install_piratebox.zip]]. **a)** A copy of [[http://​stable.openwrt.piratebox.de/​auto/​install_piratebox.zip|install_piratebox.zip]].
  
-**b)** ​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  ​+**b)** ​Our 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__!+**Important:​** Be sure to use one of the OpenWrt images ​files linked above! They are customized to work together with the install_piratebox.zip. __ If you use a different image-file, you will not be able to use this automatic installation__!
  
 <​html><​span style="​font-size:​125%;"><​b>​2. Prepare USB Flash Drive</​b></​span></​html> ​ <​html><​span style="​font-size:​125%;"><​b>​2. Prepare USB Flash Drive</​b></​span></​html> ​
  
-**a)** Extract the **install_piratebox.zip** file (double click on it) and drag the "​install"​ folder over to your USB flash drive.+**a)** Extract the **install_piratebox.zip** file (double click on it) then 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.+**b)** SAFELY REMOVE your USB drive from your computer, then plug the USB stick into your OpenWrt router.
  
 <​html><​span style="​font-size:​125%;"><​b>​3. Prepare your Router</​b></​span></​html> ​ <​html><​span style="​font-size:​125%;"><​b>​3. Prepare your Router</​b></​span></​html> ​
  
-**a)** Set the toggle switch located beside the LAN/WAN port on the router to **3G mode**, if a switch is available.+**a)** Set the toggle switch located beside the LAN/WAN port on the router to **3G mode**, if a such 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.+**b)** Connect the router via Ethernet ​cable to your computer ​then power up the router (Make sure the router is connected to a power supply)
  
 <​html><​span style="​font-size:​125%;"><​b>​4. Install Software</​b></​span></​html> ​ <​html><​span style="​font-size:​125%;"><​b>​4. Install Software</​b></​span></​html> ​
  
-**a)** Once the router is running and you'​re ​connected to it via ethernet ​cable, open a web browser and visit the following address: ​+**a)** Once the router is running and you are connected to it via Ethernet ​cable, open a web browser and visit the following address:
  
   ***MR3020:​** http://​192.168.0.254 ​   ***MR3020:​** http://​192.168.0.254 ​
Line 68: Line 74:
 **b)** Enter the default username & password (admin & admin). **Note:** For the GLiNet router you will need to select a language, time zone, and password. **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** ​+**c)** Navigate to **System Tools > Firmware Upgrade** ​then select the OpenWRT firmware ​file 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. **d)** Select **upgrade**. **Note**: For the GLiNet router, you must make sure the flag “keep settings” is not ticked.
Line 74: Line 80:
 **e)** After the upgrade completes, the router will restart. ​ **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.+**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. The device is finished with the installation when the LEDs stay (relatively) steady. If the lights are blinking on a regular frequency, then the installation is still running, after 45 minutes you should check out our [[openwrt:​troubleshooting|OpenWrt Troubleshooting]].
  
-**Notice:** WebUI, you visited ​for uploading the firmware, ​will time out in your browser. The reason is, that during the process the IP of the devices changes ​to 192.168.1.1, while your browser is pointing to something elsePirateBox is not shipped with a default WebUI for administrating,​ so don'​t ​try to access it via 192.168.1.1 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 routerPlease 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.
  
 <​html><​span style="​font-size:​125%;"><​b>​5. Next Steps</​b></​span></​html> ​ <​html><​span style="​font-size:​125%;"><​b>​5. Next Steps</​b></​span></​html> ​
Line 88: Line 94:
 ---- ----
 ===== Upgrade PirateBox ===== ===== 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. ​+**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 belowyou should follow the [[openwrt:​upgrade_pre_1.0.0|Update a very old PirateBox-HowTo]].+The upgrade process is different according the PirateBox ​version running ​on your router ​([[openwrt:​version|to know it]]): 
 +  * if **version 0.6 and below** is installed: ​you should follow the [[openwrt:​upgrade_pre_1.0.0|Update a very old PirateBox-HowTo]]
 +  * if **version 1.0.* ** is installed: you should follow the [[openwrt:​upgrade_from_1.0.0|Update from PirateBox 1.0 -HowTo]]. 
 +  * if **version 1.1.* ** is installed: the following instructions should get you up and running in a flash (literally!).
  
 <​html><​span style="​font-size:​125%;"><​b>​1. Download Software</​b></​span></​html> ​ <​html><​span style="​font-size:​125%;"><​b>​1. Download Software</​b></​span></​html> ​
Line 104: Line 113:
 <​html><​span style="​font-size:​125%;"><​b>​2. Install Custom OpenWrt</​b></​span></​html> ​ <​html><​span style="​font-size:​125%;"><​b>​2. Install Custom OpenWrt</​b></​span></​html> ​
  
-**a)** ​Drag the **"​*squashfs-factory.bin"​** file to your USB flash drive (you don't need to extract this file first!).+**a)** ​Create a folder on your USB flash drive called ''​auto_flash'​'.
  
-**b)** ​Now SAFELY REMOVE your USB drive from your computer and plug the USB stick into your OpenWrt router.+**b)** ​Drag the **"​*squashfs-factory.bin"​** file to this new folder ''​auto_flash''​ (you don't need to extract this file first!).
  
-**c)** ​Connect your router via ethernet cable to your computer and power up the router+**c)** ​Remove ​the old ''​install''​ folder.
  
-**d)** ​Once the router is runningopen a terminal window (for OS X, go to Applications > Utilities > Terminal; for Windows, install and open [[http://​www.chiark.greenend.org.uk/​~sgtatham/​putty/​|PuTTY]]) and log in with ssh:+**d)** ​Some features are in the frontend. If you want these featuresyou need to remove the folder called "​content"​ from your USB flash driveThis folder can be found under "​PirateBox"​You want to backup custom changes before doing that
  
-  ssh root@192.168.1.1  +**e)** ​Copy over the expanded ​install folder to your USB stick (take care the folders are not duplicate).
-   +
-**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!  +
- +
-<​html><​span style="​font-size:​125%;"><​b>​3. Install PirateBox</​b></​span></​html>​  +
- +
-**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.+**f)** 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. ​+**g)**  Put the USB stick to your PirateBox and 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. ​
  
 <​html><​span style="​font-size:​125%;"><​b>​4. Next Steps</​b></​span></​html> ​ <​html><​span style="​font-size:​125%;"><​b>​4. Next Steps</​b></​span></​html> ​
Line 167: Line 150:
   box_init_setup.sh   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. +**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. Write your password somewhere because you will not need it before several months (ie: PirateBox upgrade).
  
 **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: **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:
Line 177: Line 160:
 <​html><​span style="​font-size:​125%;"><​b>​2. Kareha Image and Discussion Board</​b></​span></​html> ​ <​html><​span style="​font-size:​125%;"><​b>​2. Kareha Image and Discussion Board</​b></​span></​html> ​
  
-**a)** ​Activate ​the Kareha Image and Discussion Board by using the vi text editor (**[[http://​www.lagmonster.org/​docs/​vi.html|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: +**a)** ​To activate your imageboard, run the following command
- +   ​/​opt/​piratebox/​bin/board-autoconf.sh
-  ​vi ​/​opt/​piratebox/​www/board/config.pl+
  
-**b)** ​Once you have updated the Kareha config.pl filepoint your web browser to http://​piratebox.lan/​board/​kareha.pl to activate it.+**b)** ​Enter your password, after you are promptedthen you are done.
   ​   ​
 <​html><​span style="​font-size:​125%;"><​b>​3. UPnP Media Server</​b></​span></​html> ​ <​html><​span style="​font-size:​125%;"><​b>​3. UPnP Media Server</​b></​span></​html> ​
Line 199: Line 181:
 <​html><​span style="​font-size:​125%;"><​b>​4. Next Steps</​b></​span></​html> ​ <​html><​span style="​font-size:​125%;"><​b>​4. Next Steps</​b></​span></​html> ​
  
-Your PirateBox 1.should be ready to use! Be sure to also check out the **[[:​openwrt|PirateBox OpenWrt page]]** and the **[[http://​forum.piratebox.cc/​list.php?​8|OpenWrt discussion board]]** on our **[[http://​forum.piratebox.cc|PirateBox Forum]]** for more info and support.+Your PirateBox 1.should be ready to use! Be sure to also check out the **[[:​openwrt|PirateBox OpenWrt page]]** and the **[[http://​forum.piratebox.cc/​list.php?​8|OpenWrt discussion board]]** on our **[[http://​forum.piratebox.cc|PirateBox Forum]]** for more info and support.
  
 \\ \\