Update documentation for syncthing, removing owncloud

This commit is contained in:
Bob Mottram 2016-04-10 12:14:06 +01:00
parent 60220b6604
commit 7934940bdc
3710 changed files with 847 additions and 3325 deletions

View File

@ -7,6 +7,8 @@ all:
debug:
translations:
bash -c "./translate make"
rmtranslations:
bash -c "./translate remove"
alltranslations:
bash -c "./translate translations"
source:

View File

@ -38,7 +38,7 @@ The following projects made Freedombone possible.<br>
<tr>
<td><center><a href="https://www.torproject.org">Tor</a></center></td>
<td><center><a href="https://prosody.im">Prosody</a></center></td>
<td><center><a href="https://owncloud.org">Owncloud</a></center></td>
<td><center><a href="https://syncthing.net">Syncthing</a></center></td>
</tr>
<tr>
<td><center><a href="https://tox.chat/">Tox</a></center></td>

View File

@ -87,30 +87,9 @@ ssh username@address.onion -p 2222
Subsequently even if dynamic DNS isn't working you may still be able to administer your system. Using the onion address also gives you some degree of protection against corporate or government metadata analysis, since it becomes more difficult to passively detect which systems are communicating.
* Syncing to the Cloud
Owncloud provides an easy way to sync files across multiple systems (desktop, laptop and mobile), and is a good way to wean people off of the proprietary systems such as [[http://www.drop-dropbox.com/][Dropbox]]. Unlike "/the cloud/" which computing industry pundits often go on about, this is a cloud /which you control/ and where your data resides within your own home.
[[https://syncthing.net][Syncthing]] provides a similar capability to proprietary systems such as [[http://www.drop-dropbox.com/][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, "/men in the middle/", 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.
Via additional apps with a single click install process it can also do many other things, such as acting as a jukebox or a collaborative document editing system. Owncloud servers can [[https://www.youtube.com/watch?v=b1F-N3QXN2s][federate together]] to make it easy for independent installs to share files.
** Initial install
On first visiting your owncloud domain it will ask for an password, then select *Finish*. The password can be anything, but it's a good idea to follow the usual guidelines of using a random password generated by a password manager. If you see a timeout error then just wait and try reloading the page a few minutes later. It can take a while for the database to be created and for any files in the data folder to be indexed.
You may wish to add extra apps, such as calendar, music and document editing.
** On Android
Within F-droid search for *owncloud* and install the client. Also install *CalDAV Sync Adapter*.
Open the owncloud app and enter your owncloud domain name (including the https prefix) and login details for the user you created.
Open the calendar app (S planner) and under *settings* select *Calendars* then *Add account* then *CalDAV Sync Adapter*. Enter your owncloud username and password and the following URL:
#+BEGIN_SRC bash
https://myownclouddomain/remote.php/caldav/principals/myowncloudusername
#+END_SRC
You will also be prompted to enter login details. Your Android and Owncloud calendars should now be synchronised.
** On Linux
It's best to use an [[https://owncloud.com/products/desktop-clients/][officially supported client]] from the Owncloud site, rather than one which may be packaged by your distro. It's more lilkely that the official client will be up to date. [[https://software.opensuse.org/download/package?project=isv:ownCloud:desktop&package=owncloud-client][Packages are available]] for Debian and other distros.
Once the client is installed then open it and log in. After sychronisation you can then drag and drop files into *ownCloud* in your home directory.
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 /all of their files/ with each other, but might want to share some in a common pool (eg. birthday photos). You can also easily share between different servers.
* Play Music
** With the DLNA service
An easy way to play music on any mobile device in your home is to use the DLNA service. Copy your music into a directory called "/Music/" on a USB thumb drive and then insert it into from socket on the Beaglebone.
@ -132,10 +111,7 @@ The system will scan the Music directory, which could take a while if there are
If you have an Android device then go to F-Droid (if you don't already have it installed then it can be [[https://f-droid.org/][downloaded here]]) and search for *ControlDLNA*. On running the app you should see a red Debian icon which you can press on, then you may need to select "local". After a few seconds the list of albums or tracks should then appear and you can browse and play them.
The DLNA service will only work within your local home network, and isn't remotely accessible from other locations via the internet. That can be both a good and a bad thing. Another consideration is that there are no access controls on DLNA services, so any music or videos on the USB drive will be playable by anyone within your home network. If you need to restrict access to certain files then it may be better to use the music player within Owncloud.
** With Owncloud
The main advantage of playing music via Owncloud is that you can do that from anywhere - not only within your home network. Select *Apps* from the menu and then you can install the music app. It will subsequently appear on the same menu.
The DLNA service will only work within your local home network, and isn't remotely accessible from other locations via the internet. That can be both a good and a bad thing. Another consideration is that there are no access controls on DLNA services, so any music or videos on the USB drive will be playable by anyone within your home network.
* Microblogging (GNU Social)
To log into your GNU Social site first obtain your username and password from the "microblogging" section of the readme file.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

View File

@ -15,6 +15,7 @@
"Backing up personal settings for $USERNAME": "",
"Backing up ssh keys for $USERNAME": "",
"Backing up fin files for $USERNAME": "",
"Backing up syncthing files for $USERNAME": "",
"Backing up config files for $USERNAME": "",
"Backing up local files for $USERNAME": "",
"Backing up Mutt settings for $USERNAME": "",

View File

@ -9,6 +9,7 @@
"Backing up personal settings for $USERNAME": "",
"Backing up gpg keys for $USERNAME": "",
"Backing up ssh keys for $USERNAME": "",
"Backing up syncthing files for $USERNAME": "",
"Backing up config files for $USERNAME": "",
"Backing up fin files for $USERNAME": "",
"Backing up local files for $USERNAME": "",
@ -24,7 +25,8 @@
"Backing up GNU social installation": "",
"GNU Social domain specified but not found in /var/www/${MICROBLOG_DOMAIN_NAME}": "",
"Hubzilla domain specified but not found in /var/www/${HUBZILLA_DOMAIN_NAME}": "",
"Backing up Owncloud data": "",
"Backing up syncthing configuration": "",
"Backing up syncthing shared files": "",
"Backing up Mediagoblin": "",
"Obtaining Gogs settings backup": "",
"Obtaining Gogs repos backup": "",

Binary file not shown.

Binary file not shown.

View File

@ -209,8 +209,6 @@
"Domain name validation": "",
"Blog Configuration": "",
"\\nPlease enter your blog details:": "",
"Owncloud Configuration": "",
"\\nPlease enter your Owncloud details:": "",
"Mediagoblin Configuration": "",
"\\nPlease enter your Mediagoblin details, or just select Ok if you don't need a Mediagoblin site:": "",
"Hubzilla Configuration": "",

Binary file not shown.

View File

@ -109,7 +109,7 @@
"XMPP chat": "",
"GNU Social": "",
"Hubzilla": "",
"Owncloud": "",
"Syncthing": "",
"Gogs": "",
"Wiki": "",
"Blog": "",

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

View File

@ -36,6 +36,9 @@
"Restoring personal settings for $USERNAME": "",
"Restoring public mailing list": "",
"Restoring XMPP settings": "",
"Restoring syncthing configuration": "",
"Restoring syncthing shared files": "",
"Restoring syncthing files for $USERNAME": "",
"Restoring Gogs settings": "",
"Restoring Gogs repos": "",
"Restoring Gogs authorized_keys": "",

View File

@ -29,7 +29,9 @@
"Restoring personal settings for $USERNAME": "",
"Restoring public mailing list": "",
"Restoring XMPP settings": "",
"Restoring Owncloud installation": "",
"Restoring syncthing configuration": "",
"Restoring syncthing shared files": "",
"Restoring syncthing files for $USERNAME": "",
"Restoring Mediagoblin installation": "",
"Restoring Gogs repos": "",
"Restoring Gogs authorized_keys": "",

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

View File

@ -86,12 +86,6 @@
"ERROR: nginx does not appear to have installed. $CHECK_MESSAGE": "",
"Your MariaDB password is: $MARIADB_PASSWORD": "",
"ERROR: mariadb-server does not appear to have installed. $CHECK_MESSAGE": "",
"Owncloud install did not recognise the system type $SYSTEM_TYPE": "",
" *** ${PROJECT_NAME} $SYSTEM_TYPE is now installed ***": "",
"Open $OWNCLOUD_DOMAIN_NAME in a web browser to complete the setup": "",
"Owncloud database password: $OWNCLOUD_ADMIN_PASSWORD": "",
"the Users dropdown menu entry. The username should be '$MY_USERNAME'.": "",
"the URL https://$OWNCLOUD_DOMAIN_NAME/remote.php/caldav/principals/$MY_USERNAME": "",
"Unable to clone repo $GOPATH/src/github.com/gogits/gogs": "",
"Gogs admin user password": "",
"Database password: $MARIADB_PASSWORD": "",

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

View File

@ -15,6 +15,7 @@
"Backing up personal settings for $USERNAME": "",
"Backing up ssh keys for $USERNAME": "",
"Backing up fin files for $USERNAME": "",
"Backing up syncthing files for $USERNAME": "",
"Backing up config files for $USERNAME": "",
"Backing up local files for $USERNAME": "",
"Backing up Mutt settings for $USERNAME": "",

View File

@ -9,6 +9,7 @@
"Backing up personal settings for $USERNAME": "",
"Backing up gpg keys for $USERNAME": "",
"Backing up ssh keys for $USERNAME": "",
"Backing up syncthing files for $USERNAME": "",
"Backing up config files for $USERNAME": "",
"Backing up fin files for $USERNAME": "",
"Backing up local files for $USERNAME": "",
@ -24,7 +25,8 @@
"Backing up GNU social installation": "",
"GNU Social domain specified but not found in /var/www/${MICROBLOG_DOMAIN_NAME}": "",
"Hubzilla domain specified but not found in /var/www/${HUBZILLA_DOMAIN_NAME}": "",
"Backing up Owncloud data": "",
"Backing up syncthing configuration": "",
"Backing up syncthing shared files": "",
"Backing up Mediagoblin": "",
"Obtaining Gogs settings backup": "",
"Obtaining Gogs repos backup": "",

Binary file not shown.

Binary file not shown.

View File

@ -209,8 +209,6 @@
"Domain name validation": "",
"Blog Configuration": "",
"\\nPlease enter your blog details:": "",
"Owncloud Configuration": "",
"\\nPlease enter your Owncloud details:": "",
"Mediagoblin Configuration": "",
"\\nPlease enter your Mediagoblin details, or just select Ok if you don't need a Mediagoblin site:": "",
"Hubzilla Configuration": "",

Binary file not shown.

View File

@ -109,7 +109,7 @@
"XMPP chat": "",
"GNU Social": "",
"Hubzilla": "",
"Owncloud": "",
"Syncthing": "",
"Gogs": "",
"Wiki": "",
"Blog": "",

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

View File

@ -36,6 +36,9 @@
"Restoring personal settings for $USERNAME": "",
"Restoring public mailing list": "",
"Restoring XMPP settings": "",
"Restoring syncthing configuration": "",
"Restoring syncthing shared files": "",
"Restoring syncthing files for $USERNAME": "",
"Restoring Gogs settings": "",
"Restoring Gogs repos": "",
"Restoring Gogs authorized_keys": "",

View File

@ -29,7 +29,9 @@
"Restoring personal settings for $USERNAME": "",
"Restoring public mailing list": "",
"Restoring XMPP settings": "",
"Restoring Owncloud installation": "",
"Restoring syncthing configuration": "",
"Restoring syncthing shared files": "",
"Restoring syncthing files for $USERNAME": "",
"Restoring Mediagoblin installation": "",
"Restoring Gogs repos": "",
"Restoring Gogs authorized_keys": "",

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Some files were not shown because too many files have changed in this diff Show More