nik/FreedomBox
1
0
Fork 0
mirror of https://github.com/freedombox/FreedomBox.git synced 2026-05-20 10:34:30 +00:00
Code Issues Packages Projects Releases Wiki Activity

Fetch latest manual from wiki

Browse Source
This commit is contained in:
James Valleroy 2017-01-22 14:22:11 -05:00
parent ffe9799089
commit 34b691cb7c
No known key found for this signature in database
GPG Key ID: 77C0C75E7B650808
1 changed files with 601 additions and 75 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

676
doc/freedombox-manual.xml
View File

@ -7,10 +7,10 @@
</articleinfo> </articleinfo>
<section> <section>
<title>FreedomBox: take your online privacy back</title> <title>FreedomBox: take your online privacy back</title>
<para>FreedomBox is a ready made personal server designed with privacy and data ownership in mind. It is a subset of the <ulink url="https://www.debian.org/">Debian universal operating system</ulink>, and includes free software only. You can run it on a small, inexpensive, and power-efficient computer box in your home, dedicated for that use. It can also be installed on any computer running Debian, or in a virtual machine.</para> <para>FreedomBox is a ready made personal server, designed with privacy and data ownership in mind. It is a subset of the <ulink url="https://www.debian.org/">Debian universal operating system</ulink> and includes free software only. You can run it on a small, inexpensive and power-efficient computer box in your home that is dedicated for that use. It can also be installed on any computer running Debian or in a virtual machine.</para>
<para>In order to replace third-party communication services data mining your entire life, you will be able to host services yourself, and use them at home or over the Internet through a browser or specialized apps. These services include chat and voice calls, calendar, webmail, file sharing, address book and news feed synchronization. For example, to start using a private chat service, activate the service from your administration interface, and add your friends as authorized users of the service. They will be able to connect to the service hosted on your FreedomBox, using XMPP chat clients such as Conversations on Android, Pidgin on Windows and Linux, or Messages on Mac OS, for encrypted communications.</para> <para>In order to replace third-party communication services that are data mining your entire life, you will be able to host services yourself and use them at home or over the Internet through a browser or specialized apps. These services include chat and voice calls, webmail, file sharing and calendar, address book and news feed synchronization. For example, to start using a private chat service, activate the service from the administration interface and add your friends as authorized users of the service. They will be able to connect to the service hosted on your FreedomBox, using XMPP chat clients such as Conversations on Android, Pidgin on Windows and Linux, or Messages on Mac OS, for encrypted communications.</para>
<para>FreedomBox can also host a Wi-Fi access point, ad blocking proxy, and VPN. More advanced users can replace their router with a FreedomBox. </para> <para>FreedomBox can also host a Wi-Fi access point, ad blocking proxy and VPN. More advanced users can replace their router with a FreedomBox. </para>
<para>To set up FreedomBox at home on a specific hardware, or on your computer running Debian, may required a bit of technical expertise or help from the community. Once installed, the interface is easy to use, similar to a smart phone. </para> <para>To set up FreedomBox at home on a specific hardware or on your computer running Debian may require a bit of technical expertise or help from the community. Once installed the interface is easy to use, similar to a smart phone. </para>
<para>Related documentation: </para> <para>Related documentation: </para>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
@ -40,12 +40,14 @@
</listitem> </listitem>
</itemizedlist> </itemizedlist>
<section> <section>
<title>Easy: Private Cloud</title> <title>Typical usage: Private Cloud</title>
<para>FreedomBox provides services: to your computers and mobile devices in your home, and to your friends. This includes secure instant messaging and low-bandwidth, high-quality voice conference calling. FreedomBox lets you publish your content in a blog and wiki to collaborate with the rest of the world. Coming soon, a personal email server and federated social networking using GNU Social and Diaspora, providing privacy-respecting alternatives to Gmail and Facebook. </para> <para>FreedomBox provides services to the computers and mobile devices in your home, and to your friends. This includes secure instant messaging and low-bandwidth, high-quality voice conference calling. FreedomBox lets you publish your content in a blog and wiki to collaborate with the rest of the world. On the roadmap are a personal email server and federated social networking using GNU Social and Diaspora, to provide privacy-respecting alternatives to Gmail and Facebook. </para>
</section> </section>
<section> <section>
<title>Advanced: Smart Home Router</title> <title>Advanced usage: Smart Home Router</title>
<para>FreedomBox runs in a physical computer and can route your traffic. It can sit between various devices at home such as mobiles, laptops and TVs and the Internet, replacing a home wireless router. By routing traffic, FreedomBox can remove tracking advertisements and malicious web bugs before they ever reach your devices. FreedomBox can cloak your location and protect your anonymity by "onion routing" your traffic over Tor. FreedomBox provides a VPN server that you can use while you are away from home to keep your traffic secret on untrusted public wireless networks and to securely access various devices at home. It can also be carried along with your laptop and used to connect to public networks at work, school, or office to avail its services. It could be used in a village to make available digital communications throughout the village. In future, FreedomBox intends to deliver support for alternative ways of connecting to the Internet such as Mesh networks. </para> <para>FreedomBox runs in a physical computer and can route your traffic. It can sit between various devices at home such as mobiles, laptops and TVs and the Internet, replacing a home wireless router. By routing traffic, FreedomBox can remove tracking advertisements and malicious web bugs before they ever reach your devices. FreedomBox can cloak your location and protect your anonymity by "onion routing" your traffic over Tor. FreedomBox provides a VPN server that you can use while you are away from home to keep your traffic secret on untrusted public wireless networks and to securely access various devices at home. </para>
<para>It can also be carried along with your laptop and used to connect to public networks at work, school or office to avail its services. </para>
<para>It could be used in a village to make available digital communications throughout the village. In the future, FreedomBox intends to deliver support for alternative ways of connecting to the Internet such as Mesh networking. </para>
</section> </section>
<section> <section>
<title>FreedomBox Interface</title> <title>FreedomBox Interface</title>
@ -77,16 +79,16 @@
<title>What you need to get started</title> <title>What you need to get started</title>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>A supported <ulink url="https://wiki.debian.org/FreedomBox/Hardware#">device</ulink> (including any device that can run Debian) </para> <para>A supported <ulink url="https://wiki.debian.org/FreedomBox/Hardware#">device</ulink> (including any device that can run Debian). We will call that the FreedomBox in the rest of this manual. </para>
</listitem> </listitem>
<listitem> <listitem>
<para>A power cable for your device </para> <para>A power cable for your device. </para>
</listitem> </listitem>
<listitem> <listitem>
<para>An ethernet cable </para> <para>An ethernet cable. </para>
</listitem> </listitem>
<listitem> <listitem>
<para>A microSD card (or equivalent storage media for your device), prepared according to the instructions on the <ulink url="https://wiki.debian.org/FreedomBox/Download#">Download</ulink> page </para> <para>A microSD card (or equivalent storage media for your device), prepared according to the instructions on the <ulink url="https://wiki.debian.org/FreedomBox/Download#">Download</ulink> page. </para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</section> </section>
@ -97,10 +99,10 @@
<para>Plug one end of your ethernet cord into your FreedomBox's ethernet port, and plug the other end into your router. </para> <para>Plug one end of your ethernet cord into your FreedomBox's ethernet port, and plug the other end into your router. </para>
</listitem> </listitem>
<listitem> <listitem>
<para>Power on your your FreedomBox. </para> <para>Power on the FreedomBox. </para>
</listitem> </listitem>
<listitem> <listitem>
<para>On first boot, the FreedomBox will perform initial setup and then reboot. This may take several minutes. </para> <para>On first boot, the FreedomBox will perform it's initial setup and then reboot. This may take several minutes. </para>
</listitem> </listitem>
<listitem> <listitem>
<para>After the FreedomBox has rebooted, you can access its web interface (called Plinth) through your web browser. </para> <para>After the FreedomBox has rebooted, you can access its web interface (called Plinth) through your web browser. </para>
@ -109,11 +111,15 @@
<para>If your computer is connected directly to the FreedomBox through a second (LAN) ethernet port, you can browse to: <ulink url="http://freedombox/"/> or <ulink url="http://10.42.0.1/"/>. </para> <para>If your computer is connected directly to the FreedomBox through a second (LAN) ethernet port, you can browse to: <ulink url="http://freedombox/"/> or <ulink url="http://10.42.0.1/"/>. </para>
</listitem> </listitem>
<listitem> <listitem>
<para>If your computer supports mDNS (GNU/Linux, Mac OSX and Windows with mDNS software installed), you can browse to: <ulink url="http://freedombox.local/"/> (or <ulink url="http://the-hostname-you-entered-during-install.local/"/>) </para> <para>If your computer supports mDNS (GNU/Linux, Mac OSX or Windows with mDNS software installed), you can browse to: <ulink url="http://freedombox.local/"/> (or <ulink url="http://the-hostname-you-entered-during-install.local/"/>) </para>
</listitem> </listitem>
<listitem> <listitem>
<para>If neither of these methods are available, then you will need to figure out the IP address of your FreedomBox. You can use the "nmap" program from your computer to find its IP address: </para> <para>If you know your way around the router's web interface, you can look up the IP adress of the FreedomBox there, and browse to that address. </para>
<screen format="linespecific"> nmap -p 80 --open -sV 192.168.0.0/24</screen> </listitem>
<listitem>
<para>If none of these methods are available, then you will need to figure out the IP address of your FreedomBox. You can use the "nmap" program from your computer to find its IP address: </para>
<screen format="linespecific"> nmap -p 80 --open -sV 192.168.0.0/24 (replace the ip/netmask with the one the router uses)</screen>
<para>In most cases you can look at your current ip adress, and change the last digits with zero to find your home network, like so: XXX.XXX.XXX.0/24 </para>
<para>Your FreedomBox will show up as an IP address with an open tcp port 80 using Apache httpd service on Debian, such as the example below which would make it accessible at <ulink url="http://192.168.0.165"/>: </para> <para>Your FreedomBox will show up as an IP address with an open tcp port 80 using Apache httpd service on Debian, such as the example below which would make it accessible at <ulink url="http://192.168.0.165"/>: </para>
<screen format="linespecific"> Nmap scan report for 192.168.0.165 <screen format="linespecific"> Nmap scan report for 192.168.0.165
Host is up (0.00088s latency). Host is up (0.00088s latency).
@ -131,7 +137,7 @@
</itemizedlist> </itemizedlist>
</listitem> </listitem>
<listitem> <listitem>
<para>On accessing Plinth your browser will warn you that it communicates securely but that it regards the security certificate for doing so as invalid. This is a fact you need to accept because the certificate is auto generated on the box and therefore "self-signed" (the browser might also use words such as "untrusted", "not private", "privacy error" or "unknown issuer/authority"). Telling your browser that you are aware of this might involve pressing buttons such as "I understand the Risks", "proceed to ... (unsafe)" or "Add exception". </para> <para>On accessing Plinth your browser will warn you that it communicates securely but that it regards the security certificate for doing so as invalid. This is a fact you need to accept because the certificate is auto generated on the box and therefore "self-signed" (the browser might also use words such as "untrusted", "not private", "privacy error" or "unknown issuer/authority"). Telling your browser that you are aware of this might involve pressing buttons such as "I understand the Risks", "proceed to ... (unsafe)" or "Add exception". After installation this certificate can be changed to a normal one using the Let's Encrypt option. </para>
<itemizedlist> <itemizedlist>
<listitem override="none"> <listitem override="none">
<para> <para>
@ -180,7 +186,7 @@
<para>The next page asks you to provide a user name and password. Fill in the form, and then click "Create Account." </para> <para>The next page asks you to provide a user name and password. Fill in the form, and then click "Create Account." </para>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>Note: The user that you create here has Admin privileges and can also <ulink url="https://wiki.debian.org/FreedomBox/Manual/SecureShell#">log in using ssh</ulink>. </para> <para>Note: The user that you create here has Admin privileges and can also <ulink url="https://wiki.debian.org/FreedomBox/Manual/SecureShell#">log in using ssh</ulink>. You might not want to use the user account you will want to use in daily usage, to prevent security issues. You can later add more users. </para>
</listitem> </listitem>
<listitem override="none"> <listitem override="none">
<para> <para>
@ -214,7 +220,7 @@
</itemizedlist> </itemizedlist>
</listitem> </listitem>
</orderedlist> </orderedlist>
<para>Now, you can try <ulink url="https://wiki.debian.org/FreedomBox/Features#">any of the Apps</ulink> that are available on FreedomBox. </para> <para>Now you can try <ulink url="https://wiki.debian.org/FreedomBox/Features#">any of the Apps</ulink> that are available on FreedomBox. </para>
</section> </section>
<section> <section>
<title>Finding your way around</title> <title>Finding your way around</title>
@ -263,7 +269,7 @@
</section> </section>
<section> <section>
<title>System menu</title> <title>System menu</title>
<para>The System menu can be accessed by clicking the gear icon in the top-right corner. It includes a number of pages related to the system configuration. </para> <para>The System menu can be accessed by clicking the gear icon in the top-right corner. It includes a number of pages related to system configuration. </para>
<para> <para>
<inlinemediaobject> <inlinemediaobject>
<imageobject> <imageobject>
@ -296,10 +302,10 @@
<para> <para>
<anchor id="gettinghelp"/> <anchor id="gettinghelp"/>
</para> </para>
<para>This document is intended to give you all the information you need to get started with your FreedomBox. However, if you have any questions after reading this document, you can get help by: </para> <para>This document is intended to give you the information you need to get started with your FreedomBox. However, if you have any questions after reading this document, you can get help by: </para>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>Emailing <ulink url="mailto:freedombox-discuss@lists.alioth.debian.org">freedombox-discuss@lists.alioth.debian.org</ulink>. You can also <ulink url="http://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss">sign up</ulink> to receive copies of every discussion that happens on the mailing list and <ulink url="http://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss">read the archives</ulink>. </para> <para>Emailing to our mailinglist at <ulink url="mailto:freedombox-discuss@lists.alioth.debian.org">freedombox-discuss@lists.alioth.debian.org</ulink>. You can also <ulink url="http://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss">sign up</ulink> to receive copies of every discussion that happens on the mailing list or <ulink url="http://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss">read the archives</ulink>. </para>
</listitem> </listitem>
<listitem> <listitem>
<para>Chatting at <ulink url="irc://irc.oftc.net:6667/%23freedombox">#freedombox@irc.oftc.net</ulink>. </para> <para>Chatting at <ulink url="irc://irc.oftc.net:6667/%23freedombox">#freedombox@irc.oftc.net</ulink>. </para>
@ -317,17 +323,17 @@
</section> </section>
<section> <section>
<title>Download and Install</title> <title>Download and Install</title>
<para>Welcome to the FreedomBox download page. You may either install FreedomBox on one of the supported inexpensive <ulink url="https://wiki.debian.org/FreedomBox/Hardware#">hardware</ulink>, on a Linux <ulink url="https://wiki.debian.org/FreedomBox/Hardware/Debian#">Debian</ulink> operating system, or deploy on a virtual machine. </para> <para>Welcome to the FreedomBox download page. You may either install FreedomBox on one of the supported inexpensive <ulink url="https://wiki.debian.org/FreedomBox/Hardware#">hardware</ulink> devices, on any Linux <ulink url="https://wiki.debian.org/FreedomBox/Hardware/Debian#">Debian</ulink> operating system, or deploy it on a virtual machine. </para>
<para>Installing on a machine running a Debian system is easy because FreedomBox is available as a package. We recommend to install FreedomBox on a supported single board computer though. The board will be dedicated for FreedomBox use from home. What we are requiring is to buy a device and plug in an SD card. In case of trouble when choosing the appropriate board or during install, please use <ulink url="https://wiki.debian.org/FreedomBox/Support#">Live Help</ulink> or read and interact with the <ulink url="https://wiki.debian.org/FreedomBox/QuestionsAndAnswers#">Questions and Answers</ulink> page based on <ulink url="https://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss">Freedombox-discuss</ulink> mailing list archives. </para> <para>Installing on a machine running a Debian system is easy because FreedomBox is available as a package. We do recommend to install FreedomBox on a supported single board computer (SBC). The board will be dedicated for FreedomBox use from home, this will prevent a lot of risks, such as accidental misconfiguration by the user. In case of trouble deciding which hardware is best for you or during the installation, please use the <ulink url="https://wiki.debian.org/FreedomBox/Support#">support page</ulink> or read the <ulink url="https://wiki.debian.org/FreedomBox/QuestionsAndAnswers#">Questions and Answers</ulink> page based on posts on the <ulink url="https://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss">Freedombox-discuss</ulink> mailing list archives. </para>
<section> <section>
<title>Downloading on Debian</title> <title>Downloading on Debian</title>
<para>If you are installing on Debian, you don't need to download these images. Instead read <ulink url="https://wiki.debian.org/FreedomBox/Hardware/Debian#">instructions</ulink> on setting up FreedomBox on Debian. </para> <para>If you are installing on an existing Debian installation, you don't need to download these images. Instead read the <ulink url="https://wiki.debian.org/FreedomBox/Hardware/Debian#">instructions</ulink> on setting up FreedomBox on Debian. </para>
</section> </section>
<section> <section>
<title>Downloading on Hardware or Virtual Machine</title> <title>Downloading for SBC or Virtual Machine</title>
<section> <section>
<title>Prepare your device</title> <title>Prepare your device</title>
<para>See hardware specific instructions on how to prepare your device at the <ulink url="https://wiki.debian.org/FreedomBox/Hardware#">Hardware</ulink> section. Gather and read a lot of documentation on the web about first boot and flashing USB or SD Card on your hardware. </para> <para>Read the hardware specific instructions on how to prepare your device at the <ulink url="https://wiki.debian.org/FreedomBox/Hardware#">Hardware</ulink> section. On the web is a lot of documentation about setting your device up and flashing USB or SD Cards to boot your hardware. </para>
</section> </section>
<section> <section>
<title>Downloading Images</title> <title>Downloading Images</title>
@ -381,7 +387,7 @@ sub 2048R/2A624357 2015-12-22</screen>
</section> </section>
<section> <section>
<title>Installation</title> <title>Installation</title>
<para>After the download you can use the image to boot <ulink url="https://wiki.debian.org/FreedomBox/Hardware#">supported hardware</ulink> (including virtual machines). You'll need to copy the image to the memory card or USB stick as follows: </para> <para>After the download you can use the image to boot your chosen <ulink url="https://wiki.debian.org/FreedomBox/Hardware#">hardware</ulink> (including virtual machines). You'll need to copy the image to the memory card or USB stick as follows: </para>
<orderedlist numeration="arabic" inheritnum="ignore" continuation="restarts"> <orderedlist numeration="arabic" inheritnum="ignore" continuation="restarts">
<listitem> <listitem>
<para>Figure out which device your card actually is. </para> <para>Figure out which device your card actually is. </para>
@ -426,11 +432,11 @@ sub 2048R/2A624357 2015-12-22</screen>
<para>The above command is an example for the <emphasis>cubietruck</emphasis> image built on 2015-12-13. Your downloaded file name will be different. </para> <para>The above command is an example for the <emphasis>cubietruck</emphasis> image built on 2015-12-13. Your downloaded file name will be different. </para>
</listitem> </listitem>
<listitem> <listitem>
<para>Copy the image to your card. Double check and make sure you don't write to your computer's main storage (such as /dev/sda). Also make sure that you don't run this step as root to avoid potentially overriding data on your hard drive due to a mistake in identifying the device or errors while typing the command. USB disks and SD cards inserted into the system should typically be write accessible to normal users. If you don't have permission to write to your SD card as a user, you may need to run this command as root. In this case triple check everything before you run the command. Another safety precaution is to unplug all external disks except the SD card before running the command. </para> <para>Copy the image to your card. Double check to make sure you don't write to your computer's main storage (such as /dev/sda). Also make sure that you don't run this step as root to avoid potentially overriding data on your hard drive due to a mistake in identifying the device or errors while typing the command. USB disks and SD cards inserted into the system should typically be write accessible to normal users. If you don't have permission to write to your SD card as a user, you may need to run this command as root. In this case triple check everything before you run the command. Another safety precaution is to unplug all external disks except the SD card before running the command. </para>
<para>For example, if your SD card is <emphasis>/dev/sdf</emphasis> as noted in the first step above, then to copy the image, run: </para> <para>For example, if your SD card is <emphasis>/dev/sdg</emphasis> as noted in the first step above, then to copy the image, run: </para>
<screen format="linespecific">$ dd bs=1M if=freedombox-unstable-free_2015-12-13_cubietruck-armhf.img of=/dev/sdf conv=fdatasync</screen> <screen format="linespecific">$ dd bs=1M if=freedombox-unstable-free_2015-12-13_cubietruck-armhf.img of=/dev/sdg conv=fdatasync</screen>
<para>The above command is an example for the <emphasis>cubietruck</emphasis> image built on 2015-12-13. Your image file name will be different. </para> <para>The above command is an example for the <emphasis>cubietruck</emphasis> image built on 2015-12-13. Your image file name will be different. </para>
<para>When picking a device, use the drive-letter destination, like <emphasis>/dev/sdf</emphasis>, not a numbered destination, like <emphasis>/dev/sdf1</emphasis>. The device without a number refers to the entire device, while the device with a number refers to a specific partition. We want to use the whole device. Downloaded images contain complete information about how many partitions there should be, their sizes and types. You don't have to format your SD card or create partitions. All the data on the SD card will be wiped off during the write process. </para> <para>When picking a device, use the drive-letter destination, like <emphasis>/dev/sdg</emphasis>, not a numbered destination, like <emphasis>/dev/sdg1</emphasis>. The device without a number refers to the entire device, while the device with a number refers to a specific partition. We want to use the whole device. Downloaded images contain complete information about how many partitions there should be, their sizes and types. You don't have to format your SD card or create partitions. All the data on the SD card will be wiped off during the write process. </para>
</listitem> </listitem>
<listitem> <listitem>
<para>Use the image by inserting the SD card or USB disk into the target device and booting from it. Your device should also be prepared (see the <ulink url="https://wiki.debian.org/FreedomBox/Hardware#">Hardware</ulink> section). </para> <para>Use the image by inserting the SD card or USB disk into the target device and booting from it. Your device should also be prepared (see the <ulink url="https://wiki.debian.org/FreedomBox/Hardware#">Hardware</ulink> section). </para>
@ -586,19 +592,6 @@ sub 2048R/2A624357 2015-12-22</screen>
</itemizedlist> </itemizedlist>
</section> </section>
</section> </section>
<section>
<title>Bookmarks (Shaarli)</title>
<caution>
<para>
<emphasis role="strong">Currently not functional</emphasis>
</para>
<para>Shaarli is currently not available in Debian testing and the version in sid is said to be not functional. We are expecting this will soon be resolved and Shaarli will be again available in the <ulink url="https://wiki.debian.org/FreedomBox#">FreedomBox</ulink>. </para>
</caution>
<section>
<title>What is Shaarli?</title>
<para>Shaarli is personal (single-user) bookmarking application to install on your FreedomBox. It can also be used for micro-blogging, pastebin, online notepad and snippet archive. Shaarli is designed as a no-database delicious clone. As such, it provides very fast services, easy backup and import/export links as desktop or mobile browser bookmarks. Links stored can be public or private. Shaarli delivers ATOM and RSS feeds from its minimalist interface. </para>
</section>
</section>
<section> <section>
<title>Calendar and Addressbook (Radicale)</title> <title>Calendar and Addressbook (Radicale)</title>
<para>With Radicale, you can synchronize your personal calendars, ToDo lists, and addressbooks with your various computers, tablets, and smartphones, and share them with friends, without letting third parties know your personal schedule or contacts. </para> <para>With Radicale, you can synchronize your personal calendars, ToDo lists, and addressbooks with your various computers, tablets, and smartphones, and share them with friends, without letting third parties know your personal schedule or contacts. </para>
@ -3985,7 +3978,7 @@ Password:
</section> </section>
<section> <section>
<title>Hardware</title> <title>Hardware</title>
<para>FreedomBox is aimed as a consumer electronics device that is easy to setup, maintain and use. The project does not aim to create a custom hardware device. Instead we plan to support/customize exiting hardware. </para> <para>FreedomBox is designed to be the software for a consumer electronics device that is easy to setup, maintain and use. The project does not aim to create a custom hardware device ourselves, but instead we plan to support/customize exiting hardware. </para>
<para>In addition to supporting various single board computers and other devices, FreedomBox also supports being installed in a virtual machine. Also, any Debian machine can be turned into a FreedomBox by installing the <code>freedombox-setup</code> package. See the <ulink url="https://wiki.debian.org/FreedomBox/Manual#">manual</ulink> for more details. </para> <para>In addition to supporting various single board computers and other devices, FreedomBox also supports being installed in a virtual machine. Also, any Debian machine can be turned into a FreedomBox by installing the <code>freedombox-setup</code> package. See the <ulink url="https://wiki.debian.org/FreedomBox/Manual#">manual</ulink> for more details. </para>
<section> <section>
<title>Supported Hardware</title> <title>Supported Hardware</title>
@ -4139,13 +4132,546 @@ Password:
<ulink url="https://wiki.debian.org/FreedomBox/Hardware/VirtualBox#">VirtualBox</ulink> <ulink url="https://wiki.debian.org/FreedomBox/Hardware/VirtualBox#">VirtualBox</ulink>
</para> </para>
</entry> </entry>
<entry colsep="1" rowsep="1"> <entry colsep="1" rowsep="1"/>
<para>.</para>
</entry>
</row> </row>
</tbody> </tbody>
</tgroup> </tgroup>
</informaltable> </informaltable>
<section>
<title>Recommended Hardware chart</title>
<informaltable>
<tgroup cols="9">
<colspec colname="col_0"/>
<colspec colname="col_1"/>
<colspec colname="col_2"/>
<colspec colname="col_3"/>
<colspec colname="col_4"/>
<colspec colname="col_5"/>
<colspec colname="col_6"/>
<colspec colname="col_7"/>
<colspec colname="col_8"/>
<tbody>
<row rowsep="1">
<entry colsep="1" rowsep="1">
<para>
<emphasis role="strong">Name</emphasis>
</para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<emphasis role="strong">Speed (GHz)</emphasis>
</para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<emphasis role="strong">Debian arch</emphasis>
</para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<emphasis role="strong">Ram (GB)</emphasis>
</para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<emphasis role="strong">disk (GB)</emphasis>
</para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<emphasis role="strong">battery</emphasis>
</para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<emphasis role="strong">SATA</emphasis>
</para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<emphasis role="strong">Ethernet speed</emphasis>
</para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<emphasis role="strong">
<ulink url="https://wiki.debian.org/OpenSourceHardware#">OSHW</ulink>
</emphasis>
</para>
</entry>
</row>
<row rowsep="1">
<entry colsep="1" rowsep="1">
<para>APU.1D </para>
</entry>
<entry colsep="1" rowsep="1">
<para>1x2</para>
</entry>
<entry colsep="1" rowsep="1">
<para>amd64 </para>
</entry>
<entry colsep="1" rowsep="1">
<para>2</para>
</entry>
<entry colsep="1" rowsep="1">
<para>-</para>
</entry>
<entry colsep="1" rowsep="1">
<para> - </para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<inlinemediaobject>
<imageobject>
<imagedata depth="8pt" fileref="images/checkmark.png" width="8pt"/>
</imageobject>
<textobject>
<phrase>(./)</phrase>
</textobject>
</inlinemediaobject>
</para>
</entry>
<entry colsep="1" rowsep="1">
<para>1000x3</para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<inlinemediaobject>
<imageobject>
<imagedata depth="8pt" fileref="images/icon-error.png" width="8pt"/>
</imageobject>
<textobject>
<phrase>{X}</phrase>
</textobject>
</inlinemediaobject>
</para>
</entry>
</row>
<row rowsep="1">
<entry colsep="1" rowsep="1">
<para>APU.1D4 </para>
</entry>
<entry colsep="1" rowsep="1">
<para>1x2</para>
</entry>
<entry colsep="1" rowsep="1">
<para>amd64 </para>
</entry>
<entry colsep="1" rowsep="1">
<para>4</para>
</entry>
<entry colsep="1" rowsep="1">
<para>-</para>
</entry>
<entry colsep="1" rowsep="1">
<para> - </para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<inlinemediaobject>
<imageobject>
<imagedata depth="8pt" fileref="images/checkmark.png" width="8pt"/>
</imageobject>
<textobject>
<phrase>(./)</phrase>
</textobject>
</inlinemediaobject>
</para>
</entry>
<entry colsep="1" rowsep="1">
<para>1000x3</para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<inlinemediaobject>
<imageobject>
<imagedata depth="8pt" fileref="images/icon-error.png" width="8pt"/>
</imageobject>
<textobject>
<phrase>{X}</phrase>
</textobject>
</inlinemediaobject>
</para>
</entry>
</row>
<row rowsep="1">
<entry colsep="1" rowsep="1">
<para>BeagleBone Black C </para>
</entry>
<entry colsep="1" rowsep="1">
<para>1 </para>
</entry>
<entry colsep="1" rowsep="1">
<para>armhf/omap </para>
</entry>
<entry colsep="1" rowsep="1">
<para>½</para>
</entry>
<entry colsep="1" rowsep="1">
<para>4</para>
</entry>
<entry colsep="1" rowsep="1">
<para> - </para>
</entry>
<entry colsep="1" rowsep="1">
<para> - </para>
</entry>
<entry colsep="1" rowsep="1">
<para>100 </para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<inlinemediaobject>
<imageobject>
<imagedata depth="8pt" fileref="images/checkmark.png" width="8pt"/>
</imageobject>
<textobject>
<phrase>(./)</phrase>
</textobject>
</inlinemediaobject>
</para>
</entry>
</row>
<row rowsep="1">
<entry colsep="1" rowsep="1">
<para>Cubieboard2 </para>
</entry>
<entry colsep="1" rowsep="1">
<para>1x2</para>
</entry>
<entry colsep="1" rowsep="1">
<para>armhf/sunxi </para>
</entry>
<entry colsep="1" rowsep="1">
<para>1</para>
</entry>
<entry colsep="1" rowsep="1">
<para>4</para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<inlinemediaobject>
<imageobject>
<imagedata depth="8pt" fileref="images/checkmark.png" width="8pt"/>
</imageobject>
<textobject>
<phrase>(./)</phrase>
</textobject>
</inlinemediaobject>
</para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<inlinemediaobject>
<imageobject>
<imagedata depth="8pt" fileref="images/checkmark.png" width="8pt"/>
</imageobject>
<textobject>
<phrase>(./)</phrase>
</textobject>
</inlinemediaobject>
</para>
</entry>
<entry colsep="1" rowsep="1">
<para>100 </para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<inlinemediaobject>
<imageobject>
<imagedata depth="8pt" fileref="images/icon-error.png" width="8pt"/>
</imageobject>
<textobject>
<phrase>{X}</phrase>
</textobject>
</inlinemediaobject>
</para>
</entry>
</row>
<row rowsep="1">
<entry colsep="1" rowsep="1">
<para>Cubieboard2-Dual </para>
</entry>
<entry colsep="1" rowsep="1">
<para>1x2</para>
</entry>
<entry colsep="1" rowsep="1">
<para>armhf/sunxi </para>
</entry>
<entry colsep="1" rowsep="1">
<para>1</para>
</entry>
<entry colsep="1" rowsep="1">
<para>-</para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<inlinemediaobject>
<imageobject>
<imagedata depth="8pt" fileref="images/checkmark.png" width="8pt"/>
</imageobject>
<textobject>
<phrase>(./)</phrase>
</textobject>
</inlinemediaobject>
</para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<inlinemediaobject>
<imageobject>
<imagedata depth="8pt" fileref="images/checkmark.png" width="8pt"/>
</imageobject>
<textobject>
<phrase>(./)</phrase>
</textobject>
</inlinemediaobject>
</para>
</entry>
<entry colsep="1" rowsep="1">
<para>100 </para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<inlinemediaobject>
<imageobject>
<imagedata depth="8pt" fileref="images/icon-error.png" width="8pt"/>
</imageobject>
<textobject>
<phrase>{X}</phrase>
</textobject>
</inlinemediaobject>
</para>
</entry>
</row>
<row rowsep="1">
<entry colsep="1" rowsep="1">
<para>Cubieboard3/Cubietruck </para>
</entry>
<entry colsep="1" rowsep="1">
<para>1x2</para>
</entry>
<entry colsep="1" rowsep="1">
<para>armhf/sunxi </para>
</entry>
<entry colsep="1" rowsep="1">
<para>2</para>
</entry>
<entry colsep="1" rowsep="1">
<para>8</para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<inlinemediaobject>
<imageobject>
<imagedata depth="8pt" fileref="images/checkmark.png" width="8pt"/>
</imageobject>
<textobject>
<phrase>(./)</phrase>
</textobject>
</inlinemediaobject>
</para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<inlinemediaobject>
<imageobject>
<imagedata depth="8pt" fileref="images/checkmark.png" width="8pt"/>
</imageobject>
<textobject>
<phrase>(./)</phrase>
</textobject>
</inlinemediaobject>
</para>
</entry>
<entry colsep="1" rowsep="1">
<para>1000 </para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<inlinemediaobject>
<imageobject>
<imagedata depth="8pt" fileref="images/icon-error.png" width="8pt"/>
</imageobject>
<textobject>
<phrase>{X}</phrase>
</textobject>
</inlinemediaobject>
</para>
</entry>
</row>
<row rowsep="1">
<entry colsep="1" rowsep="1">
<para>OLinuXino A20 LIME </para>
</entry>
<entry colsep="1" rowsep="1">
<para>1x2</para>
</entry>
<entry colsep="1" rowsep="1">
<para>armhf/sunxi </para>
</entry>
<entry colsep="1" rowsep="1">
<para>½</para>
</entry>
<entry colsep="1" rowsep="1">
<para>-</para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<inlinemediaobject>
<imageobject>
<imagedata depth="8pt" fileref="images/checkmark.png" width="8pt"/>
</imageobject>
<textobject>
<phrase>(./)</phrase>
</textobject>
</inlinemediaobject>
</para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<inlinemediaobject>
<imageobject>
<imagedata depth="8pt" fileref="images/checkmark.png" width="8pt"/>
</imageobject>
<textobject>
<phrase>(./)</phrase>
</textobject>
</inlinemediaobject>
</para>
</entry>
<entry colsep="1" rowsep="1">
<para>100 </para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<inlinemediaobject>
<imageobject>
<imagedata depth="8pt" fileref="images/checkmark.png" width="8pt"/>
</imageobject>
<textobject>
<phrase>(./)</phrase>
</textobject>
</inlinemediaobject>
</para>
</entry>
</row>
<row rowsep="1">
<entry colsep="1" rowsep="1">
<para>OLinuXino A20 LIME2 </para>
</entry>
<entry colsep="1" rowsep="1">
<para>1x2</para>
</entry>
<entry colsep="1" rowsep="1">
<para>armhf/sunxi </para>
</entry>
<entry colsep="1" rowsep="1">
<para>1</para>
</entry>
<entry colsep="1" rowsep="1">
<para>-</para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<inlinemediaobject>
<imageobject>
<imagedata depth="8pt" fileref="images/checkmark.png" width="8pt"/>
</imageobject>
<textobject>
<phrase>(./)</phrase>
</textobject>
</inlinemediaobject>
</para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<inlinemediaobject>
<imageobject>
<imagedata depth="8pt" fileref="images/checkmark.png" width="8pt"/>
</imageobject>
<textobject>
<phrase>(./)</phrase>
</textobject>
</inlinemediaobject>
</para>
</entry>
<entry colsep="1" rowsep="1">
<para>1000 </para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<inlinemediaobject>
<imageobject>
<imagedata depth="8pt" fileref="images/checkmark.png" width="8pt"/>
</imageobject>
<textobject>
<phrase>(./)</phrase>
</textobject>
</inlinemediaobject>
</para>
</entry>
</row>
<row rowsep="1">
<entry colsep="1" rowsep="1">
<para>OLinuXino A20 MICRO </para>
</entry>
<entry colsep="1" rowsep="1">
<para>1x2</para>
</entry>
<entry colsep="1" rowsep="1">
<para>armhf/sunxi </para>
</entry>
<entry colsep="1" rowsep="1">
<para>1</para>
</entry>
<entry colsep="1" rowsep="1">
<para>-</para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<inlinemediaobject>
<imageobject>
<imagedata depth="8pt" fileref="images/checkmark.png" width="8pt"/>
</imageobject>
<textobject>
<phrase>(./)</phrase>
</textobject>
</inlinemediaobject>
</para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<inlinemediaobject>
<imageobject>
<imagedata depth="8pt" fileref="images/checkmark.png" width="8pt"/>
</imageobject>
<textobject>
<phrase>(./)</phrase>
</textobject>
</inlinemediaobject>
</para>
</entry>
<entry colsep="1" rowsep="1">
<para>100 </para>
</entry>
<entry colsep="1" rowsep="1">
<para>
<inlinemediaobject>
<imageobject>
<imagedata depth="8pt" fileref="images/checkmark.png" width="8pt"/>
</imageobject>
<textobject>
<phrase>(./)</phrase>
</textobject>
</inlinemediaobject>
</para>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</section>
</section> </section>
<section> <section>
<title>Also Working Hardware</title> <title>Also Working Hardware</title>
@ -4237,18 +4763,18 @@ Password:
</tbody> </tbody>
</tgroup> </tgroup>
</informaltable> </informaltable>
<para><emphasis>Note</emphasis>: As FreedomBox is in development state, <emphasis>Supported Hardware</emphasis> means that FreedomBox images are built for the said hardware and at least one developers has reported the basic functions to be working. </para> <para><emphasis>Note</emphasis>: As FreedomBox is currently in the development stage, <emphasis>Supported Hardware</emphasis> means that FreedomBox images are built for said hardware and at least one developer has reported the basic functions to be working. </para>
</section> </section>
</section> </section>
<section> <section>
<title>Targeted Hardware</title> <title>Targeted Hardware</title>
<section> <section>
<title>List of Hardware Targeted</title> <title>List of Targeted Hardware</title>
<para>Although the project may focus on supporting specific devices, we are looking to support as wider a variety of hardware as possible that is suitable for FreedomBox needs. Take a look at the list of <ulink url="https://wiki.debian.org/FreedomBox/TargetedHardware#">hardware targeted</ulink> for support. </para> <para>Although the project may focus on supporting specific devices, we are looking to support as much hardware as possible given that it is suitable for FreedomBox's needs. Take a look at the list of <ulink url="https://wiki.debian.org/FreedomBox/TargetedHardware#">targeted hardware</ulink> for more information. </para>
</section> </section>
<section> <section>
<title>Adding Hardware Support</title> <title>Adding Hardware Support</title>
<para>If you are a developer, consider adding hardware support for your device by modifying <ulink url="https://wiki.debian.org/FreedomBox/Maker#">Freedom Maker</ulink> and <ulink url="https://wiki.debian.org/FreedomBox/Setup#">FreedomBox Setup</ulink>. </para> <para>If you are a developer, consider adding hardware support for your device by modifying <ulink url="https://wiki.debian.org/FreedomBox/Maker#">Freedom Maker</ulink> and <ulink url="https://wiki.debian.org/FreedomBox/Setup#">FreedomBox Setup</ulink>. If you have access to one of these <ulink url="https://wiki.debian.org/FreedomBox/TargetedHardware#">targeted hardware</ulink> devices and would like to work with us to make it run FreedomBox, please contact us! </para>
</section> </section>
</section> </section>
<section> <section>
@ -4265,16 +4791,16 @@ Password:
</textobject> </textobject>
</inlinemediaobject> </inlinemediaobject>
</para> </para>
<para><ulink url="http://projectdanube.org">FreedomBox Danube Edition</ulink> is a custom casing around Cubietruck coupled with an SSD. </para> <para><ulink url="http://projectdanube.org">FreedomBox Danube Edition</ulink> is a custom casing around Cubietruck and an SSD-hard drive. </para>
</section> </section>
<section> <section>
<title>Cubietruck / Cubieboard3</title> <title>Cubietruck / Cubieboard3</title>
<para><ulink url="http://cubieboard.org/model/">Cubietruck</ulink> (Cubieboard3) is a single board computer with better performance than many other such boards. FreedomBox images are being built for it. For using this board as FreedomBox, a separate <ulink url="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#">USB WiFi device</ulink> that does not require non-free firmware is recommended. </para> <para><ulink url="http://cubieboard.org/model/">Cubietruck</ulink> (Cubieboard3) is a single board computer with very good performance compared to many other boards. FreedomBox images are built for this device. To use this board as FreedomBox, a separate <ulink url="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#">USB WiFi device</ulink> that does not require non-free firmware is recommended. </para>
</section> </section>
<section> <section>
<title>Download</title> <title>Download</title>
<para>FreedomBox SD card <ulink url="https://wiki.debian.org/FreedomBox/Download#">images</ulink> for this hardware are being built. These SD card images are meant for use with the on-board SD card slot and won't work when used with a separate SD card reader connected via USB. </para> <para>FreedomBox SD card <ulink url="https://wiki.debian.org/FreedomBox/Download#">images</ulink> are provided for this hardware. These SD card images are meant for use with the on-board SD card slot and do not work when used with a separate SD card reader connected via USB. </para>
<para>An alternative to downloading these images is to <ulink url="https://wiki.debian.org/InstallingDebianOn/Allwinner#">install Debian</ulink> on Cubietruck and then <ulink url="https://wiki.debian.org/FreedomBox/Hardware/Debian#">install FreedomBox</ulink> on it. </para> <para>An alternative to downloading these images is to <ulink url="https://wiki.debian.org/InstallingDebianOn/Allwinner#">install Debian</ulink> on the Cubietruck and then <ulink url="https://wiki.debian.org/FreedomBox/Hardware/Debian#">install FreedomBox</ulink> on it. </para>
</section> </section>
<section> <section>
<title>Build Image</title> <title>Build Image</title>
@ -4347,7 +4873,7 @@ Password:
<title>Known Issues</title> <title>Known Issues</title>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>WiFi does not work with free software. A separate <ulink url="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#">USB WiFi device</ulink> is recommended. </para> <para>The on-board WiFi does not work with free software. A separate <ulink url="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#">USB WiFi device</ulink> is recommended. </para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</section> </section>
@ -4364,12 +4890,12 @@ Password:
</textobject> </textobject>
</inlinemediaobject> </inlinemediaobject>
</para> </para>
<para><ulink url="http://beagleboard.org/black">Beagle Bone Black</ulink> (Revision C.1) is an open hardware single board computer. FreedomBox images are built and tested for it. For using this board as FreedomBox, a <ulink url="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#">USB WiFi device</ulink> that does not require non-free firmware is recommended. </para> <para><ulink url="http://beagleboard.org/black">Beagle Bone Black</ulink> (Revision C.1) is an Open Source Hardware (OSHW) single board computer. This means that the designer is actively helping people using the platform for their own designs, and supports them in adding hardware functionality and production advice. This is a part of freedom that is often overlooked, but very much aligned with the FreedomBox goals. FreedomBox images are built and tested for this device. To use this device as a FreedomBox, a separate USB <ulink url="https://wiki.debian.org/WiFi#">WiFi</ulink> device that does not require non-free firmware is recommended. </para>
<section> <section>
<title>Download</title> <title>Download</title>
<para>FreedomBox SD card <ulink url="https://wiki.debian.org/FreedomBox/Download#">images</ulink> for this hardware are available. Follow the instructions on the <ulink url="https://wiki.debian.org/FreedomBox/Download#">download</ulink> page to create a FreedomBox SD card and boot into FreedomBox. </para> <para>FreedomBox SD card <ulink url="https://wiki.debian.org/FreedomBox/Download#">images</ulink> are available for this device. Follow the instructions on the <ulink url="https://wiki.debian.org/FreedomBox/Download#">download</ulink> page to create a FreedomBox SD card and boot the device. </para>
<para>Note: This image is for BeagleBone Black. It won't work on BeagleBone Green. </para> <para>Note: This image is for BeagleBone Black (Revision C.1) only. It will not work on the BeagleBone Green, and also not on the Revisions A&amp;B. If you have such a device and would like to help getting FreedomBox to run on it, contact us! </para>
<para>An alternative to downloading these images is to <ulink url="https://wiki.debian.org/InstallingDebianOn/TI/BeagleBone#">install Debian</ulink> on BeagleBone and then <ulink url="https://wiki.debian.org/FreedomBox/Hardware/Debian#">install FreedomBox</ulink> on it. </para> <para>An alternative to downloading these images is to <ulink url="https://wiki.debian.org/InstallingDebianOn/TI/BeagleBone#">install Debian</ulink> on the BeagleBone and then <ulink url="https://wiki.debian.org/FreedomBox/Hardware/Debian#">install FreedomBox</ulink> on it. </para>
</section> </section>
<section> <section>
<title>Build Image</title> <title>Build Image</title>
@ -4397,7 +4923,7 @@ Password:
<title>Hardware</title> <title>Hardware</title>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>Open Hardware: <ulink url="http://elinux.org/Beagleboard:BeagleBoneBlack">Yes</ulink> </para> <para>Open Source Hardware (OSHW): <ulink url="http://elinux.org/Beagleboard:BeagleBoneBlack">Yes</ulink> </para>
</listitem> </listitem>
<listitem> <listitem>
<para>CPU: <ulink url="http://www.ti.com/product/am3358">AM335x 1GHz ARM Cortex-A8</ulink> </para> <para>CPU: <ulink url="http://www.ti.com/product/am3358">AM335x 1GHz ARM Cortex-A8</ulink> </para>
@ -4453,7 +4979,7 @@ Password:
</textobject> </textobject>
</inlinemediaobject> </inlinemediaobject>
</para> </para>
<para>Olimex's <ulink url="https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXIno-LIME2/open-source-hardware">A20 OLinuXino Lime2</ulink> is fully open source hardware single board computer using the Allwinner A20 Dual Core ARM processor. FreedomBox images are being built for it starting with version 0.7. For using this board as FreedomBox, a separate <ulink url="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#">USB WiFi device</ulink> that does not require non-free firmware is recommended. </para> <para>Olimex's <ulink url="https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXIno-LIME2/open-source-hardware">A20 OLinuXino Lime2</ulink> is a fully Open Source Hardware (OSHW) single board computer. This means that the designer is actively helping people using the platform for their own designs, and supports them in adding hardware functionality and production advice. This is a part of freedom that is often overlooked, but very much aligned with the FreedomBox goals. It uses the Allwinner A20 Dual Core ARM processor. FreedomBox images are built and tested for this device starting with version 0.7. To use this device as a FreedomBox, a separate USB <ulink url="https://wiki.debian.org/WiFi#">WiFi</ulink> device that does not require non-free firmware is recommended. </para>
<section> <section>
<title>Similar Hardware</title> <title>Similar Hardware</title>
<para>The following similar hardware will also work well with FreedomBox. </para> <para>The following similar hardware will also work well with FreedomBox. </para>
@ -4465,12 +4991,12 @@ Password:
</section> </section>
<section> <section>
<title>Download</title> <title>Download</title>
<para>FreedomBox SD card <ulink url="https://wiki.debian.org/FreedomBox/Download#">images</ulink> for this hardware are being built. These SD card images are meant for use with the on-board SD card slot and won't work when used with a separate SD card reader connected via USB. </para> <para>FreedomBox SD card <ulink url="https://wiki.debian.org/FreedomBox/Download#">images</ulink> are available for this device. Follow the instructions on the <ulink url="https://wiki.debian.org/FreedomBox/Download#">download</ulink> page to create a FreedomBox SD card and boot the device. These SD card images are meant for use with the on-board SD card slot and won't work when used with a separate SD card reader connected via USB. </para>
<para>An alternative to downloading these images is to <ulink url="https://wiki.debian.org/InstallingDebianOn/Allwinner#">install Debian</ulink> on the device and then <ulink url="https://wiki.debian.org/FreedomBox/Hardware/Debian#">install FreedomBox</ulink> on it. </para> <para>An alternative to downloading these images is to <ulink url="https://wiki.debian.org/InstallingDebianOn/Allwinner#">install Debian</ulink> on the device and then <ulink url="https://wiki.debian.org/FreedomBox/Hardware/Debian#">install FreedomBox</ulink> on it. </para>
</section> </section>
<section> <section>
<title>Build Image</title> <title>Build Image</title>
<para>FreedomBox images for this hardware can be built using <ulink url="https://wiki.debian.org/FreedomBox/Maker#">Freedom Maker</ulink> once the support for it is added. </para> <para>FreedomBox images for this hardware can be built using <ulink url="https://wiki.debian.org/FreedomBox/Maker#">Freedom Maker</ulink>. </para>
</section> </section>
<section> <section>
<title>Availability</title> <title>Availability</title>
@ -4492,7 +5018,7 @@ Password:
<title>Hardware</title> <title>Hardware</title>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>Open Source Hardware (OSHW): Yes </para> <para>Open Source Hardware (OSHW): <ulink url="https://github.com/OLIMEX/OLINUXINO/tree/master/HARDWARE">Yes</ulink> </para>
</listitem> </listitem>
<listitem> <listitem>
<para>CPU: Allwinner A20, ARM Cortex-A7 @ 1GHz dual-core </para> <para>CPU: Allwinner A20, ARM Cortex-A7 @ 1GHz dual-core </para>
@ -4538,7 +5064,7 @@ Password:
<title>Known Issues</title> <title>Known Issues</title>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>WiFi is not available. A separate <ulink url="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#">USB WiFi device</ulink> is recommended. </para> <para>None </para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</section> </section>
@ -4555,7 +5081,7 @@ Password:
</textobject> </textobject>
</inlinemediaobject> </inlinemediaobject>
</para> </para>
<para>Olimex's <ulink url="https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXIno-MICRO/open-source-hardware">A20 OLinuXino MICRO</ulink> is fully open source hardware single board computer using the Allwinner A20 Dual Core ARM processor. FreedomBox images are being built for it starting with version 0.7. For using this board as FreedomBox, a separate <ulink url="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#">USB WiFi device</ulink> that does not require non-free firmware is recommended. </para> <para>Olimex's <ulink url="https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXIno-MICRO/open-source-hardware">A20 OLinuXino MICRO</ulink> is a fully Open Source Hardware (OSHW) single board computer. This means that the designer is actively helping people using the platform for their own designs, and supports them in adding hardware functionality and production advice. This is a part of freedom that is often overlooked, but very much aligned with the FreedomBox goals. It uses the Allwinner A20 Dual Core ARM processor. FreedomBox images are built and tested for this device starting with version 0.7. To use this device as a FreedomBox, a separate USB <ulink url="https://wiki.debian.org/WiFi#">WiFi</ulink> device that does not require non-free firmware is recommended. </para>
<section> <section>
<title>Similar Hardware</title> <title>Similar Hardware</title>
<para>The following similar hardware will also work well with FreedomBox. </para> <para>The following similar hardware will also work well with FreedomBox. </para>
@ -4567,12 +5093,12 @@ Password:
</section> </section>
<section> <section>
<title>Download</title> <title>Download</title>
<para>FreedomBox SD card <ulink url="https://wiki.debian.org/FreedomBox/Download#">images</ulink> for this hardware are being built. These SD card images are meant for use with the on-board SD card slot and won't work when used with a separate SD card reader connected via USB. </para> <para>FreedomBox SD card <ulink url="https://wiki.debian.org/FreedomBox/Download#">images</ulink> are available for this device. Follow the instructions on the <ulink url="https://wiki.debian.org/FreedomBox/Download#">download</ulink> page to create a FreedomBox SD card and boot the device. These SD card images are meant for use with the on-board SD card slot and won't work when used with a separate SD card reader connected via USB. </para>
<para>An alternative to downloading these images is to <ulink url="https://wiki.debian.org/InstallingDebianOn/Allwinner#">install Debian</ulink> on the device and then <ulink url="https://wiki.debian.org/FreedomBox/Hardware/Debian#">install FreedomBox</ulink> on it. </para> <para>An alternative to downloading these images is to <ulink url="https://wiki.debian.org/InstallingDebianOn/Allwinner#">install Debian</ulink> on the device and then <ulink url="https://wiki.debian.org/FreedomBox/Hardware/Debian#">install FreedomBox</ulink> on it. </para>
</section> </section>
<section> <section>
<title>Build Image</title> <title>Build Image</title>
<para>FreedomBox images for this hardware can be built using <ulink url="https://wiki.debian.org/FreedomBox/Maker#">Freedom Maker</ulink> once the support for it is added. </para> <para>FreedomBox images for this hardware can be built using <ulink url="https://wiki.debian.org/FreedomBox/Maker#">Freedom Maker</ulink>. </para>
</section> </section>
<section> <section>
<title>Availability</title> <title>Availability</title>
@ -4594,7 +5120,7 @@ Password:
<title>Hardware</title> <title>Hardware</title>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>Open Source Hardware (OSHW): Yes </para> <para>Open Source Hardware (OSHW): <ulink url="https://github.com/OLIMEX/OLINUXINO/tree/master/HARDWARE">Yes</ulink> </para>
</listitem> </listitem>
<listitem> <listitem>
<para>CPU: Allwinner A20, ARM Cortex-A7 @ 1GHz dual-core </para> <para>CPU: Allwinner A20, ARM Cortex-A7 @ 1GHz dual-core </para>
@ -4640,7 +5166,7 @@ Password:
<title>Known Issues</title> <title>Known Issues</title>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>WiFi is not available. A separate <ulink url="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#">USB WiFi device</ulink> is recommended. </para> <para>None </para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</section> </section>
@ -5690,7 +6216,7 @@ wget https://www.thinkpenguin.com/files/ath9k_firmware_free-version/htc_7010.fw<
<title>Release Notes</title> <title>Release Notes</title>
<para>The following are the release notes for each FreedomBox version. </para> <para>The following are the release notes for each FreedomBox version. </para>
<section> <section>
<title>Plinth v0.13.0 (2017-01-18)</title> <title>Plinth v0.13.1 (2017-01-22)</title>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>Two new apps were added: </para> <para>Two new apps were added: </para>