421 lines
12 KiB
HTML
421 lines
12 KiB
HTML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
|
|
<head>
|
|
<title></title>
|
|
<!-- 2015-03-02 Mon 13:47 -->
|
|
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
|
|
<meta name="generator" content="Org-mode" />
|
|
<meta name="author" content="Bob Mottram" />
|
|
<meta name="description" content="Turn the Beaglebone Black into a personal communications server"
|
|
/>
|
|
<meta name="keywords" content="freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber" />
|
|
<style type="text/css">
|
|
<!--/*--><![CDATA[/*><!--*/
|
|
.title { text-align: center; }
|
|
.todo { font-family: monospace; color: red; }
|
|
.done { color: green; }
|
|
.tag { background-color: #eee; font-family: monospace;
|
|
padding: 2px; font-size: 80%; font-weight: normal; }
|
|
.timestamp { color: #bebebe; }
|
|
.timestamp-kwd { color: #5f9ea0; }
|
|
.right { margin-left: auto; margin-right: 0px; text-align: right; }
|
|
.left { margin-left: 0px; margin-right: auto; text-align: left; }
|
|
.center { margin-left: auto; margin-right: auto; text-align: center; }
|
|
.underline { text-decoration: underline; }
|
|
#postamble p, #preamble p { font-size: 90%; margin: .2em; }
|
|
p.verse { margin-left: 3%; }
|
|
pre {
|
|
border: 1px solid #ccc;
|
|
box-shadow: 3px 3px 3px #eee;
|
|
padding: 8pt;
|
|
font-family: monospace;
|
|
overflow: auto;
|
|
margin: 1.2em;
|
|
}
|
|
pre.src {
|
|
position: relative;
|
|
overflow: visible;
|
|
padding-top: 1.2em;
|
|
}
|
|
pre.src:before {
|
|
display: none;
|
|
position: absolute;
|
|
background-color: white;
|
|
top: -10px;
|
|
right: 10px;
|
|
padding: 3px;
|
|
border: 1px solid black;
|
|
}
|
|
pre.src:hover:before { display: inline;}
|
|
pre.src-sh:before { content: 'sh'; }
|
|
pre.src-bash:before { content: 'sh'; }
|
|
pre.src-emacs-lisp:before { content: 'Emacs Lisp'; }
|
|
pre.src-R:before { content: 'R'; }
|
|
pre.src-perl:before { content: 'Perl'; }
|
|
pre.src-java:before { content: 'Java'; }
|
|
pre.src-sql:before { content: 'SQL'; }
|
|
|
|
table { border-collapse:collapse; }
|
|
caption.t-above { caption-side: top; }
|
|
caption.t-bottom { caption-side: bottom; }
|
|
td, th { vertical-align:top; }
|
|
th.right { text-align: center; }
|
|
th.left { text-align: center; }
|
|
th.center { text-align: center; }
|
|
td.right { text-align: right; }
|
|
td.left { text-align: left; }
|
|
td.center { text-align: center; }
|
|
dt { font-weight: bold; }
|
|
.footpara:nth-child(2) { display: inline; }
|
|
.footpara { display: block; }
|
|
.footdef { margin-bottom: 1em; }
|
|
.figure { padding: 1em; }
|
|
.figure p { text-align: center; }
|
|
.inlinetask {
|
|
padding: 10px;
|
|
border: 2px solid gray;
|
|
margin: 10px;
|
|
background: #ffffcc;
|
|
}
|
|
#org-div-home-and-up
|
|
{ text-align: right; font-size: 70%; white-space: nowrap; }
|
|
textarea { overflow-x: auto; }
|
|
.linenr { font-size: smaller }
|
|
.code-highlighted { background-color: #ffff00; }
|
|
.org-info-js_info-navigation { border-style: none; }
|
|
#org-info-js_console-label
|
|
{ font-size: 10px; font-weight: bold; white-space: nowrap; }
|
|
.org-info-js_search-highlight
|
|
{ background-color: #ffff00; color: #000000; font-weight: bold; }
|
|
/*]]>*/-->
|
|
</style>
|
|
<link rel="stylesheet" type="text/css"
|
|
href="http://sachachua.com/blog/wp-content/themes/sacha-v3/foundation/css/foundation.min.css"></link>
|
|
<link rel="stylesheet" type="text/css" href="http://sachachua.com/org-export.css"></link>
|
|
<link rel="stylesheet" type="text/css" href="http://sachachua.com/blog/wp-content/themes/sacha-v3/style.css"></link>
|
|
<script type="text/javascript">
|
|
/*
|
|
@licstart The following is the entire license notice for the
|
|
JavaScript code in this tag.
|
|
|
|
Copyright (C) 2012-2013 Free Software Foundation, Inc.
|
|
|
|
The JavaScript code in this tag is free software: you can
|
|
redistribute it and/or modify it under the terms of the GNU
|
|
General Public License (GNU GPL) as published by the Free Software
|
|
Foundation, either version 3 of the License, or (at your option)
|
|
any later version. The code is distributed WITHOUT ANY WARRANTY;
|
|
without even the implied warranty of MERCHANTABILITY or FITNESS
|
|
FOR A PARTICULAR PURPOSE. See the GNU GPL for more details.
|
|
|
|
As additional permission under GNU GPL version 3 section 7, you
|
|
may distribute non-source (e.g., minimized or compacted) forms of
|
|
that code without the copy of the GNU GPL normally required by
|
|
section 4, provided you include this license notice and a URL
|
|
through which recipients can access the Corresponding Source.
|
|
|
|
|
|
@licend The above is the entire license notice
|
|
for the JavaScript code in this tag.
|
|
*/
|
|
<!--/*--><![CDATA[/*><!--*/
|
|
function CodeHighlightOn(elem, id)
|
|
{
|
|
var target = document.getElementById(id);
|
|
if(null != target) {
|
|
elem.cacheClassElem = elem.className;
|
|
elem.cacheClassTarget = target.className;
|
|
target.className = "code-highlighted";
|
|
elem.className = "code-highlighted";
|
|
}
|
|
}
|
|
function CodeHighlightOff(elem, id)
|
|
{
|
|
var target = document.getElementById(id);
|
|
if(elem.cacheClassElem)
|
|
elem.className = elem.cacheClassElem;
|
|
if(elem.cacheClassTarget)
|
|
target.className = elem.cacheClassTarget;
|
|
}
|
|
/*]]>*///-->
|
|
</script>
|
|
</head>
|
|
<body>
|
|
<div id="preamble" class="status">
|
|
<a name="top" id="top"></a>
|
|
</div>
|
|
<div id="content">
|
|
<h1 class="title"></h1>
|
|
<div class="center">
|
|
|
|
<div class="figure">
|
|
<p><img src="./images/logo.png" alt="logo.png" />
|
|
</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="center">
|
|
<table border="-1" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
|
|
|
|
|
|
<colgroup>
|
|
<col class="left" />
|
|
</colgroup>
|
|
<tbody>
|
|
<tr>
|
|
<td class="left"><a href="index.html">Home</a></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="left"><a href="#unnumbered-1">Backup to USB</a></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="left"><a href="#unnumbered-2">Restore from USB</a></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="left"><a href="#unnumbered-3">Distributed backups</a></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="left"><a href="#unnumbered-4">Restore from a friend</a></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div id="outline-container-unnumbered-1" class="outline-2">
|
|
<h2 id="unnumbered-1">Backup to USB</h2>
|
|
<div class="outline-text-2" id="text-unnumbered-1">
|
|
<p>
|
|
Insert a USB thumb drive into the front socket of the Beaglebone Black.
|
|
</p>
|
|
|
|
<p>
|
|
Log into the system and become the root user, then run the <i>backup</i> command.
|
|
</p>
|
|
|
|
<div class="org-src-container">
|
|
|
|
<pre class="src src-bash">ssh username@domainname -p 2222
|
|
su
|
|
backup
|
|
</pre>
|
|
</div>
|
|
|
|
<p>
|
|
If this is the first time that you've made a backup then you will be prompted for your GPG key password.
|
|
</p>
|
|
|
|
<p>
|
|
When the backup ends remove the USB drive and keep it somewhere safe. Even if it gets lost or falls into the wrong hands the content is encrypted and so is unlikely to become a source of leaks.
|
|
</p>
|
|
</div>
|
|
</div>
|
|
<div id="outline-container-unnumbered-2" class="outline-2">
|
|
<h2 id="unnumbered-2">Restore from USB</h2>
|
|
<div class="outline-text-2" id="text-unnumbered-2">
|
|
<p>
|
|
Insert the USB thumb drive containing your backup into the front socket of the Beaglebone Black.
|
|
</p>
|
|
|
|
<p>
|
|
Log into the system and become the root user, then run the <i>restore</i> command.
|
|
</p>
|
|
|
|
<div class="org-src-container">
|
|
|
|
<pre class="src src-bash">ssh username@domainname -p 2222
|
|
su
|
|
restore
|
|
</pre>
|
|
</div>
|
|
|
|
<p>
|
|
You will be prompted to enter your GPG key password, then when the restore is complete you can remove the USB drive.
|
|
</p>
|
|
</div>
|
|
</div>
|
|
<div id="outline-container-unnumbered-3" class="outline-2">
|
|
<h2 id="unnumbered-3">Distributed backups</h2>
|
|
<div class="outline-text-2" id="text-unnumbered-3">
|
|
<p>
|
|
Distributed backups are a better way of ensuring the persistence of your data, such that even if your system gets stolen or destroyed then the data will still be recoverable from your friends. Since the backups are encrypted your friends (or anyone else with access to their systems) won't be able to read your backed up content even if their systems are subsequently compromised.
|
|
</p>
|
|
|
|
<p>
|
|
Firstly you will need to have a user account on one or more of your friends servers. They don't necessarily need to be using Freedombone, just some version of GNU/Linux with ssh access. They can create a user account for you with the <b>adduser <username></b> command when logged in as root and then give you the username and password via a secure method, such as on paper or via an encrypted email or via an XMPP chat using OTR. Make sure that the password used is a strong one - preferably a long random string stored in a password manager - so that dictionary attacks will fail. Also for maximum resilience put your password manager file onto a USB thumb drive and carry it with you.
|
|
</p>
|
|
|
|
<p>
|
|
To add friends servers create a file called <i>backup.list</i> in the following way.
|
|
</p>
|
|
|
|
<div class="org-src-container">
|
|
|
|
<pre class="src src-bash">ssh username@domainname -p 2222
|
|
emacs ~/backup.list
|
|
</pre>
|
|
</div>
|
|
|
|
<p>
|
|
Add entries like this. The numbers are the ssh port number to log in on.
|
|
</p>
|
|
|
|
<div class="org-src-container">
|
|
|
|
<pre class="src src-bash">username1@frienddomain1:2222//home/username1 ssh_password1
|
|
username2@frienddomain2:2222//home/username2 ssh_password2
|
|
...
|
|
</pre>
|
|
</div>
|
|
|
|
<p>
|
|
Save and exit with <b>CTRL-x CTRL-s</b> then <b>CTRL-x CTRL-c</b>, then type <b>exit</b>.
|
|
</p>
|
|
|
|
<p>
|
|
The system will try to backup to these remote locations once per day.
|
|
</p>
|
|
</div>
|
|
</div>
|
|
<div id="outline-container-unnumbered-4" class="outline-2">
|
|
<h2 id="unnumbered-4">Restore from a friend</h2>
|
|
<div class="outline-text-2" id="text-unnumbered-4">
|
|
</div><div id="outline-container-unnumbered-5" class="outline-3">
|
|
<h3 id="unnumbered-5">With a completely new Freedombone installation</h3>
|
|
<div class="outline-text-3" id="text-unnumbered-5">
|
|
<p>
|
|
This is the ultimate disaster recovery scenario in which you are beginning completely from scratch with new hardware and a new Freedombone installation. It is assumed that the old hardware was destroyed, but that you have the passwords stored within a password manager on a USB thumb drive.
|
|
</p>
|
|
|
|
<p>
|
|
First log in and create a new friends list:
|
|
</p>
|
|
|
|
<div class="org-src-container">
|
|
|
|
<pre class="src src-bash">ssh username@domainname -p 2222
|
|
emacs ~/backup.list
|
|
</pre>
|
|
</div>
|
|
|
|
<p>
|
|
Add entries like this. The numbers are the ssh port number to log in on.
|
|
</p>
|
|
|
|
<div class="org-src-container">
|
|
|
|
<pre class="src src-bash">username1@frienddomain1:2222//home/username1 ssh_password1
|
|
username2@frienddomain2:2222//home/username2 ssh_password2
|
|
...
|
|
</pre>
|
|
</div>
|
|
|
|
<p>
|
|
Save and exit with <b>CTRL-x CTRL-s</b> then <b>CTRL-x CTRL-c</b>.
|
|
</p>
|
|
|
|
<p>
|
|
Now log in as root and edit the restore script.
|
|
</p>
|
|
|
|
<div class="org-src-container">
|
|
|
|
<pre class="src src-bash">su
|
|
emacs /usr/bin/restorefromfriend
|
|
</pre>
|
|
</div>
|
|
|
|
<p>
|
|
Recover your backup password from your password manager and set the PASSPHRASE variable accordingly.
|
|
</p>
|
|
|
|
<p>
|
|
Save and exit with <b>CTRL-x CTRL-s</b> and <b>CTRL-x CTRL-c</b>.
|
|
</p>
|
|
|
|
<p>
|
|
Then use the command:
|
|
</p>
|
|
|
|
<div class="org-src-container">
|
|
|
|
<pre class="src src-bash">restorefromfriend <friends server domain name>
|
|
</pre>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div id="outline-container-unnumbered-6" class="outline-3">
|
|
<h3 id="unnumbered-6">On an existing Freedombone installation</h3>
|
|
<div class="outline-text-3" id="text-unnumbered-6">
|
|
<p>
|
|
This is for more common situations in which maybe some data became corrupted and you want to restore it.
|
|
</p>
|
|
|
|
<p>
|
|
Log in as root:
|
|
</p>
|
|
|
|
<div class="org-src-container">
|
|
|
|
<pre class="src src-bash">ssh username@domainname -p 2222
|
|
su
|
|
</pre>
|
|
</div>
|
|
|
|
<p>
|
|
Then use the command:
|
|
</p>
|
|
|
|
<div class="org-src-container">
|
|
|
|
<pre class="src src-bash">restorefromfriend <friends server domain name>
|
|
</pre>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div id="postamble" class="status">
|
|
|
|
<style type="text/css">
|
|
.back-to-top {
|
|
position: fixed;
|
|
bottom: 2em;
|
|
right: 0px;
|
|
text-decoration: none;
|
|
color: #000000;
|
|
background-color: rgba(235, 235, 235, 0.80);
|
|
font-size: 12px;
|
|
padding: 1em;
|
|
display: none;
|
|
}
|
|
|
|
.back-to-top:hover {
|
|
background-color: rgba(135, 135, 135, 0.50);
|
|
}
|
|
</style>
|
|
|
|
<div class="back-to-top">
|
|
<a href="#top">Back to top</a> | <a href="mailto:bob@robotics.uk.to">E-mail me</a>
|
|
</div>
|
|
|
|
<script type="text/javascript">
|
|
var offset = 220;
|
|
var duration = 500;
|
|
jQuery(window).scroll(function() {
|
|
if (jQuery(this).scrollTop() > offset) {
|
|
jQuery('.back-to-top').fadeIn(duration);
|
|
} else {
|
|
jQuery('.back-to-top').fadeOut(duration);
|
|
}
|
|
});
|
|
</script>
|
|
</div>
|
|
</body>
|
|
</html>
|