release31.html 15KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376
  1. <?xml version="1.0" encoding="utf-8"?>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
  3. "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
  4. <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
  5. <head>
  6. <!-- 2018-05-10 Thu 11:49 -->
  7. <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
  8. <meta name="viewport" content="width=device-width, initial-scale=1" />
  9. <title>&lrm;</title>
  10. <meta name="generator" content="Org mode" />
  11. <meta name="author" content="Bob Mottram" />
  12. <meta name="description" content="Version 3.1"
  13. />
  14. <meta name="keywords" content="freedombone" />
  15. <style type="text/css">
  16. <!--/*--><![CDATA[/*><!--*/
  17. .title { text-align: center;
  18. margin-bottom: .2em; }
  19. .subtitle { text-align: center;
  20. font-size: medium;
  21. font-weight: bold;
  22. margin-top:0; }
  23. .todo { font-family: monospace; color: red; }
  24. .done { font-family: monospace; color: green; }
  25. .priority { font-family: monospace; color: orange; }
  26. .tag { background-color: #eee; font-family: monospace;
  27. padding: 2px; font-size: 80%; font-weight: normal; }
  28. .timestamp { color: #bebebe; }
  29. .timestamp-kwd { color: #5f9ea0; }
  30. .org-right { margin-left: auto; margin-right: 0px; text-align: right; }
  31. .org-left { margin-left: 0px; margin-right: auto; text-align: left; }
  32. .org-center { margin-left: auto; margin-right: auto; text-align: center; }
  33. .underline { text-decoration: underline; }
  34. #postamble p, #preamble p { font-size: 90%; margin: .2em; }
  35. p.verse { margin-left: 3%; }
  36. pre {
  37. border: 1px solid #ccc;
  38. box-shadow: 3px 3px 3px #eee;
  39. padding: 8pt;
  40. font-family: monospace;
  41. overflow: auto;
  42. margin: 1.2em;
  43. }
  44. pre.src {
  45. position: relative;
  46. overflow: visible;
  47. padding-top: 1.2em;
  48. }
  49. pre.src:before {
  50. display: none;
  51. position: absolute;
  52. background-color: white;
  53. top: -10px;
  54. right: 10px;
  55. padding: 3px;
  56. border: 1px solid black;
  57. }
  58. pre.src:hover:before { display: inline;}
  59. /* Languages per Org manual */
  60. pre.src-asymptote:before { content: 'Asymptote'; }
  61. pre.src-awk:before { content: 'Awk'; }
  62. pre.src-C:before { content: 'C'; }
  63. /* pre.src-C++ doesn't work in CSS */
  64. pre.src-clojure:before { content: 'Clojure'; }
  65. pre.src-css:before { content: 'CSS'; }
  66. pre.src-D:before { content: 'D'; }
  67. pre.src-ditaa:before { content: 'ditaa'; }
  68. pre.src-dot:before { content: 'Graphviz'; }
  69. pre.src-calc:before { content: 'Emacs Calc'; }
  70. pre.src-emacs-lisp:before { content: 'Emacs Lisp'; }
  71. pre.src-fortran:before { content: 'Fortran'; }
  72. pre.src-gnuplot:before { content: 'gnuplot'; }
  73. pre.src-haskell:before { content: 'Haskell'; }
  74. pre.src-hledger:before { content: 'hledger'; }
  75. pre.src-java:before { content: 'Java'; }
  76. pre.src-js:before { content: 'Javascript'; }
  77. pre.src-latex:before { content: 'LaTeX'; }
  78. pre.src-ledger:before { content: 'Ledger'; }
  79. pre.src-lisp:before { content: 'Lisp'; }
  80. pre.src-lilypond:before { content: 'Lilypond'; }
  81. pre.src-lua:before { content: 'Lua'; }
  82. pre.src-matlab:before { content: 'MATLAB'; }
  83. pre.src-mscgen:before { content: 'Mscgen'; }
  84. pre.src-ocaml:before { content: 'Objective Caml'; }
  85. pre.src-octave:before { content: 'Octave'; }
  86. pre.src-org:before { content: 'Org mode'; }
  87. pre.src-oz:before { content: 'OZ'; }
  88. pre.src-plantuml:before { content: 'Plantuml'; }
  89. pre.src-processing:before { content: 'Processing.js'; }
  90. pre.src-python:before { content: 'Python'; }
  91. pre.src-R:before { content: 'R'; }
  92. pre.src-ruby:before { content: 'Ruby'; }
  93. pre.src-sass:before { content: 'Sass'; }
  94. pre.src-scheme:before { content: 'Scheme'; }
  95. pre.src-screen:before { content: 'Gnu Screen'; }
  96. pre.src-sed:before { content: 'Sed'; }
  97. pre.src-sh:before { content: 'shell'; }
  98. pre.src-sql:before { content: 'SQL'; }
  99. pre.src-sqlite:before { content: 'SQLite'; }
  100. /* additional languages in org.el's org-babel-load-languages alist */
  101. pre.src-forth:before { content: 'Forth'; }
  102. pre.src-io:before { content: 'IO'; }
  103. pre.src-J:before { content: 'J'; }
  104. pre.src-makefile:before { content: 'Makefile'; }
  105. pre.src-maxima:before { content: 'Maxima'; }
  106. pre.src-perl:before { content: 'Perl'; }
  107. pre.src-picolisp:before { content: 'Pico Lisp'; }
  108. pre.src-scala:before { content: 'Scala'; }
  109. pre.src-shell:before { content: 'Shell Script'; }
  110. pre.src-ebnf2ps:before { content: 'ebfn2ps'; }
  111. /* additional language identifiers per "defun org-babel-execute"
  112. in ob-*.el */
  113. pre.src-cpp:before { content: 'C++'; }
  114. pre.src-abc:before { content: 'ABC'; }
  115. pre.src-coq:before { content: 'Coq'; }
  116. pre.src-groovy:before { content: 'Groovy'; }
  117. /* additional language identifiers from org-babel-shell-names in
  118. ob-shell.el: ob-shell is the only babel language using a lambda to put
  119. the execution function name together. */
  120. pre.src-bash:before { content: 'bash'; }
  121. pre.src-csh:before { content: 'csh'; }
  122. pre.src-ash:before { content: 'ash'; }
  123. pre.src-dash:before { content: 'dash'; }
  124. pre.src-ksh:before { content: 'ksh'; }
  125. pre.src-mksh:before { content: 'mksh'; }
  126. pre.src-posh:before { content: 'posh'; }
  127. /* Additional Emacs modes also supported by the LaTeX listings package */
  128. pre.src-ada:before { content: 'Ada'; }
  129. pre.src-asm:before { content: 'Assembler'; }
  130. pre.src-caml:before { content: 'Caml'; }
  131. pre.src-delphi:before { content: 'Delphi'; }
  132. pre.src-html:before { content: 'HTML'; }
  133. pre.src-idl:before { content: 'IDL'; }
  134. pre.src-mercury:before { content: 'Mercury'; }
  135. pre.src-metapost:before { content: 'MetaPost'; }
  136. pre.src-modula-2:before { content: 'Modula-2'; }
  137. pre.src-pascal:before { content: 'Pascal'; }
  138. pre.src-ps:before { content: 'PostScript'; }
  139. pre.src-prolog:before { content: 'Prolog'; }
  140. pre.src-simula:before { content: 'Simula'; }
  141. pre.src-tcl:before { content: 'tcl'; }
  142. pre.src-tex:before { content: 'TeX'; }
  143. pre.src-plain-tex:before { content: 'Plain TeX'; }
  144. pre.src-verilog:before { content: 'Verilog'; }
  145. pre.src-vhdl:before { content: 'VHDL'; }
  146. pre.src-xml:before { content: 'XML'; }
  147. pre.src-nxml:before { content: 'XML'; }
  148. /* add a generic configuration mode; LaTeX export needs an additional
  149. (add-to-list 'org-latex-listings-langs '(conf " ")) in .emacs */
  150. pre.src-conf:before { content: 'Configuration File'; }
  151. table { border-collapse:collapse; }
  152. caption.t-above { caption-side: top; }
  153. caption.t-bottom { caption-side: bottom; }
  154. td, th { vertical-align:top; }
  155. th.org-right { text-align: center; }
  156. th.org-left { text-align: center; }
  157. th.org-center { text-align: center; }
  158. td.org-right { text-align: right; }
  159. td.org-left { text-align: left; }
  160. td.org-center { text-align: center; }
  161. dt { font-weight: bold; }
  162. .footpara { display: inline; }
  163. .footdef { margin-bottom: 1em; }
  164. .figure { padding: 1em; }
  165. .figure p { text-align: center; }
  166. .inlinetask {
  167. padding: 10px;
  168. border: 2px solid gray;
  169. margin: 10px;
  170. background: #ffffcc;
  171. }
  172. #org-div-home-and-up
  173. { text-align: right; font-size: 70%; white-space: nowrap; }
  174. textarea { overflow-x: auto; }
  175. .linenr { font-size: smaller }
  176. .code-highlighted { background-color: #ffff00; }
  177. .org-info-js_info-navigation { border-style: none; }
  178. #org-info-js_console-label
  179. { font-size: 10px; font-weight: bold; white-space: nowrap; }
  180. .org-info-js_search-highlight
  181. { background-color: #ffff00; color: #000000; font-weight: bold; }
  182. .org-svg { width: 90%; }
  183. /*]]>*/-->
  184. </style>
  185. <link rel="stylesheet" type="text/css" href="freedombone.css" />
  186. <script type="text/javascript">
  187. /*
  188. @licstart The following is the entire license notice for the
  189. JavaScript code in this tag.
  190. Copyright (C) 2012-2017 Free Software Foundation, Inc.
  191. The JavaScript code in this tag is free software: you can
  192. redistribute it and/or modify it under the terms of the GNU
  193. General Public License (GNU GPL) as published by the Free Software
  194. Foundation, either version 3 of the License, or (at your option)
  195. any later version. The code is distributed WITHOUT ANY WARRANTY;
  196. without even the implied warranty of MERCHANTABILITY or FITNESS
  197. FOR A PARTICULAR PURPOSE. See the GNU GPL for more details.
  198. As additional permission under GNU GPL version 3 section 7, you
  199. may distribute non-source (e.g., minimized or compacted) forms of
  200. that code without the copy of the GNU GPL normally required by
  201. section 4, provided you include this license notice and a URL
  202. through which recipients can access the Corresponding Source.
  203. @licend The above is the entire license notice
  204. for the JavaScript code in this tag.
  205. */
  206. <!--/*--><![CDATA[/*><!--*/
  207. function CodeHighlightOn(elem, id)
  208. {
  209. var target = document.getElementById(id);
  210. if(null != target) {
  211. elem.cacheClassElem = elem.className;
  212. elem.cacheClassTarget = target.className;
  213. target.className = "code-highlighted";
  214. elem.className = "code-highlighted";
  215. }
  216. }
  217. function CodeHighlightOff(elem, id)
  218. {
  219. var target = document.getElementById(id);
  220. if(elem.cacheClassElem)
  221. elem.className = elem.cacheClassElem;
  222. if(elem.cacheClassTarget)
  223. target.className = elem.cacheClassTarget;
  224. }
  225. /*]]>*///-->
  226. </script>
  227. </head>
  228. <body>
  229. <div id="preamble" class="status">
  230. <a name="top" id="top"></a>
  231. </div>
  232. <div id="content">
  233. <div class="figure">
  234. <p><img src="images/logo.png" alt="logo.png" width="80%" height="10%" align="center" />
  235. </p>
  236. </div>
  237. <div id="outline-container-org91557ca" class="outline-2">
  238. <h2 id="org91557ca"><b>Version 3.1, 2018-04-15</b></h2>
  239. <div class="outline-text-2" id="text-org91557ca">
  240. <p>
  241. Newer and shinier than before, <a href="./index.html">Freedombone</a> 3.1 rests upon the solid foundation of Debian stable and delivers major new self-hosted apps, improved mesh networking and a new logo. It supports version 3 onion addresses and the ability to use <a href="./usage_email.html">email with onion and I2P addresses</a>. New apps are:
  242. </p>
  243. <ul class="org-ul">
  244. <li><a href="./app_akaunting.html">Akaunting</a>: Personal or small business accounts</li>
  245. <li><a href="./app_bdsmail.html">bdsmail</a>: Avoid PGP complexity by using email over I2P</li>
  246. <li><a href="./app_bludit.html">Bludit</a>: Painless markdown blogging</li>
  247. <li><a href="./app_edith.html">Edith</a>: The simplest possible note taking system</li>
  248. <li><a href="./app_icecast.html">Icecast</a>: Run your own internet radio station</li>
  249. <li><a href="./app_peertube.html">PeerTube</a>: Peer-to-peer video hosting system</li>
  250. <li><a href="./app_pleroma.html">Pleroma</a>: Ultra lightweight fediverse instance with Mastodon compatibility</li>
  251. </ul>
  252. <p>
  253. The <a href="./mesh.html">mesh version</a> now supports BMX6, OLSR2 and Babel routing protocols on layer 3 and so is protocol compatible with <a href="https://libremesh.org">LibreMesh</a>. It also now runs on pure IPv6 and has built in video editor and CryptPad integration for networked collaboration even during times when the internet is not available.
  254. </p>
  255. <p>
  256. There is a new <a href="./socialinstance.html">social instance</a> image build option, if you want to be able to rapidly deploy fediverse instances, and a <a href="./devguide.html">template command</a> for quickly adding new apps to the system which automates a lot of the boilerplate.
  257. </p>
  258. <p>
  259. According to some narratives the open web is dying with the silo companies comprising 80% of web traffic and what remains being pushed into an increasingly marginal corner. But at the same time these colonial occupiers have come under renewed <a href="https://www.wired.co.uk/article/open-letter-mark-zuckerberg-congress">public criticism</a> as they continue to abuse their monopoly powers in ever more egregious ways. 2017 seemed to be a turning point in attitudes towards Silicon Valley generally and there is room for a new kind of movement to get started which is about reclaiming the internet for the common good.
  260. </p>
  261. <p>
  262. This is where we make our stand. If the internet falls then so too does freedom.
  263. </p>
  264. <p>
  265. The future is decentralized.
  266. </p>
  267. </div>
  268. </div>
  269. <div id="outline-container-org8bab5d6" class="outline-2">
  270. <h2 id="org8bab5d6">Installation</h2>
  271. <div class="outline-text-2" id="text-org8bab5d6">
  272. <p>
  273. The simplest way to install is from a pre-made disk image. Images can be <a href="https://freedombone.net/downloads/v31">downloaded here</a>. You will need to have previously obtained a domain name and have a dynamic DNS account somewhere. Or if you don't need clearnet domains and will be using Tor compatible browsers then you can use the "onion only" images where apps will be accessible via an onion address.
  274. </p>
  275. <p>
  276. Copy the image to a microSD card or USB thumb drive, replacing sdX with the identifier of the USB thumb drive. Don't include any numbers (so for example use sdc instead of sdc1).
  277. </p>
  278. <div class="org-src-container">
  279. <pre class="src src-bash">unxz downloadedimagefile.img.xz
  280. dd <span class="org-variable-name">bs</span>=32M <span class="org-variable-name">if</span>=downloadedimagefile.img <span class="org-variable-name">of</span>=/dev/sdX <span class="org-variable-name">conv</span>=fdatasync,sync,noerror
  281. </pre>
  282. </div>
  283. <p>
  284. And wait. It will take a while to copy over. When that's done you might want to increase the partition size on the drive, using a tool such as <a href="http://gparted.org">Gparted</a>. Whether you need to do that will depend upon how many apps you intend to install and how much data they will store.
  285. </p>
  286. <p>
  287. Plug the microSD or USB drive into the target hardware which you want to use as a server and power on. If you're using an old laptop or netbook as the server then you will need to set the BIOS to boot from USB.
  288. </p>
  289. <p>
  290. As the system boots for the first time the login is:
  291. </p>
  292. <div class="org-src-container">
  293. <pre class="src src-bash">username: fbone
  294. password: freedombone
  295. </pre>
  296. </div>
  297. <p>
  298. If you're installing from a microSD card on a single board computer without a screen and keyboard attached then you can ssh into it with:
  299. </p>
  300. <div class="org-src-container">
  301. <pre class="src src-bash">ssh fbone@freedombone.local -p 2222
  302. </pre>
  303. </div>
  304. <p>
  305. Using the initial password "freedombone". If you have trouble accessing the server then make sure you have Avahi installed and <a href="https://en.wikipedia.org/wiki/Multicast_DNS">mDNS</a> enabled.
  306. </p>
  307. <p>
  308. You will then be shown a new randomly generated password. It's very important that you write this down somewhere or transfer it to a password manager before going further, because you'll need this to log in later.
  309. </p>
  310. <p>
  311. More detailed installation instructions are linked from <a href="./installmethods.html">the main site</a>.
  312. </p>
  313. </div>
  314. </div>
  315. <div id="outline-container-org2293b57" class="outline-2">
  316. <h2 id="org2293b57">Upgrading from a previous install</h2>
  317. <div class="outline-text-2" id="text-org2293b57">
  318. <p>
  319. To upgrade from version 3 just go to the <b>administrator control panel</b> and select <b>check for updates</b>.
  320. </p>
  321. </div>
  322. </div>
  323. </div>
  324. <div id="postamble" class="status">
  325. <style type="text/css">
  326. .back-to-top {
  327. position: fixed;
  328. bottom: 2em;
  329. right: 0px;
  330. text-decoration: none;
  331. color: #000000;
  332. background-color: rgba(235, 235, 235, 0.80);
  333. font-size: 12px;
  334. padding: 1em;
  335. display: none;
  336. }
  337. .back-to-top:hover {
  338. background-color: rgba(135, 135, 135, 0.50);
  339. }
  340. </style>
  341. <div class="back-to-top">
  342. <a href="#top">Back to top</a> | <a href="mailto:bob@freedombone.net">E-mail me</a>
  343. </div>
  344. </div>
  345. </body>
  346. </html>