freedomboneeee/website/EN/app_syncthing.html

309 lines
12 KiB
HTML
Raw Normal View History

2016-11-12 19:00:38 +01:00
<?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>
2018-05-24 14:41:14 +02:00
<!-- 2018-05-24 Thu 13:40 -->
2018-04-12 14:01:49 +02:00
<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="How to use Syncthing"
2016-11-12 19:00:38 +01:00
/>
2018-04-12 14:01:49 +02:00
<meta name="keywords" content="freedombone, file sync" />
2016-11-12 19:00:38 +01:00
<style type="text/css">
<!--/*--><![CDATA[/*><!--*/
2018-04-12 14:01:49 +02:00
.title { text-align: center; }
2016-11-12 19:00:38 +01:00
.todo { font-family: monospace; color: red; }
2018-04-12 14:01:49 +02:00
.done { color: green; }
2016-11-12 19:00:38 +01:00
.tag { background-color: #eee; font-family: monospace;
padding: 2px; font-size: 80%; font-weight: normal; }
.timestamp { color: #bebebe; }
.timestamp-kwd { color: #5f9ea0; }
2018-04-12 14:01:49 +02:00
.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; }
2016-11-12 19:00:38 +01:00
.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;}
2018-04-12 14:01:49 +02:00
pre.src-sh:before { content: 'sh'; }
pre.src-bash:before { content: 'sh'; }
2016-11-12 19:00:38 +01:00
pre.src-emacs-lisp:before { content: 'Emacs Lisp'; }
2018-04-12 14:01:49 +02:00
pre.src-R:before { content: 'R'; }
pre.src-perl:before { content: 'Perl'; }
pre.src-java:before { content: 'Java'; }
pre.src-sql:before { content: 'SQL'; }
2016-11-12 19:00:38 +01:00
table { border-collapse:collapse; }
caption.t-above { caption-side: top; }
caption.t-bottom { caption-side: bottom; }
td, th { vertical-align:top; }
2018-04-12 14:01:49 +02:00
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; }
2016-11-12 19:00:38 +01:00
dt { font-weight: bold; }
2018-04-12 14:01:49 +02:00
.footpara:nth-child(2) { display: inline; }
.footpara { display: block; }
2016-11-12 19:00:38 +01:00
.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="freedombone.css" />
<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">
2018-04-12 14:01:49 +02:00
<h1 class="title"></h1>
2016-11-12 19:00:38 +01:00
<div class="figure">
2018-04-12 14:01:49 +02:00
<p><img src="images/logo.png" alt="logo.png" width="80%" height="10%" align="center" />
2016-11-12 19:00:38 +01:00
</p>
</div>
2018-04-12 14:01:49 +02:00
<div id="outline-container-sec-1" class="outline-2">
<h2 id="sec-1">Syncthing</h2>
<div class="outline-text-2" id="text-1">
2016-11-12 19:00:38 +01:00
<p>
Syncthing provides a similar capability to proprietary systems such as Dropbox, and also is well suited for use with low power single board computers. You can have one or more directories which are synchronized across your various laptops/desktops/devices, and this makes it hard for you to ever lose important files. The manner in which the synchronization is done is pretty secure, such that it would be difficult for passive adversaries (mass surveillance, "<i>men in the middle</i>", etc) to know what files you're sharing. Of course, you don't necessarily need to be running a server in order to use Syncthing, but if you do have a server which is always running then there's always at least one place to synchronize your files to or from.
</p>
<p>
Freedombone provides Syncthing shared directories for each user on the system, plus a single shared directory for all users. The expected most common scenario here is that of a family in which members may not want to share <i>all of their files</i> with each other, but might want to share some in a common pool (eg. birthday photos). You can also easily share between different servers.
</p>
2018-04-12 14:01:49 +02:00
</div>
</div>
2016-11-12 19:00:38 +01:00
2018-04-12 14:01:49 +02:00
<div id="outline-container-sec-2" class="outline-2">
<h2 id="sec-2">On a laptop</h2>
<div class="outline-text-2" id="text-2">
2016-11-12 19:00:38 +01:00
<p>
Install syncthing on a Debian based distro:
</p>
<div class="org-src-container">
2018-04-12 14:01:49 +02:00
2016-11-12 19:00:38 +01:00
<pre class="src src-bash">curl -s https://syncthing.net/release-key.txt | sudo apt-key add -
2018-04-12 14:01:49 +02:00
echo "deb http://apt.syncthing.net/ syncthing release" | sudo tee /etc/apt/sources.list.d/syncthing.list
2016-11-12 19:00:38 +01:00
sudo apt-get update
sudo apt-get install syncthing
</pre>
</div>
<p>
Or on Arch/Parabola:
</p>
<div class="org-src-container">
2018-04-12 14:01:49 +02:00
2016-11-12 19:00:38 +01:00
<pre class="src src-bash">sudo pacman -S syncthing
</pre>
</div>
<p>
Add syncthing to your startup applications, so that it begins running when your system starts. Then either restart your system or run the command "syncthing" from a terminal.
</p>
<p>
In another terminal log into Freedombone:
</p>
<div class="org-src-container">
2018-04-12 14:01:49 +02:00
2016-11-12 19:00:38 +01:00
<pre class="src src-bash">ssh username@domainname -p 2222
</pre>
</div>
<p>
2018-05-24 13:59:48 +02:00
Then select <b>Run an App</b> and <b>syncthing</b>.
2016-11-12 19:00:38 +01:00
</p>
<div class="figure">
2018-04-12 14:01:49 +02:00
<p><img src="images/controlpanel/control_panel_file_sync.jpg" alt="control_panel_file_sync.jpg" width="80%" align="center" />
2016-11-12 19:00:38 +01:00
</p>
</div>
<p>
Select <b>Show device ID</b> and copy the long string of letters and numbers shown, using the shift key then select the text followed by right click then select copy.
</p>
<p>
Open a non-Tor browser and enter <b><a href="http://127.0.0.1:8384">http://127.0.0.1:8384</a></b> as the URL. You should now see the minimalistic user interface. Under <b>Remote Devices</b> select <b>Add Remote Device</b>. In the <b>Device ID</b> field paste the string you just copied (CTRL+v). The Device name can be anything. Under <b>Share Folders with Device</b> check <b>default</b> (or whatever folder you created on your local machine), then save.
</p>
<div class="figure">
2018-04-12 14:01:49 +02:00
<p><img src="images/syncthing_browser.jpg" alt="syncthing_browser.jpg" width="50%" align="center" />
2016-11-12 19:00:38 +01:00
</p>
</div>
<p>
From the top menu select <b>Actions</b> and then <b>Show ID</b>, then copy the ID string (usually select then CTRL+c). Go back to the terminal control panel menu and select <b>Add an ID</b> then paste what you just copied (CTRL+v). Optionally you can also provide a description so that you later can know what that string corresponds to.
</p>
<p>
Now wait for a few minutes. Eventually you will see two messages appear within the browser asking if you want to add two new folders from the Freedombone server. Say yes to both, and specify <b>~/Sync</b> as the directory with your username and <b>~/SyncShared</b> as the shared directory. You can now copy files into your <b>~/Sync</b> directory and they will automatically be synced to the server. Those will be files which only you can access. If you copy files into <b>~/SyncShared</b> then they will also be available to any other users on the system.
</p>
</div>
</div>
2018-04-12 14:01:49 +02:00
<div id="outline-container-sec-3" class="outline-2">
2018-05-24 14:41:14 +02:00
<h2 id="sec-3">Desktop app</h2>
2018-04-12 14:01:49 +02:00
<div class="outline-text-2" id="text-3">
2016-11-12 19:00:38 +01:00
<p>
2018-05-24 14:41:14 +02:00
If you're running Arch/Parabola there is a package called <a href="https://github.com/syncthing/syncthing-gtk">syncthing-gtk</a> which provides a GTK GUI and an icon indicating whether synchronization is happening. This can be more convenient than using the browser interface.
</p>
</div>
</div>
<div id="outline-container-sec-4" class="outline-2">
<h2 id="sec-4">On Android</h2>
<div class="outline-text-2" id="text-4">
<p>
2016-11-12 19:00:38 +01:00
Install Syncthing and Connectbot from F-droid.
</p>
<p>
Set up Connectbot to log into Freedombone.
</p>
<p>
Select <b>File Synchronization</b>.
</p>
<p>
Select <b>Show device ID</b> and copy the long string of letters by pressing anywhere on the screen, selecting the <b>menu</b> then <b>copy</b> and then selecting the ID string. This is very tricky on a small screen, so expect to fail multiple times before you succeed in copying the text.
</p>
<p>
Open Syncthing and select the devices tab. Press on <b>+</b> and then paste the device ID with a long press followed by <b>Paste</b>. You may need to remove any stray characters which were copied during the previous haphazard selection process. Add a name, which can be anything.
</p>
<p>
Now select the menu (top left or menu button) and then press on <b>Device ID</b>. It will be copied to the clipboard. Go back to Connectbot and from the control panel select <b>File Synchronization</b> followed by <b>Add an ID</b>. You can then paste in the ID with a long press, and optionally add a description for the device. When that's done you can disconnect from Connectbot.
</p>
<p>
Now wait for a few minutes or more. Eventually you should receive two notifications (swipe down from the top to see them) which will allow you to confirm the connection to the server. Say yes to both, and specify appropriate directories for your files and the shared files. To reduce battery and data usage via the settings you can also set Syncthing to only sync while it's charging and only while it's connected to wifi.
</p>
</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@freedombone.net">E-mail me</a>
</div>
</div>
</body>
</html>