/usr/share/doc/plinth/freedombox-manual.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>FreedomBox Manual</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="article"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="ARTICLE"
><DIV
CLASS="TITLEPAGE"
><H1
CLASS="title"
><A
NAME="AEN2"
>FreedomBox Manual</A
></H1
><HR></DIV
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
>1. <A
HREF="#AEN4"
>FreedomBox Introduction</A
></DT
><DD
><DL
><DT
>1.1. <A
HREF="#AEN8"
>Smart Router</A
></DT
><DT
>1.2. <A
HREF="#AEN11"
>Private Cloud</A
></DT
></DL
></DD
><DT
>2. <A
HREF="#AEN14"
>Quick Start</A
></DT
><DT
>3. <A
HREF="#AEN58"
>Getting Help</A
></DT
><DT
>4. <A
HREF="#AEN81"
>Release Notes</A
></DT
><DD
><DL
><DT
>4.1. <A
HREF="#AEN84"
>Version 0.8 (2016-02)</A
></DT
><DT
>4.2. <A
HREF="#AEN103"
>Version 0.7 (2015-12-13)</A
></DT
><DT
>4.3. <A
HREF="#AEN116"
>Version 0.6 (2015-10-31)</A
></DT
><DT
>4.4. <A
HREF="#AEN140"
>Version 0.5 (2015-08-07)</A
></DT
><DT
>4.5. <A
HREF="#AEN161"
>Version 0.3 (2015-01-20)</A
></DT
><DT
>4.6. <A
HREF="#AEN187"
>Version 0.2 (2014-03-16)</A
></DT
><DT
>4.7. <A
HREF="#AEN216"
>Version 0.1 (2013-02-26)</A
></DT
></DL
></DD
><DT
>5. <A
HREF="#AEN238"
>Download and Install</A
></DT
><DD
><DL
><DT
>5.1. <A
HREF="#AEN247"
>Downloading on Debian</A
></DT
><DT
>5.2. <A
HREF="#AEN251"
>Downloading on Hardware or Virtual Machine</A
></DT
><DD
><DL
><DT
>5.2.1. <A
HREF="#AEN253"
>Prepare your device</A
></DT
><DT
>5.2.2. <A
HREF="#AEN257"
>Downloading Images</A
></DT
><DT
>5.2.3. <A
HREF="#AEN264"
>Verifying the Downloaded Images</A
></DT
><DT
>5.2.4. <A
HREF="#AEN278"
>Installation</A
></DT
></DL
></DD
></DL
></DD
><DT
>6. <A
HREF="#AEN319"
>Apps</A
></DT
><DD
><DL
><DT
>6.1. <A
HREF="#AEN321"
>Anonymity Network (Tor)</A
></DT
><DD
><DL
><DT
>6.1.1. <A
HREF="#AEN323"
>What is Tor?</A
></DT
><DT
>6.1.2. <A
HREF="#AEN326"
>Using Tor to browse anonymously</A
></DT
><DT
>6.1.3. <A
HREF="#AEN330"
>Using Tor Hidden Service to access your FreedomBox</A
></DT
><DT
>6.1.4. <A
HREF="#AEN336"
>Using Tor SOCKS port (advanced)</A
></DT
></DL
></DD
><DT
>6.2. <A
HREF="#AEN339"
>Deluge</A
></DT
><DD
><DL
><DT
>6.2.1. <A
HREF="#AEN341"
>What is Deluge?</A
></DT
></DL
></DD
><DT
>6.3. <A
HREF="#AEN344"
>Transmission</A
></DT
><DD
><DL
><DT
>6.3.1. <A
HREF="#AEN346"
>What is Transmission ?</A
></DT
></DL
></DD
><DT
>6.4. <A
HREF="#AEN349"
>Shaarli</A
></DT
><DD
><DL
><DT
>6.4.1. <A
HREF="#AEN351"
>What is Shaarli?</A
></DT
></DL
></DD
><DT
>6.5. <A
HREF="#AEN354"
>Chat Server (XMPP)</A
></DT
><DD
><DL
><DT
>6.5.1. <A
HREF="#AEN356"
>What is XMPP?</A
></DT
><DT
>6.5.2. <A
HREF="#AEN359"
>Setting the Domain Name</A
></DT
><DT
>6.5.3. <A
HREF="#AEN364"
>Registering XMPP users through SSO</A
></DT
></DL
></DD
><DT
>6.6. <A
HREF="#AEN367"
>Dynamic DNS</A
></DT
><DD
><DL
><DT
>6.6.1. <A
HREF="#AEN369"
>What is Dynamic DNS?</A
></DT
><DT
>6.6.2. <A
HREF="#AEN374"
>GnuDIP vs. Update URL</A
></DT
><DT
>6.6.3. <A
HREF="#AEN381"
>Using the GnuDIP protocol</A
></DT
><DT
>6.6.4. <A
HREF="#AEN399"
>Using an Update URL</A
></DT
><DT
>6.6.5. <A
HREF="#AEN423"
>Checking If It Works</A
></DT
></DL
></DD
><DT
>6.7. <A
HREF="#AEN435"
>Roundcube</A
></DT
><DD
><DL
><DT
>6.7.1. <A
HREF="#AEN437"
>What is Roundcube?</A
></DT
></DL
></DD
><DT
>6.8. <A
HREF="#AEN440"
>ownCloud</A
></DT
><DD
><DL
><DT
>6.8.1. <A
HREF="#AEN442"
>What is ownCloud?</A
></DT
><DT
>6.8.2. <A
HREF="#AEN446"
>Installation</A
></DT
></DL
></DD
><DT
>6.9. <A
HREF="#AEN464"
>PageKite</A
></DT
><DD
><DL
><DT
>6.9.1. <A
HREF="#AEN466"
>What is PageKite?</A
></DT
><DT
>6.9.2. <A
HREF="#AEN469"
>Use PageKite</A
></DT
></DL
></DD
><DT
>6.10. <A
HREF="#AEN473"
>Secure Shell</A
></DT
><DD
><DL
><DT
>6.10.1. <A
HREF="#AEN475"
>What is Secure Shell?</A
></DT
><DT
>6.10.2. <A
HREF="#AEN479"
>Default User Account</A
></DT
><DT
>6.10.3. <A
HREF="#AEN490"
>Logging In</A
></DT
><DT
>6.10.4. <A
HREF="#AEN508"
>Becoming Superuser</A
></DT
><DT
>6.10.5. <A
HREF="#AEN516"
>Changing Password</A
></DT
></DL
></DD
><DT
>6.11. <A
HREF="#AEN523"
>Mumble</A
></DT
><DD
><DL
><DT
>6.11.1. <A
HREF="#AEN525"
>What is Mumble?</A
></DT
></DL
></DD
><DT
>6.12. <A
HREF="#AEN528"
>Privoxy</A
></DT
><DD
><DL
><DT
>6.12.1. <A
HREF="#AEN530"
>What is Privoxy?</A
></DT
></DL
></DD
><DT
>6.13. <A
HREF="#AEN534"
>Wiki &#38; Blog (Ikiwiki)</A
></DT
><DD
><DL
><DT
>6.13.1. <A
HREF="#AEN536"
>What is Ikiwiki?</A
></DT
><DT
>6.13.2. <A
HREF="#AEN539"
>Creating a wiki or blog</A
></DT
><DT
>6.13.3. <A
HREF="#AEN543"
>Accessing your wiki or blog</A
></DT
><DT
>6.13.4. <A
HREF="#AEN547"
>User login through SSO</A
></DT
></DL
></DD
><DT
>6.14. <A
HREF="#AEN552"
>Unhosted Storage</A
></DT
><DD
><DL
><DT
>6.14.1. <A
HREF="#AEN554"
>What is Unhosted?</A
></DT
><DT
>6.14.2. <A
HREF="#AEN562"
>Setup</A
></DT
><DT
>6.14.3. <A
HREF="#AEN569"
>Try Unhosted apps</A
></DT
></DL
></DD
><DT
>6.15. <A
HREF="#AEN602"
>OpenVPN</A
></DT
><DD
><DL
><DT
>6.15.1. <A
HREF="#AEN604"
>What is OpenVPN?</A
></DT
></DL
></DD
><DT
>6.16. <A
HREF="#AEN607"
>GnuSocial</A
></DT
><DD
><DL
><DT
>6.16.1. <A
HREF="#AEN609"
>What is GNU social?</A
></DT
><DT
>6.16.2. <A
HREF="#AEN613"
>Status of package</A
></DT
></DL
></DD
></DL
></DD
><DT
>7. <A
HREF="#AEN616"
>System</A
></DT
><DD
><DL
><DT
>7.1. <A
HREF="#AEN618"
>Networks</A
></DT
><DD
><DL
><DT
>7.1.1. <A
HREF="#AEN622"
>Default setup</A
></DT
><DT
>7.1.2. <A
HREF="#AEN654"
>Internet Connection Sharing</A
></DT
><DT
>7.1.3. <A
HREF="#AEN665"
>Customization</A
></DT
><DT
>7.1.4. <A
HREF="#AEN692"
>Manual Network Operation</A
></DT
></DL
></DD
><DT
>7.2. <A
HREF="#AEN716"
>Upgrades</A
></DT
><DD
><DL
><DT
>7.2.1. <A
HREF="#AEN722"
>Manual Upgrades</A
></DT
></DL
></DD
><DT
>7.3. <A
HREF="#AEN735"
>Firewall</A
></DT
><DD
><DL
><DT
>7.3.1. <A
HREF="#AEN741"
>Interfaces</A
></DT
><DT
>7.3.2. <A
HREF="#AEN749"
>Ports/Services</A
></DT
><DT
>7.3.3. <A
HREF="#AEN1573"
>Manual operation</A
></DT
></DL
></DD
></DL
></DD
><DT
>8. <A
HREF="#AEN1627"
>Hardware</A
></DT
><DD
><DL
><DT
>8.1. <A
HREF="#AEN1633"
>Supported Hardware</A
></DT
><DD
><DL
><DT
>8.1.1. <A
HREF="#AEN1635"
>Recommended Hardware</A
></DT
><DT
>8.1.2. <A
HREF="#AEN1735"
>Also Working Hardware</A
></DT
></DL
></DD
><DT
>8.2. <A
HREF="#AEN1778"
>Targeted Hardware</A
></DT
><DD
><DL
><DT
>8.2.1. <A
HREF="#AEN1780"
>List of Hardware Targeted</A
></DT
><DT
>8.2.2. <A
HREF="#AEN1784"
>Adding Hardware Support</A
></DT
></DL
></DD
><DT
>8.3. <A
HREF="#AEN1789"
>Cubietruck</A
></DT
><DD
><DL
><DT
>8.3.1. <A
HREF="#AEN1791"
>FreedomBox Danube Edition</A
></DT
><DT
>8.3.2. <A
HREF="#AEN1801"
>Cubietruck / Cubieboard3</A
></DT
><DT
>8.3.3. <A
HREF="#AEN1806"
>Download</A
></DT
><DT
>8.3.4. <A
HREF="#AEN1813"
>Build Image</A
></DT
><DT
>8.3.5. <A
HREF="#AEN1817"
>Availability</A
></DT
><DT
>8.3.6. <A
HREF="#AEN1831"
>Hardware</A
></DT
><DT
>8.3.7. <A
HREF="#AEN1850"
>Non-Free Status</A
></DT
><DT
>8.3.8. <A
HREF="#AEN1859"
>Known Issues</A
></DT
></DL
></DD
><DT
>8.4. <A
HREF="#AEN1865"
>Beagle Bone Black</A
></DT
><DD
><DL
><DT
>8.4.1. <A
HREF="#AEN1876"
>Download</A
></DT
><DT
>8.4.2. <A
HREF="#AEN1885"
>Build Image</A
></DT
><DT
>8.4.3. <A
HREF="#AEN1889"
>Availability</A
></DT
><DT
>8.4.4. <A
HREF="#AEN1900"
>Hardware</A
></DT
><DT
>8.4.5. <A
HREF="#AEN1922"
>Non-Free Status</A
></DT
><DT
>8.4.6. <A
HREF="#AEN1931"
>Known Issues</A
></DT
></DL
></DD
><DT
>8.5. <A
HREF="#AEN1934"
>A20 OLinuXino Lime2</A
></DT
><DD
><DL
><DT
>8.5.1. <A
HREF="#AEN1945"
>Similar Hardware</A
></DT
><DT
>8.5.2. <A
HREF="#AEN1952"
>Download</A
></DT
><DT
>8.5.3. <A
HREF="#AEN1959"
>Build Image</A
></DT
><DT
>8.5.4. <A
HREF="#AEN1963"
>Availability</A
></DT
><DT
>8.5.5. <A
HREF="#AEN1973"
>Hardware</A
></DT
><DT
>8.5.6. <A
HREF="#AEN1993"
>Non-Free Status</A
></DT
><DT
>8.5.7. <A
HREF="#AEN2005"
>Known Issues</A
></DT
></DL
></DD
><DT
>8.6. <A
HREF="#AEN2011"
>A20 OLinuXino MICRO</A
></DT
><DD
><DL
><DT
>8.6.1. <A
HREF="#AEN2022"
>Similar Hardware</A
></DT
><DT
>8.6.2. <A
HREF="#AEN2029"
>Download</A
></DT
><DT
>8.6.3. <A
HREF="#AEN2036"
>Build Image</A
></DT
><DT
>8.6.4. <A
HREF="#AEN2040"
>Availability</A
></DT
><DT
>8.6.5. <A
HREF="#AEN2050"
>Hardware</A
></DT
><DT
>8.6.6. <A
HREF="#AEN2070"
>Non-Free Status</A
></DT
><DT
>8.6.7. <A
HREF="#AEN2082"
>Known Issues</A
></DT
></DL
></DD
><DT
>8.7. <A
HREF="#AEN2088"
>APU</A
></DT
><DD
><DL
><DT
>8.7.1. <A
HREF="#AEN2099"
>Similar Hardware</A
></DT
><DT
>8.7.2. <A
HREF="#AEN2142"
>Download</A
></DT
><DT
>8.7.3. <A
HREF="#AEN2150"
>Networking</A
></DT
><DT
>8.7.4. <A
HREF="#AEN2153"
>Build Image</A
></DT
><DT
>8.7.5. <A
HREF="#AEN2157"
>Availability</A
></DT
><DT
>8.7.6. <A
HREF="#AEN2168"
>Hardware</A
></DT
><DT
>8.7.7. <A
HREF="#AEN2189"
>Non-Free Status</A
></DT
><DT
>8.7.8. <A
HREF="#AEN2201"
>Known Issues</A
></DT
></DL
></DD
><DT
>8.8. <A
HREF="#AEN2204"
>VirtualBox</A
></DT
><DD
><DL
><DT
>8.8.1. <A
HREF="#AEN2223"
>Download</A
></DT
><DT
>8.8.2. <A
HREF="#AEN2230"
>Creating a Virtual Machine</A
></DT
><DT
>8.8.3. <A
HREF="#AEN2241"
>Network Configuration</A
></DT
><DT
>8.8.4. <A
HREF="#AEN2452"
>Using</A
></DT
><DT
>8.8.5. <A
HREF="#AEN2458"
>Build Image</A
></DT
><DT
>8.8.6. <A
HREF="#AEN2462"
>Tips &#38; Troubleshooting</A
></DT
></DL
></DD
><DT
>8.9. <A
HREF="#AEN2493"
>Debian</A
></DT
><DD
><DL
><DT
>8.9.1. <A
HREF="#AEN2505"
>Installing on Debian</A
></DT
><DT
>8.9.2. <A
HREF="#AEN2535"
>Troubleshooting</A
></DT
></DL
></DD
><DT
>8.10. <A
HREF="#AEN2553"
>DreamPlug</A
></DT
><DD
><DL
><DT
>8.10.1. <A
HREF="#AEN2566"
>Download</A
></DT
><DT
>8.10.2. <A
HREF="#AEN2575"
>Firmware</A
></DT
><DT
>8.10.3. <A
HREF="#AEN2579"
>Build Image</A
></DT
><DT
>8.10.4. <A
HREF="#AEN2583"
>Testing</A
></DT
><DT
>8.10.5. <A
HREF="#AEN2587"
>Availability</A
></DT
><DT
>8.10.6. <A
HREF="#AEN2598"
>Hardware</A
></DT
><DT
>8.10.7. <A
HREF="#AEN2618"
>Non-Free Status</A
></DT
><DT
>8.10.8. <A
HREF="#AEN2627"
>Known Issues</A
></DT
></DL
></DD
><DT
>8.11. <A
HREF="#AEN2633"
>Raspberry Pi Model B+</A
></DT
><DD
><DL
><DT
>8.11.1. <A
HREF="#AEN2647"
>Download</A
></DT
><DT
>8.11.2. <A
HREF="#AEN2652"
>Build Image</A
></DT
><DT
>8.11.3. <A
HREF="#AEN2656"
>Availability</A
></DT
><DT
>8.11.4. <A
HREF="#AEN2664"
>Hardware</A
></DT
><DT
>8.11.5. <A
HREF="#AEN2684"
>Non-Free Status</A
></DT
><DT
>8.11.6. <A
HREF="#AEN2693"
>Known Issues</A
></DT
></DL
></DD
><DT
>8.12. <A
HREF="#AEN2699"
>Raspberry Pi 2 Model B</A
></DT
><DD
><DL
><DT
>8.12.1. <A
HREF="#AEN2714"
>Download</A
></DT
><DT
>8.12.2. <A
HREF="#AEN2719"
>Build Image</A
></DT
><DT
>8.12.3. <A
HREF="#AEN2723"
>Availability</A
></DT
><DT
>8.12.4. <A
HREF="#AEN2731"
>Hardware</A
></DT
><DT
>8.12.5. <A
HREF="#AEN2751"
>Non-Free Status</A
></DT
><DT
>8.12.6. <A
HREF="#AEN2760"
>Known Issues</A
></DT
></DL
></DD
><DT
>8.13. <A
HREF="#AEN2767"
>USB Wi-Fi</A
></DT
><DD
><DL
><DT
>8.13.1. <A
HREF="#AEN2778"
>Firmware Installation</A
></DT
><DT
>8.13.2. <A
HREF="#AEN2782"
>Resources</A
></DT
></DL
></DD
><DT
>8.14. <A
HREF="#AEN2794"
>Advanced Topics</A
></DT
><DD
><DL
><DT
>8.14.1. <A
HREF="#AEN2798"
>Adding Additional Features</A
></DT
></DL
></DD
></DL
></DD
><DT
>9. <A
HREF="#AEN2803"
>Contributing</A
></DT
><DD
><DL
><DT
>9.1. <A
HREF="#AEN2806"
>Quick Links</A
></DT
><DT
>9.2. <A
HREF="#AEN2814"
>Welcome to newcomers</A
></DT
><DT
>9.3. <A
HREF="#AEN2820"
>Development priorities</A
></DT
><DT
>9.4. <A
HREF="#AEN2828"
>Contributions needed</A
></DT
><DD
><DL
><DT
>9.4.1. <A
HREF="#AEN2830"
>Add an Application</A
></DT
><DT
>9.4.2. <A
HREF="#AEN2834"
>Bugs</A
></DT
><DT
>9.4.3. <A
HREF="#AEN2838"
>Code</A
></DT
><DT
>9.4.4. <A
HREF="#AEN2854"
>Design</A
></DT
><DT
>9.4.5. <A
HREF="#AEN2881"
>Donate</A
></DT
><DT
>9.4.6. <A
HREF="#AEN2886"
>Document: User Manual, Website and Wiki</A
></DT
><DT
>9.4.7. <A
HREF="#AEN2893"
>Quality Assurance</A
></DT
><DT
>9.4.8. <A
HREF="#AEN2902"
>Localization</A
></DT
><DT
>9.4.9. <A
HREF="#AEN2924"
>Spread the Word</A
></DT
></DL
></DD
></DL
></DD
><DT
>10. <A
HREF="#AEN2929"
>Developer Guide</A
></DT
><DD
><DL
><DT
>10.1. <A
HREF="#AEN2932"
>Writing Applications - Tutorial</A
></DT
><DD
><DL
><DT
>10.1.1. <A
HREF="#AEN2941"
>Before we begin</A
></DT
><DT
>10.1.2. <A
HREF="#AEN2946"
>Picking an application</A
></DT
><DT
>10.1.3. <A
HREF="#AEN2956"
>Packaging the application</A
></DT
><DT
>10.1.4. <A
HREF="#AEN2970"
>Creating the project structure</A
></DT
><DT
>10.1.5. <A
HREF="#AEN2984"
>Tell Plinth that we exist</A
></DT
><DT
>10.1.6. <A
HREF="#AEN2995"
>Writing the URLs</A
></DT
><DT
>10.1.7. <A
HREF="#AEN3005"
>Adding a menu item</A
></DT
><DT
>10.1.8. <A
HREF="#AEN3032"
>Specifying module dependencies</A
></DT
><DT
>10.1.9. <A
HREF="#AEN3043"
>Writing the enable/disable form</A
></DT
><DT
>10.1.10. <A
HREF="#AEN3054"
>Writing a view</A
></DT
><DT
>10.1.11. <A
HREF="#AEN3062"
>Getting the current status of the application</A
></DT
><DT
>10.1.12. <A
HREF="#AEN3073"
>Displaying the application page</A
></DT
><DT
>10.1.13. <A
HREF="#AEN3085"
>Applying the changes from the form</A
></DT
><DT
>10.1.14. <A
HREF="#AEN3095"
>Installing packages required for the application</A
></DT
><DT
>10.1.15. <A
HREF="#AEN3105"
>Writing actions</A
></DT
><DT
>10.1.16. <A
HREF="#AEN3116"
>Creating diagnostics</A
></DT
><DT
>10.1.17. <A
HREF="#AEN3132"
>Logging</A
></DT
><DT
>10.1.18. <A
HREF="#AEN3138"
>Adding a License</A
></DT
><DT
>10.1.19. <A
HREF="#AEN3144"
>Internationalization</A
></DT
><DT
>10.1.20. <A
HREF="#AEN3158"
>Coding standards</A
></DT
></DL
></DD
><DT
>10.2. <A
HREF="#AEN3166"
>Reference Guide</A
></DT
><DD
><DL
><DT
>10.2.1. <A
HREF="#AEN3169"
>Applications</A
></DT
><DT
>10.2.2. <A
HREF="#AEN3195"
>Actions</A
></DT
><DT
>10.2.3. <A
HREF="#AEN3217"
>Menus</A
></DT
><DT
>10.2.4. <A
HREF="#AEN3246"
>Services</A
></DT
></DL
></DD
></DL
></DD
><DT
>11. <A
HREF="#AEN3265"
>Hacking</A
></DT
><DD
><DL
><DT
>11.1. <A
HREF="#AEN3275"
>Plinth</A
></DT
><DD
><DL
><DT
>11.1.1. <A
HREF="#AEN3281"
>Using</A
></DT
><DT
>11.1.2. <A
HREF="#AEN3296"
>Screenshots</A
></DT
><DT
>11.1.3. <A
HREF="#AEN3323"
>Support</A
></DT
><DT
>11.1.4. <A
HREF="#AEN3333"
>Contributing</A
></DT
></DL
></DD
><DT
>11.2. <A
HREF="#AEN3371"
>FreedomBox Setup</A
></DT
><DD
><DL
><DT
>11.2.1. <A
HREF="#AEN3379"
>Using</A
></DT
><DT
>11.2.2. <A
HREF="#AEN3392"
>Support</A
></DT
><DT
>11.2.3. <A
HREF="#AEN3402"
>Contributing</A
></DT
></DL
></DD
><DT
>11.3. <A
HREF="#AEN3422"
>Freedom Maker</A
></DT
><DD
><DL
><DT
>11.3.1. <A
HREF="#AEN3450"
>Building FreedomBox Images</A
></DT
><DT
>11.3.2. <A
HREF="#AEN3457"
>Support</A
></DT
><DT
>11.3.3. <A
HREF="#AEN3467"
>Contributing</A
></DT
></DL
></DD
></DL
></DD
><DT
>12. <A
HREF="#AEN3492"
>Other Resources: Manual Older Versions</A
></DT
><DT
>13. <A
HREF="#AEN3504"
>Tell people around you</A
></DT
></DL
></DIV
><DIV
CLASS="section"
><H2
CLASS="section"
><A
NAME="AEN4"
>1. FreedomBox Introduction</A
></H2
><P
>FreedomBox is a personal server that protects your privacy. It is a free software stack, a subset of the Debian universal operating system, that can be installed in many flavors of inexpensive and power-efficient <A
HREF="https://wiki.debian.org/FreedomBox/Hardware#"
TARGET="_top"
>hardware</A
>. The simplicity of setting up and operating a FreedomBox is similar to that of a smart phone. </P
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN8"
>1.1. Smart Router</A
></H3
><P
>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 provide communications throughout the village. In future, FreedomBox intends to provide support for alternative ways of connecting to the Internet such as Mesh networks. </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN11"
>1.2. Private Cloud</A
></H3
><P
>FreedomBox provides services: to your computers and mobile devices in your home and to computers and mobile devices of other people who are your friends. FreedomBox provides file sharing like Dropbox, shared calendering like Google or Yahoo and photo sharing. FreedomBox provides instant messaging and truly secure voice conference calling that works on low bandwidth providing high quality. FreedomBox has a blog and wiki to let you publish your content and 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.  </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="AEN14"
>2. Quick Start</A
></H2
><P
></P
><OL
TYPE="1"
><LI
><P
>If you have not already done so, download and install a FreedomBox image by following the instructions on the <A
HREF="https://wiki.debian.org/FreedomBox/Download#"
TARGET="_top"
>Download</A
> page. </P
></LI
><LI
><P
>Plug one end of your ethernet cord into your FreedomBox's ethernet port, and plug the other end into your router. </P
><P
></P
><UL
><LI
><P
>On the Dreamplug, the eth0 port (the one toward the middle of the box) should be connected to your router. </P
></LI
></UL
></LI
><LI
><P
>If your device has a 2nd ethernet port, you can connect your computer to it directly, using an ethernet cable. </P
></LI
><LI
><P
>Power on your your FreedomBox. </P
></LI
><LI
><P
>On first boot, the FreedomBox will perform initial setup and then reboot. This may take several minutes. </P
></LI
><LI
><P
>After the FreedomBox has rebooted, you can access its web interface (called Plinth) through your web browser. </P
><P
></P
><UL
><LI
><P
>If your computer is connected directly to the FreedomBox through a second (LAN) ethernet port, you can browse to: <A
HREF="http://freedombox/"
TARGET="_top"
>http://freedombox/</A
> or <A
HREF="http://10.42.0.1/"
TARGET="_top"
>http://10.42.0.1/</A
>. </P
></LI
><LI
><P
>If your computer supports mDNS (GNU/Linux, Mac OSX and Windows with mDNS software installed), you can browse to: <A
HREF="http://freedombox.local/"
TARGET="_top"
>http://freedombox.local/</A
> (or <A
HREF="http://the-hostname-you-entered-during-install.local/"
TARGET="_top"
>http://the-hostname-you-entered-during-install.local/</A
>) </P
></LI
><LI
><P
>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 to find its IP address: </P
><PRE
CLASS="screen"
>     nmap -p 80 --open -sV 192.168.0.0/24</PRE
><P
>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 <A
HREF="http://192.168.0.165"
TARGET="_top"
>http://192.168.0.165</A
>: </P
><PRE
CLASS="screen"
>     Nmap scan report for 192.168.0.165
     Host is up (0.00088s latency).
     PORT   STATE SERVICE VERSION
     80/tcp open  http    Apache httpd 2.4.17 ((Debian))</PRE
></LI
></UL
></LI
><LI
><P
>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". </P
></LI
><LI
><P
>On the intial access you will see a welcome page that asks you to provide some basic information for setting up your FreedomBox. </P
></LI
><LI
><P
>After completing the form, you will be logged in to Plinth and able to access apps and configuration through the interface. </P
></LI
><LI
><P
>If your computer is connected directly to the FreedomBox, your FreedomBox can act as a router, allowing you to access the Internet. </P
></LI
></OL
><P
>Now, you can try <A
HREF="https://wiki.debian.org/FreedomBox/Features#"
TARGET="_top"
>any of the Apps</A
> that are available on FreedomBox. </P
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="AEN58"
>3. Getting Help</A
></H2
><P
>&#13;      <A
NAME="gettinghelp"
></A
>
    </P
><P
>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: </P
><P
></P
><UL
><LI
><P
>Emailing <A
HREF="mailto:freedombox-discuss@lists.alioth.debian.org"
TARGET="_top"
>freedombox-discuss@lists.alioth.debian.org</A
>. You can also <A
HREF="http://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss"
TARGET="_top"
>sign up</A
> to receive copies of every discussion that happens on the mailing list and <A
HREF="http://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss"
TARGET="_top"
>read the archives</A
>. </P
></LI
><LI
><P
>Chatting at <A
HREF="irc://irc.oftc.net:6667/%23freedombox"
TARGET="_top"
>#freedombox@irc.oftc.net</A
>. </P
></LI
><LI
><P
>Reading the <A
HREF="http://wiki.debian.org/FreedomBox"
TARGET="_top"
>wiki</A
>. </P
></LI
><LI
><P
>Reading the <A
HREF="https://freedomboxfoundation.org/"
TARGET="_top"
>FreedomBox Foundation's website</A
>. </P
></LI
><LI
><P
>Reading the <A
HREF="https://alioth.debian.org/projects/freedombox"
TARGET="_top"
>FreedomBox Project Page</A
>. </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="AEN81"
>4. Release Notes</A
></H2
><P
>The following are the release notes for each FreedomBox version.  </P
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN84"
>4.1. Version 0.8 (2016-02)</A
></H3
><P
></P
><UL
><LI
><P
>Added Quassel, an IRC client that stays connected to IRC networks and can synchronize multiple frontends. </P
></LI
><LI
><P
>Improved first boot user interface. </P
></LI
><LI
><P
>Fixed Transmission RPC whitelist issue. </P
></LI
><LI
><P
>Added translations for Turkish, Chinese, and Russian. Fixed and updated translations in other languages. </P
></LI
><LI
><P
>Added Monkeysphere, which uses PGP web of trust for SSH host key verification. </P
></LI
><LI
><P
>Added Let's Encrypt, to obtain certificates for domains, so that browser certificate warnings can be avoided. </P
></LI
><LI
><P
>Added repro, a SIP server for audio and video calls. </P
></LI
><LI
><P
>Allow users to set their SSH public keys, so they can login over SSH without a password. </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN103"
>4.2. Version 0.7 (2015-12-13)</A
></H3
><P
></P
><UL
><LI
><P
>Translations! Full translations of the interface in Danish, Dutch, French, German and Norwegian Bokmål, and partial Telugu. </P
></LI
><LI
><P
>Support for OLinuXino A20 MICRO and LIME2 </P
></LI
><LI
><P
>New Plinth applications: OpenVPN, reStore </P
></LI
><LI
><P
>Improved first-boot experience </P
></LI
><LI
><P
>Many bugfixes and cleanups </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN116"
>4.3. Version 0.6 (2015-10-31)</A
></H3
><P
></P
><UL
><LI
><P
>New supported hardware target: Raspberry Pi 2 </P
></LI
><LI
><P
>New modules in Plinth: </P
><P
></P
><UL
><LI
><P
>Shaarli: Web application to manage and share bookmarks </P
></LI
><LI
><P
>Date &#38; Time: Configure time zone and NTP service </P
></LI
><LI
><P
>Service Discovery: Configure Avahi service </P
></LI
></UL
></LI
><LI
><P
>Documentation revamp including new user manual and developer guide </P
></LI
><LI
><P
>Improved diagnostic tests, available in Plinth </P
></LI
><LI
><P
>Avoid unnecessary changes when installing on existing Debian system </P
></LI
><LI
><P
>Network configuration supports PPPoE connections </P
></LI
><LI
><P
>Debian packages can be download over Tor </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN140"
>4.4. Version 0.5 (2015-08-07)</A
></H3
><P
></P
><UL
><LI
><P
>New targets: CubieTruck, i386, amd64 </P
></LI
><LI
><P
>New apps in Plinth: Transmission, Dynamic DNS, Mumble, ikiwiki, Deluge, Roundcube, Privoxy </P
></LI
><LI
><P
>NetworkManager handles network configuration and can be manipulated through Plinth. </P
></LI
><LI
><P
>Software Upgrades (unattended-upgrades) module can upgrade the system, and enable automatic upgrades. </P
></LI
><LI
><P
>Plinth is now capable of installing ejabberd, jwchat, and privoxy, so they are not included in image but can be installed when needed. </P
></LI
><LI
><P
>User authentication through LDAP for SSH, XMPP (ejabberd), and ikiwiki. </P
></LI
><LI
><P
>Unit test suite is automatically run on Plinth upstream. This helps us catch at least some code errors before they are discovered by users! </P
></LI
><LI
><P
>New, simpler look for Plinth. </P
></LI
><LI
><P
>Performance improvements for Plinth. </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN161"
>4.5. Version 0.3 (2015-01-20)</A
></H3
><P
></P
><UL
><LI
><P
>Tor Bridges: All boxes now act as non-exit Tor bridges, routing traffic for the Tor network. </P
></LI
><LI
><P
><A
HREF="https://wiki.debian.org/FreedomBox/Manual/Firewall#"
TARGET="_top"
>Firewall</A
>: firewall is on by default and is automatically managed. </P
></LI
><LI
><P
>Add BeagleBone support.  We now have images for BeagleBone, RaspberryPi, VirtualBox i386/amd64, and DreamPlug. </P
></LI
><LI
><P
>Ability to enable and use Tor Hidden Services.  Works with Ejabberd/JWChat and ownCloud services. </P
></LI
><LI
><P
>Enable Tor obfsproxy with scramblesuit. </P
></LI
><LI
><P
>Drop well-known root password (an account with sudo capabilities still exists for now but will be removed soon). </P
></LI
><LI
><P
>Switch to unstable as suite of choice for easier development. </P
></LI
><LI
><P
>Newer images are built with systemd by default (due to Debian change). </P
></LI
><LI
><P
>Install and operate firewall automatically (uses firewalld). </P
></LI
><LI
><P
>Major restructuring of Plinth UI using Python3, Django web development framework and Bootstrap3.  Code quality is much better and UI is more polished. </P
></LI
><LI
><P
>Introduced packaging framework in Plinth UI for on-demand application installation. </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN187"
>4.6. Version 0.2 (2014-03-16)</A
></H3
><P
></P
><UL
><LI
><P
>Support for Raspberry Pi and VirtualBox (x86) in addition to the <A
HREF="https://wiki.debian.org/FreedomBox/ReleaseNotes/FreedomBox/Hardware/DreamPlug#"
TARGET="_top"
>DreamPlug</A
>. </P
></LI
><LI
><P
>New Services: </P
><P
></P
><UL
><LI
><P
>Configuration Management UI. </P
></LI
><LI
><P
>Instant Messaging. </P
></LI
><LI
><P
>OwnCloud. </P
></LI
><LI
><P
>dnsmasq. </P
></LI
><LI
><P
>Low-Level Configuration Management. </P
></LI
><LI
><P
>Service Announcement. </P
></LI
><LI
><P
>LDAP Server. </P
></LI
><LI
><P
>LXC Support. </P
></LI
><LI
><P
>Source Packages. </P
></LI
></UL
></LI
><LI
><P
>The privoxy setup is now the default from Debian. </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN216"
>4.7. Version 0.1 (2013-02-26)</A
></H3
><P
></P
><UL
><LI
><P
>First FreedomBox software release (0.1 image, developer release).  </P
></LI
><LI
><P
>Full hardware support in Debian </P
></LI
><LI
><P
>Support for <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/DreamPlug#"
TARGET="_top"
>DreamPlug</A
>. </P
></LI
><LI
><P
>Basic software tools selected as common working environment: </P
><P
></P
><UL
><LI
><P
>User interface system "plinth" </P
></LI
><LI
><P
>Cryptography tools: gpg or "monkeysphere" </P
></LI
><LI
><P
>Box-to-box communication design: Freedom-buddy (uses <A
HREF="https://en.wikipedia.org/wiki/Tor_%28anonymity_network%29"
TARGET="_top"
>TOR network</A
>) </P
></LI
><LI
><P
>Web cleaning: "privoxy-freedombox". </P
></LI
></UL
></LI
></UL
></DIV
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="AEN238"
>5. Download and Install</A
></H2
><P
>Wellcome to the <A
HREF="https://wiki.debian.org/FreedomBox#"
TARGET="_top"
>FreedomBox</A
> download page. You may either install FreedomBox on one of the supported inexpensive <A
HREF="https://wiki.debian.org/FreedomBox/Hardware#"
TARGET="_top"
>hardware</A
>, on a Linux <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/Debian#"
TARGET="_top"
>Debian</A
> operating system, or deploy on a virtual machine. Installing on Debian is easy because <A
HREF="https://wiki.debian.org/FreedomBox#"
TARGET="_top"
>FreedomBox</A
> is available as packages. On hardware, you may need a little bit of technical expertise to setup. What we are requiring is to buy a device and plug in an SD card. In case of trouble, please read and interact with the <A
HREF="https://wiki.debian.org/FreedomBox/QuestionsAndAnswers#"
TARGET="_top"
>Questions and Answers</A
> page based on <A
HREF="https://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss"
TARGET="_top"
>Freedombox-discuss</A
> mailing list archives. </P
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN247"
>5.1. Downloading on Debian</A
></H3
><P
>If you are installing on Debian, you don't need to download these images. Instead read <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/Debian#"
TARGET="_top"
>instructions</A
> on setting up FreedomBox on Debian. </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN251"
>5.2. Downloading on Hardware or Virtual Machine</A
></H3
><DIV
CLASS="section"
><H4
CLASS="section"
><A
NAME="AEN253"
>5.2.1. Prepare your device</A
></H4
><P
>See hardware specific instructions on how to prepare your device at the <A
HREF="https://wiki.debian.org/FreedomBox/Hardware#"
TARGET="_top"
>Hardware</A
> section. Gather and read a lot of documentation on the web about first boot and flashing USB or SD Card on your hardware. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN257"
>5.2.2. Downloading Images</A
></H4
><P
>Recent images for supported targets are available here: </P
><P
></P
><UL
><LI
STYLE="list-style-type: none"
><P
>Official Images: <A
HREF="http://ftp.skolelinux.org/pub/freedombox/"
TARGET="_top"
>http://ftp.skolelinux.org/pub/freedombox/</A
> </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN264"
>5.2.3. Verifying the Downloaded Images</A
></H4
><P
>It is important to verify the images you have downloaded to ensure that the file has not be corrupted during the transmission and that it is indeed the image built by FreedomBox developers.  </P
><P
></P
><UL
><LI
><P
>First open a terminal and import the public key of the FreedomBox developer who built the images: </P
><PRE
CLASS="screen"
>$ gpg --keyserver x-hkp://pool.sks-keyservers.net --recv-keys 0x36C361440C9BC971</PRE
></LI
><LI
><P
>Next, verify the fingerprint of the public key: </P
><PRE
CLASS="screen"
>$ gpg --fingerprint 0x36C361440C9BC971
pub   4096R/0C9BC971 2011-11-12
      Key fingerprint = BCBE BD57 A11F 70B2 3782  BC57 36C3 6144 0C9B C971
uid                  Sunil Mohan Adapa &#60;sunil@medhas.org&#62;
sub   4096R/4C1D4B57 2011-11-12</PRE
></LI
><LI
><P
>Finally, verify your downloaded image with its signature file <FONT
COLOR="RED"
>.sig</FONT
>. For example: </P
><PRE
CLASS="screen"
>$ gpg --verify freedombox-unstable-free_2015-12-13_cubietruck-armhf.img.xz.sig freedombox-unstable-free_2015-12-13_cubietruck-armhf.img.xz
gpg: Signature made Thursday 15 January 2015 09:27:50 AM IST using RSA key ID 0C9BC971
gpg: Good signature from "Sunil Mohan Adapa &#60;sunil@medhas.org&#62;"
gpg: WARNING: This key is not certified with a trusted signature!
gpg:          There is no indication that the signature belongs to the owner.
Primary key fingerprint: BCBE BD57 A11F 70B2 3782  BC57 36C3 6144 0C9B C971</PRE
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN278"
>5.2.4. Installation</A
></H4
><P
>After the download you can use the image to boot <A
HREF="https://wiki.debian.org/FreedomBox/Hardware#"
TARGET="_top"
>supported hardware</A
> (including virtual machines).  You'll need to copy the image to the memory card or USB stick as follows: </P
><P
></P
><OL
TYPE="1"
><LI
><P
>Figure out which device your card actually is. </P
><P
></P
><OL
TYPE="1"
><LI
><P
>Unplug your card. </P
></LI
><LI
><P
>Run <FONT
COLOR="RED"
>dmesg -w</FONT
> to show and follow the kernel messages. </P
></LI
><LI
><P
>Plug your card in.  You will see messages such as following: </P
><PRE
CLASS="screen"
>[33299.023096] usb 4-6: new high-speed USB device number 12 using ehci-pci
[33299.157160] usb 4-6: New USB device found, idVendor=058f, idProduct=6361
[33299.157162] usb 4-6: New USB device strings: Mfr=1, Product=2, SerialNumber=3
[33299.157164] usb 4-6: Product: Mass Storage Device
[33299.157165] usb 4-6: Manufacturer: Generic
[33299.157167] usb 4-6: SerialNumber: XXXXXXXXXXXX
[33299.157452] usb-storage 4-6:1.0: USB Mass Storage device detected
[33299.157683] scsi host13: usb-storage 4-6:1.0
[33300.155626] scsi 13:0:0:0: Direct-Access     Generic- Compact Flash    1.01 PQ: 0 ANSI: 0
[33300.156223] scsi 13:0:0:1: Direct-Access     Multiple Flash Reader     1.05 PQ: 0 ANSI: 0
[33300.157059] sd 13:0:0:0: Attached scsi generic sg4 type 0
[33300.157462] sd 13:0:0:1: Attached scsi generic sg5 type 0
[33300.462115] sd 13:0:0:1: [sdg] 30367744 512-byte logical blocks: (15.5 GB/14.4 GiB)
[33300.464144] sd 13:0:0:1: [sdg] Write Protect is off
[33300.464159] sd 13:0:0:1: [sdg] Mode Sense: 03 00 00 00
[33300.465896] sd 13:0:0:1: [sdg] No Caching mode page found
[33300.465912] sd 13:0:0:1: [sdg] Assuming drive cache: write through
[33300.470489] sd 13:0:0:0: [sdf] Attached SCSI removable disk
[33300.479493]  sdg: sdg1
[33300.483566] sd 13:0:0:1: [sdg] Attached SCSI removable disk</PRE
></LI
><LI
><P
>In the above case, the disk that is newly inserted is available as <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>/dev/sdg</I
></SPAN
>.  Very carefully note this and use it in the copying step below. </P
></LI
></OL
></LI
><LI
><P
>Decompress the downloaded image using tar: </P
><PRE
CLASS="screen"
>$ xz -d freedombox-unstable-free_2015-12-13_cubietruck-armhf.img.xz</PRE
><P
>The above command is an example for the <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>cubietruck</I
></SPAN
> image built on 2015-12-13.  Your downloaded file name will be different. </P
></LI
><LI
><P
>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. </P
><P
>For example, if your SD card is <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>/dev/sdf</I
></SPAN
> as noted in the first step above, then to copy the image, run: </P
><PRE
CLASS="screen"
>$ dd bs=1M if=freedombox-unstable-free_2015-12-13_cubietruck-armhf.img of=/dev/sdf conv=fdatasync</PRE
><P
>The above command is an example for the <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>cubietruck</I
></SPAN
> image built on 2015-12-13.  Your image file name will be different. </P
><P
>When picking a device, use the drive-letter destination, like <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>/dev/sdf</I
></SPAN
>, not a numbered destination, like <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>/dev/sdf1</I
></SPAN
>.  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. </P
></LI
><LI
><P
>Use the image by inserting the SD card or USB disk into the target </P
><P
>device and booting from it.  Your device should also be prepared (see the <A
HREF="https://wiki.debian.org/FreedomBox/Hardware#"
TARGET="_top"
>Hardware</A
> section). </P
></LI
><LI
><P
>Read (the rest of) the <A
HREF="https://wiki.debian.org/FreedomBox/Manual#"
TARGET="_top"
>Manual</A
> for instructions on how to use applications in FreedomBox. </P
></LI
></OL
></DIV
></DIV
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="AEN319"
>6. Apps</A
></H2
><DIV
CLASS="section"
><H3
CLASS="section"
><A
NAME="AEN321"
>6.1. Anonymity Network (Tor)</A
></H3
><DIV
CLASS="section"
><H4
CLASS="section"
><A
NAME="AEN323"
>6.1.1. What is Tor?</A
></H4
><P
>Tor is a network of server operated by volunteers. It allows users of these servers to improve their privacy and security while surfing on the Internet. You and your friends are able to access to your FreedomBox via Tor network without revealing its IP address. Activating Tor application on your FreedomBox, you will be able to offer remote services (chat, wiki, file sharing, etc...) without showing your location. This application will give you a better protection than a public web server because you will be less exposed to intrusive people on the web. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN326"
>6.1.2. Using Tor to browse anonymously</A
></H4
><P
>Tor Browser is the recommended way to browse the web using Tor. You can download the Tor Browser from <A
HREF="https://www.torproject.org/projects/torbrowser.html"
TARGET="_top"
>https://www.torproject.org/projects/torbrowser.html</A
> and follow the instructions on that site to install and run it. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN330"
>6.1.3. Using Tor Hidden Service to access your FreedomBox</A
></H4
><P
>Tor Hidden Service provides a way to access your FreedomBox, even if it's behind a router or firewall. </P
><P
>To enable Tor Hidden Service, first navigate to the Anonymity Network (Tor) page. (If you don't see it, click on the FreedomBox logo at the top-left of the page, to go to the main Apps page.) On the Anonymity Network (Tor) page, under Configuration, check "Enable Tor Hidden Service", then press the Update setup button. Tor will be reconfigured and restarted. </P
><P
>After a while, the page will refresh and under Status, you will see a table listing the Hidden Service .onion address. Copy the entire address (ending in .onion) and paste it into the Tor Browser's address field, and you should be able to access your FreedomBox. (You may see a certificate warning because FreedomBox has a self-signed certificate.) </P
><P
>Currently only HTTP (port 80) and HTTPS (port 443) are accessible through the Tor Hidden Service configured on the FreedomBox. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN336"
>6.1.4. Using Tor SOCKS port (advanced)</A
></H4
><P
>FreedomBox provides a Tor SOCKS port that other applications can connect to, in order to route their traffic over the Tor network. This port is accessible on any interfaces configured in the internal firewall zone. To configure the application, set SOCKS Host to the internal network connection's IP address, and set the SOCKS Port to 9050. </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN339"
>6.2. Deluge</A
></H3
><DIV
CLASS="section"
><H4
CLASS="section"
><A
NAME="AEN341"
>6.2.1. What is Deluge?</A
></H4
><P
>Your FreedomBox provides a Deluge application to enable. Deluge is a lightweight Bit Torrent client. Bit Torrent is a communications protocol using peer-to-peer (P2P) file sharing. P2P is a system that aims to interconnect end-user machines. Highly configurable, Deluge offers functionalities in the form of plugins.  </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN344"
>6.3. Transmission</A
></H3
><DIV
CLASS="section"
><H4
CLASS="section"
><A
NAME="AEN346"
>6.3.1. What is Transmission ?</A
></H4
><P
>In addition to Deluge Bit Torrent, your FreedomBox provides a Transmission application to enable. Transmission is a lightweight Bit Torrent client allowing end-user machine to share files (documents, pictures, sounds, videos and programs). Transmission is well known for its simplicity and a default configuration that "Just Works". </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN349"
>6.4. Shaarli</A
></H3
><DIV
CLASS="section"
><H4
CLASS="section"
><A
NAME="AEN351"
>6.4.1. What is Shaarli?</A
></H4
><P
>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. </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN354"
>6.5. Chat Server (XMPP)</A
></H3
><DIV
CLASS="section"
><H4
CLASS="section"
><A
NAME="AEN356"
>6.5.1. What is XMPP?</A
></H4
><P
>XMPP is a federated protocol for Instant Messaging. This means that users who have accounts on one server, can talk to users that are on another server. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN359"
>6.5.2. Setting the Domain Name</A
></H4
><P
>For XMPP to work, your FreedomBox needs to have a Domain Name that can be accessed over the public Internet. You can read more about obtaining a Domain Name in the Dynamic DNS section of this manual. </P
><P
>Once you have a Domain Name, you can tell your FreedomBox to use it by setting the Domain Name in the System Config. </P
><P
>Please note that Pagekite does not support the XMPP protocol at this time. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN364"
>6.5.3. Registering XMPP users through SSO</A
></H4
><P
>Currently, all users created through Plinth will be able to login to the XMPP server. You can add new users through the System Users and Groups module. It does not matter which Groups are selected for the new user. </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN367"
>6.6. Dynamic DNS</A
></H3
><DIV
CLASS="section"
><H4
CLASS="section"
><A
NAME="AEN369"
>6.6.1. What is Dynamic DNS?</A
></H4
><P
>In order to reach a server on the Internet, the server needs to have permanent address also know as the static IP address.  Many Internet service providers don't provide home users with a static IP address or they charge more providing a static IP address.  Instead they provide the home user with an IP address that changes every time the user connects to the Internet.  Clients wishing to contact the server will have difficulty reaching the server. </P
><P
>Dynamic DNS service providers assist in working around a problem.  First they provide you with a domain name, such as 'myhost.example.org'.  Then they associate your IP address, whenever it changes, with this domain name.  Then anyone intending to reach the server will be to contact the server using the domain name 'myhost.example.org' which always points to the latest IP address of the server. </P
><P
>For this to work, every time you connect to the Internet, you will have to tell your Dynamic DNS provider what your current IP address is.  Hence you need special software on your server to perform this operation. The Dynamic DNS function in FreedomBox will allow users without a static public IP address to push the current public IP address to a Dynamic DNS Server.  This allows you to expose services on FreedomBox, such as ownCloud, to the Internet. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN374"
>6.6.2. GnuDIP vs. Update URL</A
></H4
><P
>There are two main mechanism to notify the Dynamic DNS server of your new IP address; using the <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>GnuDIP</I
></SPAN
> protocol and using the <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Update URL</I
></SPAN
> mechanism. </P
><P
>If a service provided using update URL is not properly secured using HTTPS, your credentials may be visible to an adversary.  Once an adversary gains your credentials, they will be able to replay your request your server and hijack your domain. </P
><P
>On the other hand, the GnuDIP protocol will only transport a salted MD5 value of your password, in a way that is secure against replay attacks.  </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN381"
>6.6.3. Using the GnuDIP protocol</A
></H4
><P
></P
><OL
TYPE="1"
><LI
><P
>Register an account with any Dynamic DNS service provider.  A free service provided by the FreedomBox community is available at <A
HREF="https://gnudip.datasystems24.net"
TARGET="_top"
>https://gnudip.datasystems24.net</A
> . </P
></LI
><LI
><P
>In FreedomBox UI, enable the Dynamic DNS Service. </P
></LI
><LI
><P
>Select <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>GnuDIP</I
></SPAN
> as <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Service type</I
></SPAN
>, enter your Dynamic DNS service provider address (for example, gnudip.datasystems24.net) into <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>GnuDIP Server Address</I
></SPAN
> field. </P
></LI
><LI
><P
>Fill <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Domain Name</I
></SPAN
>, <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Username</I
></SPAN
>, <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Password</I
></SPAN
> information given by your provider into the corresponding fields. </P
></LI
></OL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN399"
>6.6.4. Using an Update URL</A
></H4
><P
>This feature is implemented because the most popular Dynamic DNS providers are using Update URLs mechanism. </P
><P
></P
><OL
TYPE="1"
><LI
><P
>Register an account with a Dynamic DNS service provider providing their service using Update URL mechanism.  Some example providers are listed in the configuration page itself. </P
></LI
><LI
><P
>In FreedomBox UI, enable the Dynamic DNS service. </P
></LI
><LI
><P
>Select <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>other Update URL</I
></SPAN
> as <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Service type</I
></SPAN
>, enter the update URL given by your provider into <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Update URL</I
></SPAN
> field. </P
></LI
><LI
><P
>If you browse the update URL with your Internet browser and a warning message about untrusted certificate appears, then enable <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>accept all SSL certificates</I
></SPAN
>.  WARNING: your credentials may be readable here because man-in-the-middle attacks are possible!  Consider choosing a better service provider instead. </P
></LI
><LI
><P
>If you browse the update URL with your Internet browser and the username/password box appears, enable <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>use HTTP basic authentication</I
></SPAN
> checkbox and provide the <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Username</I
></SPAN
> and <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Password</I
></SPAN
>.  </P
></LI
><LI
><P
>If the update URL contains your current IP address, replace the IP address with the string <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>&#60;Ip&#62;</I
></SPAN
>. </P
></LI
></OL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN423"
>6.6.5. Checking If It Works</A
></H4
><P
></P
><OL
TYPE="1"
><LI
><P
>Make sure that external services you have enabled such as /jwchat, /roundcube and /ikiwiki are available on your domain address. </P
></LI
><LI
><P
>Go to the <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Status</I
></SPAN
> page, make sure that the NAT type is detected correctly. If your FreedomBox is behind a NAT device, this should be detected over there (Text: <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Behind NAT</I
></SPAN
>).  If your FreedomBox has a public IP address assigned, the text should be "Direct connection to the Internet". </P
></LI
><LI
><P
>Check that the last update status is not <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>failed</I
></SPAN
>. </P
></LI
></OL
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN435"
>6.7. Roundcube</A
></H3
><DIV
CLASS="section"
><H4
CLASS="section"
><A
NAME="AEN437"
>6.7.1. What is Roundcube?</A
></H4
><P
>RoundCube is a browser-based multilingual email client with an application-like user interface. RoundCube is using the Internet Message Access Protocol (IMAP) to access e-mail on a remote mail server. It supports MIME to send files, and provides particularly address book, folder management, message searching and spell checking. </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN440"
>6.8. ownCloud</A
></H3
><DIV
CLASS="section"
><H4
CLASS="section"
><A
NAME="AEN442"
>6.8.1. What is ownCloud?</A
></H4
><P
>ownCloud is a self-hosted file sync and share server. It provides access to your data through a platform to view, sync and share across devices. Calendars and Contacts feature will help you keeping google at a nice distance. ownCloud's functionalities are native or available via plugins (Collaborative Editing, Play Music, Watch Movies, Store Passwords, Dashboard, Mozilla Sync...) via <A
HREF="https://apps.owncloud.com/"
TARGET="_top"
>https://apps.owncloud.com/</A
> </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN446"
>6.8.2. Installation</A
></H4
><P
>Clicking on the ownCloud application in Plinth will show an installation prompt.  Proceed to install.  After the installation, visit the /owncloud link provided in the ownCloud page.  First time installation wizard will show up asking for administrator username and password to setup (no additional details such as database configuration are requested).  After providing the details, you will be logged.  You will be able to start using the ownCloud and create more users. </P
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN449"
>6.8.2.1. External Storage</A
></H5
><P
>ownCloud's external storage plugin allows you to expose the contents of a hard drive or those of an online storage account as a folder.  Following are the steps required to setup such storage. </P
><P
></P
><OL
TYPE="1"
><LI
><P
>Mount your hard drive or external storage to any fixed directory on the system. </P
></LI
><LI
><P
>Install two packages needed via the 'apt-get' on the SSH command line shell (this step will not be needed in future): </P
><P
></P
><UL
><LI
STYLE="list-style-type: none"
><PRE
CLASS="screen"
>$ sudo apt-get install php-google-api-php-client php-dropbox  </PRE
></LI
></UL
></LI
><LI
><P
>Goto ownCloud Apps section and enable 'External Storage Support' plugin. </P
></LI
><LI
><P
>Goto 'Admin' section and add your hard drive mount path in the external storage section.  This folder will now show up in your folders list to access and sync across devices. </P
></LI
></OL
></DIV
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN464"
>6.9. PageKite</A
></H3
><DIV
CLASS="section"
><H4
CLASS="section"
><A
NAME="AEN466"
>6.9.1. What is PageKite?</A
></H4
><P
>PageKite makes local websites and services publicly accessible immediately without creating yourself a public IP address. PageKite provides "Kites" and "Services". Kites aims to make accessible in a second a web page (for instance foo.pagekite.me). Services can expose a file or a folder. Technically speaking, PageKite is free Software solution for tunneling HTTP, HTTPS and SSH servers through firewalls and NAT. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN469"
>6.9.2. Use PageKite</A
></H4
><P
>See <A
HREF="http://pagekite.net/downloads/"
TARGET="_top"
>PageKite</A
> website. </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN473"
>6.10. Secure Shell</A
></H3
><DIV
CLASS="section"
><H4
CLASS="section"
><A
NAME="AEN475"
>6.10.1. What is Secure Shell?</A
></H4
><P
>FreedomBox runs <FONT
COLOR="RED"
>openssh-server</FONT
> server by default allowing remote logins from all interfaces.  If your hardware device is connected to a monitor and a keyboard, you may login directly as well.  Regular operation of FreedomBox does not require you to use the shell.  However, some tasks or identifying a problem may require you to login to a shell. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN479"
>6.10.2. Default User Account</A
></H4
><P
>The pre-built FreedomBox images have a default user account called "fbx". However the password is not set for this account, so it will not be possible to log in with this account by default. </P
><P
>There is a script included in the freedom-maker program, that will allow you to set the password for this account, if it is needed. To set a password for the "fbx" user: </P
><P
>1. Decompress the image file. </P
><P
>2. Get a copy of freedom-maker from <A
HREF="https://github.com/freedombox/freedom-maker"
TARGET="_top"
>https://github.com/freedombox/freedom-maker</A
>. </P
><P
>3. Run <FONT
COLOR="RED"
>sudo ./bin/passwd-in-image &#60;image-file&#62; fbx</FONT
>. </P
><P
>4. Copy the image file to SD card and boot device as normal. </P
><P
>The "fbx" user also has superuser privileges via sudo. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN490"
>6.10.3. Logging In</A
></H4
><P
>To login via SSH, to your FreedomBox: </P
><PRE
CLASS="screen"
>$ ssh fbx@freedombox</PRE
><P
>Replace <FONT
COLOR="RED"
>fbx</FONT
> with the name of the user you wish to login as.  <FONT
COLOR="RED"
>freedombox</FONT
> should be replaced with the hostname or IP address of you FreedomBox device as found in the <A
HREF="https://wiki.debian.org/FreedomBox/Manual/QuickStart#"
TARGET="_top"
>Quick Start</A
> process. </P
><P
><FONT
COLOR="RED"
>fbx</FONT
> is the default user present on FreedomBox with superuser privileges.  Any other user created using Plinth and belonging to the group <FONT
COLOR="RED"
>admin</FONT
> will be able to login.  The <FONT
COLOR="RED"
>root</FONT
> account has no password set and will not be able to login.  Access will be denied to all other users. </P
><P
><FONT
COLOR="RED"
>fbx</FONT
> and users in <FONT
COLOR="RED"
>admin</FONT
> group will also be able to login on the terminal directly.  Other users will be denied access. </P
><P
>If you repeatedly try to login as a user and fail, you will be blocked from logging in for some time.  This is due to <FONT
COLOR="RED"
>libpam-abl</FONT
> package that FreedomBox installs by default.  To control this behavior consult <FONT
COLOR="RED"
>libpam-abl</FONT
> documentation. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN508"
>6.10.4. Becoming Superuser</A
></H4
><P
>After logging in, if you want to become the superuser for performing administrative activities: </P
><PRE
CLASS="screen"
>$ sudo su</PRE
><P
>Make a habit of logging in as root <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>only when you need to</I
></SPAN
>.  If you aren't logged in as root, you can't accidentally break everything. </P
><P
>&#13;          <A
NAME="changingpassword"
></A
>
        </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN516"
>6.10.5. Changing Password</A
></H4
><P
>To change the password of a user managed by Plinth, use the change password page.  However, the <FONT
COLOR="RED"
>fbx</FONT
> default user is not managed by Plinth and its password cannot be changed in the web interface. </P
><P
>To change password on the terminal, log in to your FreedomBox as the user whose password you want to change. Then, run the following command: </P
><PRE
CLASS="screen"
>$ passwd</PRE
><P
>This will ask you for your current password before giving you the opportunity to set a new one. </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN523"
>6.11. Mumble</A
></H3
><DIV
CLASS="section"
><H4
CLASS="section"
><A
NAME="AEN525"
>6.11.1. What is Mumble?</A
></H4
><P
>Mumble is a voice chat software. Primarily intended for use while gaming, it is suitable for simple talking with high audio quality, noise suppression, encrypted communication, public/private-key authentication by default, and "wizards" to configure your microphone for instance. A user can be marked as a "priority speaker" within a channel. </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN528"
>6.12. Privoxy</A
></H3
><DIV
CLASS="section"
><H4
CLASS="section"
><A
NAME="AEN530"
>6.12.1. What is Privoxy?</A
></H4
><P
>Privoxy is a software for security, privacy, and accurate control over the web. It provides a much more powerful web proxy (anonymity on the web) than what your browser can offer. Privoxy "is a proxy that is primarily focused on privacy enhancement, ad and junk elimination and freeing the user from restrictions placed on his activities" (source: <A
HREF="http://www.privoxy.org/faq/index.html"
TARGET="_top"
>Privoxy FAQ</A
>). Learning about networking protocols like HTTP, about HTML, and "Regular Expressions" can help a lot using Privoxy. </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN534"
>6.13. Wiki &#38; Blog (Ikiwiki)</A
></H3
><DIV
CLASS="section"
><H4
CLASS="section"
><A
NAME="AEN536"
>6.13.1. What is Ikiwiki?</A
></H4
><P
>Ikiwiki converts wiki pages into HTML pages suitable for publishing on a website. It provides particularly blogging, podcasting, calendars and a large selection of plugins. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN539"
>6.13.2. Creating a wiki or blog</A
></H4
><P
>You can create a wiki or blog to be hosted on your FreedomBox through the Wiki &#38; Blog (Ikiwiki) page in Plinth. The first time you visit this page, it will ask to install packages required by Ikiwiki. </P
><P
>After the package install has completed, select the Create tab. You can select the type to be Wiki or Blog. Also type in a name for the wiki or blog, and the username and password for the wiki's/blog's admin account. Then click Update setup and you will see the wiki/blog added to your list. Note that each wiki/blog has its own admin account. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN543"
>6.13.3. Accessing your wiki or blog</A
></H4
><P
>From the Wiki &#38; Blog (Ikiwiki) page, select the Manage tab and you will see a list of your wikis and blogs. Click a name to navigate to that wiki or blog. </P
><P
>From here, if you click Edit or Preferences, you will be taken to a login page. To log in with the admin account that you created before, select the Other tab, enter the username and password, and click Login. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN547"
>6.13.4. User login through SSO</A
></H4
><P
>Besides the wiki/blog admin, other FreedomBox users can be given access to login and edit wikis and blogs.  However, they will not have all the same permissions as the wiki admin. They can add or edit pages, but cannot change the wiki's configuration. </P
><P
>To add a wiki user, go to the Users and Groups page in Plinth (under System configuration, the gear icon at the top right corner of the page). Create or modify a user, and add them to the wiki group. (Users in the admin group will also have wiki access.) </P
><P
>To login as a FreedomBox user, go to the wiki/blog's login page and select the Other tab.  Then click the "Login with HTTP auth" button. The browser will show a popup dialog where you can enter the username and password of the FreedomBox user. </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN552"
>6.14. Unhosted Storage</A
></H3
><DIV
CLASS="section"
><H4
CLASS="section"
><A
NAME="AEN554"
>6.14.1. What is Unhosted?</A
></H4
><P
><A
HREF="http://unhosted.org/"
TARGET="_top"
>Unhosted</A
> is a way to uncouple web applications from data.  No matter where a web application is served from, the data can be stored on an Unhosted storage server of user's choice.  Unhosted web apps do not send your user data to their server and are hence known as "serverless", "client-side", or "static" web apps.  Either you connect your own server at runtime, or your data stays within the browser.  Your FreedomBox can become your Unhosted storage server using a remoteStorage server know as <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>reStore</I
></SPAN
>. </P
><DIV
CLASS="note"
><P
></P
><TABLE
CLASS="note"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="../images/note.gif"
HSPACE="5"
ALT="Note"></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>This module is currently disabled in FreedomBox as the package required for reStore server is not available in Debian yet.  The package is available for testing via <A
HREF="http://debian-dev.freedombox.at/"
TARGET="_top"
>http://debian-dev.freedombox.at/</A
> </P
></TD
></TR
></TABLE
></DIV
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN562"
>6.14.2. Setup</A
></H4
><P
>Your FreedomBox contains a remoteStorage server called <A
HREF="https://github.com/jcoglan/restore"
TARGET="_top"
>reStore</A
>, that can serve as your personal storage server for Unhosted web apps.  To setup reStore, simply install and enable in FreedomBox web UI.  After the setup, create an account by visiting the link provided on the Unhosted app page <FONT
COLOR="RED"
>https://&#60;yourdomain&#62;/restore/</FONT
>. </P
><DIV
CLASS="warning"
><P
></P
><TABLE
CLASS="warning"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="../images/warning.gif"
HSPACE="5"
ALT="Warning"></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>User accounts are currently not integrated with Plinth user management, and public sign-up is enabled! </P
></TD
></TR
></TABLE
></DIV
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN569"
>6.14.3. Try Unhosted apps</A
></H4
><P
>Once Unhosted is setup on FreedomBox and when FreedomBox is accessible by a domain name (such by using PageKite, Dynamic DNS or Tor Hidden Service), try one of the following Unhosted web apps (more are listed at <A
HREF="http://unhosted.org/apps"
TARGET="_top"
>http://unhosted.org/apps</A
>): </P
><P
></P
><UL
><LI
><P
><A
HREF="http://litewrite.net/"
TARGET="_top"
>http://litewrite.net/</A
> (a note taking application) </P
></LI
><LI
><P
><A
HREF="https://myfavoritedrinks.5apps.com/"
TARGET="_top"
>https://myfavoritedrinks.5apps.com/</A
> (list your favorite drinks) </P
></LI
><LI
><P
><A
HREF="https://todomvc.5apps.com/labs/architecture-examples/remotestorage/"
TARGET="_top"
>https://todomvc.5apps.com/labs/architecture-examples/remotestorage/</A
> (a simple todo list) </P
></LI
></UL
><P
>To connect the Unhosted app to your FreedomBox's Unhosted storage, click on the remoteStorage icon and type your address <FONT
COLOR="RED"
>&#60;user&#62;@&#60;yourdomain&#62;</FONT
>, e.g.: </P
><P
>&#13;          <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/remotestorage.png"></SPAN
>
        </P
><P
>If this doesn't work, make sure that </P
><P
></P
><UL
><LI
><P
>FreedomBox has a domain name using PageKite, Dynamic DNS or Tor Hidden Service. </P
></LI
><LI
><P
>The reStore server is running. </P
></LI
><LI
><P
>You have created the account specified in the reStore server. </P
></LI
><LI
><P
>Your FreedomBox SSL certificate is trusted in your current browser session (important when using private browsing). </P
></LI
></UL
><P
>Finish the OAuth flow by authenticating with your password and authorizing access, then you should get redirected back to the Unhosted app, and be able to use it. All data of the Unhosted web app is now stored on your FreedomBox. </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN602"
>6.15. OpenVPN</A
></H3
><DIV
CLASS="section"
><H4
CLASS="section"
><A
NAME="AEN604"
>6.15.1. What is OpenVPN?</A
></H4
><P
>OpenVPN provides to your FreedomBox a virtual private network service. You can use this software for remote access, site-to-site VPNs and Wi-Fi security. OpenVPN includes support for dynamic IP addresses and NAT. </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN607"
>6.16. GnuSocial</A
></H3
><DIV
CLASS="section"
><H4
CLASS="section"
><A
NAME="AEN609"
>6.16.1. What is GNU social?</A
></H4
><P
>GNU social is a continuation of the <A
HREF="https://wiki.debian.org/StatusNet#"
TARGET="_top"
>StatusNet</A
> project. It is social communication software for both public and private communications. It is widely supported and has a large userbase. It is already used by the Free Software Foundation, and Richard Stallman himself. Think of GNU Social as twitter and beyond. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN613"
>6.16.2. Status of package</A
></H4
><P
>GNU Social is still getting packaged for debian and will be available soon for everyone to use. check the progress by tracking the bug #782812. </P
></DIV
></DIV
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="AEN616"
>7. System</A
></H2
><DIV
CLASS="section"
><H3
CLASS="section"
><A
NAME="AEN618"
>7.1. Networks</A
></H3
><P
>This section describes how networking is setup by default in FreedomBox and how you can customize it.  See also the <A
HREF="https://wiki.debian.org/FreedomBox/Manual/Firewall#"
TARGET="_top"
>Firewall</A
> section for more information on how firewall works. </P
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN622"
>7.1.1. Default setup</A
></H4
><P
>In a fresh image of FreedomBox, network is not configured at all. When the image is written to an SD card and the device boots, configuration is done.  During first boot, FreedomBox setup package detects the networks interfaces and tries to automatically configure them so that FreedomBox is available for further configuration via the web interface from another machine without the need to connect a monitor.  Automatic configuration also tries to make FreedomBox useful, out of the box, for the most important scenarios FreedomBox is used for. </P
><P
>There are two scenarios it handles: when is a single ethernet interface and when there are multiple ethernet interfaces. </P
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN626"
>7.1.1.1. Single ethernet interface</A
></H5
><P
>When there is only single ethernet interface available on the hardware device, there is not much scope for it to play the role of a router. In this case, the device is assumed to be just another machine in the network.  Accordingly, the only available interface is configured to be an <FONT
COLOR="RED"
>internal</FONT
> interface in <FONT
COLOR="RED"
>automatic</FONT
> configuration mode.  This means that it connects to the Internet using the configuration provided by a router in the network and also makes all (internal and external) of its services available to all the clients on this network. </P
></DIV
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN631"
>7.1.1.2. Multiple ethernet interface</A
></H5
><P
>When there are multiple ethernet interfaces available on the hardware device, the device can act as a router.  The interfaces are then configured to perform this function. </P
><P
>The first network interface is configured to be an WAN or <FONT
COLOR="RED"
>external</FONT
> interface in automatic configuration mode.  This means that it connects to the Internet using network configuration provided by the Internet Service Provider (ISP).  Only services that are meant to be provided across the entire Internet (external services) will be exposed on this interface.  You must plug your Internet connection into the port of this ethernet interface.  If you wish to continue to have your existing router manage the Internet connection for you, then plug a connection from your router to the port on this interface. </P
><P
>The remaining network interfaces are configured for the clients of a router.  They are configured as LAN or <FONT
COLOR="RED"
>internal</FONT
> interfaces in <FONT
COLOR="RED"
>shared</FONT
> configuration mode.  This means that all the services (both external and internal) services are provided to who ever connects on this interface.  Further, the <FONT
COLOR="RED"
>shared</FONT
> mode means that clients will be able to receive details of automatic network connection on this interface.  Specifically, DHCP configuration and DNS servers are provided on this interface.  The Internet connection available to the device using the first network interface will be <FONT
COLOR="RED"
>shared</FONT
> with clients using this interface.  This all means that you can connect your computers to this network interface and they will get automatically configured and will be able to access the Internet via the FreedomBox. </P
><P
>Currently, it is not very clear which interface will be come the WAN interface (and the remaining being LAN interfaces) although the assignment process is deterministic.  So, it take a bit of trail and error to figure out which one is which.  In future, for each device, this will be well documented. </P
></DIV
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN642"
>7.1.1.3. Wi-Fi configuration</A
></H5
><P
>All Wi-Fi interfaces are configured to be LAN or <FONT
COLOR="RED"
>internal</FONT
> interfaces in <FONT
COLOR="RED"
>shared</FONT
> configuration mode.  They are also configured to become Wi-Fi access points with following details. </P
><P
></P
><UL
><LI
><P
>Name of the access point will be <FONT
COLOR="RED"
>FreedomBox</FONT
> plus the name of the interface (to handle the case where there are multiple of them). </P
></LI
><LI
><P
>Password for connecting to the interface will be <FONT
COLOR="RED"
>freedombox123</FONT
>. </P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN654"
>7.1.2. Internet Connection Sharing</A
></H4
><P
>Although the primary duty of FreedomBox is to provide decentralized services, it can't also act like a home router.  Hence, in most cases, FreedomBox connects to the Internet and provides other machines in the network the ability to use that Internet connection.  FreedomBox can do this in two ways: using a <FONT
COLOR="RED"
>shared</FONT
> mode connection or using an <FONT
COLOR="RED"
>internal</FONT
> connection. </P
><P
>When an interface is set in <FONT
COLOR="RED"
>shared</FONT
> mode, you may connect your machine directly to it.  This is either by plugging in an ethernet cable from this interface to your machine or by connecting to a Wi-Fi access point.  This case is the simplest to use, as FreedomBox automatically provides your machine with the necessary network configuration.  Your machine will automatically connect to FreedomBox provided network and will be able to connect to the Internet given that FreedomBox can itself connect to the Internet. </P
><P
>Sometimes the above setup may not be possible because the hardware device may have only one network interface or for other reasons.  Even in this case, your machine can still connect to the Internet via FreedomBox.  For this to work, make sure that the network interface that your machine is connecting to is in <FONT
COLOR="RED"
>internal</FONT
> mode.  Then, connect your machine to network in which FreedomBox is present.  After this, in your machine's network configuration, set FreedomBox's IP address as the gateway.  FreedomBox will then accept your network traffic from your machine and send it over to the Internet.  This works because network interfaces in <FONT
COLOR="RED"
>internal</FONT
> mode are configured to <FONT
COLOR="RED"
>masquerade</FONT
> packets from local machines to the Internet and receive packets from Internet and forward them back to local machines. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN665"
>7.1.3. Customization</A
></H4
><P
>The above default configuration may not be fit for your setup.  You can customize the configuration to suit your needs from the <FONT
COLOR="RED"
>Networks</FONT
> area in the 'setup' section of the FreedomBox web interface. </P
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN669"
>7.1.3.1. PPPoE connections</A
></H5
><P
>If your ISP does not provide automatic network configuration via DHCP and requires you to connection via PPPoE.  To configure PPPoE, remove any network connection existing on an interface and add a PPPoE connection.  Here, optionally, provide the account username and password given by your ISP and activate the connection. </P
></DIV
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN672"
>7.1.3.2. Connect to Internet via Wi-Fi</A
></H5
><P
>By default Wi-Fi devices attached during first boot will be configured as access points.  They can be configured as regular Wi-Fi devices instead to connection to a local network or an existing Wi-Fi router. To do this, click on the Wi-Fi connection to edit it.  Change the mode to <FONT
COLOR="RED"
>Infrastructure</FONT
> instead of <FONT
COLOR="RED"
>Access Point</FONT
> mode and <FONT
COLOR="RED"
>IPv4 Addressing Method</FONT
> to <FONT
COLOR="RED"
>Automatic (DHCP)</FONT
> instead of <FONT
COLOR="RED"
>Shared</FONT
> mode. Then the SSID provided will mean the Wi-Fi network name you wish to connect to and passphrase will be the used to while making the connection. </P
></DIV
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN680"
>7.1.3.3. Adding a new network device</A
></H5
><P
>When a new network device is added, network manager will automatically configure it.  In most cases this will not work to your liking. Delete the automatic configuration created on the interface and create a new network connection.  Select your newly added network interface in the add connection page. </P
><P
></P
><UL
><LI
><P
>Then set firewall zone to <FONT
COLOR="RED"
>internal</FONT
> and <FONT
COLOR="RED"
>external</FONT
> appropriately. </P
></LI
><LI
><P
>You can configure the interface to connect to a network or provide network configuration to whatever machine connects to it. </P
></LI
><LI
><P
>Similarly, if it is a Wi-Fi interface, you can configure it to become a Wi-FI access point or to connect to an existing access points in the network. </P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN692"
>7.1.4. Manual Network Operation</A
></H4
><P
>FreedomBox automatically configures networks by default and provides a simplified interface to customize the configuration to specific needs.  In most cases, manual operation is not necessary.  The following steps describe how to manually operate network configuration in the event that a user finds FreedomBox interface to insufficient for task at hand or to diagnose a problem that FreedomBox does not identify. </P
><P
>On the command line interface: </P
><P
>To see the list of available network devices: </P
><PRE
CLASS="screen"
>nmcli device</PRE
><P
>To see the list of configured connections: </P
><PRE
CLASS="screen"
>nmcli connection</PRE
><P
>To see the current status of a connection: </P
><PRE
CLASS="screen"
>nmcli connection show '&#60;conneciton_name&#62;'</PRE
><P
>To see the current firewall zone assigned to a network interface: </P
><PRE
CLASS="screen"
>nmcli connection show '&#60;conneciton_name&#62;' | grep zone</PRE
><P
>or </P
><PRE
CLASS="screen"
>firewall-cmd --zone=internal --list=all
firewall-cmd --zone=external --list=all</PRE
><P
>To create a new network connection: </P
><PRE
CLASS="screen"
>nmcli con add con-name "&#60;connection_name&#62;" ifname "&#60;interface&#62;" type ethernet
nmcli con modify "&#60;connection_name&#62;" connection.autoconnect TRUE
nmcli con modify "&#60;connection_name&#62;" connection.zone internal</PRE
><P
>To change the firewall zone for a connection: </P
><PRE
CLASS="screen"
>nmcli con modify "&#60;connection_name&#62;" connection.zone "&#60;internal|external&#62;"</PRE
><P
>For more information on how to use <FONT
COLOR="RED"
>nmcli</FONT
> command, see its man page. Also for a full list of configuration settings and type of connections accepted by Network Manager see: </P
><P
>&#13;          <A
HREF="https://developer.gnome.org/NetworkManager/stable/ref-settings.html"
TARGET="_top"
>https://developer.gnome.org/NetworkManager/stable/ref-settings.html</A
>
        </P
><P
>To see the current status of the firewall and manually operate it, see the <A
HREF="https://wiki.debian.org/FreedomBox/Manual/Firewall#"
TARGET="_top"
>Firewall</A
> section. </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN716"
>7.2. Upgrades</A
></H3
><P
>FreedomBox can automatically install security upgrades.  On the <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Upgrades</I
></SPAN
> page of the <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Settings</I
></SPAN
> section in Plinth you can turn on automatic upgrades. For FreedomBox versions above 0.5, this feature is enabled by default and there is no manual action necessary.  It is strongly recommended that you have this option enabled to keep your FreedomBox secure. </P
><P
>Upgrades are performed every day at night.  If you wish to shutdown FreedomBox every day after use, keep it running at night once a week or so to let the automatic upgrades happen.  Alternatively, you can perform manual upgrades as described below. </P
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN722"
>7.2.1. Manual Upgrades</A
></H4
><P
>In the Plinth web interface, you can initiate a manual upgrade process from <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Upgrades</I
></SPAN
> page of the <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Settings</I
></SPAN
> section.  Note that once the upgrades start, it may take a long time to complete and Plinth may seem to wait for the page to load. </P
><P
>Under some circumstances, automatic upgrades may fail and require you perform a manual upgrade action.  Even upgrades initiated from Plinth may not finish properly.  This may be because the upgrade process requires you to make a decision.  In these cases, manual upgrade on the terminal may be the only option. </P
><P
>In addition, while the upgrade task is running any application installations will wait until the upgrade task is finished. Depending on the hardware, the upgrade task may take a little time, therefore, giving the impression that the application installation stalled. </P
><P
>To perform manual upgrades on the terminal, login into FreedomBox on a terminal or using a remote secure shell (see <A
HREF="https://wiki.debian.org/FreedomBox/Manual/SecureShell#"
TARGET="_top"
>Secure Shell</A
> section).  Then run the following commands: </P
><PRE
CLASS="screen"
>$ sudo su -
Password:
# apt-get update
# apt-get dist-upgrade</PRE
><P
>This will ask you if it is alright to install/upgrade (or remove) some packages and use (or release) some disk space.  Say <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>yes</I
></SPAN
> after review.  In some cases, during the upgrades process you will be asked questions about modified configuration files, answering with a default <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Keep current configuration</I
></SPAN
> is usually safe. </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN735"
>7.3. Firewall</A
></H3
><P
>Firewall is a network security system that controls the incoming and outgoing network traffic. Keeping a firewall enabled and properly configured reduces risk of security threat from the Internet. </P
><P
>The operation of the firewall in Plinth web interface of FreedomBox is automatic. When you enable a service it is automatically permitted in the firewall and when you disable a service it is automatically disabled in the firewall. For services which are enabled by default on FreedomBox, firewall ports are also enabled by default during the first run process. </P
><P
>Firewall management in FreedomBox is done using <A
HREF="https://fedoraproject.org/wiki/FirewallD"
TARGET="_top"
>FirewallD</A
>. </P
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN741"
>7.3.1. Interfaces</A
></H4
><P
>Each interface is needs to be assigned to one (and only one) zone. Whatever rules are in effect for a zone, those rules start to apply for that interface. For example, if HTTP traffic is allowed in a particular zone, then web requests will be accepted on all the addresses configured for all the interfaces assigned to that zone. </P
><P
>There are primarily two firewall zones used. The <FONT
COLOR="RED"
>internal</FONT
> zone is meant for services that are provided to all machines on the local network.  This may include services such as streaming media and simple file sharing.  The <FONT
COLOR="RED"
>external</FONT
> zone is meant for services that are provided publicly on the Internet.  This may include services such as blog, website, email web client etc. </P
><P
>For details on how network interfaces are configured by default, see the <A
HREF="https://wiki.debian.org/FreedomBox/Manual/Networks#"
TARGET="_top"
>Networks</A
> section. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN749"
>7.3.2. Ports/Services</A
></H4
><P
>The following table attempts to document the ports, services and their default statuses in FreedomBox. If you find this page outdated, see the Plinth source for <A
HREF="http://sources.debian.net/src/plinth/latest/data/usr/lib/freedombox/first-run.d/90_firewall"
TARGET="_top"
>lib/freedombox/first-run.d/90_firewall</A
> and Firewall status page in Plinth UI. </P
><DIV
CLASS="informaltable"
><P
></P
><A
NAME="AEN753"
></A
><TABLE
BORDER="1"
CLASS="CALSTABLE"
><COL
WIDTH="1*"
TITLE="col_0"><COL
WIDTH="1*"
TITLE="col_1"><COL
WIDTH="1*"
TITLE="col_2"><COL
WIDTH="1*"
TITLE="col_3"><COL
WIDTH="1*"
TITLE="col_4"><COL
WIDTH="1*"
TITLE="col_5"><TBODY
><TR
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="strong"
><B
CLASS="emphasis"
>Service</B
></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="strong"
><B
CLASS="emphasis"
>Port</B
></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="strong"
><B
CLASS="emphasis"
>External</B
></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="strong"
><B
CLASS="emphasis"
>Enabled by default</B
></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="strong"
><B
CLASS="emphasis"
>Status shown in Plinth</B
></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="strong"
><B
CLASS="emphasis"
>Managed by Plinth</B
></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
> SSH         </P
>
                </TD
><TD
>&#13;                  <P
> 22/tcp       </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/star_on.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
> JWChat      </P
>
                </TD
><TD
>&#13;                  <P
> 80/tcp       </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/star_on.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
> JWChat      </P
>
                </TD
><TD
>&#13;                  <P
> 443/tcp      </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/star_on.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
> OwnCloud   </P
>
                </TD
><TD
>&#13;                  <P
> 80/tcp       </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/star_on.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
> OwnCloud   </P
>
                </TD
><TD
>&#13;                  <P
> 443/tcp      </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/star_on.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
> Plinth      </P
>
                </TD
><TD
>&#13;                  <P
> 443/tcp      </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/star_on.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
> Tor (Socks) </P
>
                </TD
><TD
>&#13;                  <P
> 9050/tcp     </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/star_off.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
> NTP         </P
>
                </TD
><TD
>&#13;                  <P
> 123/udp      </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/star_off.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
> DNS         </P
>
                </TD
><TD
>&#13;                  <P
> 53/tcp       </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/star_off.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
> DNS         </P
>
                </TD
><TD
>&#13;                  <P
> 53/tdp       </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/star_off.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
> mDNS        </P
>
                </TD
><TD
>&#13;                  <P
> 5353/udp     </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/star_off.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
> DHCP        </P
>
                </TD
><TD
>&#13;                  <P
> 67/udp       </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/star_off.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
> Bootp       </P
>
                </TD
><TD
>&#13;                  <P
> 67/tcp       </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/star_off.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
> Bootp       </P
>
                </TD
><TD
>&#13;                  <P
> 67/udp       </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/star_off.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
> Bootp       </P
>
                </TD
><TD
>&#13;                  <P
> 68/tcp       </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/star_off.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
> Bootp       </P
>
                </TD
><TD
>&#13;                  <P
> 68/udp       </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/star_off.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
> LDAP        </P
>
                </TD
><TD
>&#13;                  <P
> 389/tcp      </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/star_off.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
> LDAPS       </P
>
                </TD
><TD
>&#13;                  <P
> 636/tcp      </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/star_off.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
> OpenVPN     </P
>
                </TD
><TD
>&#13;                  <P
> 1194/udp     </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/star_on.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
> Privoxy     </P
>
                </TD
><TD
>&#13;                  <P
> 8118/tcp     </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/star_off.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
> XMPP Server </P
>
                </TD
><TD
>&#13;                  <P
> 5269/tcp     </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/star_on.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
> XMPP Client </P
>
                </TD
><TD
>&#13;                  <P
> 5222/tcp     </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/star_on.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
> XMPP Bosh   </P
>
                </TD
><TD
>&#13;                  <P
> 5280/tcp     </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/star_on.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
> Obfsproxy   </P
>
                </TD
><TD
>&#13;                  <P
> &#60;random&#62;/tcp </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/star_on.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN1573"
>7.3.3. Manual operation</A
></H4
><P
>See <A
HREF="https://fedoraproject.org/wiki/FirewallD"
TARGET="_top"
>FirewallD</A
> documentation for more information on the basic concepts and comprehensive documentation. </P
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN1577"
>7.3.3.1. Enable/disable firewall</A
></H5
><P
>To disable firewall </P
><PRE
CLASS="screen"
>service firewalld stop</PRE
><P
>or with systemd </P
><PRE
CLASS="screen"
>systemctl stop firewalld</PRE
><P
>To re-enable firewall </P
><PRE
CLASS="screen"
>service firewalld start</PRE
><P
>or with systemd </P
><PRE
CLASS="screen"
>systemctl start firewalld</PRE
></DIV
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN1587"
>7.3.3.2. Modifying services/ports</A
></H5
><P
>You can manually add or remove a service from a zone. </P
><P
>To see list of services enabled: </P
><PRE
CLASS="screen"
>firewall-cmd --zone=&#60;zone&#62; --list-services</PRE
><P
>Example: </P
><PRE
CLASS="screen"
>firewall-cmd --zone=internal --list-services</PRE
><P
>To see list of ports enabled: </P
><PRE
CLASS="screen"
>firewall-cmd --zone=&#60;zone&#62; --list-ports</PRE
><P
>Example: </P
><PRE
CLASS="screen"
>firewall-cmd --zone=internal --list-ports</PRE
><P
>To remove a service from a zone: </P
><PRE
CLASS="screen"
>firewall-cmd --zone=&#60;zone&#62; --remove-service=&#60;service&#62;
firewall-cmd --permanent --zone=&#60;zone&#62; --remove-service=&#60;interface&#62;</PRE
><P
>Example: </P
><PRE
CLASS="screen"
>firewall-cmd --zone=internal --remove-service=xmpp-bosh
firewall-cmd --permanent --zone=internal --remove-service=xmpp-bosh</PRE
><P
>To remove a port from a zone: </P
><PRE
CLASS="screen"
>firewall-cmd --zone=internal --remove-port=&#60;port&#62;/&#60;protocol&#62;
firewall-cmd --permanent --zone=internal --remove-port=&#60;port&#62;/&#60;protocol&#62;</PRE
><P
>Example: </P
><PRE
CLASS="screen"
>firewall-cmd --zone=internal --remove-port=5353/udp
firewall-cmd --permanent --zone=internal --remove-port=5353/udp</PRE
><P
>To add a service to a zone: </P
><PRE
CLASS="screen"
>firewall-cmd --zone=&#60;zone&#62; --add-service=&#60;service&#62;
firewall-cmd --permanent --zone=&#60;zone&#62; --add-service=&#60;interface&#62;</PRE
><P
>Example: </P
><PRE
CLASS="screen"
>firewall-cmd --zone=internal --add-service=xmpp-bosh
firewall-cmd --permanent --zone=internal --add-service=xmpp-bosh</PRE
><P
>To add a port to a zone: </P
><PRE
CLASS="screen"
>firewall-cmd --zone=internal --add-port=&#60;port&#62;/&#60;protocol&#62;
firewall-cmd --permanent --zone=internal --add-port=&#60;port&#62;/&#60;protocol&#62;</PRE
><P
>Example: </P
><PRE
CLASS="screen"
>firewall-cmd --zone=internal --add-port=5353/udp
firewall-cmd --permanent --zone=internal --add-port=5353/udp</PRE
></DIV
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN1614"
>7.3.3.3. Modifying the zone of interfaces</A
></H5
><P
>You can manually change the assignment of zones of each interfaces after they have been autuomatically assigned by the first boot process. </P
><P
>To see current assignment of interfaces to zones: </P
><PRE
CLASS="screen"
>firewall-cmd --list-all-zones</PRE
><P
>To remove an interface from a zone: </P
><PRE
CLASS="screen"
>firewall-cmd --zone=&#60;zone&#62; --remove-interface=&#60;interface&#62;
firewall-cmd --permanent --zone=&#60;zone&#62; --remove-interface=&#60;interface&#62;</PRE
><P
>Example: </P
><PRE
CLASS="screen"
>firewall-cmd --zone=external --remove-interface=eth0
firewall-cmd --permanent --zone=external --remove-interface=eth0</PRE
><P
>To add an interface to a zone: </P
><PRE
CLASS="screen"
>firewall-cmd --zone=&#60;zone&#62; --add-interface=&#60;interface&#62;
firewall-cmd --permanent --zone=&#60;zone&#62; --add-interface=&#60;interface&#62;</PRE
><P
>Example: </P
><PRE
CLASS="screen"
>firewall-cmd --zone=internal --add-interface=eth0
firewall-cmd --permanent --zone=internal --add-interface=eth0</PRE
></DIV
></DIV
></DIV
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="AEN1627"
>8. Hardware</A
></H2
><P
>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. </P
><P
>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 <FONT
COLOR="RED"
>freedombox-setup</FONT
> package.  See the <A
HREF="https://wiki.debian.org/FreedomBox/Manual#"
TARGET="_top"
>manual</A
> for more details. </P
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN1633"
>8.1. Supported Hardware</A
></H3
><DIV
CLASS="section"
><H4
CLASS="section"
><A
NAME="AEN1635"
>8.1.1. Recommended Hardware</A
></H4
><DIV
CLASS="informaltable"
><P
></P
><A
NAME="AEN1637"
></A
><TABLE
BORDER="1"
CLASS="CALSTABLE"
><COL
WIDTH="1*"
TITLE="col_0"><COL
WIDTH="1*"
TITLE="col_1"><COL
WIDTH="1*"
TITLE="col_2"><COL
WIDTH="1*"
TITLE="col_3"><COL
WIDTH="1*"
TITLE="col_4"><TBODY
><TR
><TD
ALIGN="center"
>&#13;                  <P
>&#13;                    <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/Cubietruck#"
TARGET="_top"
>&#13;                      <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/danube_thumb.png"
WIDTH="117.5pt"
HEIGHT="103pt"></SPAN
>
                    </A
>
                  </P
>
                  <P
>&#13;                    <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/Cubietruck#"
TARGET="_top"
>FreedomBox - Danube Edition</A
>
                  </P
>
                  <P
> (based on Cubietruck) </P
>
                </TD
><TD
ALIGN="center"
>&#13;                  <P
>&#13;                    <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/Cubieboard2#"
TARGET="_top"
>&#13;                      <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/cubieboard2_thumb.jpg"
WIDTH="117.5pt"
HEIGHT="78pt"></SPAN
>
                    </A
>
                  </P
>
                  <P
>&#13;                    <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/Cubieboard2#"
TARGET="_top"
>Cubieboard2</A
>
                  </P
>
                </TD
><TD
ALIGN="center"
>&#13;                  <P
>&#13;                    <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/BeagleBone#"
TARGET="_top"
>&#13;                      <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/beagleboard_thumb.jpg"
WIDTH="117.5pt"
HEIGHT="78.5pt"></SPAN
>
                    </A
>
                  </P
>
                  <P
>&#13;                    <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/BeagleBone#"
TARGET="_top"
>BeagleBone Black</A
>
                  </P
>
                </TD
><TD
>&nbsp;</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="center"
>&#13;                  <P
>&#13;                    <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/A20-OLinuXino-Lime2#"
TARGET="_top"
>&#13;                      <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/a20-olinuxino-lime2_thumb.jpg"
WIDTH="117.5pt"
HEIGHT="79.5pt"></SPAN
>
                    </A
>
                  </P
>
                  <P
>&#13;                    <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/A20-OLinuXino-Lime2#"
TARGET="_top"
>A20 OLinuXino Lime2</A
>
                  </P
>
                </TD
><TD
ALIGN="center"
>&#13;                  <P
>&#13;                    <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/A20-OLinuXino-MICRO#"
TARGET="_top"
>&#13;                      <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/a20-olinuxino-micro_thumb.jpg"
WIDTH="117.5pt"
HEIGHT="66pt"></SPAN
>
                    </A
>
                  </P
>
                  <P
>&#13;                    <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/A20-OLinuXino-MICRO#"
TARGET="_top"
>A20 OLinuXino MICRO</A
>
                  </P
>
                </TD
><TD
ALIGN="center"
>&#13;                  <P
>&#13;                    <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/APU#"
TARGET="_top"
>&#13;                      <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/apu1d_thumb.jpg"
WIDTH="117.5pt"
HEIGHT="78.5pt"></SPAN
>
                    </A
>
                  </P
>
                  <P
>&#13;                    <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/APU#"
TARGET="_top"
>PC Engines APU</A
>
                  </P
>
                </TD
><TD
>&nbsp;</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="center"
>&#13;                  <P
>&#13;                    <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/Debian#"
TARGET="_top"
>&#13;                      <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/debian_thumb.png"
WIDTH="78pt"
HEIGHT="100.5pt"></SPAN
>
                    </A
>
                  </P
>
                  <P
>&#13;                    <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/Debian#"
TARGET="_top"
>Debian</A
>
                  </P
>
                </TD
><TD
ALIGN="center"
>&#13;                  <P
>&#13;                    <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/VirtualBox#"
TARGET="_top"
>&#13;                      <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/virtualbox_thumb.png"
WIDTH="117.5pt"
HEIGHT="77pt"></SPAN
>
                    </A
>
                  </P
>
                  <P
>&#13;                    <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/VirtualBox#"
TARGET="_top"
>VirtualBox</A
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>.</P
>
                </TD
><TD
>&#13;                  <P
>.</P
>
                </TD
><TD
>&#13;                  <P
>.</P
>
                </TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN1735"
>8.1.2. Also Working Hardware</A
></H4
><P
>This hardware works but is not recommended due to freedom, performance-per-cost, or other concerns: </P
><DIV
CLASS="informaltable"
><P
></P
><A
NAME="AEN1738"
></A
><TABLE
BORDER="1"
CLASS="CALSTABLE"
><COL
WIDTH="1*"
TITLE="col_0"><COL
WIDTH="1*"
TITLE="col_1"><COL
WIDTH="1*"
TITLE="col_2"><TBODY
><TR
><TD
ALIGN="center"
>&#13;                  <P
>&#13;                    <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/DreamPlug#"
TARGET="_top"
>&#13;                      <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/dreamplug_thumb.jpg"
WIDTH="117.5pt"
HEIGHT="78pt"></SPAN
>
                    </A
>
                  </P
>
                  <P
>&#13;                    <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/DreamPlug#"
TARGET="_top"
>DreamPlug</A
>
                  </P
>
                </TD
><TD
ALIGN="center"
>&#13;                  <P
>&#13;                    <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/RaspberryPi#"
TARGET="_top"
>&#13;                      <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/raspberry_thumb.jpg"
WIDTH="117.5pt"
HEIGHT="79pt"></SPAN
>
                    </A
>
                  </P
>
                  <P
>&#13;                    <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/RaspberryPi#"
TARGET="_top"
>Raspberry Pi</A
>
                  </P
>
                </TD
><TD
ALIGN="center"
>&#13;                  <P
>&#13;                    <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/RaspberryPi2#"
TARGET="_top"
>&#13;                      <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/raspberry2_thumb.jpg"
WIDTH="117.5pt"
HEIGHT="78.5pt"></SPAN
>
                    </A
>
                  </P
>
                  <P
>&#13;                    <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/RaspberryPi2#"
TARGET="_top"
>Raspberry Pi 2</A
>
                  </P
>
                </TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
><P
><SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Note</I
></SPAN
>: As FreedomBox is in development state, <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Supported Hardware</I
></SPAN
> means that FreedomBox images are built for the said hardware and at least one developers has reported the basic functions to be working. </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN1778"
>8.2. Targeted Hardware</A
></H3
><DIV
CLASS="section"
><H4
CLASS="section"
><A
NAME="AEN1780"
>8.2.1. List of Hardware Targeted</A
></H4
><P
>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 <A
HREF="https://wiki.debian.org/FreedomBox/TargetedHardware#"
TARGET="_top"
>hardware targeted</A
> for support.   </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN1784"
>8.2.2. Adding Hardware Support</A
></H4
><P
>If you are a developer, consider adding hardware support for your device by modifying <A
HREF="https://wiki.debian.org/FreedomBox/Maker#"
TARGET="_top"
>Freedom Maker</A
> and <A
HREF="https://wiki.debian.org/FreedomBox/Setup#"
TARGET="_top"
>FreedomBox Setup</A
>. </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN1789"
>8.3. Cubietruck</A
></H3
><DIV
CLASS="section"
><H4
CLASS="section"
><A
NAME="AEN1791"
>8.3.1. FreedomBox Danube Edition</A
></H4
><P
>&#13;          <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/freedombox-danube.jpg"
WIDTH="320pt"
HEIGHT="280.5pt"></SPAN
>
        </P
><P
><A
HREF="http://projectdanube.org/freedombox/"
TARGET="_top"
>FreedomBox Danube Edition</A
> is a custom casing around Cubietruck coupled with an SSD. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN1801"
>8.3.2. Cubietruck / Cubieboard3</A
></H4
><P
><A
HREF="http://cubieboard.org/model/"
TARGET="_top"
>Cubietruck</A
> (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 <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#"
TARGET="_top"
>USB WiFi device</A
> that does not require non-free firmware is recommended. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN1806"
>8.3.3. Download</A
></H4
><P
>FreedomBox SD card <A
HREF="https://wiki.debian.org/FreedomBox/Download#"
TARGET="_top"
>images</A
> 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. </P
><P
>An alternative to downloading these images is to <A
HREF="https://wiki.debian.org/InstallingDebianOn/Allwinner#"
TARGET="_top"
>install Debian</A
> on Cubietruck and then <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/Debian#"
TARGET="_top"
>install FreedomBox</A
> on it. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN1813"
>8.3.4. Build Image</A
></H4
><P
>FreedomBox images for this hardware can be built using <A
HREF="https://wiki.debian.org/FreedomBox/Maker#"
TARGET="_top"
>Freedom Maker</A
>. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN1817"
>8.3.5. Availability</A
></H4
><P
>FreedomBox Danue Edition </P
><P
></P
><UL
><LI
><P
>A limited number of units are planned to be shipped along with the release of FreedomBox 1.0.  If you wish to get one, <A
HREF="http://projectdanube.org/freedombox/"
TARGET="_top"
>express your interest</A
>. </P
></LI
></UL
><P
>Cubietruck / Cubieboard3 </P
><P
></P
><UL
><LI
><P
>Price: 89 USD </P
></LI
><LI
><P
>&#13;              <A
HREF="http://cubieboard.org/buy/"
TARGET="_top"
>List of suppliers</A
>
            </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN1831"
>8.3.6. Hardware</A
></H4
><P
></P
><UL
><LI
><P
>Open Hardware: No </P
></LI
><LI
><P
>CPU: Allwinner A20, ARM Cortex-A7 @ 1GHz dual-core </P
></LI
><LI
><P
>RAM: 2 GiB DDR3 @ 480 MHz </P
></LI
><LI
><P
>Storage: 8 GB NAND flash built-in, 1x microSD slot </P
></LI
><LI
><P
>Architecture: armhf </P
></LI
><LI
><P
>Ethernet: 10/100/1000, RJ45 </P
></LI
><LI
><P
>WiFi: Broadcom BCM4329/BCM40181 (no free WiFi drivers + firmware available) </P
></LI
><LI
><P
>SATA: 1x 2.0 port </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN1850"
>8.3.7. Non-Free Status</A
></H4
><P
></P
><UL
><LI
><P
>Non-free blobs required: ? </P
></LI
><LI
><P
>WiFi: no free WiFi drivers + firmware available </P
></LI
><LI
><P
>Works with stock Debian kernel: yes </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN1859"
>8.3.8. Known Issues</A
></H4
><P
></P
><UL
><LI
><P
>WiFi does not work with free software.  A separate <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#"
TARGET="_top"
>USB WiFi device</A
> is recommended. </P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN1865"
>8.4. Beagle Bone Black</A
></H3
><P
>&#13;        <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/beagleboard.jpg"
WIDTH="316pt"
HEIGHT="210.5pt"></SPAN
>
      </P
><P
><A
HREF="http://beagleboard.org/black"
TARGET="_top"
>Beagle Bone Black</A
> (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 <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#"
TARGET="_top"
>USB WiFi device</A
> that does not require non-free firmware is recommended. </P
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN1876"
>8.4.1. Download</A
></H4
><P
>FreedomBox SD card <A
HREF="https://wiki.debian.org/FreedomBox/Download#"
TARGET="_top"
>images</A
> for this hardware are available.  Follow the instructions on the <A
HREF="https://wiki.debian.org/FreedomBox/Download#"
TARGET="_top"
>download</A
> page to create a FreedomBox SD card and boot into FreedomBox. </P
><P
>Note: This image is for BeagleBone Black. It won't work on BeagleBone Green. </P
><P
>An alternative to downloading these images is to <A
HREF="https://wiki.debian.org/InstallingDebianOn/TI/BeagleBone#"
TARGET="_top"
>install Debian</A
> on BeagleBone and then <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/Debian#"
TARGET="_top"
>install FreedomBox</A
> on it. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN1885"
>8.4.2. Build Image</A
></H4
><P
>FreedomBox images for this hardware can be built using <A
HREF="https://wiki.debian.org/FreedomBox/Maker#"
TARGET="_top"
>Freedom Maker</A
>. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN1889"
>8.4.3. Availability</A
></H4
><P
></P
><UL
><LI
><P
>Price: ~ 59 USD (50 EUR) </P
></LI
><LI
><P
>&#13;              <A
HREF="http://dk.mouser.com/access/?pn=595-BB-BBLK-000"
TARGET="_top"
>Mouser Electronics</A
>
            </P
></LI
><LI
><P
>&#13;              <A
HREF="http://beagleboard.org/black"
TARGET="_top"
>Full list of suppliers</A
>
            </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN1900"
>8.4.4. Hardware</A
></H4
><P
></P
><UL
><LI
><P
>Open Hardware: <A
HREF="http://elinux.org/Beagleboard:BeagleBoneBlack"
TARGET="_top"
>Yes</A
> </P
></LI
><LI
><P
>CPU: <A
HREF="http://www.ti.com/product/am3358"
TARGET="_top"
>AM335x 1GHz ARM Cortex-A8</A
> </P
></LI
><LI
><P
>RAM: 512MB DDR3L 800 Mhz  </P
></LI
><LI
><P
>Storage: Onboard 4GB, 8bit Embedded MMC and microSD </P
></LI
><LI
><P
>Architecture: armhf </P
></LI
><LI
><P
>Ethernet: 10/100, RJ45 </P
></LI
><LI
><P
>WiFi: None, use a <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#"
TARGET="_top"
>USB WiFi device</A
> </P
></LI
><LI
><P
>SATA: None </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN1922"
>8.4.5. Non-Free Status</A
></H4
><P
></P
><UL
><LI
><P
>Non-free blobs required: No </P
></LI
><LI
><P
>WiFi: Not available </P
></LI
><LI
><P
>Works with stock Debian kernel: Yes </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN1931"
>8.4.6. Known Issues</A
></H4
><P
>None </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN1934"
>8.5. A20 OLinuXino Lime2</A
></H3
><P
>&#13;        <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/a20-olinuxino-lime2.jpg"
WIDTH="320pt"
HEIGHT="216pt"></SPAN
>
      </P
><P
>Olimex's <A
HREF="https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXIno-LIME2/open-source-hardware"
TARGET="_top"
>A20 OLinuXino Lime2</A
> 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 <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#"
TARGET="_top"
>USB WiFi device</A
> that does not require non-free firmware is recommended. </P
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN1945"
>8.5.1. Similar Hardware</A
></H4
><P
>The following similar hardware will also work well with FreedomBox. </P
><P
></P
><UL
><LI
><P
>Olimex's <A
HREF="https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXIno-LIME2-4GB/open-source-hardware"
TARGET="_top"
>A20 OLinuXino Lime2 4GB</A
>.  This hardware merely has extra 4GB NAND storage that is not used by FreedomBox. </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN1952"
>8.5.2. Download</A
></H4
><P
>FreedomBox SD card <A
HREF="https://wiki.debian.org/FreedomBox/Download#"
TARGET="_top"
>images</A
> 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. </P
><P
>An alternative to downloading these images is to <A
HREF="https://wiki.debian.org/InstallingDebianOn/Allwinner#"
TARGET="_top"
>install Debian</A
> on the device and then <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/Debian#"
TARGET="_top"
>install FreedomBox</A
> on it. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN1959"
>8.5.3. Build Image</A
></H4
><P
>FreedomBox images for this hardware can be built using <A
HREF="https://wiki.debian.org/FreedomBox/Maker#"
TARGET="_top"
>Freedom Maker</A
> once the support for it is added. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN1963"
>8.5.4. Availability</A
></H4
><P
></P
><UL
><LI
><P
>Price: 45 EUR (A20 OLinuXino Lime2) </P
></LI
><LI
><P
>Price: 55 EUR (A20 OLinuXino Lime2 4GB) </P
></LI
><LI
><P
>&#13;              <A
HREF="https://www.olimex.com/Products/OLinuXino/A20/open-source-hardware"
TARGET="_top"
>Olimex Store</A
>
            </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN1973"
>8.5.5. Hardware</A
></H4
><P
></P
><UL
><LI
><P
>Open Source Hardware (OSHW): Yes </P
></LI
><LI
><P
>CPU: Allwinner A20, ARM Cortex-A7 @ 1GHz dual-core </P
></LI
><LI
><P
>RAM: 1 GiB DDR3 </P
></LI
><LI
><P
>Storage: 4 GB NAND flash built-in (only on 4GB model), 1x microSD slot </P
></LI
><LI
><P
>Architecture: armhf </P
></LI
><LI
><P
>Ethernet: 10/100/1000, RJ45 </P
></LI
><LI
><P
>WiFi: None, use a <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#"
TARGET="_top"
>USB WiFi device</A
> </P
></LI
><LI
><P
>SATA: 1x port </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN1993"
>8.5.6. Non-Free Status</A
></H4
><P
></P
><UL
><LI
><P
>Non-free blobs required: No </P
></LI
><LI
><P
>WiFi: Not available </P
></LI
><LI
><P
>Works with stock Debian kernel: Yes </P
></LI
><LI
><P
>Boot Firmware: <A
HREF="https://linux-sunxi.org/BROM"
TARGET="_top"
>BROM</A
> (GPLV2+) </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2005"
>8.5.7. Known Issues</A
></H4
><P
></P
><UL
><LI
><P
>WiFi is not available.  A separate <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#"
TARGET="_top"
>USB WiFi device</A
> is recommended. </P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN2011"
>8.6. A20 OLinuXino MICRO</A
></H3
><P
>&#13;        <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/a20-olinuxino-micro.jpg"
WIDTH="320pt"
HEIGHT="179.5pt"></SPAN
>
      </P
><P
>Olimex's <A
HREF="https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXIno-MICRO/open-source-hardware"
TARGET="_top"
>A20 OLinuXino MICRO</A
> 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 <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#"
TARGET="_top"
>USB WiFi device</A
> that does not require non-free firmware is recommended. </P
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2022"
>8.6.1. Similar Hardware</A
></H4
><P
>The following similar hardware will also work well with FreedomBox. </P
><P
></P
><UL
><LI
><P
>Olimex's <A
HREF="https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXIno-MICRO-4GB/open-source-hardware"
TARGET="_top"
>A20 OLinuXino MICRO 4GB</A
>.  This hardware merely has extra 4GB NAND storage that is not used by FreedomBox. </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2029"
>8.6.2. Download</A
></H4
><P
>FreedomBox SD card <A
HREF="https://wiki.debian.org/FreedomBox/Download#"
TARGET="_top"
>images</A
> 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. </P
><P
>An alternative to downloading these images is to <A
HREF="https://wiki.debian.org/InstallingDebianOn/Allwinner#"
TARGET="_top"
>install Debian</A
> on the device and then <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/Debian#"
TARGET="_top"
>install FreedomBox</A
> on it. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2036"
>8.6.3. Build Image</A
></H4
><P
>FreedomBox images for this hardware can be built using <A
HREF="https://wiki.debian.org/FreedomBox/Maker#"
TARGET="_top"
>Freedom Maker</A
> once the support for it is added. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2040"
>8.6.4. Availability</A
></H4
><P
></P
><UL
><LI
><P
>Price: 55 EUR (A20 OLinuXino MICRO) </P
></LI
><LI
><P
>Price: 65 EUR (A20 OLinuXino MICRO 4GB) </P
></LI
><LI
><P
>&#13;              <A
HREF="https://www.olimex.com/Products/OLinuXino/A20/open-source-hardware"
TARGET="_top"
>Olimex Store</A
>
            </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2050"
>8.6.5. Hardware</A
></H4
><P
></P
><UL
><LI
><P
>Open Source Hardware (OSHW): Yes </P
></LI
><LI
><P
>CPU: Allwinner A20, ARM Cortex-A7 @ 1GHz dual-core </P
></LI
><LI
><P
>RAM: 1 GiB DDR3 </P
></LI
><LI
><P
>Storage: 4 GB NAND flash built-in (only on 4GB model), 1x microSD slot </P
></LI
><LI
><P
>Architecture: armhf </P
></LI
><LI
><P
>Ethernet: 10/100, RJ45 </P
></LI
><LI
><P
>WiFi: None, use a <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#"
TARGET="_top"
>USB WiFi device</A
> </P
></LI
><LI
><P
>SATA: 1x port </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2070"
>8.6.6. Non-Free Status</A
></H4
><P
></P
><UL
><LI
><P
>Non-free blobs required: No </P
></LI
><LI
><P
>WiFi: Not available </P
></LI
><LI
><P
>Works with stock Debian kernel: Yes </P
></LI
><LI
><P
>Boot Firmware: <A
HREF="https://linux-sunxi.org/BROM"
TARGET="_top"
>BROM</A
> (GPLV2+) </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2082"
>8.6.7. Known Issues</A
></H4
><P
></P
><UL
><LI
><P
>WiFi is not available.  A separate <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#"
TARGET="_top"
>USB WiFi device</A
> is recommended. </P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN2088"
>8.7. APU</A
></H3
><P
>&#13;        <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/apu1d.jpg"
WIDTH="316pt"
HEIGHT="159.5pt"></SPAN
>
      </P
><P
><A
HREF="http://www.pcengines.ch/apu1d.htm"
TARGET="_top"
>PC Engines APU 1D</A
> is a single board computer with 3 Gigabit ethernet ports, a powerful AMD APU and Coreboot firmware.  FreedomBox images built for AMD64 machines are tested to work well for it.  For using this board as FreedomBox, a <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#"
TARGET="_top"
>USB WiFi device</A
> that does not require non-free firmware is recommended. </P
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2099"
>8.7.1. Similar Hardware</A
></H4
><P
>Although untested, the following similar hardware is also likely to work well with FreedomBox. </P
><P
></P
><UL
><LI
><P
>Using amd64 image: </P
><P
></P
><UL
><LI
><P
>&#13;                  <A
HREF="http://www.pcengines.ch/apu1c.htm"
TARGET="_top"
>apu1c</A
>
                </P
></LI
><LI
><P
>&#13;                  <A
HREF="http://www.pcengines.ch/apu1c4.htm"
TARGET="_top"
>apu1c4</A
>
                </P
></LI
><LI
><P
>&#13;                  <A
HREF="http://www.pcengines.ch/apu1d4.htm"
TARGET="_top"
>apu1d4</A
>
                </P
></LI
></UL
></LI
><LI
><P
>Using i386 image: </P
><P
></P
><UL
><LI
><P
>&#13;                  <A
HREF="http://www.pcengines.ch/alix1d.htm"
TARGET="_top"
>alix1d</A
>
                </P
></LI
><LI
><P
>&#13;                  <A
HREF="http://www.pcengines.ch/alix1e.htm"
TARGET="_top"
>alix1e</A
>
                </P
></LI
><LI
><P
>&#13;                  <A
HREF="http://www.pcengines.ch/alix2d2.htm"
TARGET="_top"
>alix2d2</A
>
                </P
></LI
><LI
><P
>&#13;                  <A
HREF="http://www.pcengines.ch/alix2d3.htm"
TARGET="_top"
>alix2d3</A
>
                </P
></LI
><LI
><P
>&#13;                  <A
HREF="http://www.pcengines.ch/alix2d13.htm"
TARGET="_top"
>alix2d13</A
>
                </P
></LI
><LI
><P
>&#13;                  <A
HREF="http://www.pcengines.ch/alix3d2.htm"
TARGET="_top"
>alix3d2</A
>
                </P
></LI
><LI
><P
>&#13;                  <A
HREF="http://www.pcengines.ch/alix3d3.htm"
TARGET="_top"
>alix3d3</A
>
                </P
></LI
><LI
><P
>&#13;                  <A
HREF="http://www.pcengines.ch/alix6f2.htm"
TARGET="_top"
>alix6f2</A
>
                </P
></LI
></UL
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2142"
>8.7.2. Download</A
></H4
><P
>FreedomBox disk <A
HREF="https://wiki.debian.org/FreedomBox/Download#"
TARGET="_top"
>images</A
> for this hardware are available.  Follow the instructions on the <A
HREF="https://wiki.debian.org/FreedomBox/Download#"
TARGET="_top"
>download</A
> page to create a FreedomBox SD card, USB disk, SSD or hard drive and boot into FreedomBox.  Pick the image meant for all amd64 machines. </P
><P
>An alternative to downloading these images is to <A
HREF="https://wiki.debian.org/InstallingDebianOn/Alix3d2#"
TARGET="_top"
>install Debian</A
> on the APU and then <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/Debian#"
TARGET="_top"
>install FreedomBox</A
> on it. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2150"
>8.7.3. Networking</A
></H4
><P
>The first network port, the left most one in the above picture, is configured by FreedomBox to be an upstream Internet link and the remaining 2 ports are configured for local computers to connect to. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2153"
>8.7.4. Build Image</A
></H4
><P
>FreedomBox images for this hardware, which is for all amd64 machines, can be built using <A
HREF="https://wiki.debian.org/FreedomBox/Maker#"
TARGET="_top"
>Freedom Maker</A
>. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2157"
>8.7.5. Availability</A
></H4
><P
></P
><UL
><LI
><P
>Price: 110 - 170 USD (depending on the board and supplier) </P
></LI
><LI
><P
>&#13;              <A
HREF="http://www.pcengines.ch/order1.php"
TARGET="_top"
>PC Engines</A
>
            </P
></LI
><LI
><P
>&#13;              <A
HREF="http://www.pcengines.ch/order.php"
TARGET="_top"
>Full list of suppliers</A
>
            </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2168"
>8.7.6. Hardware</A
></H4
><P
></P
><UL
><LI
><P
>Open Hardware: No </P
></LI
><LI
><P
>CPU: <A
HREF="http://www.amd.com/en-gb/products/embedded/processors/g-series"
TARGET="_top"
>AMD G series T40E</A
> </P
></LI
><LI
><P
>RAM: 2 GB DDR3-1066 DRAM </P
></LI
><LI
><P
>Storage: SD card, External USB </P
></LI
><LI
><P
>Architecture: amd64 </P
></LI
><LI
><P
>Ethernet: 3 Gigabit Ethernet ports </P
></LI
><LI
><P
>WiFi: None, use a <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#"
TARGET="_top"
>USB WiFi device</A
> </P
></LI
><LI
><P
>SATA: 1 m-SATA and 1 SATA </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2189"
>8.7.7. Non-Free Status</A
></H4
><P
></P
><UL
><LI
><P
>Non-free blobs required: No </P
></LI
><LI
><P
>WiFi: Not available </P
></LI
><LI
><P
>Works with stock Debian kernel: Yes </P
></LI
><LI
><P
>Boot firmware: <A
HREF="http://www.pcengines.ch/apu1d.htm"
TARGET="_top"
>Coreboot</A
> </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2201"
>8.7.8. Known Issues</A
></H4
><P
>None </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN2204"
>8.8. VirtualBox</A
></H3
><P
>&#13;        <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/virtualbox.png"
WIDTH="363pt"
HEIGHT="237.5pt"></SPAN
>
      </P
><P
>This page will help you get started with using FreedomBox on a <A
HREF="https://en.wikipedia.org/wiki/Virtual_machine"
TARGET="_top"
>virtual machine</A
> using <A
HREF="https://wiki.debian.org/VirtualBox#"
TARGET="_top"
>VirtualBox</A
>.  While VirtualBox images are primarily used for testing and development, they can also be used for regular use if you have spare resources on one of your machines.  This setup is useful if: </P
><P
></P
><UL
><LI
><P
>You don't own one of the <A
HREF="https://wiki.debian.org/FreedomBox/Hardware#"
TARGET="_top"
>supported hardware</A
> devices. </P
></LI
><LI
><P
>You don't use Debian GNU/Linux as your operating system. </P
></LI
><LI
><P
>You don't want to disturb your Debian installation to try out FreedomBox. </P
></LI
></UL
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2223"
>8.8.1. Download</A
></H4
><P
>FreedomBox SD card images for this VirtualBox are available. Follow the instructions on the <A
HREF="https://wiki.debian.org/FreedomBox/Download#"
TARGET="_top"
>download</A
> page to download and verify VirtualBox images. </P
><P
>An alternative to downloading these images is to <A
HREF="https://wiki.debian.org/InstallingDebianOn#"
TARGET="_top"
>install Debian</A
> on VirtualBox and then <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/Debian#"
TARGET="_top"
>install FreedomBox</A
> on it. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2230"
>8.8.2. Creating a Virtual Machine</A
></H4
><P
></P
><OL
TYPE="1"
><LI
><P
>Decompress the downloaded VDI image. </P
></LI
><LI
><P
>Create a new VirtualBox VM. </P
></LI
><LI
><P
>When asked for a "Virtual Hard Disk" select the .vdi file you just extracted in step 1. </P
></LI
><LI
><P
>After a virtual machine is created, go to settings -&#62; [Network] -&#62; [Interface] and set on the following options. </P
></LI
></OL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2241"
>8.8.3. Network Configuration</A
></H4
><P
>VirtualBox provides many types of networking options.  Each has its advantages and disadvantages.  For more information about how various networking types work in VirtualBox, see VirtualBox's networking documentation. <A
HREF="https://www.virtualbox.org/manual/ch06.html"
TARGET="_top"
>https://www.virtualbox.org/manual/ch06.html</A
> </P
><P
>For a simple setup, it is recommended that you use a single network interface in your guest machine.  This will make the first boot script automatically configure that interface as an <FONT
COLOR="RED"
>internal</FONT
> network with <FONT
COLOR="RED"
>automatic</FONT
> network configuration.  Inside the guest machine, the networking is configured automatically and all the services are made available on this network interface.  For more information on how networks are configured by default in FreedomBox, see <A
HREF="https://wiki.debian.org/FreedomBox/Manual/Networks#"
TARGET="_top"
>Networks</A
> section. </P
><P
>What remains is to make those services available to the host machine or to other machines in the network.  You must then choose one of the following types of networking for the network interface on your guest machine.  To set a particular type of network for the guest's network adapter, go to the guest VM's settings then the network options and then select the adapter you wish to configure.  There, set the network type from the available list of networks. </P
><P
></P
><OL
TYPE="1"
><LI
><P
>First and the recommended option is to use the <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Bridge</I
></SPAN
> type of network.  This option exposes the guest machine to the same network that host network is connected to.  The guest obtains network configuration information from a router or DHCP server on the network.  The guest will appear as just another machine in the network.  A major advantage of this of setup is that the host and all other machines in the network will be able to access the services provided by guest without requiring any further setup. The only drawback of this approach is that if the host is not connected to any network, the guest's network will remain unconfigured making it inaccessible even from the host. </P
></LI
><LI
><P
>Second method is <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Host only</I
></SPAN
> type of networking.  With a guest's network interface configured in this manner, it will only be accessible from the host machine.  The guest will not able access any other machine but the host, so you do not have internet access on the guest. All services on the guest are available to the host machine without any configuration such as port forwarding. </P
></LI
><LI
><P
>The third option is to use the <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>NAT</I
></SPAN
> type of network.  This the networking type that VirtualBox assigns to a freshly created virtual machine.  This option works even when host is not connected to any network.  The guest is automatically configured and is able to access the Internet and local networks that host is able to connect to. However, the services provided by the guest require port forwarding configuration setup to be available outside. </P
><P
>To configure this go to VM settings -&#62; [Network] -&#62; [Adapter] -&#62; [Port Forwarding].  Map a port such as 2222 from host to guest port 22 and you will be able to ssh into FreedomBox from host machine as follows: </P
><PRE
CLASS="screen"
> ssh -p 2222 fbx@localhost</PRE
><P
>Map 4443 on host to 443 on the guest.  This make FreedomBox HTTPS service available on host using the URL <A
HREF="https://localhost:4443/"
TARGET="_top"
>https://localhost:4443/</A
> You will need to add a mapping for each such services from host to guest. </P
></LI
><LI
><P
>The final option is to create two network interfaces, one <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>host only</I
></SPAN
> and one <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>NAT</I
></SPAN
> type.  This way you can access the guest without any additional configuration, and you have internet access on the guest. The guest will be invisible to any other machines on the network. </P
></LI
></OL
><P
>Summary of various network types: </P
><DIV
CLASS="informaltable"
><P
></P
><A
NAME="AEN2269"
></A
><TABLE
BORDER="1"
CLASS="CALSTABLE"
><COL
WIDTH="1*"
TITLE="col_0"><COL
WIDTH="1*"
TITLE="col_1"><COL
WIDTH="1*"
TITLE="col_2"><COL
WIDTH="1*"
TITLE="col_3"><COL
WIDTH="1*"
TITLE="col_4"><COL
WIDTH="1*"
TITLE="col_5"><TBODY
><TR
><TD
>&#13;                  <P
> - </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="strong"
><B
CLASS="emphasis"
>Guest accessible from other machines</B
></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="strong"
><B
CLASS="emphasis"
>Guest accessible from host</B
></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="strong"
><B
CLASS="emphasis"
>Works without port forwarding</B
></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="strong"
><B
CLASS="emphasis"
>Works without host connected to network</B
></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="strong"
><B
CLASS="emphasis"
>Guest has internet access</B
></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="strong"
><B
CLASS="emphasis"
>Bridged</B
></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="strong"
><B
CLASS="emphasis"
>Host only</B
></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="strong"
><B
CLASS="emphasis"
>NAT</B
></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
><TR
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="strong"
><B
CLASS="emphasis"
>NAT and Host </B
></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/icon-error.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
><TD
>&#13;                  <P
>&#13;                    <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/checkmark.png"
WIDTH="8pt"
HEIGHT="8pt"></SPAN
>
                  </P
>
                </TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2452"
>8.8.4. Using</A
></H4
><P
>You can log in as the user created during Plinth setup. </P
><P
>After logging in, you can become root with the command <FONT
COLOR="RED"
>sudo su</FONT
>.   See the FreedomBox <A
HREF="https://wiki.debian.org/FreedomBox/Use#"
TARGET="_top"
>usage</A
> page for more details.   </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2458"
>8.8.5. Build Image</A
></H4
><P
>If you wish to build your own images instead of downloading available images, it can be done using <A
HREF="https://wiki.debian.org/FreedomBox/Maker#"
TARGET="_top"
>Freedom Maker</A
>.  </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2462"
>8.8.6. Tips &#38; Troubleshooting</A
></H4
><DIV
CLASS="section"
><H5
CLASS="section"
><A
NAME="AEN2464"
>8.8.6.1. Finding out the IP address of the virtual machine</A
></H5
><P
>This depends on the network configuration you chose. With a <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>bridged adapter</I
></SPAN
>, your virtual machine gets its IP address from the DHCP server of your network, most likely of your Router. You can try the first couple of IP addresses or check your router web interface for a list of connected devices. </P
><P
>If you chose <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>host-only adapter</I
></SPAN
>, the IP address is assigned by the DHCP server of your VirtualBox network. In the VirtualBox Manager, go to File -&#62; Preferences -&#62; Network -&#62; Host-only Networks. You can see and edit the DHCP address range there, typically you get assigned addresses close to the <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Lower Address Bound</I
></SPAN
>. </P
><P
>Another possibility of finding the IP address is to login via the Virtualbox Manager (or similar software). The FreedomBox images do not have any default user accounts, so you need to set an initial user and password using the <A
HREF="https://github.com/freedombox/freedom-maker/blob/master/bin/passwd-in-image"
TARGET="_top"
>passwd-in-image script</A
>. </P
></DIV
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN2473"
>8.8.6.2. Networking Problems with macchanger</A
></H5
><P
>The package <FONT
COLOR="RED"
>macchanger</FONT
> can cause network problems with VirtualBox.  If you have a valid IP address on your guest's host network adapter (like 192.168.56.101) but are not able to ping or access the host (like 192.168.56.1), try uninstalling <FONT
COLOR="RED"
>macchanger</FONT
>: </P
><PRE
CLASS="screen"
>$ dpkg --ignore-depends=freedombox-setup --remove macchanger </PRE
><P
>You might have to manually remove the script <FONT
COLOR="RED"
>/etc/network/if-prep-up/macchanger</FONT
>. If Debian complains about unmet dependencies when you use a package manager (apt-get, aptitude, dpkg), try to remove 'macchanger' from the dependencies of 'freedombox-setup' in the file <FONT
COLOR="RED"
>/var/lib/dpkg/status</FONT
>. </P
></DIV
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN2482"
>8.8.6.3. Mounting Images Locally</A
></H5
><P
>If you want to mount images locally, use the following to copy built images off the VirtualBox: </P
><PRE
CLASS="screen"
>$ mkdir /tmp/vbox-img1 /tmp/vbox-root1
$ vdfuse -f freedombox-unstable_2013.0519_virtualbox-i386-hdd.vdi /tmp/vbox-img1/
$ sudo mount -o loop /tmp/vbox-img1/Partition1 /tmp/vbox-root1
$ cp /tmp/vbox-root1/home/fbx/freedom-maker/build/freedom*vdi ~/
$ sudo umount /tmp/vbox-root1
# $ sudo umount /tmp/vbox-img1 # corruption here.</PRE
></DIV
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN2486"
>8.8.6.4. Fixing the time after suspend and resume</A
></H5
><P
>The virtual machine loses the correct time/date after suspending and resuming. One way to fix this is to create a cron-job that restarts the time service <FONT
COLOR="RED"
>ntp</FONT
>. You can add a crontab entry as root to restart ntp every 15 minutes by typing <FONT
COLOR="RED"
>'crontab -e'</FONT
> and adding this line: </P
><PRE
CLASS="screen"
>*/15 * *   *   *     /etc/init.d/ntp restart</PRE
><P
>Do not restart this service too often as this increases the load of publicly and freely available NTP servers. </P
></DIV
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN2493"
>8.9. Debian</A
></H3
><P
>FreedomBox is a <A
HREF="https://wiki.debian.org/DebianPureBlends#"
TARGET="_top"
>pure blend</A
> of Debian.  This means that all the work on FreedomBox is available in Debian as packages.  It also means that any machine running Debian can be turned into a FreedomBox. </P
><P
>This page describes the process of installing FreedomBox on a Debian system. Currently, FreedomBox works in Debian Testing (Stretch) and Unstable (Sid). </P
><DIV
CLASS="caution"
><P
></P
><TABLE
CLASS="caution"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="../images/caution.gif"
HSPACE="5"
ALT="Caution"></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>&#13;          <SPAN
CLASS="strong"
><B
CLASS="emphasis"
>Use a fresh Debian installation</B
></SPAN
>
        </P
><P
>Installing FreedomBox changes your Debian system in many important ways.  This includes installing a firewall and regenerating server certificates.  It is hence recommended that you install FreedomBox on a fresh Debian installation instead of an existing setup. </P
><P
>&#13;          <SPAN
CLASS="strong"
><B
CLASS="emphasis"
>use "fbx" as the login name</B
></SPAN
>
        </P
><P
> If you choose to create an initial user account, use "fbx" as the login name.  (Once the FreedomBox setup program completes, all user accounts except for the "fbx" account will be locked out via pam_access.  This also affects sudo access.) </P
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2505"
>8.9.1. Installing on Debian</A
></H4
><P
></P
><OL
TYPE="1"
><LI
><P
>Check the Troubleshooting section below, for any tips or work-arounds that might help during the install. </P
></LI
><LI
><P
><A
HREF="https://wiki.debian.org/InstallingDebianOn#"
TARGET="_top"
>Install Debian</A
> Testing (Stretch) or Unstable (Sid) on your hardware. </P
></LI
><LI
><P
>Update your package list. </P
><PRE
CLASS="screen"
>$ sudo apt-get update</PRE
></LI
><LI
><P
>Install <FONT
COLOR="RED"
>freedombox-setup</FONT
> package. </P
><PRE
CLASS="screen"
>$ sudo apt-get install freedombox-setup</PRE
><P
></P
><UL
><LI
><P
>When asked to specify whether Macchanger should be set up to run automatically, please choose "No". </P
></LI
></UL
></LI
><LI
><P
>Run FreedomBox setup program.  This installs further packages and sets up basic configuration. </P
><PRE
CLASS="screen"
>$ sudo /usr/lib/freedombox/setup | tee freedombox-setup.log</PRE
><P
>You may have to clear your existing network configuration.  See Troubleshooting note #2 below. </P
></LI
><LI
><P
>Reboot the system.  This is necessary to trigger the first-run script. </P
><PRE
CLASS="screen"
>$ sudo reboot</PRE
></LI
><LI
><P
>After the system boots up, wait for it to reboot again.  The first-run scripts sets up a few things and initiates a reboot. </P
></LI
><LI
><P
>After the second reboot you can start <A
HREF="https://wiki.debian.org/FreedomBox/Use#"
TARGET="_top"
>using</A
> FreedomBox. </P
></LI
></OL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2535"
>8.9.2. Troubleshooting</A
></H4
><P
></P
><OL
TYPE="1"
><LI
><P
>There is a <A
HREF="https://bugs.debian.org/797368"
TARGET="_top"
>bug</A
> in policykit-1 package that causes errors and hangs during installation of freedombox-setup package.  A workaround is to first install policykit-1 package and then reboot.  After that, follow the above procedure setup procedure. </P
><PRE
CLASS="screen"
>$ sudo apt-get update
$ sudo apt-get install policykit-1
$ sudo reboot</PRE
></LI
><LI
><P
>Freedombox does not support network device configuration via <FONT
COLOR="RED"
>/etc/network/interfaces</FONT
>, and it will not manage any non-loopback interfaces mentioned there. (See <A
HREF="https://bugs.debian.org/797614"
TARGET="_top"
>bug #797614</A
>.)  Future versions of freedombox-setup will clear this file automatically; for now, edit it manually and ensure that it contains only the following: </P
><PRE
CLASS="screen"
>auto lo
iface lo inet loopback</PRE
><P
>If you have already completed the setup process without doing this step, you will need to clear out the <FONT
COLOR="RED"
>/etc/network/interfaces</FONT
> file keeping only the above lines.  Then perform a reboot.  After this network connections configured by the <FONT
COLOR="RED"
>setup</FONT
> step above will configure your network.  Network interfaces will then be in the <FONT
COLOR="RED"
>internal</FONT
> or <FONT
COLOR="RED"
>external</FONT
> firwall zone.  This is essential for the FreedomBox's web interface to be reachable from other machines in the network.  You can tweak network manager connections with the <FONT
COLOR="RED"
>nmtui</FONT
> command if you wish.  </P
></LI
></OL
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN2553"
>8.10. DreamPlug</A
></H3
><P
>&#13;        <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/dreamplug.jpg"
WIDTH="320pt"
HEIGHT="212.5pt"></SPAN
>
      </P
><P
><A
HREF="https://www.globalscaletechnologies.com/t-dreamplugdetails.aspx"
TARGET="_top"
>DreamPlug</A
> is the hardware for which FreedomBox has been originally targeted.  FreedomBox images are built and tested for it.  For using this device as FreedomBox, a <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#"
TARGET="_top"
>USB WiFi device</A
> that does not require non-free firmware is recommended. </P
><P
>You can find more support and discussion for DreamPlug on the <A
HREF="http://www.plugcomputer.org/plugforum/"
TARGET="_top"
>official forum</A
>. </P
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2566"
>8.10.1. Download</A
></H4
><P
>FreedomBox SD card <A
HREF="https://wiki.debian.org/FreedomBox/Download#"
TARGET="_top"
>images</A
> for this hardware are available.  Follow the instructions on the <A
HREF="https://wiki.debian.org/FreedomBox/Download#"
TARGET="_top"
>download</A
> page to create a FreedomBox SD card and boot into FreedomBox.  See also instructions for using an <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/DreamPlug/InternalMicroSD#"
TARGET="_top"
>internal micro-SD</A
> with DreamPlug. </P
><P
>An alternative to downloading these images is to <A
HREF="https://wiki.debian.org/InstallingDebianOn/DreamPlug#"
TARGET="_top"
>install Debian</A
> on DreamPlug and then <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/Debian#"
TARGET="_top"
>install FreedomBox</A
> on it. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2575"
>8.10.2. Firmware</A
></H4
><P
>Note that the factory firmware configurations may vary between revisions of the hardware, and render some images incompatible.  See the DreamPlug <A
HREF="https://wiki.debian.org/InstallingDebianOn/DreamPlug/U-bootUpgradeFromUSB#"
TARGET="_top"
>firmware</A
> page for information on what images are compatible and how to update your DreamPlug firmware. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2579"
>8.10.3. Build Image</A
></H4
><P
>FreedomBox images for this hardware can be built using <A
HREF="https://wiki.debian.org/FreedomBox/Maker#"
TARGET="_top"
>Freedom Maker</A
>. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2583"
>8.10.4. Testing</A
></H4
><P
>Instructions on how to <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/DreamPlug/Testing#"
TARGET="_top"
>test</A
> this hardware are available. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2587"
>8.10.5. Availability</A
></H4
><P
></P
><UL
><LI
><P
>Price: 159 USD </P
></LI
><LI
><P
>&#13;              <A
HREF="http://www.globalscaletechnologies.com/p-54-dreamplug-devkit.aspx"
TARGET="_top"
>DreamPlug manufacturer</A
>
            </P
></LI
><LI
><P
>Reseller <A
HREF="http://www.spinifex.com.au/shop/"
TARGET="_top"
>Spinifex</A
> in Australia </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2598"
>8.10.6. Hardware</A
></H4
><P
></P
><UL
><LI
><P
>Open Hardware: No </P
></LI
><LI
><P
>CPU: Marvell Kirkwood 88F6281 @ 1.2GHz </P
></LI
><LI
><P
>RAM: 512MB 16bit DDR2-800 MHz </P
></LI
><LI
><P
>Storage: 4 GB on board micro-SD </P
></LI
><LI
><P
>Architecture: armel </P
></LI
><LI
><P
>Ethernet: 2x 10/100/1000, RJ45 </P
></LI
><LI
><P
>WiFi: <A
HREF="https://origin-www.marvell.com/wireless/assets/8787.pdf"
TARGET="_top"
>SD8787</A
>, 802.11 b/g/n </P
></LI
><LI
><P
>SATA: eSATA 2.0 port </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2618"
>8.10.7. Non-Free Status</A
></H4
><P
></P
><UL
><LI
><P
>Non-free blobs required: built-in WiFi </P
></LI
><LI
><P
>WiFi: no free WiFi drivers + firmware available  </P
></LI
><LI
><P
>Works with stock Debian kernel: yes </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2627"
>8.10.8. Known Issues</A
></H4
><P
></P
><UL
><LI
><P
>WiFi does not work with free software. A separate <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#"
TARGET="_top"
>USB WiFi device</A
> is recommended. </P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN2633"
>8.11. Raspberry Pi Model B+</A
></H3
><P
>&#13;        <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/raspberrypi.jpg"
WIDTH="320pt"
HEIGHT="214.5pt"></SPAN
>
      </P
><P
><A
HREF="http://www.raspberrypi.org/products/model-b-plus/"
TARGET="_top"
>Raspberry Pi</A
> (Model B+) is a popular single board computer developed with the intention of promoting  teaching of basic computer science in schools.  FreedomBox images are built and tested for it.  For using this board as FreedomBox, a <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#"
TARGET="_top"
>USB WiFi device</A
> that does not require non-free firmware is recommended. </P
><P
><SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Note:</I
></SPAN
> The Debian architecture used for this device is <FONT
COLOR="RED"
>armel</FONT
>.  This means floating point computations are done in software and most operations are slower than what Raspberry Pi is capable of.  </P
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2647"
>8.11.1. Download</A
></H4
><P
>FreedomBox SD card <A
HREF="https://wiki.debian.org/FreedomBox/Download#"
TARGET="_top"
>images</A
> for this hardware are available.  Follow the instructions on the <A
HREF="https://wiki.debian.org/FreedomBox/Download#"
TARGET="_top"
>download</A
> page to create a FreedomBox SD card and boot into FreedomBox. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2652"
>8.11.2. Build Image</A
></H4
><P
>FreedomBox images for this hardware can be built using <A
HREF="https://wiki.debian.org/FreedomBox/Maker#"
TARGET="_top"
>Freedom Maker</A
>. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2656"
>8.11.3. Availability</A
></H4
><P
></P
><UL
><LI
><P
>Price: 35 USD </P
></LI
><LI
><P
>&#13;              <A
HREF="http://www.raspberrypi.org/products/model-b-plus/"
TARGET="_top"
>List of official distributors</A
>
            </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2664"
>8.11.4. Hardware</A
></H4
><P
></P
><UL
><LI
><P
>Open Hardware: No </P
></LI
><LI
><P
>CPU: ARM1176JZF-S (ARMv6k) 700 MHz </P
></LI
><LI
><P
>RAM: 512 MB </P
></LI
><LI
><P
>Storage: MicroSD card slot </P
></LI
><LI
><P
>Architecture: armel </P
></LI
><LI
><P
>Ethernet: 10/100, RJ45 </P
></LI
><LI
><P
>WiFi: None, use a <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#"
TARGET="_top"
>USB WiFi device</A
> </P
></LI
><LI
><P
>SATA: None </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2684"
>8.11.5. Non-Free Status</A
></H4
><P
></P
><UL
><LI
><P
>Non-free blobs required: boot firmware </P
></LI
><LI
><P
>WiFi: Not available </P
></LI
><LI
><P
>Works with stock Debian kernel: No </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2693"
>8.11.6. Known Issues</A
></H4
><P
></P
><UL
><LI
><P
>The Debian architecture used for this device is <FONT
COLOR="RED"
>armel</FONT
>.  This means floating point computations are done in software and generally most operations are slower than what Raspberry Pi is capable of. </P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN2699"
>8.12. Raspberry Pi 2 Model B</A
></H3
><P
>&#13;        <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/raspberrypi2.jpg"
WIDTH="320pt"
HEIGHT="214pt"></SPAN
>
      </P
><P
><A
HREF="https://www.raspberrypi.org/products/raspberry-pi-2-model-b/"
TARGET="_top"
>Raspberry Pi 2</A
> (Model B ) is a popular single board computer developed with the intention of promoting teaching of basic computer science in schools.  It is a successor to Raspberry Pi Model B+ with much faster processor and more RAM.  FreedomBox images are built and tested for it.  For using this board as FreedomBox, a <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#"
TARGET="_top"
>USB WiFi device</A
> that does not require non-free firmware is recommended. </P
><P
><SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Note:</I
></SPAN
> For FreedomBox release 0.5, the Debian architecture used for this device is <FONT
COLOR="RED"
>armel</FONT
>.  This means floating point computations are done in software and most operations are slower than what Raspberry Pi 2 is capable of.  Starting with FreedomBox release 0.6 separate <FONT
COLOR="RED"
>armhf</FONT
> images with full hardware floating point support will be available. </P
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2714"
>8.12.1. Download</A
></H4
><P
>FreedomBox SD card <A
HREF="https://wiki.debian.org/FreedomBox/Download#"
TARGET="_top"
>images</A
> for this hardware are available.  Follow the instructions on the <A
HREF="https://wiki.debian.org/FreedomBox/Download#"
TARGET="_top"
>download</A
> page to create a FreedomBox SD card and boot into FreedomBox. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2719"
>8.12.2. Build Image</A
></H4
><P
>FreedomBox images for this hardware can be built using <A
HREF="https://wiki.debian.org/FreedomBox/Maker#"
TARGET="_top"
>Freedom Maker</A
>. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2723"
>8.12.3. Availability</A
></H4
><P
></P
><UL
><LI
><P
>Price: 35 USD </P
></LI
><LI
><P
>&#13;              <A
HREF="https://www.raspberrypi.org/products/raspberry-pi-2-model-b/"
TARGET="_top"
>List of official distributors</A
>
            </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2731"
>8.12.4. Hardware</A
></H4
><P
></P
><UL
><LI
><P
>Open Hardware: No </P
></LI
><LI
><P
>CPU: 900 MHz quad-core ARM Cortex-A7 </P
></LI
><LI
><P
>RAM: 1 GB </P
></LI
><LI
><P
>Storage: MicroSD card slot </P
></LI
><LI
><P
>Architecture: armhf </P
></LI
><LI
><P
>Ethernet: 10/100, RJ45 </P
></LI
><LI
><P
>WiFi: None, use a <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/USBWiFi#"
TARGET="_top"
>USB WiFi device</A
> </P
></LI
><LI
><P
>SATA: None </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2751"
>8.12.5. Non-Free Status</A
></H4
><P
></P
><UL
><LI
><P
>Non-free blobs required: boot firmware </P
></LI
><LI
><P
>WiFi: Not available </P
></LI
><LI
><P
>Works with stock Debian kernel: No </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2760"
>8.12.6. Known Issues</A
></H4
><P
></P
><UL
><LI
><P
>The Debian architecture used for this device is <FONT
COLOR="RED"
>armel</FONT
>.  This means floating point computations are done in software and generally most operations are slower than what Raspberry Pi 2 is capable of.  However, starting with FreedomBox 0.6 separate images for Raspberry Pi 2 with <FONT
COLOR="RED"
>armhf</FONT
> architecture will be built. </P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN2767"
>8.13. USB Wi-Fi</A
></H3
><P
>FreedomBox works on many single board computers.  However, many of these boards do not have built-in Wi-Fi capabilities.  Even when Wi-Fi capability is available, non-free proprietary firmware is required to make them work. </P
><P
>A solution to the problem is to plug-in a USB Wi-Fi device into one of the available USB ports.  There are many such devices available which do not require non-free firmware to work.  The following is a list of such devices that work with FreedomBox devices.  Some devices based on these chips have tested to work well with FreedomBox including functions such as access point mode. </P
><P
></P
><UL
><LI
><P
>&#13;            <A
HREF="https://wikidevi.com/wiki/AR7010"
TARGET="_top"
>Devices with Atheros AR7010 chip</A
>
          </P
></LI
><LI
><P
>&#13;            <A
HREF="https://wikidevi.com/wiki/AR9271"
TARGET="_top"
>Devices with Atheros AR9271 chip</A
>
          </P
></LI
></UL
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2778"
>8.13.1. Firmware Installation</A
></H4
><P
>The free firmware for these devices is not packaged in Debian yet. You can manually download and install the firmware as follows: </P
><PRE
CLASS="screen"
>sudo su [enter password]
cd /lib/firmware
wget https://www.thinkpenguin.com/files/ath9k-htc/version-1.4-beta/htc_9271.fw
wget https://www.thinkpenguin.com/files/ath9k_firmware_free-version/htc_7010.fw</PRE
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2782"
>8.13.2. Resources</A
></H4
><P
></P
><UL
><LI
><P
>&#13;              <A
HREF="https://wiki.debian.org/WiFi#USB_Devices"
TARGET="_top"
>Debian Wiki on WiFi drivers</A
>
            </P
></LI
><LI
><P
>&#13;              <A
HREF="https://en.wikipedia.org/wiki/Comparison_of_open-source_wireless_drivers#Linux_drivers_for_802.11_.22wireless.22"
TARGET="_top"
>Wikipedia: Comparison of open-source Linux wireless network drivers</A
>
            </P
></LI
><LI
><P
>&#13;              <A
HREF="https://wikidevi.com/wiki/Main_Page"
TARGET="_top"
>WikiDevi: database of computer hardware</A
>
            </P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN2794"
>8.14. Advanced Topics</A
></H3
><P
>&#13;        <A
NAME="additionalprojects"
></A
>
      </P
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2798"
>8.14.1. Adding Additional Features</A
></H4
><P
>There are a number of incomplete projects that you might find useful, for setting up a wiki, an IM server, and so forth.  To check these out, download the repository: </P
><PRE
CLASS="screen"
>$ hg clone https://bitbucket.org/nickdaly/plugserver ~/plugserver</PRE
><P
>Then, read the README. It's pretty detailed.  Also, if you can, it may be best to wait until these tools are fully integrated into the FreedomBox image. Otherwise, migrating from these custom tools to the officially supported FreedomBox tools may be difficult. Ultimately, that decision is up to you. </P
></DIV
></DIV
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="AEN2803"
>9. Contributing</A
></H2
><P
>From code, design and translation to spreading the world and donation, here is a list of possible contributions to develop FreedomBox. </P
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN2806"
>9.1. Quick Links</A
></H3
><P
>&#13;        <A
HREF="https://wiki.debian.org/FreedomBox/ProgressCalls#"
TARGET="_top"
>Progess calls</A
>
      </P
><P
>&#13;        <A
HREF="https://wiki.debian.org/FreedomBox/TODO#"
TARGET="_top"
>TODO page</A
>
      </P
><P
>&#13;        <A
HREF="https://www.freedomboxfoundation.org/donate/"
TARGET="_top"
>Donation page</A
>
      </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN2814"
>9.2. Welcome to newcomers</A
></H3
><P
>As a newcomer, you are more than welcome to introduce yourself to all users and doers on the "FreedomBox-discuss" <A
HREF="http://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss"
TARGET="_top"
>mailing list</A
> or on the <A
HREF="irc://irc.debian.org/freedombox"
TARGET="_top"
>#freedombox IRC</A
> channel. In addition to make useful contacts, you can start reporting bugs and translate (see below) the wiki website and the <A
HREF="https://wiki.debian.org/FreedomBox#"
TARGET="_top"
>FreedomBox</A
> web interface.  </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN2820"
>9.3. Development priorities</A
></H3
><P
>Upcoming priorities have been discussed end of October 2015 by several core developers and the Freedombox Foundation. You'll find on the mailing list archives a <A
HREF="http://lists.alioth.debian.org/pipermail/freedombox-discuss/2015-November/006973.html"
TARGET="_top"
>Medium Term Roadmap</A
> for 2015 and 2016. We want to enjoy soon a version 1.0. We are targeting mid January for a 0.8 release. The main focus of the 0.8 release is going to be integrated in the PGP based SSL Client authentication work. We are planning on a 0.9 polish release for late February with general usability improvements.</P
><P
>Please check next <A
HREF="https://wiki.debian.org/FreedomBox/ProgressCalls#"
TARGET="_top"
>progess calls</A
> to keep yourself on track and meet members of the release team. A <A
HREF="https://wiki.debian.org/FreedomBox/TODO#"
TARGET="_top"
>TODO page</A
> aggregates the complete list of the items to work on for <A
HREF="https://wiki.debian.org/FreedomBox#"
TARGET="_top"
>FreedomBox</A
>.  </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN2828"
>9.4. Contributions needed</A
></H3
><DIV
CLASS="section"
><H4
CLASS="section"
><A
NAME="AEN2830"
>9.4.1. Add an Application</A
></H4
><P
>If you are a developer and wish to see an application available in FreedomBox, you can contribute by adding the application to FreedomBox.  See the <A
HREF="https://wiki.debian.org/FreedomBox/Manual/Developer#"
TARGET="_top"
>FreedomBox Developer Manual</A
>. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2834"
>9.4.2. Bugs</A
></H4
><P
><A
HREF="https://wiki.debian.org/FreedomBox/Contribute/Bugs#"
TARGET="_top"
>List of bugs</A
> listed on Debian universal system. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2838"
>9.4.3. Code</A
></H4
><P
>If you are a developer, you can contribute code to one of the sub-projects of FreedomBox.  Step-by-step process of <A
HREF="https://wiki.debian.org/FreedomBox/Contribute/Code#"
TARGET="_top"
>contributing code</A
> to FreedomBox is available. </P
><P
></P
><UL
><LI
><P
><A
HREF="https://wiki.debian.org/FreedomBox/Setup#"
TARGET="_top"
>FreedomBox Setup</A
>: a Debian package for setting up the FreedomBox. </P
></LI
><LI
><P
><A
HREF="https://wiki.debian.org/FreedomBox/Plinth#"
TARGET="_top"
>Plinth</A
>: a web interface to administer the functions of FreedomBox. </P
></LI
><LI
><P
><A
HREF="https://wiki.debian.org/FreedomBox/Maker#"
TARGET="_top"
>Freedom Maker</A
>: a script to build FreedomBox disk images for use on various hardware devices or virtual machines. </P
></LI
></UL
><P
>You can pickup a task from one of the <A
HREF="https://wiki.debian.org/FreedomBox/TODO#"
TARGET="_top"
>TODO</A
> lists. The individual page project pages contain information availabily of the code, how to build and TODO lists. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2854"
>9.4.4. Design</A
></H4
><DIV
CLASS="section"
><H5
CLASS="section"
><A
NAME="AEN2856"
>9.4.4.1. User Experience Design</A
></H5
><P
>If you are a user experience designer, you can help FreedomBox with the following items: </P
><P
></P
><UL
><LI
><P
>UI experience for the Plinth web interface </P
></LI
><LI
><P
>Web design for <A
HREF="https://freedomboxfoundation.org"
TARGET="_top"
>freedomboxfoundation.org</A
> and FreedomBox <A
HREF="https://wiki.debian.org/FreedomBox#"
TARGET="_top"
>wiki</A
> pages </P
></LI
><LI
><P
>Logo and branding (we currently have <A
HREF="https://github.com/freedombox/Plinth/tree/master/static/themes/default/"
TARGET="_top"
>an identity manual and logos</A
>) </P
></LI
><LI
><P
>Possible designs for custom FreedomBox cases on single board computers </P
></LI
><LI
><P
>&#13;                <A
HREF="https://wiki.debian.org/FreedomBox/Design#"
TARGET="_top"
>User experience design</A
>
              </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN2874"
>9.4.4.2. Technical Design</A
></H5
><P
>FreedomBox is still under development any many components are yet to be worked on.  You can contribute to the discussion on various technical design and implementation aspects of FreedomBox.  See: </P
><P
></P
><UL
><LI
><P
>&#13;                <A
HREF="https://wiki.debian.org/FreedomBox/Design#"
TARGET="_top"
>Design portal</A
>
              </P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2881"
>9.4.5. Donate</A
></H4
><P
>The <A
HREF="https://freedomboxfoundation.org"
TARGET="_top"
>FreedomBox Foundation</A
> is a Delaware non-profit corporation in the process of applying for 501(c)(3) federal nonprofit recognition from the IRS. FreedomBox project is run by volunteers.  You can help the project financially by donating via PayPal, Bitcoin or by mailing a check.  Please see the <A
HREF="https://www.freedomboxfoundation.org/donate/"
TARGET="_top"
>donation page</A
> for details on how to donate. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2886"
>9.4.6. Document: User Manual, Website and Wiki</A
></H4
><P
>FreedomBox needs better documentation for users and contributors.  FreedomBox manual is prepared by aggregating various pages on the wiki and exporting to various formats.  The manual is then used in Plinth and elsewhere. </P
><P
>If you wish to contribute to the FreedomBox <A
HREF="https://wiki.debian.org/FreedomBox#"
TARGET="_top"
>wiki</A
> (and consequently the FreedomBox manual), you can create a wiki account and start editing. </P
><P
>For contributing to the website please start a discussion on the FreedomBox <A
HREF="http://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss"
TARGET="_top"
>mailing list</A
>. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2893"
>9.4.7. Quality Assurance</A
></H4
><P
></P
><UL
><LI
><P
>FreedomBox already runs on many platforms and it is not possible for developers to test all possible platforms.  If you have one of the supported hardware you can help with testing FreedomBox on the platform. </P
></LI
><LI
><P
>When an application is made available on FreedomBox, not all of its functionality is tested in the real world by developer doing the work.  Deploying the application and testing it will help ensure high quality applications in FreedomBox. </P
></LI
></UL
><P
>See the <A
HREF="https://wiki.debian.org/FreedomBox/QualityAssurance#"
TARGET="_top"
>quality assurance</A
> page for a basic list of test cases to check for and information on reporting bugs. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2902"
>9.4.8. Localization</A
></H4
><P
>All text visible to users of FreedomBox needs to be localized to various languages.  This translation work includes: </P
><P
></P
><UL
><LI
><P
><A
HREF="https://wiki.debian.org/FreedomBox/Plinth#"
TARGET="_top"
>Plinth</A
> web interface for FreedomBox </P
></LI
><LI
><P
>FreedomBox documentation </P
></LI
><LI
><P
>FreedomBox <A
HREF="https://freedomboxfoundation.org"
TARGET="_top"
>website</A
> and <A
HREF="https://wiki.debian.org/FreedomBox#"
TARGET="_top"
>wiki</A
> </P
></LI
><LI
><P
>Individual applications that FreedomBox exposes to users such as ownCloud, JWChat etc. </P
></LI
></UL
><P
>Some of the translation work are implemented in user interface (Plinth) since the 0.7 release. Documents for user interface translation are currently available on <A
HREF="https://www.transifex.com/freedombox/"
TARGET="_top"
>Transifex localization platform</A
> and <A
HREF="https://github.com/freedombox/Plinth/tree/master/locale"
TARGET="_top"
>GitHub</A
>. If you wish to see FreedomBox available for one of your languages, please start a discussion on the FreedomBox discuss <A
HREF="http://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss"
TARGET="_top"
>mailing list</A
> or on the <A
HREF="irc://irc.debian.org/freedombox"
TARGET="_top"
>#freedombox IRC</A
> channel to avoid double translations. </P
><P
>For more information, please visit the FreedomBox <A
HREF="https://wiki.debian.org/FreedomBox/Translate#"
TARGET="_top"
>translation landing page</A
>. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2924"
>9.4.9. Spread the Word</A
></H4
><P
>Speak to your family, friends, local community or at global conferences about the importance of FreedomBox.  To be a successful project we need many more participants, be it users or contributors.  Write about your efforts at the <A
HREF="https://www.freedomboxfoundation.org/appearances/index.en.html"
TARGET="_top"
>talks page</A
> and on the <A
HREF="https://wiki.debian.org/FreedomBox/TalksAndPresentations#"
TARGET="_top"
>wiki</A
>. </P
></DIV
></DIV
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="AEN2929"
>10. Developer Guide</A
></H2
><P
>This manual is meant for developers intending to develop applications for FreedomBox.  It provides a step by step tutorial and an API reference. </P
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN2932"
>10.1. Writing Applications - Tutorial</A
></H3
><P
>This tutorial covers writing an application for FreedomBox. FreedomBox is a pure blend of Debian with a web interface, known as Plinth, that configures its applications.  We shall discuss various aspects of building an application for FreedomBox, by creating an example application. </P
><P
>There are two parts to writing a FreedomBox application.  First is to make sure that the application is available as a Debian package uploaded to the repositories.  This is the majority of the work involved.  However, if an application is already available in Debian repositories, it is trivial to build a FreedomBox UI for it. The second part of writing an application for FreedomBox is to provide a thin web interface layer for configuring the application.  This is done by extending Plinth's user interface to provide visibility to the application and to let the user control its operations in a highly simplified way.  This layer is referred to as 'Plinth application'. </P
><P
>Plinth applications can either be distributed as part of Plinth source code by submitting the applications to the Plinth project or they can distributed independently.  This tutorial covers writing an application that is meant to be distributed as part of Plinth. However, writing independent Plinth applications is also very similar and most of this tutorial is applicable. </P
><DIV
CLASS="note"
><P
></P
><TABLE
CLASS="note"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="../images/note.gif"
HSPACE="5"
ALT="Note"></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>&#13;          <SPAN
CLASS="strong"
><B
CLASS="emphasis"
>Note</B
></SPAN
>
        </P
><P
>The term application, in this tutorial, is used to mean multiple concepts.  FreedomBox application is a combination of Debian package and a web interface layer.  The web interface layer is also called a Plinth application which is very similar to and built upon a Django application. </P
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2941"
>10.1.1. Before we begin</A
></H4
><P
>Plinth is a web interface built using Python3 and Django.  FreedomBox applications are simply Django applications within the Plinth project. Hence, for the most part, writing a FreedomBox application is all about writing a Django application. </P
><P
>You should start by reading the <A
HREF="https://docs.djangoproject.com/en/stable/intro/tutorial01/"
TARGET="_top"
>Django tutorial</A
>.  All the concepts described there are applicable for how plinth and its applications are be built. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2946"
>10.1.2. Picking an application</A
></H4
><P
>We must first, of course, pick an application to add to FreedomBox. For the purpose of this tutorial, let us pick Tiny Tiny RSS.  The project description reads as, <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Tiny Tiny RSS is an open source web-based news feed (RSS/Atom) reader and aggregator, designed to allow you to read news from any location, while feeling as close to a real desktop application as possible</I
></SPAN
>. </P
><DIV
CLASS="important"
><P
></P
><TABLE
CLASS="important"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="../images/important.gif"
HSPACE="5"
ALT="Important"></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>&#13;            <SPAN
CLASS="strong"
><B
CLASS="emphasis"
>Choosing an application</B
></SPAN
>
          </P
><P
>When choosing an application we must make sure that the application respects users' freedom and privacy.  By choosing to use FreedomBox, users have explicitly made a choice to keep the data with themselves, to not provide privacy compromising data to centralized entities and to use Free Software that respects their Software Freedom.  These are not properties of <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>some</I
></SPAN
> of the applications in FreedomBox but all applications <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>must</I
></SPAN
> adhere to these principles. Applications should not even ask the users questions to this effect, because users have already made a choice. </P
></TD
></TR
></TABLE
></DIV
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2956"
>10.1.3. Packaging the application</A
></H4
><P
>Majority of the effort in creating an application for FreedomBox is to package it for Debian and get it uploaded to Debian repositories. Going through the process of packaging itself is outside the scope of this tutorial.  It is, however, well documented elsewhere.  You should start <A
HREF="https://wiki.debian.org/Packaging"
TARGET="_top"
>here</A
>. </P
><P
>Debian packaging might seem like an unnecessary process that takes time with its adherence to standards, review process, legal checks, etc.  However, upon close examination, one will find that without these steps the goals of the FreedomBox project cannot be met.  Some of the advantages of Debian packaging are listed below: </P
><P
></P
><UL
><LI
><P
>Legal check ensures that proprietary licensed code or code with bad licenses does not inadvertently creep in. </P
></LI
><LI
><P
>Libraries have to be packaged separately easing security handling. When a security vulnerability is identified in a library, just the library will have to be updated and not all the applications that depend on it. </P
></LI
><LI
><P
>Upgrades become smoother.  The dependency handling of the packaging system, configuration handling tools, tools to deal with various types of well known files help with ensuring a proper upgrade. </P
></LI
><LI
><P
>Collaborative maintenance teams ensure that the package is well cared for even if you get busy with other work and can't spend time on your package.  Following standards and using common infrastructure is critical to enable this development methodology. </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2970"
>10.1.4. Creating the project structure</A
></H4
><P
>Create a directory structure as follows with empty files.  We will fill them up in a step-by-step manner. </P
><PRE
CLASS="screen"
>+- &#60;plinth_root&#62;/
  |
  +- plinth/
  | |
  | +- modules/
  |   |
  |   +- ttrss/
  |     |
  |     +- __init__.py
  |     |
  |     +- forms.py
  |     |
  |     +- urls.py
  |     |
  |     +- views.py
  |     |
  |     +- templates/
  |     | |
  |     | +- ttrss.html
  |     |
  |     +- tests
  |       |
  |       +- __init__.py
  |
  +- actions/
  | |
  | +- ttrss
  |
  +- data/
    |
    +- etc/
      |
      +- plinth/
        |
        +- modules-enabled/
          |
          +- ttrss</PRE
><P
>The <FONT
COLOR="RED"
>__init__.py</FONT
> indicates that the directory in which it is present is a Python module.  For now, it is an empty file. </P
><P
>Plinth's setup script <FONT
COLOR="RED"
>setup.py</FONT
> will automatically install the <FONT
COLOR="RED"
>plinth/modules/ttrss</FONT
> directory (along with other files described later) to an appropriate location.  If you are creating an application that stays independent and outside of Plinth source tree, then your <FONT
COLOR="RED"
>setup.py</FONT
> script will need to install it a proper location on the system. The <FONT
COLOR="RED"
>plinth/modules/</FONT
> directory is a Python3 <A
HREF="https://www.python.org/dev/peps/pep-0420/"
TARGET="_top"
>namespace package</A
>. So, you can install it with the <FONT
COLOR="RED"
>plinth/modules/</FONT
> directory structure into any Python path and still be discovered as <FONT
COLOR="RED"
>plinth.modules.*</FONT
>. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2984"
>10.1.5. Tell Plinth that we exist</A
></H4
><P
>The first thing to do is tell Plinth that our application exists.  This is done by writing a small file with the Python import path to our application and placing it in <FONT
COLOR="RED"
>data/etc/plinth/modules-enabled/</FONT
>.  Let us create this file <FONT
COLOR="RED"
>ttrss</FONT
>: </P
><PRE
CLASS="screen"
>plinth.modules.ttrss</PRE
><P
>This file is automatically installed to <FONT
COLOR="RED"
>/etc/plinth/modules-enabled/</FONT
> by Plinth's installation script <FONT
COLOR="RED"
>setup.py</FONT
>.  If we are writing a module that resides independently outside the Plinth's source code, the setup script will need to copy it to the target location.   Further, it is not necessary for the application to be part of the <FONT
COLOR="RED"
>plinth.modules</FONT
> namespace. It can, for example, be <FONT
COLOR="RED"
>plinth_ttrss</FONT
>. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN2995"
>10.1.6. Writing the URLs</A
></H4
><P
>For a user to visit our application in Plinth, we need to provide a URL.  When the user visits this URL, a view is executed and a page is displayed.  In <FONT
COLOR="RED"
>urls.py</FONT
> write the following: </P
><PRE
CLASS="screen"
>from django.conf.urls import url

from . import views

urlpatterns = [
    url(r'^apps/ttrss/$', views.index, name='index'),
]</PRE
><P
>This routes the <FONT
COLOR="RED"
>/apps/ttrss/</FONT
> URL to a view called <FONT
COLOR="RED"
>index</FONT
> defined in <FONT
COLOR="RED"
>plinth/modules/ttrss/views.py</FONT
>.  This is no different than how routing URLs are written in Django.  See <A
HREF="https://docs.djangoproject.com/en/stable/topics/http/urls/"
TARGET="_top"
>Django URL dispatcher</A
> for more information. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3005"
>10.1.7. Adding a menu item</A
></H4
><P
>We have added a URL to be handled by our application but this does not yet show up to be a link in Plinth web interface.  Let us add a link in the applications list.  In <FONT
COLOR="RED"
>__init__.py</FONT
> add the following: </P
><PRE
CLASS="screen"
>from plinth import cfg

def init():
    """Intialize the module."""
    menu = cfg.main_menu.get('apps:index')
    menu.add_urlname('News Feed Reader (Tiny Tiny RSS)', 'glyphicon-bullhorn',
                     'ttrss:index', 850)</PRE
><P
>As soon as Plinth starts, it will load all the enabled modules into memory.  After this, it gives a chance to each of the modules to initialize itself by calling the <FONT
COLOR="RED"
>init()</FONT
> method if there is such a method available as <FONT
COLOR="RED"
>&#60;app&#62;.init()</FONT
>.  Here we have implemented this method and added our menu item to the applications menu as part of the initialization process. </P
><P
>We wish to add our menu item to the list of applications which is why we have retrieved the applications menu which is available under the main menu.  After this we add our own menu item to this menu.  There are several parameters during this process that are important: </P
><P
></P
><UL
><LI
><P
>In the first parameter we are providing the display name to use for our application when showing the menu item. </P
></LI
><LI
><P
>In the second parameter we are providing the icon to show for this menu item.  This is an icon from the Twitter Bootstrap library.  See </P
><P
>the Twitter Bootstrap library documentation for a list of <A
HREF="http://getbootstrap.com/components/#glyphicons"
TARGET="_top"
>available icons</A
>.  We can pick an icon from the available list of icons and just mention its glyphicon class as name here. </P
></LI
><LI
><P
>The third parameter is the name of the URL we have created for our application.  Note that when including this application's URLs, Plinth will automatically set the name of the module as the Django </P
><P
>URL namespace.  Hence it is <FONT
COLOR="RED"
>ttrss:index</FONT
> and not just <FONT
COLOR="RED"
>index</FONT
>. </P
></LI
><LI
><P
>The final parameter specifies where in the menu this application shows up.  This is weightage number with which Plinth sorts the menu items.  Higher the weightage, the lower the menu item appears (as it sinks).  Since Plinth menu items are alphabetically sorted, for our </P
><P
>application we wish for it to appear between <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Public Visibility</I
></SPAN
> and <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Voice Chat</I
></SPAN
>.  Their weights are 800 and 900 respectively.  So we selected 850. </P
></LI
></UL
><P
>We have used the application menu item to insert our own menu item as a child.  To be able to use the application menu item, we need to make sure that the module providing the application menu is loaded before our application is loaded.  We will do that in the next step. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3032"
>10.1.8. Specifying module dependencies</A
></H4
><P
>Specifying a simple list of applications to be loaded before our application provided to Plinth is sufficient.  Add this in <FONT
COLOR="RED"
>__init__.py</FONT
>. </P
><PRE
CLASS="screen"
>depends = ['plinth.modules.apps']</PRE
><P
>Plinth will now make sure that the <FONT
COLOR="RED"
>apps</FONT
> module is loaded before our module is loaded.  Application initialization is also ensured to happen in this order.  We can safely use any features of this module knowing that they have been initialized. </P
><DIV
CLASS="note"
><P
></P
><TABLE
CLASS="note"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="../images/note.gif"
HSPACE="5"
ALT="Note"></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>&#13;            <SPAN
CLASS="strong"
><B
CLASS="emphasis"
>Circular dependencies</B
></SPAN
>
          </P
><P
>Circular dependencies are not possible among Plinth applications.  Attempting to add them will result in error during startup. </P
></TD
></TR
></TABLE
></DIV
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3043"
>10.1.9. Writing the enable/disable form</A
></H4
><P
>We wish to provide a user interface to the user to enable and disable the application.  Complex modules may require more options but this is sufficient for our application.  Add the following <FONT
COLOR="RED"
>forms.py</FONT
>. </P
><PRE
CLASS="screen"
>from django import forms

class TtrssForm(forms.Form):
    """Tiny Tiny RSS configuration form."""
    enabled = forms.BooleanField(
        label='Enable Tiny Tiny RSS',
        required=False)</PRE
><P
>This creates a Django form that shows a single option to enable/disable the application.  It also shows its current state. This is how a regular Django form is built.  See <A
HREF="https://docs.djangoproject.com/en/stable/topics/forms/"
TARGET="_top"
>Django Forms documentation</A
> for more information. </P
><DIV
CLASS="tip"
><P
></P
><TABLE
CLASS="tip"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="../images/tip.gif"
HSPACE="5"
ALT="Tip"></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>&#13;            <SPAN
CLASS="strong"
><B
CLASS="emphasis"
>Too many options</B
></SPAN
>
          </P
><P
>Resist the temptation to create a lot of configuration options.  Although this will put more control in the hands of the users, it will make FreedomBox less usable.  FreedomBox is a consumer product.  Our target users are not technically savvy and we have make most of the decisions on behalf of the user to make the interface as simple and easy to use as possible. </P
></TD
></TR
></TABLE
></DIV
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3054"
>10.1.10. Writing a view</A
></H4
><P
>In <FONT
COLOR="RED"
>views.py</FONT
>, let us add a view that can handle the URL we have provided above. </P
><PRE
CLASS="screen"
>from .forms import TtrssForm

def index(request):
    """Serve configuration page."""
    status = get_status()

    form = None

    if request.method == 'POST':
        form = TtrssForm(request.POST, prefix='ttrss')
        if form.is_valid():
            _apply_changes(request, status, form.cleaned_data)
            status = get_status()
            form = TtrssForm(initial=status, prefix='ttrss')
    else:
        form = TtrssForm(initial=status, prefix='ttrss')

    return TemplateResponse(request, 'ttrss.html',
                            {'title': 'News Feed Reader (Tiny Tiny RSS)',
                             'status': status,
                             'form': form})</PRE
><P
>This view works with the form we created in the previous step.  It shows the current status of the service in form.  This status is retrieved with the help of <FONT
COLOR="RED"
>get_status()</FONT
> helper method.  When the form is posted, again this view is called and it verifies whether the form's input values are correct.  If so, it will apply the actions necessary for changed form values using the <FONT
COLOR="RED"
>_apply_changes()</FONT
> method. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3062"
>10.1.11. Getting the current status of the application</A
></H4
><P
>The view in the previous setup requires the status of the application to be retrieved using the <FONT
COLOR="RED"
>get_status()</FONT
> method.  Let us implement that method in <FONT
COLOR="RED"
>views.py</FONT
>. </P
><PRE
CLASS="screen"
>from plinth.modules import ttrss

def get_status():
    """Get the current status."""
    return {'enabled': ttrss.is_enabled()}</PRE
><P
>This method retrieves the various statuses of the application for display in the view.  Currently, we only need to show whether the application is enabled or disabled.  So, we retrieve that using a helper method defined in <FONT
COLOR="RED"
>__init__.py</FONT
>. </P
><PRE
CLASS="screen"
>from plinth import action_utils

def is_enabled():
    """Return whether the module is enabled."""
    return action_utils.webserver_is_enabled('50-tt-rss')</PRE
><P
>This method uses one of the several action utilities provided by Plinth.  This method checks whether a webserver configuration named <FONT
COLOR="RED"
>50-tt-rss</FONT
> is enabled. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3073"
>10.1.12. Displaying the application page</A
></H4
><P
>The view that we have written above requires a template file known as <FONT
COLOR="RED"
>ttrss.html</FONT
> to work.  This template file controls how the web page for our application is displayed.  Let us create this template file in <FONT
COLOR="RED"
>templates/ttrss.html</FONT
>. </P
><PRE
CLASS="screen"
>{% extends "base.html" %}

{% load bootstrap %}

{% block content %}

&#60;h2&#62;News Feed Reader (Tiny Tiny RSS)&#60;/h2&#62;

&#60;p&#62;Tiny Tiny RSS is a news feed (RSS/Atom) reader and aggregator,
  designed to allow you to read news from any location, while feeling
  as close to a real desktop application as possible.&#60;/p&#62;

&#60;h3&#62;Configuration&#60;/h3&#62;

&#60;form class="form" method="post"&#62;
  {% csrf_token %}

  {{ form|bootstrap }}

  &#60;input type="submit" class="btn btn-primary" value="Update setup"/&#62;
&#60;/form&#62;

{% endblock %}</PRE
><P
>This template extends an existing template known as <FONT
COLOR="RED"
>base.html</FONT
>.  This template is available in Plinth core to provide all the basic layout, styling, menus, JavaScript and CSS libraries.  We will override the content area of the base template and keep the rest. </P
><P
>Yet again, there is nothing special about the way this template is written.  This is a regular Django template. See <A
HREF="https://docs.djangoproject.com/en/stable/topics/templates/"
TARGET="_top"
>Django Template documentation</A
>. </P
><P
>For styling and UI components, Plinth uses the Twitter Bootstrap project. See <A
HREF="http://getbootstrap.com/css/"
TARGET="_top"
>Bootstrap documentation</A
> for reference. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3085"
>10.1.13. Applying the changes from the form</A
></H4
><P
>The view we have created displays the form and processes the form after the user submits it.  It used a helper method called <FONT
COLOR="RED"
>_apply_changes()</FONT
> to actually get the work done.  Let us implement that method in <FONT
COLOR="RED"
>views.py</FONT
>. </P
><PRE
CLASS="screen"
>from django.contrib import messages

from plinth import actions

def _apply_changes(request, old_status, new_status):
    """Apply the changes."""
    modified = False

    if old_status['enabled'] != new_status['enabled']:
        sub_command = 'enable' if new_status['enabled'] else 'disable'
        actions.superuser_run('ttrss', [sub_command])
        modified = True

    if modified:
        messages.success(request, 'Configuration updated')
    else:
        messages.info(request, 'Setting unchanged')</PRE
><P
>We check to make sure that we don't try to disable the application when it is already disabled or try to enable the application when it is already enabled.  Although Plinth's operations are idempotent, meaning that running them twice will not be problematic, we still wish avoid unnecessary operations for the sake of speed. </P
><P
>We are actually perform the operation using Plinth actions.  We will implement the action to be performed a bit later. </P
><P
>After we perform the operation, we will show a message on the response page showing that the action was successful or that nothing happened. We use the Django messaging framework to accomplish this.  See <A
HREF="https://docs.djangoproject.com/en/stable/ref/contrib/messages/"
TARGET="_top"
>Django messaging framework</A
> for more information. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3095"
>10.1.14. Installing packages required for the application</A
></H4
><P
>Plinth takes care of installing all the Debian packages required for our application to work.  All we need to do is specify the list of the Debian packages required using a decorator on our view as follows: </P
><PRE
CLASS="screen"
>from plinth import package

@package.required(['tt-rss'])
def index(request):
    """Serve configuration page."""
    ...</PRE
><P
>The first time this application's view is accessed, Plinth shows a package installation page and allows the user to install the required packages.  After the package installation is completed, the user is shown the application's configuration page. </P
><P
>If there are configuration tasks to be performed immediately before or after the package installation, Plinth provides hooks for it.  The <FONT
COLOR="RED"
>before_install=</FONT
> and <FONT
COLOR="RED"
>on_install=</FONT
> parameters to the <FONT
COLOR="RED"
>@package.required</FONT
> decorator take a callback methods that are called before installation of packages and after installation of packages respectively.  See the reference section of this manual or the <FONT
COLOR="RED"
>plinth.package</FONT
> module for details.  Other modules in Plinth that use this feature provided example usage. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3105"
>10.1.15. Writing actions</A
></H4
><P
>The actual work of performing the configuration change is carried out by a Plinth action.  Actions are independent scripts that run with higher privileges required to perform a task.  They are placed in a separate directory and invoked as scripts via sudo.  For our application we need to write an action that can enable and disable the web configuration.  We will do this by creating a file <FONT
COLOR="RED"
>actions/ttrss</FONT
>. </P
><PRE
CLASS="screen"
>import argparse

from plinth import action_utils


def parse_arguments():
    """Return parsed command line arguments as dictionary."""
    parser = argparse.ArgumentParser()
    subparsers = parser.add_subparsers(dest='subcommand', help='Sub command')

    subparsers.add_parser('enable', help='Enable Tiny Tiny RSS')
    subparsers.add_parser('disable', help='Disable Tiny Tiny RSS')

    return parser.parse_args()


def subcommand_enable(_):
    """Enable web configuration and reload."""
    action_utils.webserver_enable('50-tt-rss')


def subcommand_disable(_):
    """Disable web configuration and reload."""
    action_utils.webserver_disable('50-tt-rss')


def main():
    """Parse arguments and perform all duties."""
    arguments = parse_arguments()

    subcommand = arguments.subcommand.replace('-', '_')
    subcommand_method = globals()['subcommand_' + subcommand]
    subcommand_method(arguments)


if __name__ == '__main__':
    main()</PRE
><P
>This is a simple Python3 program that parses command line arguments. While Python3 is preferred, it can be written in other languages also. It uses a helper utility provided by Plinth to actually enable and disable Apache2 web server configuration. </P
><P
>This script is automatically installed to <FONT
COLOR="RED"
>/usr/share/plinth/actions</FONT
> by Plinth's installation script <FONT
COLOR="RED"
>setup.py</FONT
>. Only from here will there is a possibility of running the script under <FONT
COLOR="RED"
>sudo</FONT
>.  If you are writing an application that resides indenpendently of Plinth's source code, your <FONT
COLOR="RED"
>setup.py</FONT
> script will need to take care of copying the file to the target location. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3116"
>10.1.16. Creating diagnostics</A
></H4
><P
>Plinth provides a simple API for showing diagnostics results.  The application has to implement a method for actually running the diagnostics and return the results as a list.  Plinth then takes care of calling the diagnostics method and displaying the list in a formatted manner. </P
><P
>To implement the diagnostics method, method called <FONT
COLOR="RED"
>diagnose()</FONT
> has to be available as <FONT
COLOR="RED"
>&#60;app&#62;.diagnose()</FONT
>.  It must return a list in which each item is the result of a test performed.  The item itself is a two-tuple containing the display name of the test followed by the result as <FONT
COLOR="RED"
>passed</FONT
>, <FONT
COLOR="RED"
>failed</FONT
> or <FONT
COLOR="RED"
>error</FONT
>. </P
><PRE
CLASS="screen"
>def diagnose():
    """Run diagnostics and return the results."""
    results = []

    results.extend(action_utils.diagnose_url_on_all(
        'https://{host}/ttrss', extra_options=['--no-check-certificate']))

    return results</PRE
><P
>There are several helpers available to implement some of the common diagnostic tests.  For our application we wish to implement a test to check whether the <FONT
COLOR="RED"
>/ttrss</FONT
> URL is accessible.  Since this is a commonly performed test, there is a helper method available and we have used it in the above code.  The <FONT
COLOR="RED"
>{host}</FONT
> tag replaced with various IP addresses, hostnames and domain names by the helper to produce different kinds of URLs and they are all tested.  Results for all tests are returned which we then pass on to Plinth. </P
><P
>The user can trigger the diagnostics test by going to <FONT
COLOR="RED"
>System -&#62; Diagnostics</FONT
> page.  This runs diagnostics for all the applications.  If we want users to be able to run diagnostics specifically for this application, we can include a button for it in our template immediately after the application description. </P
><PRE
CLASS="screen"
>{% include "diagnostics_button.html" with module="ttrss" %}</PRE
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3132"
>10.1.17. Logging</A
></H4
><P
>Sometimes we may feel the need to write some debug messages to the console and Plinth log file.  Doing this in Plinth is just like doing this any other Python application. </P
><PRE
CLASS="screen"
>import logging

logger = logging.getLogger(__name__)

def example_method():
    logger.debug('A debug level message')

    logger.info('Showing application page - %s', request.method)

    try:
        something()
    except Exception as exception:
        # Print stack trace
        logger.exception('Encountered an exception - %s', exception)</PRE
><P
>For more information see Python <A
HREF="https://docs.python.org/3.4/library/logging.html"
TARGET="_top"
>logging framework</A
> documentation. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3138"
>10.1.18. Adding a License</A
></H4
><P
>Plinth is licensed under the GNU Affero General Public License Version 3 or later.  FreedomBox UI applications, which run as modules under Plinth, also need to be under the same license or under a compatible license.  The license of our application needs to clear for our application to be accepted by users and other developers.  Let us add license headers to our application. </P
><PRE
CLASS="screen"
>#
# This file is part of Plinth.
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU Affero General Public License as
# published by the Free Software Foundation, either version 3 of the
# License, or (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU Affero General Public License for more details.
#
# You should have received a copy of the GNU Affero General Public License
# along with this program.  If not, see &#60;http://www.gnu.org/licenses/&#62;.
#</PRE
><P
>The above header needs to be present in every file of the application. It is suitable for Python files.  However, in template files, we need to modify it slightly. </P
><PRE
CLASS="screen"
>{% extends "base.html" %}
{% comment %}
#
# This file is part of Plinth.
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU Affero General Public License as
# published by the Free Software Foundation, either version 3 of the
# License, or (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU Affero General Public License for more details.
#
# You should have received a copy of the GNU Affero General Public License
# along with this program.  If not, see &#60;http://www.gnu.org/licenses/&#62;.
#
{% endcomment %}

...</PRE
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3144"
>10.1.19. Internationalization</A
></H4
><P
>Every string message that is visible to the user must be localized to user's native language.  For this to happen, our application needs to be internationalized.  This requires marking the user visible messages for translation.  Plinth applications use the Django's localization methods to make that happen. </P
><PRE
CLASS="screen"
>from django.utils.translation import ugettext as _

def index(request):
    ...
    return TemplateResponse(request, 'ttrss.html',
                            {'title': _('News Feed Reader (Tiny Tiny RSS)'),
                             'status': status,
                             'form': form})</PRE
><P
>Notice that the page's title is wrapped in the <FONT
COLOR="RED"
>_()</FONT
> method call. Let us do that for the menu item of the application too. </P
><PRE
CLASS="screen"
>from django.utils.translation import ugettext_lazy as _

def init():
    """Intialize the module."""
    menu = cfg.main_menu.get('apps:index')
    menu.add_urlname(_('News Feed Reader (Tiny Tiny RSS)'), 'glyphicon-envelope',
                     'ttrss:index', 600)</PRE
><P
>Notice that in this case, we have used the <FONT
COLOR="RED"
>ugettext_lazy</FONT
> and in the first case we have used the regular <FONT
COLOR="RED"
>ugettext</FONT
>.  This is because in the second case the <FONT
COLOR="RED"
>gettext</FONT
> lookup is made once and reused for every user looking at the interface.  These users may each have a different language set for their interface.  Lookup made for one language should not be used for other users.  The <FONT
COLOR="RED"
>_lazy</FONT
> method provided by Django makes sure that the return value is an object that will actually be converted to string at the final moment when the string is being displayed.  In the first case, the looked is made and string is returned immediately. </P
><P
>All of this is the usual way internationalization is done in Django.  See <A
HREF="https://docs.djangoproject.com/en/stable/topics/i18n/"
TARGET="_top"
>Django internationalization and localization</A
> documentation for more information. </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3158"
>10.1.20. Coding standards</A
></H4
><P
>For readability and easy collaboration it is important to follow common coding standards.  Plinth uses the Python coding standards and uses the <FONT
COLOR="RED"
>pylint</FONT
> and <FONT
COLOR="RED"
>flake8</FONT
> tools to check if the there are any violations.  Run these tools on our application and fix any errors and warnings.  Better yet, integrate these tools into your favorite IDE for on-the-fly checking. </P
><P
>For the most part, the code we have written so far, is already compliant with the coding standards.  This includes variable/method naming, indentation, document strings, comments, etc.  One thing we have to add are the module documentation strings.  Let us add those. In <FONT
COLOR="RED"
>__init__.py</FONT
> add the top: </P
><PRE
CLASS="screen"
>"""
Plinth module to configure Tiny Tiny RSS.
"""</PRE
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN3166"
>10.2. Reference Guide</A
></H3
><P
>This section describes Plinth API that is most frequently used by application.  Note that since Plinth is under development and has not yet reached 1.0, this API is subject to change.  This is not usually a problem because all the Plinth applications currently reside in Plinth source repository itself and are updated when the API is updated. </P
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3169"
>10.2.1. Applications</A
></H4
><P
>These methods are optionally provided by the application and Plinth calls/uses them if they are present. </P
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN3172"
>10.2.1.1. &#60;application&#62;.init()</A
></H5
><P
>Optional.  This method is called by Plinth soon after all the applications are loaded.  The <FONT
COLOR="RED"
>init()</FONT
> call order guarantees that other applications that this application depends on will be initialized before this application is initialized. </P
></DIV
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN3176"
>10.2.1.2. &#60;application&#62;.diagnose()</A
></H5
><P
>Optional.  Called when the user invokes system-wide diagnostics by visiting <FONT
COLOR="RED"
>System -&#62; Diagnositcs</FONT
>.  This method must return an array of diagnostic results.  Each diagnostic result must be a two-tuple with first element as a string that is shown to the user as name of the test and second element is the result of the test.  It must be one of <FONT
COLOR="RED"
>passed</FONT
>, <FONT
COLOR="RED"
>failed</FONT
>, <FONT
COLOR="RED"
>error</FONT
>.  Example return value: </P
><PRE
CLASS="screen"
>[('Check http://localhost/app is reachable', 'passed'),
 ('Check configuration is sane', 'passed')]</PRE
></DIV
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN3184"
>10.2.1.3. &#60;appliation&#62;.depends</A
></H5
><P
>Optional.  This module property must contain a list of all applications that this application depends on.  The application is specified as string containing the full module load path.  For example, <FONT
COLOR="RED"
>plinth.modules.apps</FONT
>. </P
></DIV
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN3188"
>10.2.1.4. plinth.package.required(package_list, before_install=None, on_install=on_install)</A
></H5
><P
>Make sure that a set of Debian packages are installed before a view can be accessed.  If the packages are not currently installed on the system, a special installation view is displayed showing the list of packages to be installed.  If the user chooses to proceed, package installation will start and an installation progress screen will be shown.  After completion of the installation process, the original view is shown. </P
><P
>The <FONT
COLOR="RED"
>package_list</FONT
> must be an iterable containing the Debian package names as strings.  If provided, the <FONT
COLOR="RED"
>before_install</FONT
> callable is called just before the installation process starts.  Similarly, <FONT
COLOR="RED"
>on_install</FONT
> callable is called just after the package installation completes. </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3195"
>10.2.2. Actions</A
></H4
><P
>Plinth's web front does not directly change any aspect of the underlying operating system.  Instead, it calls upon <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Actions</I
></SPAN
>, as shell commands.  Actions live in <FONT
COLOR="RED"
>/usr/share/plinth/actions</FONT
> directory. They require no interaction beyond passing command line arguments or taking sensitive arguments via stdin. They change the operation of the services and applications of the FreedomBox and nothing else. These actions are also directly usable by a skilled administrator. </P
><P
>The following methods are provided by Plinth to run actions and to implement them easily by reusing code for common tasks. </P
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN3201"
>10.2.2.1. plinth.actions.run(action, options=None, input=None, async=False)</A
></H5
><P
>Run an action command present under the <FONT
COLOR="RED"
>actions/</FONT
> directory.  This runs <FONT
COLOR="RED"
>subprocess.Popen()</FONT
> after some checks.  The action must be present in the actions/ directory. </P
><P
><FONT
COLOR="RED"
>options</FONT
> are a list of additional arguments to pass to the command.  If <FONT
COLOR="RED"
>input</FONT
> is given it must be bytearray containing the input to pass on to the executed action.  If <FONT
COLOR="RED"
>async</FONT
> is set to True, the method will return without waiting for the command to finish. </P
></DIV
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN3210"
>10.2.2.2. plinth.actions.superuser_run(action, options=None, input=None, async=False)</A
></H5
><P
>This is same as <FONT
COLOR="RED"
>plinth.actions.run()</FONT
> except the command is run with superuser privelages. </P
></DIV
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN3214"
>10.2.2.3. plinth.action_utils</A
></H5
><P
>Several utlities to help with the implementation of actions and diagnotic tests are implemented in this module.  Refer to the module source code for a list of these methods and their documentation. </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3217"
>10.2.3. Menus</A
></H4
><DIV
CLASS="section"
><H5
CLASS="section"
><A
NAME="AEN3219"
>10.2.3.1. plinth.cfg.main_menu</A
></H5
><P
>This is a reference to the global main menu.  All menu entries in Plinth are decendents of this menu item.  See <FONT
COLOR="RED"
>Menu.add_item()</FONT
> and <FONT
COLOR="RED"
>Menu.add_urlname()</FONT
> for adding items to this menu or its children. </P
></DIV
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN3224"
>10.2.3.2. plinth.menu.Menu.get(self, urlname, url_args=None, url_kwargs=None)</A
></H5
><P
>Return a child of this menu item.  <FONT
COLOR="RED"
>urlname</FONT
> must be the name of a URL as configured in Django.  <FONT
COLOR="RED"
>django.core.urlresolvers.reverse()</FONT
> is called before the lookup for child menu item is performed.  <FONT
COLOR="RED"
>url_args</FONT
> and <FONT
COLOR="RED"
>url_kwargs</FONT
> are passed on to <FONT
COLOR="RED"
>reverse()</FONT
>. </P
></DIV
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN3232"
>10.2.3.3. plinth.menu.Menu.add_item(self, label, icon, url, order=50)</A
></H5
><P
>Add a menu item as a child to the current menu item.  <FONT
COLOR="RED"
>label</FONT
> is the user visible string shown for the menu item.  <FONT
COLOR="RED"
>icon</FONT
> must be a glyphicon class from the Twitter Bootstrap library.  <FONT
COLOR="RED"
>url</FONT
> is the relative URL to which this menu item will take the user to. </P
></DIV
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN3238"
>10.2.3.4. plinth.menu.Menu.add_urlname(self, label, icon, urlname, order=50, url_args=None, url_kwargs=None)</A
></H5
><P
>Same as <FONT
COLOR="RED"
>plinth.menu.Menu.add_item()</FONT
> but instead of URL as input it is the name of a URL as configured in Django. <FONT
COLOR="RED"
>django.core.urlresolvers.reverse()</FONT
> is called before it is added to the parent menu item.  <FONT
COLOR="RED"
>url_args</FONT
> and <FONT
COLOR="RED"
>url_kwargs</FONT
> are passed on to <FONT
COLOR="RED"
>reverse()</FONT
>. </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3246"
>10.2.4. Services</A
></H4
><DIV
CLASS="section"
><H5
CLASS="section"
><A
NAME="AEN3248"
>10.2.4.1. plinth.service.Service.__init__(self, service_id, name, ports=None, is_external=False, enabled=True)</A
></H5
><P
>Create a new Service object to notify all applications about the existence and status of a given application.  <FONT
COLOR="RED"
>service_id</FONT
> is a unique identifier for this application.  <FONT
COLOR="RED"
>name</FONT
> is a display name of this application that is shown by other applications such as on the firewall status page.  <FONT
COLOR="RED"
>ports</FONT
> is a list of names recognized by firewalld when enabling or disabling firewalld services.  If <FONT
COLOR="RED"
>is_external</FONT
> is true, the ports for this service are accessible from external interfaces, that is, from the Internet.  Otherwise, the service is only available for client connected via LAN.  <FONT
COLOR="RED"
>enabled</FONT
> is the current state of the application. </P
></DIV
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN3256"
>10.2.4.2. plinth.service.Service.is_enabled(self)</A
></H5
><P
>Return whether the service is currently enabled. </P
></DIV
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN3259"
>10.2.4.3. plinth.service.Service.notify_enabled(self, sender, enabled)</A
></H5
><P
>Notify other applications about the change of status of this application.  <FONT
COLOR="RED"
>sender</FONT
> object should identify which application made the change.  <FONT
COLOR="RED"
>enabled</FONT
> is a boolean that signifies whether the application is enabled (= True) or disabled (= False). </P
><P
>This is typically caught by the firewall application to enable or disable the ports corresponding to an application. </P
></DIV
></DIV
></DIV
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="AEN3265"
>11. Hacking</A
></H2
><P
>FreedomBox consists of three main projects: </P
><P
></P
><UL
><LI
><P
>Plinth, the web interface </P
></LI
><LI
><P
>FreedomBox Setup, the Debian package to perform initial setup and </P
></LI
><LI
><P
>Freedom Maker, a script to build disk images for various hardware </P
></LI
></UL
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN3275"
>11.1. Plinth</A
></H3
><P
>Plinth is a web interface to administer the functions of the FreedomBox. </P
><P
>Plinth is <A
HREF="https://www.gnu.org/philosophy/"
TARGET="_top"
>Free Software</A
> under <A
HREF="https://www.gnu.org/licenses/agpl.html"
TARGET="_top"
>GNU Affero General Public License</A
> version 3 or (at your option) a later version. </P
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3281"
>11.1.1. Using</A
></H4
><P
></P
><UL
><LI
><P
>Plinth comes installed with all FreedomBox images.  You can <A
HREF="https://wiki.debian.org/FreedomBox/Download#"
TARGET="_top"
>download</A
> FreedomBox images and run on any of the supported hardware. Then, you can access Plinth by visiting the URL <A
HREF="http://freedombox/plinth"
TARGET="_top"
>http://freedombox/plinth</A
>. </P
></LI
><LI
><P
>If you are on a Debian box, you may install Plinth from Debian package archive.  Currently, only Stretch (testing) and Sid (unstable) are supported.  To install Plinth run: </P
></LI
></UL
><PRE
CLASS="screen"
>$ sudo apt-get install plinth</PRE
><P
></P
><UL
><LI
><P
>You can also get Plinth from its <A
HREF="https://github.com/freedombox/Plinth"
TARGET="_top"
>Git repository</A
> and <A
HREF="https://github.com/freedombox/Plinth/blob/master/INSTALL"
TARGET="_top"
>install from source</A
>. </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3296"
>11.1.2. Screenshots</A
></H4
><P
>&#13;          <A
HREF="https://wiki.debian.org/FreedomBox/Plinth?action=AttachFile&#38;do=get&#38;target=about.png"
TARGET="_top"
>&#13;            <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/about.png"
WIDTH="150pt"></SPAN
>
          </A
>
          <A
HREF="https://wiki.debian.org/FreedomBox/Plinth?action=AttachFile&#38;do=get&#38;target=tor.png"
TARGET="_top"
>&#13;            <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/tor.png"
WIDTH="150pt"></SPAN
>
          </A
>
          <A
HREF="https://wiki.debian.org/FreedomBox/Plinth?action=AttachFile&#38;do=get&#38;target=owncloud.png"
TARGET="_top"
>&#13;            <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/owncloud.png"
WIDTH="150pt"></SPAN
>
          </A
>
          <A
HREF="https://wiki.debian.org/FreedomBox/Plinth?action=AttachFile&#38;do=get&#38;target=firewall.png"
TARGET="_top"
>&#13;            <SPAN
CLASS="inlinemediaobject"
><IMG
SRC="images/firewall.png"
WIDTH="150pt"></SPAN
>
          </A
>
        </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3323"
>11.1.3. Support</A
></H4
><P
>You may ask for support on </P
><P
></P
><UL
><LI
><P
>&#13;              <A
HREF="https://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss#"
TARGET="_top"
>The mailing list</A
>
            </P
></LI
><LI
><P
>&#13;              <A
HREF="irc://irc.debian.org/freedombox"
TARGET="_top"
>#freedombox IRC channel</A
>
            </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3333"
>11.1.4. Contributing</A
></H4
><P
>We are looking for help to improve Plinth.  You can contribute to Plinth by not just by coding but also by translating, documenting, designing, packaging and providing support. </P
><P
></P
><UL
><LI
><P
>Instructions on how to <A
HREF="https://wiki.debian.org/FreedomBox/Contribute/Code#"
TARGET="_top"
>contribute code</A
> are available. </P
></LI
><LI
><P
>The primary Git repository is hosted at <A
HREF="https://github.com/freedombox/Plinth"
TARGET="_top"
>FreedomBox GitHub Page</A
>. </P
></LI
><LI
><P
>Instructions for <A
HREF="https://github.com/freedombox/Plinth/blob/master/INSTALL"
TARGET="_top"
>installing from source</A
> and <A
HREF="https://github.com/freedombox/Plinth/blob/master/HACKING"
TARGET="_top"
>hacking the source</A
> are available. </P
></LI
><LI
><P
>List of bugs, TODO items and feature requests are available on the <A
HREF="https://github.com/freedombox/Plinth/issues"
TARGET="_top"
>issue tracker</A
>. </P
></LI
><LI
><P
>Before contributing to Plinth code, you need understand <A
HREF="https://www.python.org/"
TARGET="_top"
>Python</A
> and <A
HREF="https://www.djangoproject.com/"
TARGET="_top"
>Django</A
> on top which it is built. </P
></LI
><LI
><P
>You can request for development assistance on <A
HREF="https://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss#"
TARGET="_top"
>the mailing list</A
> or the <A
HREF="irc://irc.debian.org/freedombox"
TARGET="_top"
>#freedombox IRC channel</A
>. </P
></LI
></UL
><DIV
CLASS="section"
><HR><H5
CLASS="section"
><A
NAME="AEN3358"
>11.1.4.1. Debian Package</A
></H5
><P
></P
><UL
><LI
><P
>Plinth is <A
HREF="https://packages.debian.org/plinth#"
TARGET="_top"
>packaged</A
> for Debian. </P
></LI
><LI
><P
>Packaging project is on <A
HREF="https://alioth.debian.org/projects/freedombox#"
TARGET="_top"
>Alioth</A
> along with <A
HREF="https://anonscm.debian.org/cgit/freedombox/plinth.git#"
TARGET="_top"
>sources</A
>. </P
></LI
><LI
><P
>Issues related to packaging are listed on <A
HREF="https://bugs.debian.org/plinth#"
TARGET="_top"
>Debian BTS</A
>. </P
></LI
></UL
></DIV
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN3371"
>11.2. FreedomBox Setup</A
></H3
><P
>FreedomBox Setup is a Debian package for setting up the FreedomBox. If you <A
HREF="https://wiki.debian.org/FreedomBox/Download#"
TARGET="_top"
>download and use pre-built images</A
> you don't have to worry about this package. </P
><P
>FreedomBox Setup is responsible for setting up basic networking, web server, user accounts, installing essential packages etc.  It performs first part of the setup during the image build process.  Later, when the image is booted for the first time on actual hardware (or on a virtual machine), it does the remaining setup and then reboots the machine.  It also comes with a diagnostic script to check if the FreedomBox Setup is running as expected. </P
><P
>FreedomBox Setup is <A
HREF="https://www.gnu.org/philosophy/"
TARGET="_top"
>Free Software</A
> licensed under <A
HREF="https://www.gnu.org/licenses/gpl.html"
TARGET="_top"
>GNU General Public License</A
> version 3 or (at your option) a later version. </P
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3379"
>11.2.1. Using</A
></H4
><P
></P
><UL
><LI
><P
>FreedomBox Setup comes installed with all FreedomBox images.  You can <A
HREF="https://wiki.debian.org/FreedomBox/Download#"
TARGET="_top"
>download</A
> FreedomBox images and run on any of the supported hardware. </P
></LI
><LI
><P
>If you are on a Debian box, you may install FreedomBox Setup from Debian package archive.  This essentially turns your Debian installation into a FreedomBox!  Currently, only Sid (unstable) is supported.  To install FreedomBox Setup, see <A
HREF="https://wiki.debian.org/FreedomBox/Hardware/Debian#"
TARGET="_top"
>instructions</A
> on setting up FreedomBox on a Debian machine. </P
></LI
><LI
><P
>You can also get FreedomBox Setup from its <A
HREF="https://anonscm.debian.org/cgit/freedombox/freedombox-setup.git"
TARGET="_top"
>Git repository</A
> and <A
HREF="https://anonscm.debian.org/cgit/freedombox/freedombox-setup.git/tree/README"
TARGET="_top"
>build Debian package from source</A
>. </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3392"
>11.2.2. Support</A
></H4
><P
>You may ask for support on </P
><P
></P
><UL
><LI
><P
>&#13;              <A
HREF="http://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss"
TARGET="_top"
>The mailing list</A
>
            </P
></LI
><LI
><P
>&#13;              <A
HREF="irc://irc.debian.org/freedombox"
TARGET="_top"
>#freedombox IRC channel</A
>
            </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3402"
>11.2.3. Contributing</A
></H4
><P
>We are looking for help to improve FreedomBox Setup. </P
><P
></P
><UL
><LI
><P
>Instructions on how to <A
HREF="https://wiki.debian.org/FreedomBox/Contribute/Code#"
TARGET="_top"
>contribute code</A
> are available. </P
></LI
><LI
><P
>FreedomBox Setup is part of the <A
HREF="https://alioth.debian.org/projects/freedombox/"
TARGET="_top"
>FreedomBox Alioth Project</A
>. </P
></LI
><LI
><P
>List of bugs, TODO items, packages issues and feature requests are available on the <A
HREF="https://bugs.debian.org/cgi-bin/pkgreport.cgi?src=freedombox-setup"
TARGET="_top"
>issue tracker</A
>. </P
></LI
><LI
><P
>You can request for development assistance on <A
HREF="http://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss"
TARGET="_top"
>the mailing list</A
> or the <A
HREF="irc://irc.debian.org/freedombox"
TARGET="_top"
>#freedombox IRC channel</A
>. </P
></LI
><LI
><P
>See <A
HREF="https://tracker.debian.org/pkg/freedombox-setup"
TARGET="_top"
>Debian tracker</A
> for information on Debian package.  FreedomBox Setup is a Debian native package meaning it is primarily built for Debian and comes with Debian packaging scripts in its repository. </P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="AEN3422"
>11.3. Freedom Maker</A
></H3
><P
>Freedom Maker is a script to build FreedomBox disk images for use on various hardware devices or virtual machines. </P
><P
>Freedom Maker can currently build FreedomBox disk images for the following: </P
><P
></P
><UL
><LI
><P
>&#13;            <A
HREF="https://en.wikipedia.org/wiki/DreamPlug"
TARGET="_top"
>DreamPlug</A
>
          </P
></LI
><LI
><P
>&#13;            <A
HREF="https://en.wikipedia.org/wiki/Raspberry_Pi"
TARGET="_top"
>Raspberry Pi</A
>
          </P
></LI
><LI
><P
>&#13;            <A
HREF="https://en.wikipedia.org/wiki/BeagleBoard#BeagleBone"
TARGET="_top"
>BeagleBone</A
>
          </P
></LI
><LI
><P
><A
HREF="https://en.wikipedia.org/wiki/Cubieboard#Cubietruck_.28Cubieboard3.29"
TARGET="_top"
>Cubietruck</A
> (work in progress) </P
></LI
><LI
><P
>&#13;            <A
HREF="https://en.wikipedia.org/wiki/VirtualBox"
TARGET="_top"
>VirtualBox</A
>
          </P
></LI
><LI
><P
>Other virtual machines (using raw disk images) </P
></LI
></UL
><P
>It relies on the <A
HREF="http://liw.fi/vmdebootstrap/"
TARGET="_top"
>vmdebootstrap</A
> project actually create images.  If a hardware platform is capable of running Debian, it should not be too much effort adopt Freedom Maker to create <A
HREF="https://wiki.debian.org/FreedomBox#"
TARGET="_top"
>FreedomBox</A
> images for the platform. </P
><P
>Freedom Maker is <A
HREF="https://www.gnu.org/philosophy/"
TARGET="_top"
>Free Software</A
> licensed under <A
HREF="https://www.gnu.org/licenses/gpl.html"
TARGET="_top"
>GNU General Public License</A
> version 3 or (at your option) a later version. </P
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3450"
>11.3.1. Building FreedomBox Images</A
></H4
><P
></P
><UL
><LI
><P
>You can get Freedom Maker from its <A
HREF="https://alioth.debian.org/anonscm/git/freedombox/freedom-maker.git"
TARGET="_top"
>Git repository</A
> and follow the instructions in the README to <A
HREF="https://alioth.debian.org/plugins/scmgit/cgi-bin/gitweb.cgi?p=freedombox/freedom-maker.git;a=blob;f=README"
TARGET="_top"
>build a FreedomBox image</A
>. </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3457"
>11.3.2. Support</A
></H4
><P
>You may ask for support on </P
><P
></P
><UL
><LI
><P
>&#13;              <A
HREF="http://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss"
TARGET="_top"
>The mailing list</A
>
            </P
></LI
><LI
><P
>&#13;              <A
HREF="irc://irc.debian.org/freedombox"
TARGET="_top"
>#freedombox IRC channel</A
>
            </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="AEN3467"
>11.3.3. Contributing</A
></H4
><P
>We are looking for help to improve Freedom Maker. </P
><P
></P
><UL
><LI
><P
>Instructions on how to <A
HREF="https://wiki.debian.org/FreedomBox/Contribute/Code#"
TARGET="_top"
>contribute code</A
> are available. </P
></LI
><LI
><P
>Freedom Maker is hosted on <A
HREF="https://alioth.debian.org/projects/freedombox/"
TARGET="_top"
>FreedomBox Alioth Portal</A
>. The primary Git repository is hosted <A
HREF="https://alioth.debian.org/anonscm/git/freedombox/freedom-maker.git"
TARGET="_top"
>there</A
>. </P
></LI
><LI
><P
>Freedom Maker is also hosted on <A
HREF="https://github.com/freedombox/freedom-maker"
TARGET="_top"
>FreedomBox GitHub Page</A
>.  Pull requests are accepted there. </P
></LI
><LI
><P
>You can contribute to FreedomBox by adding support for more hardware platforms.  Freedom Maker can be easily adopted to newer platforms if they already support running Debian. </P
></LI
><LI
><P
>You can create and test images with Freedom Maker regularly to test for new features and check for regressions. </P
></LI
><LI
><P
>List of bugs, TODO items and feature requests are available on the <A
HREF="https://github.com/freedombox/freedom-maker/issues"
TARGET="_top"
>issue tracker</A
>. </P
></LI
><LI
><P
>You can request for development assistance on <A
HREF="http://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss"
TARGET="_top"
>the mailing list</A
> or the <A
HREF="irc://irc.debian.org/freedombox"
TARGET="_top"
>#freedombox IRC channel</A
>. </P
></LI
></UL
></DIV
></DIV
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="AEN3492"
>12. Other Resources: Manual Older Versions</A
></H2
><P
></P
><UL
><LI
><P
>&#13;          <A
HREF="https://wiki.debian.org/FreedomBox/Manual/0.3#"
TARGET="_top"
>0.3 Manual</A
>
        </P
></LI
><LI
><P
>&#13;          <A
HREF="https://wiki.debian.org/FreedomBox/Manual/Jessie#"
TARGET="_top"
>0.2 Manual</A
>
        </P
></LI
><LI
><P
>&#13;          <A
HREF="https://wiki.debian.org/FreedomBox/Manual/Jessie#"
TARGET="_top"
>Jessie Manual</A
>
        </P
></LI
></UL
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="AEN3504"
>13. Tell people around you</A
></H2
><P
></P
><UL
><LI
><P
>&#13;          <A
HREF="https://wiki.debian.org/FreedomBox/Press#"
TARGET="_top"
>FreedomBox in the Press</A
>
        </P
></LI
><LI
><P
>&#13;          <A
HREF="https://wiki.debian.org/FreedomBox/Conferences#"
TARGET="_top"
>Conferences</A
>
        </P
></LI
><LI
><P
>&#13;          <A
HREF="https://wiki.debian.org/FreedomBox/TalksAndPresentations#"
TARGET="_top"
>Talks and presentations</A
>
        </P
><P
></P
><UL
><LI
><P
><A
HREF="https://wiki.debian.org/FreedomBox/TalksAndPresentations/AvailableMaterial#"
TARGET="_top"
>Available Material</A
> Slides and other raw material </P
></LI
></UL
></LI
><LI
><P
>&#13;          <A
HREF="http://www.facebook.com/freedomboxfoundation"
TARGET="_top"
>Facebook</A
>
        </P
></LI
><LI
><P
>&#13;          <A
HREF="http://twitter.com/#!/FreedomBoxFndn"
TARGET="_top"
>Twitter</A
>
        </P
></LI
><LI
><P
>&#13;          <A
HREF="http://meetings-archive.debian.net/pub/debian-meetings/2011/debconf11/low/"
TARGET="_top"
>Debconf11 Videos</A
>
        </P
></LI
></UL
></DIV
></DIV
></BODY
></HTML
>
plinth 0.8.1-1 / usr / share / doc / plinth / freedombox-manual.html
