diff --git a/doc/EN/app_akaunting.org b/doc/EN/app_akaunting.org index 479c5c9a..aeca891e 100644 --- a/doc/EN/app_akaunting.org +++ b/doc/EN/app_akaunting.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Akaunting

-
-#+END_EXPORT +* Akaunting The Freedombone system isn't primarily aimed at companies or institutions, but if you're a one person company or freelancer then having the ability to run your own accounting system and keep the data private and also backed up is useful. Akaunting provides a nice web based system for small business accounts, and is also quite usable within a mobile web browser. @@ -33,14 +28,12 @@ From the *Administrator control panel* select *Passwords* and look up the passwo Now in a browser navigate to your subdomain. You will need to enter some details for the database. The password should be the mariadb one. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/akaunting_setup.jpg]] -#+END_CENTER After that you'll need to enter a company name and an email address. You can make the administrator password anything you prefer, and a suggestion can be found within the *Passwords* section of the *Administrator control panel* under *akaunting*. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/akaunting_setup_company.jpg]] -#+END_CENTER From then on the system should be usable. Accounts software can often be quite complex, and so you'll probably want to refer to the [[https://akaunting.com/docs][official documentation]] for details. diff --git a/doc/EN/app_bdsmail.org b/doc/EN/app_bdsmail.org index 8830abd7..93af81e5 100644 --- a/doc/EN/app_bdsmail.org +++ b/doc/EN/app_bdsmail.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

BDS Mail

-
-#+END_EXPORT +* BDS Mail BDS Mail (aka "Brain Dead Simple Mail") is an optional addition to the existing email server which comes installed as default. It creates an extra folder within the Mutt client which allows you to send and receive email using [[https://en.wikipedia.org/wiki/I2P][i2p]] as the transport layer. This solves the problem of being blocked by dubious systems and also the problem of user friendly email encryption. If you're behind a hostile firewall which you don't control and which blocks all ports, this system is still likely to work. You can use GPG as an additional encryption layer if you prefer, but it's not strictly necessary because you already have the i2p public key system to ensure end-to-end security. diff --git a/doc/EN/app_bludit.org b/doc/EN/app_bludit.org index f02f639f..1ed5ddb3 100644 --- a/doc/EN/app_bludit.org +++ b/doc/EN/app_bludit.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Bludit

-
-#+END_EXPORT +* Bludit This is a databaseless blogging system which uses markdown files. It's not very complex and so there is not much to go wrong, and it should run well on any server hardware. diff --git a/doc/EN/app_cryptpad.org b/doc/EN/app_cryptpad.org index f24946a3..b680d530 100644 --- a/doc/EN/app_cryptpad.org +++ b/doc/EN/app_cryptpad.org @@ -6,19 +6,13 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

CryptPad

-
-#+END_EXPORT +* CryptPad -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/cryptpad.jpg]] -#+END_CENTER This is similar to [[./app_etherpad.html][EtherPad]] but with better security and more document types which can be collaboratively edited in real time. It includes not just text editing but also creating presentations, voting and editing source code. diff --git a/doc/EN/app_dlna.org b/doc/EN/app_dlna.org index 705521bf..d7825e88 100644 --- a/doc/EN/app_dlna.org +++ b/doc/EN/app_dlna.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

DLNA

-
-#+END_EXPORT +* DLNA 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 an unencrypted USB thumb drive and then insert it into a USB socket on the Freedombone system. diff --git a/doc/EN/app_dokuwiki.org b/doc/EN/app_dokuwiki.org index 4bc7839c..47acb5bb 100644 --- a/doc/EN/app_dokuwiki.org +++ b/doc/EN/app_dokuwiki.org @@ -6,19 +6,13 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Dokuwiki

-
-#+END_EXPORT +* Dokuwiki Dokuwiki is a wiki which stores its content in text files. Having no database makes maintaining it simpler, and it's not tied to any particular domain name so you can easily copy the files to a different domain if you need to. - * Installation Log into your system with: diff --git a/doc/EN/app_edith.org b/doc/EN/app_edith.org index bbdeb69f..2352a0d0 100644 --- a/doc/EN/app_edith.org +++ b/doc/EN/app_edith.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Edith Notes

-
-#+END_EXPORT +* Edith Notes Edith notes is the simplest and quickest kind of notes system. It has no complicated user interface. Just enter your domain and a title and a note will be created. Everything typed is saved automatically. @@ -28,8 +23,7 @@ ssh myusername@mydomain.com -p 2222 Select *Administrator controls* then *App Settings* then *edith*. Enter a subdomain name, such as /notes.mydomain.com/, and optionally a freedns code. When the installation is complete you can then look up the password for the site within the *Passwords* section of the *Administrator control panel*, then navigate to the subdomain. Log in, then enter something like /notes.mydomain.com/testnote/ and start typing. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/edith_notes.jpg]] -#+END_CENTER It is possible to turn off the login via *App Settings/edith* if you wish, but this will enable anyone on the internet to view or edit notes on your system, which could have obvious privacy or stability implications. From *App settings/edith* it's also possible to browse through your notes files. diff --git a/doc/EN/app_emacs.org b/doc/EN/app_emacs.org index dbadeb59..1bba2f4a 100644 --- a/doc/EN/app_emacs.org +++ b/doc/EN/app_emacs.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Emacs

-
-#+END_EXPORT +* Emacs Emacs is a text editor popular with software developers or anyone who needs to take notes at high speed or be able to customise their editing environment to a high degree. When installed on Freedombone it can be used together the Mutt email client to edit new emails or if you need to manually edit configuration files. diff --git a/doc/EN/app_etherpad.org b/doc/EN/app_etherpad.org index 707473cb..5aa89d65 100644 --- a/doc/EN/app_etherpad.org +++ b/doc/EN/app_etherpad.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Etherpad

-
-#+END_EXPORT +* Etherpad This is a well known system for real time collaborative editing of documents. Just log in, choose a document title and then edit. Different users will appear in different colours, and can also chat in the sidebar. This is installed as a private system in which only users on your Freedombone server will be able to create and edit documents, so it's not open to any random users on the internet. diff --git a/doc/EN/app_fedwiki.org b/doc/EN/app_fedwiki.org index 9e94bfb1..145cde6e 100644 --- a/doc/EN/app_fedwiki.org +++ b/doc/EN/app_fedwiki.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Federated Wiki

-
-#+END_EXPORT +* Federated Wiki Federated wikis are a relatively new concept. There can be multiple copies of the same page on different servers and it's then easy to pick which version you prefer, or make something new. It's like wiki meets mashup meets federation, and so is different from many previous web paradigms and may take some recalibration of how you think the web should work. diff --git a/doc/EN/app_friendica.org b/doc/EN/app_friendica.org index 350219ec..ad9e79bb 100644 --- a/doc/EN/app_friendica.org +++ b/doc/EN/app_friendica.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Friendica

-
-#+END_EXPORT +* Friendica Friendica is a federated social networking system. It can federate with other popular systems such as GNU Social and Diaspora. Currently Friendica only works on the clearnet and doesn't have an onion address. @@ -37,9 +32,8 @@ If you have just obtained a Lets Encrypt certificate as above then go to *About* On first visiting your Friendica site you'll see the login screen. The first thing you need to do is to select *register* to create a new Friendica administrator user. The first user on the system then becomes its administrator. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/friendicaadmin.jpg]] -#+END_CENTER Friendica has numerous addons which you might want to explore. Select the small icon next to the search box and you will get to the administrator settings. Select *plugins* and you can then configure which ones you want. From the *site* settings you can also force all links to use SSL/TLS for added security. diff --git a/doc/EN/app_gnusocial.org b/doc/EN/app_gnusocial.org index 3e355064..68032a05 100644 --- a/doc/EN/app_gnusocial.org +++ b/doc/EN/app_gnusocial.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

GNU Social

-
-#+END_EXPORT +* GNU Social GNU Social is typically referred to as a microblogging system, although with a maximum post length much longer than Twitter it's really a sort of federated community blog with a stream-based appearance which also supports markdown formatting. @@ -24,10 +19,8 @@ You should regard anything posted to GNU Social as being /public communication/ Some general advice about life in the fediverse [[./fediverse.html][can be found here]]. - -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/gnusocial_pleroma.jpg]] -#+END_CENTER * Installation @@ -52,16 +45,14 @@ Once you have logged in to GNU Social you may then want to select *Admin* and ch GNU Social has a clutter-free mobile user interface which can be accessed via a Tor compatible browser (make sure to add a NoScript exception). Unlike similar proprietary sites there are no bribed posts. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/gnusocial_mobile.jpg]] -#+END_CENTER * Switching user interfaces A few web based user interfaces are available for GNU SOcial. They are selectable by going to the *Administrator control panel* and choosing *App settings* then *gnusocial*. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/gnusocial_settings.jpg]] -#+END_CENTER * *Qvitter*: Looks similar to Twitter during its golden era, before the ads and other antifeatures arrived * *Pleroma*: A modern and lightweight user interface @@ -69,9 +60,8 @@ A few web based user interfaces are available for GNU SOcial. They are selectabl * Using with Emacs -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/gnu-social-mode.jpg]] -#+END_CENTER If you are an Emacs user it's also possible to set up GNU Social mode as follows: @@ -122,9 +112,8 @@ Showing timelines: | CTRL-c CTRL-d | Post direct Message | * Blocking controls -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/controlpanel/control_panel_blocking.jpg]] -#+END_CENTER The biggest hazard with GNU Social is that it's part of a public federated communications system. This means that conversations and replies from other servers may end up in your "whole known network" stream. The internet being what it is, some of these could be undesirable. You can block individual users or entire domains by going to the *Administrator control panel* and selecting *Domain or User Blocking*, then adding or removing entries. This blocks domains at the firewall level and also at the level of database and file storage. diff --git a/doc/EN/app_gogs.org b/doc/EN/app_gogs.org index bb3669a7..09052b62 100644 --- a/doc/EN/app_gogs.org +++ b/doc/EN/app_gogs.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Gogs

-
-#+END_EXPORT +* Gogs Github is ok, but it's proprietary and funded by venture capital. If you been around on the internet for long enough then you know how this story eventually works itself out - i.e. badly for the users. It's really only a question of time. If you're a software developer or do things which involve the Git version control system then it's a good idea to become accustomed to hosting your own repositories, before the inevitable Github shitstorm occurs. diff --git a/doc/EN/app_htmly.org b/doc/EN/app_htmly.org index e3fd5059..9ff77fc4 100644 --- a/doc/EN/app_htmly.org +++ b/doc/EN/app_htmly.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

HTMLy

-
-#+END_EXPORT +* HTMLy HTMLy is a databaseless blogging system. diff --git a/doc/EN/app_hubzilla.org b/doc/EN/app_hubzilla.org index 0a405c26..cb012b92 100644 --- a/doc/EN/app_hubzilla.org +++ b/doc/EN/app_hubzilla.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Hubzilla

-
-#+END_EXPORT +* Hubzilla Hubzilla is a web publishing and social network system which includes wiki, web pages, photo albums and file storage. It also has privacy controls which allow you to define who can see which content. It's possible to write posts and have them visible only to a group of friends (known as "/privacy groups/"), with the encryption being handled automatically. Currently Hubzilla only works on the clearnet and doesn't have an onion address. @@ -37,6 +32,5 @@ If you have just obtained a Lets Encrypt certificate as above then go to *About* On first visiting your Hubzilla site you'll see the login screen. The first thing you need to do is *register* a new user. The first user on the system then becomes its administrator. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/hubzilla_mobile.jpg]] -#+END_CENTER diff --git a/doc/EN/app_icecast.org b/doc/EN/app_icecast.org index bcfe122e..b7684e44 100644 --- a/doc/EN/app_icecast.org +++ b/doc/EN/app_icecast.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Icecast

-
-#+END_EXPORT +* Icecast Icecast enables you to run something like an internet radio station. So if you have multiple audio files and want to be able to stream those in sequence from a web site then this can be useful. diff --git a/doc/EN/app_irc.org b/doc/EN/app_irc.org index a3ede2c0..c7d7935b 100644 --- a/doc/EN/app_irc.org +++ b/doc/EN/app_irc.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

IRC

-
-#+END_EXPORT +* IRC IRC is useful for multi-user chat. The classic use case is for software development where many engineers might need to coordinate their activities, but it's also useful for meetings, parties and general socialising. @@ -56,10 +51,12 @@ Enter first and second nicknames and check *connect to this network on startup*. If you are using the ordinary domain name (clearnet/ICANN) then make sure that *Use SSL* is checked. +#+attr_html: :width 80% :align center [[file:images/hexchat_setup_clearnet.jpg]] If you are using the onion address then *use SSL* should be unchecked and the transport encryption will be handled via the onion address itself. +#+attr_html: :width 80% :align center [[file:images/hexchat_setup.jpg]] Within the *Password* field enter the password which can be found from the IRC menu of the *control panel*. diff --git a/doc/EN/app_kanboard.org b/doc/EN/app_kanboard.org index aee56cf1..15947e5a 100644 --- a/doc/EN/app_kanboard.org +++ b/doc/EN/app_kanboard.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

KanBoard

-
-#+END_EXPORT +* KanBoard Kanbans are one way of managing projects. They're traditionally used in businesses but can also be useful for personal TODO lists or within open source or DIY projects. If you have a list of things which need to be done and want to keep track of progress then this provides a way to do that. diff --git a/doc/EN/app_keyserver.org b/doc/EN/app_keyserver.org index fe663847..b6871716 100644 --- a/doc/EN/app_keyserver.org +++ b/doc/EN/app_keyserver.org @@ -6,23 +6,17 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

OpenPGP Key Server

-
-#+END_EXPORT +* OpenPGP Key Server The /web of trust/ is a nice idea, but how trustable is it? If you take a look at how many OpenPGP key servers are out there then there are a two or three main ones and not much else. Can you trust those servers? Who is maintaining them and how often? Is any censorship going on? How hard would it be for adversaries to get implants onto them? In terms of technology this infrastructure is quite old and it could have been neglected for a long time. Once vigilant maintainers might have turned lazy and gotten lax with server security, or been recruited over to the dark side. For these kinds of reasons you might prefer to run your own web of trust infrastructure. In simple terms it's a database of GPG public keys which provides a way for users to /find out how to communicate with others securely via email/. You can meet in person and exchange public keys via sneakernet on USB drives, but most users of GPG don't do that. Instead they just download the public key for a given email address from one of the key servers. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/keyserver.jpg]] -#+END_CENTER * Installation diff --git a/doc/EN/app_koel.org b/doc/EN/app_koel.org index 96f6e2a1..21327a8f 100644 --- a/doc/EN/app_koel.org +++ b/doc/EN/app_koel.org @@ -6,21 +6,15 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Koel

-
-#+END_EXPORT +* Koel This enables you to store your music on the Freedombone server and then access it from any internet connected device. If you just want to make music accessible within your home network then [[./app_dlna.html][DLNA]] is usually sufficient, but if you want to be able to play your music from anywhere then [[https://koel.phanan.net][Koel]] is a better option. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/koel.jpg]] -#+END_CENTER * Installation Log into your system with: @@ -37,17 +31,15 @@ Go back to the *Administrator control panel*, select *Passwords* then *koel*. Yo Once logged in go to settings and set the media path to */music*. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/koelsettings.jpg]] -#+END_CENTER * Importing music This app doesn't have any way to upload music and instead just expects that there will be a directory on the server containing music files. There are a couple of ways to get new music files onto the system: either by using ssh or by putting them onto a USB drive. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/controlpanel/control_panel_koel.jpg]] -#+END_CENTER ** Via ssh diff --git a/doc/EN/app_lychee.org b/doc/EN/app_lychee.org index 6cd6b941..2e689294 100644 --- a/doc/EN/app_lychee.org +++ b/doc/EN/app_lychee.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Lychee

-
-#+END_EXPORT +* Lychee Lychee is a simple and lightweight photo album for the web. Whether you're an amateur or professional photographer, or want to publish random holiday pics or cat pictures. Lychee just does what it says it does without any fuss. There is also a photo album feature within [[./app_hubzilla.html][Hubzilla]] if you need more sophisticated social photo sharing with individualised permissions. @@ -36,9 +31,8 @@ If you have just obtained a Lets Encrypt certificate as above then go to *About* Within a browser navigate to your lychee domain name or onion address. It should look like this: -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/lychee_setup.jpg]] -#+END_CENTER Within the *Administrator control panel* select *App Settings* and then *lychee*. This will show the initial login settings which you need to set up the database. To copy the password hold down the shift key, select the password then right click and copy. diff --git a/doc/EN/app_mailpile.org b/doc/EN/app_mailpile.org index efb46330..14781ba8 100644 --- a/doc/EN/app_mailpile.org +++ b/doc/EN/app_mailpile.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Mailpile

-
-#+END_EXPORT +* Mailpile Mailpile provides a nice looking webmail interface suitable for use on desktop or mobile clients. It has good support for email encryption and makes that quite an simple process. At present it's usable but still has a few bugs and limitations. If you need a fully functional email client with comprehensive encryption support then either use Mutt or Thunderbird/Icedove. @@ -56,15 +51,13 @@ Uncheck *Detect Settings* and click *Next*. Under *Sending Mail* select *local* or if you need to proxy outgoing email through your ISP's server select *SMTP/TLS* and enter the details, then click *Next*. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/mailpile_setup.jpg]] -#+END_CENTER Under *Receiving files* select *IMAP*, the domain as *localhost*, port *143* and your username, then click *Next*. Astute readers may well be concerned that IMAP over port 143 is not encrypted, but since this is only via localhost communication between the Mail Transport Agent and Mailpile doesn't travel over the internet and port 143 is not opened on the firewall so it's not possible to accidentally connect an external mail client insecurely. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/mailpile_setup_keys.jpg]] -#+END_CENTER Under *Security and Privacy* either select your existing encryption key or if you only get the option to create a new one then do so, then click *Add* or *Save*. diff --git a/doc/EN/app_matrix.org b/doc/EN/app_matrix.org index 6c414d3d..ae9af7bd 100644 --- a/doc/EN/app_matrix.org +++ b/doc/EN/app_matrix.org @@ -6,19 +6,13 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Matrix

-
-#+END_EXPORT +* Matrix -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/matrix_riotweb.jpg]] -#+END_CENTER Matrix is a federated communications system, typically for multi-user chat, with end-to-end content security features. You can consider it to be like a modernized version of IRC chat where the crypto and access controls have been built in by default. At present Matrix is really only a creature of the clearnet and so there isn't any way to protect the metadata. Despite the talk of security the lack of metadata defenses make this really only suitable for public communications, similar to microblogging or public IRC channels. diff --git a/doc/EN/app_mediagoblin.org b/doc/EN/app_mediagoblin.org index 9fef5ce0..cbfd8fb4 100644 --- a/doc/EN/app_mediagoblin.org +++ b/doc/EN/app_mediagoblin.org @@ -6,20 +6,16 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Mediagoblin

-
-#+END_EXPORT +* Mediagoblin With Mediagoblin you can host video and audio content in a similar manner to the proprietary systems such as YouTube and SoundCloud. This system supports free media formats such as /webm/, /ogv/ and /ogg/. Another similar system which might be better fitted for small servers is [[./app_peertube.html][PeerTube]], since it uses webtorrent to distribute video files. Webtorrent will only work with WebRTC enabled browsers though. When hosting media files you should take into consideration that since anyone on the internet can view your content then this could significantly increase your bandwidth usage and overall strain on the server. Also unless you are just hosting images then hardware such as the Beaglebone Black won't be powerful enough for a good user experience when either uploading or playing back videos. It's recommended that you use one of the more powerful quad (or more) core single board computers or an old laptop if you want to run Mediagoblin on it. +#+attr_html: :width 50% :align center #+BEGIN_CENTER [[file:images/mediagoblin.jpg]] #+END_CENTER diff --git a/doc/EN/app_mumble.org b/doc/EN/app_mumble.org index 2e046792..808af12e 100644 --- a/doc/EN/app_mumble.org +++ b/doc/EN/app_mumble.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Mumble

-
-#+END_EXPORT +* Mumble Mumble is a well known VoIP system originally used for gaming, but which works just as well for any general conference calls or meetings. @@ -32,9 +27,8 @@ Within the software center search for "mumble" and install the client then run i From the menu select *Configure* then *Settings*. Select the *Advanced* checkbox then select *Network*. Select *Force TCP mode* and proxy type *Socks5*. Hostname should be set to *localhost* and port should be *9050*. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/mumble_config.jpg]] -#+END_CENTER Select *Apply* and *Ok*, then on the menu *Server* and *Connect*. diff --git a/doc/EN/app_nextcloud.org b/doc/EN/app_nextcloud.org index 4920101c..6ecb2c72 100644 --- a/doc/EN/app_nextcloud.org +++ b/doc/EN/app_nextcloud.org @@ -6,19 +6,13 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

NextCloud

-
-#+END_EXPORT +* NextCloud -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/nextcloud.jpg]] -#+END_CENTER NextCloud is a system for file synchronisation and also has many other plugins for calendar, videoconferencing, collaborative document editing and federated file sharing. It's a lot more elaborate than Syncthing, but there may be situations where centralized control of your files on your server is better than a purely peer-to-peer approach (eg. if you need to remove a user's access to files). diff --git a/doc/EN/app_peertube.org b/doc/EN/app_peertube.org index 93f90606..d8a47e77 100644 --- a/doc/EN/app_peertube.org +++ b/doc/EN/app_peertube.org @@ -6,13 +6,11 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/peertube.jpg]] -#+END_CENTER This is a video hosting system similar to Mediagoblin but using webtorrent to help distribute the files to or between clients. This should be more practical for situations where a video becomes popular because the load is then spread across the network, with performance increasing with the number of nodes. However, the torrenting aspect of it only works with WebRTC enabled browsers and so this means it's unlikely to fully work with a Tor browser. Without WebRTC then from a user point of view it's effectively the same thing as Mediagoblin. diff --git a/doc/EN/app_pihole.org b/doc/EN/app_pihole.org index 24bf68c9..3c513625 100644 --- a/doc/EN/app_pihole.org +++ b/doc/EN/app_pihole.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

PI-Hole: The Black Hole for Web Adverts

-
-#+END_EXPORT +* PI-Hole: The Black Hole for Web Adverts Idiots who have an inflated sense of self-entitlement will tell you that it's /your moral duty/ to view their mind-numbingly tedious corporate ads on their web site or YouTube channel, or else their kids will starve and the sky will fall because their revenue stream will dry up. But that's bullshit. There is nothing intrinsic or morally mandatory about adverts propping up the livelihoods of netizens, and indeed a web not primarily based on advertising money might have been a much better and more interesting place by now, with a lot less spying. diff --git a/doc/EN/app_pleroma.org b/doc/EN/app_pleroma.org index 562bdd04..af6b1e9f 100644 --- a/doc/EN/app_pleroma.org +++ b/doc/EN/app_pleroma.org @@ -6,13 +6,8 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER - -#+BEGIN_CENTER -[[file:images/pleroma-logo.png]] -#+END_CENTER #+BEGIN_QUOTE "/The way to keep giant companies from sterilizing the Internet is to make their sites irrelevant. If all the cool stuff happens elsewhere, people will follow. We did this with AOL and Prodigy, and we can do it again./" -- Maciej Cegłowski @@ -22,9 +17,8 @@ Pleroma is an OStatus and ActivityPub compatible social networking server, compa Some general advice about life in the fediverse [[./fediverse.html][can be found here]]. -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/pleroma.jpg]] -#+END_CENTER * Installation Log into your system with: @@ -45,20 +39,18 @@ Once you have done that then you can disable further registrations from the *Adm * Mastodon user interface If you prefer a Tweetdeck-style user interface, similar to Mastodon, then once you have registered an account navigate to */yourpleromadomainname/web* and log in. -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/pleromamastodon.jpg]] -#+END_CENTER * Mobile apps It's also possible to use Mastodon apps together with Pleroma, such as Tusky, since it supports the Mastodon API. You may need to install *IcecatMobile* and set it as your default browser (under *Settings/Apps/Menu*) in order for the initial oauth registration process to work. -#+BEGIN_CENTER +#+attr_html: :width 50% :align center [[file:images/tusky.jpg]] -#+END_CENTER + * Blocking controls -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/controlpanel/control_panel_blocking.jpg]] -#+END_CENTER The biggest hazard with Pleroma is that it's part of a public federated communications system. This means that conversations and replies from other servers may end up in your "whole known network" stream. The internet being what it is, some of these could be undesirable. You can block individual users or entire domains by going to the *Administrator control panel* and selecting *Domain or User Blocking*, then adding or removing entries. This blocks domains at the firewall level and also at the level of database and file storage. diff --git a/doc/EN/app_postactiv.org b/doc/EN/app_postactiv.org index 769198f9..7624b81a 100644 --- a/doc/EN/app_postactiv.org +++ b/doc/EN/app_postactiv.org @@ -6,23 +6,17 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

PostActiv

-
-#+END_EXPORT +* PostActiv PostActiv is a fork of [[./app_gnusocial.html][GNU Social]] which includes some extra fixes and optimisations to improve performance. It federates just like GNU Social does and so whether you choose GNU Social or PostActiv is really just down to personal prefernce. Some general advice about life in the fediverse [[./fediverse.html][can be found here]]. -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/postactiv_pleroma.jpg]] -#+END_CENTER * Installation Log into your system with: @@ -47,9 +41,8 @@ Navigate to your PostActiv domain name and log in. * Switching user interfaces A few web based user interfaces are available for PostActiv. They are selectable by going to the *Administrator control panel* and choosing *App settings* then *postactiv*. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/postactiv_settings.jpg]] -#+END_CENTER * *Qvitter*: Looks similar to Twitter during its golden era, before the ads and other antifeatures arrived * *Pleroma*: A modern and lightweight user interface @@ -57,9 +50,8 @@ A few web based user interfaces are available for PostActiv. They are selectable * Using with Emacs -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/gnu-social-mode.jpg]] -#+END_CENTER If you are an Emacs user it's also possible to set up GNU Social mode, which is compatible with PostActiv. You can do that as follows: @@ -110,9 +102,8 @@ Showing timelines: | CTRL-c CTRL-d | Post direct Message | * Blocking controls -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/controlpanel/control_panel_blocking.jpg]] -#+END_CENTER The biggest hazard with PostActiv is that it's part of a public federated communications system. This means that conversations and replies from other servers may end up in your "/whole known network/" stream. The internet being what it is, some of these could be undesirable. You can block individual users or entire domains by going to the *Administrator control panel* and selecting *Domain or User Blocking*, then adding or removing entries. This blocks domains at the firewall level and also at the level of database and file storage. diff --git a/doc/EN/app_privatebin.org b/doc/EN/app_privatebin.org index eb5d5f3e..2b53c0a7 100644 --- a/doc/EN/app_privatebin.org +++ b/doc/EN/app_privatebin.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

PrivateBin

-
-#+END_EXPORT +* PrivateBin This is an encrypted pastebin, such that the server has zero knowledge of the content. It's intended for small amounts of text less than 32K in length. It's not intended for transfering large files, or for storing pastes for more than a day. diff --git a/doc/EN/app_profanity.org b/doc/EN/app_profanity.org index 938390a8..1f72fa92 100644 --- a/doc/EN/app_profanity.org +++ b/doc/EN/app_profanity.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Profanity

-
-#+END_EXPORT +* Profanity To install this app you will first need to install the [[./app_xmpp.html][XMPP server]]. diff --git a/doc/EN/app_riot.org b/doc/EN/app_riot.org index c0a3ea5a..ef78420b 100644 --- a/doc/EN/app_riot.org +++ b/doc/EN/app_riot.org @@ -6,19 +6,13 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Riot Web

-
-#+END_EXPORT +* Riot Web -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/riotweb.jpg]] -#+END_CENTER Riot Web is a browser based user interface for the [[./app_matrix.html][Matrix]] federated communications system. It allows you to do encrypted one-to-one or group chat, and has some fancy WebRTC features for voice and video conversations. The WebRTC stuff won't work in a Tor browser though. This type of system is fine for general public communications and collaboration on open source projects or gaming groups. For things which require real privacy though stick to XMPP with OMEMO. diff --git a/doc/EN/app_rss.org b/doc/EN/app_rss.org index cbb54951..38b44edd 100644 --- a/doc/EN/app_rss.org +++ b/doc/EN/app_rss.org @@ -6,21 +6,15 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

RSS Reader

-
-#+END_EXPORT +* RSS Reader The way that RSS reading is set up on Freedombone gives you strong reading privacy. Not only is there onion routing between you and the server but also between the server and the source of the RSS feed. The only down side is that many RSS feeds are still http only, and so could be vulnerable to injection attacks, but it's expected that more of this will go to https in the foreseeable future due to a combination of growing recognition of security issues and systems like Let's Encrypt which make obtaining certificates much easier. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/rss_reader_mobile.jpg]] -#+END_CENTER * Finding the onion address See the control panel for the RSS reader onion address. diff --git a/doc/EN/app_searx.org b/doc/EN/app_searx.org index 6c1d4f18..9a539152 100644 --- a/doc/EN/app_searx.org +++ b/doc/EN/app_searx.org @@ -6,24 +6,17 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

SearX

-
-#+END_EXPORT +* SearX SearX is a metasearch engine. That means it returns results from other selected search engines. It's accessible via an onion address and provides a private search ability. Really the only advantage it gives you over searching directly from a Tor browser is the ability to customise your search experience. In terms of security both the connection between you and the server, and the outgoing connection from the server to other search engines are onion routed. This should give you a reasonable level of search privacy. - -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/searx.jpg]] -#+END_CENTER * Installation diff --git a/doc/EN/app_syncthing.org b/doc/EN/app_syncthing.org index 1a1b54b3..d2e97ee2 100644 --- a/doc/EN/app_syncthing.org +++ b/doc/EN/app_syncthing.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Syncthing

-
-#+END_EXPORT +* Syncthing 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, "/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. @@ -46,17 +41,15 @@ ssh username@domainname -p 2222 Then select *File Synchronization*. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/controlpanel/control_panel_file_sync.jpg]] -#+END_CENTER Select *Show device ID* 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. Open a non-Tor browser and enter *http://127.0.0.1:8384* as the URL. You should now see the minimalistic user interface. Under *Remote Devices* select *Add Remote Device*. In the *Device ID* field paste the string you just copied (CTRL+v). The Device name can be anything. Under *Share Folders with Device* check *default* (or whatever folder you created on your local machine), then save. -#+BEGIN_CENTER +#+attr_html: :width 50% :align center [[file:images/syncthing_browser.jpg]] -#+END_CENTER From the top menu select *Actions* and then *Show ID*, then copy the ID string (usually select then CTRL+c). Go back to the terminal control panel menu and select *Add an ID* 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. diff --git a/doc/EN/app_tahoelafs.org b/doc/EN/app_tahoelafs.org index 19bacaba..e9896ce0 100644 --- a/doc/EN/app_tahoelafs.org +++ b/doc/EN/app_tahoelafs.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Tahoe-LAFS

-
-#+END_EXPORT +* Tahoe-LAFS This is a robust system for encrypted file storage on one or more servers. Files are accessed via a URL which contains the public key with which it was encrypted. @@ -37,8 +32,7 @@ Go to the *About* screen on the *Administrator control panel* and look for the o * Adding more servers You can add more servers to the system to increase its storage capacity. In a typical Tahoe-LAFS new data storage servers are automatically discovered via an introducer node, but that creates a single centralised point of failure. The installation on Freedombone has no introducer node and so details for the servers of your friends need to be entered manually. -#+BEGIN_CENTER +#+attr_html: :width 50% :align center [[file:images/controlpanel/control_panel_tahoelafs.jpg]] -#+END_CENTER Other servers will typically be Freedombone systems with Tahoe-LAFS installed. Your Tahoe-LAFS server settings can be found on the *About* screen of the *Administrator control panel*. Use an end-to-end encrypted chat app to copy and paste those details and send them to other friends. To add the server details go to *App settings* on the *Administrator control panel* then select *tahoelafs* and *Add server*. diff --git a/doc/EN/app_tox.org b/doc/EN/app_tox.org index 21fd89d5..090bc2b1 100644 --- a/doc/EN/app_tox.org +++ b/doc/EN/app_tox.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Tox

-
-#+END_EXPORT +* Tox Tox is an encrypted peer-to-peer messaging system and so should work without Freedombone. It uses a system of nodes which act as a sort of directory service allowing users to find and connect to each other. The Tox node ID on the Freedombone can be found within *App Settings* under *tox* within the *Administrator control panel*. If you have other users connect to your node then you will be able to continue chatting even when no other nodes are available. @@ -27,6 +22,5 @@ ssh myusername@mydomain -p 2222 Then from the menu select *Run an app* followed by *tox*. Tox is encrypted by default and also routed through Tor, so it should be reasonably secure both in terms of message content and metadata. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/toxic.jpg]] -#+END_CENTER diff --git a/doc/EN/app_turtl.org b/doc/EN/app_turtl.org index c0385a02..ed0a6ecb 100644 --- a/doc/EN/app_turtl.org +++ b/doc/EN/app_turtl.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Turtl

-
-#+END_EXPORT +* Turtl #+begin_quote "/Now is a very important time in history. Every aspect of our lives is moving into the digital world faster than we realize. We use apps like Dropbox or Evernote because of their convenience, but in doing so we sacrifice our privacy. What data isn't sold to advertisers or stolen by hackers is carved up by government surveillance./" @@ -24,10 +19,8 @@ Turtl is a system for privately creating and sharing notes and images, similar t Since the data at rest is stored in PGP encrypted format this is a good system to use in cases where security really is a critical factor. - -#+BEGIN_CENTER +#+attr_html: :width 50% :align center [[file:images/turtl.jpg]] -#+END_CENTER * Installation Log into your system with: @@ -49,6 +42,5 @@ Run the downloaded native app then at the bottom of the screen select *advanced You should then be able to log in and start using the app. You might also want to invite any other users of your Freedombone system to also sign up using the turtl domain name which you specified during installation. - * Locking it down Once you have created accounts it's a good idea to turn off new turtl signups. This will prevent millions of random users on the interwebs from creating accounts on your system and killing your server, or possibly other nefarious security scenarios. Go to the *administrator control panel* and select *App Settings* then *turtl*. You will then be able to disable new user registrations and also set the data storage limit for users. If you need additional users later you can always temporarily re-enable signups. diff --git a/doc/EN/app_vpn.org b/doc/EN/app_vpn.org index cbf1f2bf..74de7600 100644 --- a/doc/EN/app_vpn.org +++ b/doc/EN/app_vpn.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

OpenVPN

-
-#+END_EXPORT +* OpenVPN #+begin_quote "/The Net interprets censorship as damage and routes around it./" -- John Gilmore diff --git a/doc/EN/app_xmpp.org b/doc/EN/app_xmpp.org index 4dd404ec..dee57a64 100644 --- a/doc/EN/app_xmpp.org +++ b/doc/EN/app_xmpp.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

XMPP/Jabber

-
-#+END_EXPORT +* XMPP/Jabber Most people know XMPP as "/Jabber/" and it's sometimes regarded and an old protocol once used by Google and Facebook but which is no longer relevant. However, it still works and if appropriately configured, as it is on Freedombone, can provide the best chat messaging security currently available. diff --git a/doc/EN/apps.org b/doc/EN/apps.org index 7da061ca..46cf9460 100644 --- a/doc/EN/apps.org +++ b/doc/EN/apps.org @@ -6,9 +6,8 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER #+begin_quote "/In times of aggressive corporatization, increasing enclosure of communication spaces, and blanket surveillance, emancipatory communication practices appear to be particularly well suited to offer concrete alternatives to activists and citizens alike/" -- Stefania Milan @@ -16,10 +15,8 @@ The base install of the system just contains an email server and Mutt client, but not much else. In addition from within the *Administrator control panel* under *Add/remove apps* the following are installable. This list only applies on the home server version, with the mesh network version having a different and smaller set of apps. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/controlpanel/control_panel_apps.jpg]] -#+END_CENTER - * Akaunting A web based accounts system for small businesses or freelancers. @@ -193,3 +190,7 @@ Set up a VPN on your server so that you can bypass local internet censorship. Chat server which can be used together with client such as Gajim or Conversations to provide end-to-end content security and also onion routed metadata security. Includes advanced features such as /client state notification/ to save battery power on your mobile devices, support for seamless roaming between networks and /message carbons/ so that you can receive the same messages while being simultaneously logged in to your account on more than one device. [[./app_xmpp.html][How to use it]] + + +#+attr_html: :width 10% :height 2% :align center +[[file:fdl-1.3.txt][file:images/gfdl.png]] diff --git a/doc/EN/armbian.org b/doc/EN/armbian.org index 746fee67..a9bbf292 100644 --- a/doc/EN/armbian.org +++ b/doc/EN/armbian.org @@ -1,14 +1,13 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, armbian +#+KEYWORDS: freedombone, debian, armbian, sbc #+DESCRIPTION: Installing Freedombone on Armbian #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER #+begin_export html @@ -43,9 +42,8 @@ ssh root@[local IP address] Using the default Armbian password of *1234*. You should see the Armbian welcome message and will be asked to change the password, then create a new user account. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/armbian_setup.jpg]] -#+END_CENTER When the user account is created type *exit* to leave the ssh session then log back in with your new user account. diff --git a/doc/EN/backups.org b/doc/EN/backups.org index 640fb201..960e1cc7 100644 --- a/doc/EN/backups.org +++ b/doc/EN/backups.org @@ -1,20 +1,15 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server +#+KEYWORDS: freedombone, backup +#+DESCRIPTION: How to make backups on Freedombone #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Backups

-
-#+END_EXPORT +* Backups #+BEGIN_CENTER #+ATTR_HTML: :border -1 diff --git a/doc/EN/beaglebone.org b/doc/EN/beaglebone.org index 574fe4e0..aa08c16a 100644 --- a/doc/EN/beaglebone.org +++ b/doc/EN/beaglebone.org @@ -6,23 +6,17 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Installing Freedombone on a Beaglebone Black

-
-#+END_EXPORT +* Installing Freedombone on a Beaglebone Black The Beaglebone Black is small, cheap, a fully open hardware design, has a hardware random number generator and consumes very little electrical power, making it suitable for all kinds of uses. There is also a wireless version. You can easily use one to run your own internet services from home. -#+BEGIN_CENTER +#+attr_html: :width 50% :align center [[file:images/bbb_board.jpg]] -#+END_CENTER You will need: @@ -57,9 +51,8 @@ sudo make install freedombone-image --setup parabola #+end_src -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/microsd_reader.jpg]] -#+END_CENTER If you own a domain name and have it linked to a dynamic DNS account (eg. [[https://freedns.afraid.org][freeDNS]]) and want to make a system accessible via an ordinary browser then run: @@ -75,15 +68,13 @@ freedombone-image -t beaglebone --onion-addresses-only yes Onion addresses have the advantage of being difficult to censor and you don't need to buy a domain or have a dynamic DNS account. An onion based system also means you don't need to think about NAT traversal type issues. This *does not* mean that everything gets routed through Tor, it just means that the sites for apps which you install will be available through Tor's address system. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/bbb_back.jpg]] -#+END_CENTER Now follow the [[./homeserver.html][instructions given here to copy the image to the microSD drive]] beginning with running the /freedombone-client/ command. Wherever it says "USB drive" substitute "microSD drive". When the microSD drive is ready plug it into the front of the Beaglebone. The photo below also includes an Atheros wifi USB dongle plugged into the front, but that's not necessary unless you want to set up the system to run on a wifi network. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/bbb_front.jpg]] -#+END_CENTER Connect the power and for the non-wireless versions of the Beaglebone Black also connect the ethernet cable and plug it into your internet router. diff --git a/doc/EN/boards.org b/doc/EN/boards.org index c6f00254..3d57109e 100644 --- a/doc/EN/boards.org +++ b/doc/EN/boards.org @@ -6,22 +6,17 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Supported ARM boards

-
-#+END_EXPORT +* Supported ARM boards The following ARM boards are supported by the build system. If your board isn't listed here then you may still be able to install Freedombone using [[./armbian.html][Armbian]]. - - [[./downloads/current/freedombone-current-beaglebone-armhf.img.xz][beaglebone]] - - [[./downloads/current/freedombone-current-cubieboard2-armhf.img.xz][cubieboard2]] - - [[./downloads/current/freedombone-current-cubietruck-armhf.img.xz][cubietruck]] - - [[./downloads/current/freedombone-current-pcduino3-armhf.img.xz][pcduino3]] + - [[./downloads/v31/freedombone-beaglebone-armhf.img.xz][beaglebone]] + - [[./downloads/v31/freedombone-cubieboard2-armhf.img.xz][cubieboard2]] + - [[./downloads/v31/freedombone-cubietruck-armhf.img.xz][cubietruck]] + - [[./downloads/v31/freedombone-pcduino3-armhf.img.xz][pcduino3]] - a20-olinuxino-lime - a20-olinuxino-lime2 - a20-olinuxino-micro diff --git a/doc/EN/code.org b/doc/EN/code.org index 87a96e54..26112df0 100644 --- a/doc/EN/code.org +++ b/doc/EN/code.org @@ -1,20 +1,15 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server +#+KEYWORDS: freedombone, code +#+DESCRIPTION: Freedombone codebase #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Code

-
-#+END_EXPORT +* Code Freedombone is really just a couple of [[https://www.gnu.org/software/bash][bash]] scripts which install and configure software on a Debian GNU/Linux system. If you're a system administrator, software engineer or Linux hobbyist you'll probably be familiar with command line scripting and be able to make your own modifications or custom variants to suit your needs. Freedombone is licensed under the [[https://www.gnu.org/licenses/agpl.html][GNU Affero General Public License version 3]] (or later). diff --git a/doc/EN/codeofconduct.org b/doc/EN/codeofconduct.org index 68397380..2c837783 100644 --- a/doc/EN/codeofconduct.org +++ b/doc/EN/codeofconduct.org @@ -6,13 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+begin_export html -

Code of Conduct

-#+end_export +* Code of Conduct * Be respectful @@ -47,3 +44,6 @@ While this code of conduct should be adhered to by participants, we recognize th Serious or persistent offenders will be kicked from chat rooms and any of their subsequent patches will be unlikely to be upstreamed. In this context "serious" means that someone is causing others to feel unsafe or be unable to contribute, for whatever reason. This is not a big project and so there is no division of labor or special enforcement committee or bureaucratic process. Complaints should be made (in private) to the maintainer or chat room admin. The typical email address can be found in the source code headers. Preferably use GPG if you can, or XMPP with OpenPGP/OMEMO to bob@freedombone.net. XMPP messages are likely to get a quicker response. + +#+attr_html: :width 10% :height 2% :align center +[[file:fdl-1.3.txt][file:images/gfdl.png]] diff --git a/doc/EN/controlpanel.org b/doc/EN/controlpanel.org deleted file mode 100644 index 06274865..00000000 --- a/doc/EN/controlpanel.org +++ /dev/null @@ -1,123 +0,0 @@ -#+TITLE: -#+AUTHOR: Bob Mottram -#+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Control Panel -#+OPTIONS: ^:nil toc:nil -#+HTML_HEAD: - -#+BEGIN_CENTER -[[file:images/logo.png]] -#+END_CENTER - -#+BEGIN_EXPORT html -
-

Control panel

-
-#+END_EXPORT - -| [[Main menu]] | -| [[User control panel]] | -| [[About screen]] | -| [[Email filtering rules]] | -| [[Hubzilla menu]] | -| [[IRC menu]] | -| [[Media menu]] | -| [[Repository mirrors]] | -| [[Backup and restore menu]] | -| [[Security menu]] | -| [[User management menu]] | - -* Main menu -You can access the main menu by logging into the system. - -#+BEGIN_SRC bash -ssh myusername@mydomain -p 2222 -#+END_SRC - -Then selecting /Administrator controls/. - -It should look like this: - -#+BEGIN_CENTER -[[file:images/controlpanel/control_panel.jpg]] -#+END_CENTER - -To select anythng on the control panel use the *up and down* cursor keys and *space bar* to tag, then press *Enter*. - -* User control panel -When a user initially logs in they will see a version of the control panel with restricted options aimed at the kinds of things which someone who isn't the administrator might wish to do. An expected scenario is that you might have a few friends or family members on the system, and this is who this menu is intended for. - -From this menu checking email or running chat applications is very easy, and they are configured in a safe manner without the user needing to do anything special. Email uses *mutt*, XMPP uses *profanity* and IRC uses *irssi*. - -#+BEGIN_CENTER -[[./images/controlpanel/control_panel_user.jpg]] -#+END_CENTER - -It's also possible for the user to define email filtering rules, add a ssh public key for key based login and also add or remove GPG public keys. They can also do this via the commandline if they prefer, but the menu system may provide an easier user interface. -* About screen -To find out your current domain names select the About screen from the main menu. This is especially useful for finding your onion addresses. For improved security by compartmentalisation, and also simpler implementation, each application has its own onion address. - -#+BEGIN_CENTER -[[file:images/controlpanel/control_panel_about.jpg]] -#+END_CENTER - -You can also see the SIP extension numbers for each user and how much disk space each user is consuming (typically this corresponds with email use). - -The Local Mirrors contains mirrored copies of the git repositories used by the system. If they don't have access to default repositories (mostly Github) then you can give these details to other users and then they can set their main repository such that they can pull from your system. Obviously any users doing this need to trust that you havn't modified the mirrored repositories in any way. - -* Email filtering rules -You can add users to mailing lists, or block particular email addresses or subject lines in this menu. - -#+BEGIN_CENTER -[[file:images/controlpanel/control_panel_filtering.jpg]] -#+END_CENTER - -* Hubzilla menu -This allows you to set the global directory location and obtain an SSL/TLS certificate if necessary. - -#+BEGIN_CENTER -[[file:images/controlpanel/control_panel_hubzilla.jpg]] -#+END_CENTER - -* IRC menu -You can view the current IRC password or change it from here. Currently the IRC server does not work equally well on clrearnet and via Tor, so there is an option to switch from one to the other. Initially the IRC server will be running on clearnet (i.e. no onion routing). - -#+BEGIN_CENTER -[[file:images/controlpanel/control_panel_irc.jpg]] -#+END_CENTER - -* Media menu -It's possible to add playable media to a USB drive and plug it into the system, then make it accessible to other devices such as tablets or phones on your local network via DLNA. - -#+BEGIN_CENTER -[[file:images/controlpanel/control_panel_media.jpg]] -#+END_CENTER - -* Repository mirrors -If you don't want to use the default repositories, or don't have access to them, then you can obtain them from another Freedombone server (the details can be found on the other server on the *About* screen of the control panel). - -#+BEGIN_CENTER -[[file:images/controlpanel/control_panel_mirrors.jpg]] -#+END_CENTER - -* Backup and restore menu -You can create backups or restore from backup here. It's also possible to create keydrives which store the backup key. - -#+BEGIN_CENTER -[[file:images/controlpanel/control_panel_backup_restore.jpg]] -#+END_CENTER - -* Security menu -If you need to generate SSL/TLS certificates or change cypher details due to changing recommendations then you can do that here. If you are changing cypher details be extra careful not to make mistakes/typos, which could reduce the security of your system. - -#+BEGIN_CENTER -[[file:images/controlpanel/control_panel_security.jpg]] -#+END_CENTER - -* User management menu -Users can be added or removed here. - -#+BEGIN_CENTER -[[file:images/controlpanel/control_panel_users.jpg]] -#+END_CENTER diff --git a/doc/EN/debianinstall.org b/doc/EN/debianinstall.org index 423f3e83..4f069d2d 100644 --- a/doc/EN/debianinstall.org +++ b/doc/EN/debianinstall.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

How to install on an existing Debian system

-
-#+END_EXPORT +* How to install on an existing Debian system #+BEGIN_QUOTE "/The antagonism of surveillance is not privacy but the making of communities in struggle/" diff --git a/doc/EN/devguide.org b/doc/EN/devguide.org index 636dccfa..b78e3f1d 100644 --- a/doc/EN/devguide.org +++ b/doc/EN/devguide.org @@ -1,18 +1,15 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server +#+KEYWORDS: freedombone, developers +#+DESCRIPTION: Freedombone developers guide #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+begin_export html -

Developers Guide

-#+end_export +* Developers Guide * Introduction Freedombone consists of a set of bash scripts. There are a lot of them, but they're not very complicated. If you're familiar with the GNU/Linux commandline and can hack a bash script then you can probably add a new app or fix a bug in the system. There are no trendy development frameworks to learn or to get in your way. You might also want to consult the [[./codeofconduct.html][Code of Conduct]], and there is a Matrix room at *#fbone:matrix.freedombone.net* @@ -96,3 +93,7 @@ Submit your working app to *https://github.com/bashrc/freedombone/issues* or cre If you want to make your own specially branded version of the mesh images, such as for a particular event, then to change the default desktop backgrounds edit the images within *img/backgrounds* and to change the available avatars and desktop icons edit the images within *img/avatars*. Re-create disk images using the instructions shown previously. If you need particular /dconf/ commands to alter desktop appearance or behavior then see the function /mesh_client_startup_applications/ within *src/freedombone-image-customise*. + + +#+attr_html: :width 10% :height 2% :align center +[[file:fdl-1.3.txt][file:images/gfdl.png]] diff --git a/doc/EN/domains.org b/doc/EN/domains.org index f640b705..b22de245 100644 --- a/doc/EN/domains.org +++ b/doc/EN/domains.org @@ -6,13 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+begin_export html -

How to get a domain name

-#+end_export +* How to get a domain name * The domain name itself diff --git a/doc/EN/faq.org b/doc/EN/faq.org index b36b6ae3..3835aaf2 100644 --- a/doc/EN/faq.org +++ b/doc/EN/faq.org @@ -1,25 +1,19 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, hubzilla, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber +#+KEYWORDS: freedombone, faq #+DESCRIPTION: Frequently asked questions #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Frequently Asked Questions

-
-#+END_EXPORT - -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/surveillanceoptions.jpg]] + /Possible options for dealing with bulk surveillance at The Glass Room exhibition, 2017/ -#+END_CENTER + #+BEGIN_CENTER #+ATTR_HTML: :border -1 @@ -31,6 +25,7 @@ | [[How is Tor integrated with Freedombone?]] | | [[Can I add a clearnet domain to an onion build?]] | | [[Why use Github?]] | +| [[After using nmap or other scanning tool I can no longer log in]] | | [[Should I upload my GPG keys to keybase.io?]] | | [[Keys and emails should not be stored on servers. Why do you do that?]] | | [[Why can't I access my .onion site with a Tor browser?]] | @@ -54,6 +49,7 @@ | [[Tor is censored/blocked in my area. What can I do?]] | | [[I want to block a particular domain from getting its content into my social network sites]] | | [[The mesh system doesn't boot from USB drive]] | +| [[Mesh system doesn't connect to the network]] | #+END_CENTER @@ -119,6 +115,8 @@ At present Github is useful just because of the sheer number of eyeballs and the The source code for this project is experimentally independently hosted, and it is expected that in future the main development will shift over to an independent site, maybe with mirrors on Github if it still exists in a viable form. Currently many of the repositories used for applications which are not yet packaged for Debian are on Github, and to provide some degree of resilliance against depending too much upon that copies of them also exist within disk images. +* After using nmap or other scanning tool I can no longer log in +This system tries to block port scanners. Any other system trying to scan for open ports will have their IP address added to a temporary block list for 24 hours. * Should I upload my GPG keys to keybase.io? It's not recommended unless there exists some compelling reason for you to be on there. That site asks users to upload the *private keys*, and even if the keys are client side encrypted with a passphrase there's always the chance that there will be a data leak in future and letter agencies will then have a full time opportunity to crack the passphrases. @@ -335,9 +333,8 @@ If you can find some details for an obfs4 Tor bridge (its IP address, port numbe ssh into your Freedombone system, go to the *administrator control panel*, select *security settings* then *Tor Bridges* and *Add a bridge*. You can then enter the details. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/controlpanel/control_panel_bridges.jpg]] -#+END_CENTER Any bridges that you add will also show up on the About screen of the administrator control panel. @@ -357,9 +354,8 @@ If the system doesn't boot and reports an error which includes */dev/mapper/loop After the system has booted successfully the problem should resolve itself on subsequent reboots. +* Mesh system doesn't connect to the network +Sometimes after boot the mesh system won't connect to other peers on the network. If this happens select the *network restart* icon and enter the password, which by default is just "freedombone". Wait for a few minutes to see if it connects. -#+BEGIN_EXPORT html -
-Return to the home page -
-#+END_EXPORT +#+attr_html: :width 10% :height 2% :align center +[[file:fdl-1.3.txt][file:images/gfdl.png]] diff --git a/doc/EN/fediverse.org b/doc/EN/fediverse.org index 5af89588..d4302e4e 100644 --- a/doc/EN/fediverse.org +++ b/doc/EN/fediverse.org @@ -6,13 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_CENTER -*Homesteading the Fediverse* -#+END_CENTER +* Homesteading the Fediverse Some things you might want to know about the Fediverse: @@ -38,8 +35,5 @@ Once there are more than a couple of hundred highly active users in your timelin * Avoid big public servers It may seem like a good idea and it may seem like you're doing a service to the community by allowing random strangers to register, but servers with thousands of users only cause problems - social, administrative, financial and possibly also legal. The financial strain of running a powerful server with high reliability may be enough to encourage the administrator to begin pushing advertising onto the system, or sell user content, and then before you know it you have identical problems to Twitter. Instead try to encourage people to set up their own servers. Follow this principle and a lot of arguments and stress will be more easily avoided. - - -#+BEGIN_CENTER -This site can also be accessed via a Tor browser at http://yjxlc3imv7obva4grjae6u3qw527koaytrgjgdp364hmthrst3jodiid.onion. This documentation is under the [[https://www.gnu.org/licenses/fdl-1.3.txt][GNU Free Documentation License version 1.3]] -#+END_CENTER +#+attr_html: :width 10% :height 2% :align center +[[file:fdl-1.3.txt][file:images/gfdl.png]] diff --git a/doc/EN/homeserver.org b/doc/EN/homeserver.org index 1871ca3b..12a75e6c 100644 --- a/doc/EN/homeserver.org +++ b/doc/EN/homeserver.org @@ -1,19 +1,16 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server +#+KEYWORDS: freedombone, home server +#+DESCRIPTION: Freedombone home server setup #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+begin_export html -

Home Server

-#+end_export +* Home Server The quickest way to get started is as follows. You will need to be running a Debian based system (version 8 or later), have an old but still working laptop or netbook which you can use as a server, and 8GB or larger USB thumb drive and an ethernet cable to connect the laptop to your internet router. @@ -47,9 +44,8 @@ Now prepare your local system to talk to the freedombone by running the followin freedombone-client #+end_src -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/tor_onion.jpg]] -#+END_CENTER The version in which sites are available only via onion addresses is the easiest to get started with, since you can evaluate the system without committing to buying an ICANN domain name or needing to get involved with SSL/TLS certificates at all. However, if you do want your sites to be available typically as subdomains of a domain name which you own then remove the *--onion-addresses-only yes* option from the last command shown above. Also see the [[./domains.html][guide on setting up an ICANN domain name]]. @@ -57,9 +53,8 @@ The *onion-addresses-only* option *does not* mean that everything gets routed th If you want to create images for microSD cards used within various single board computers then replace the *i386* with *beaglebone* / *cubieboard2* / *cubietruck* / *a20-olinuxino-lime* / *a20-olinuxino-lime2* / *a20-olinuxino-micro* or *apu*. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/beaglebone_black9.jpg]] -#+END_CENTER This takes a while. Maybe an hour or so, depending on the speed of your system and the internets. The good news though is that once created you can use the resulting image any number of times, and you don't need to trust some pre-built image. @@ -107,9 +102,8 @@ freedombone-client --verify This will show the hash code for the public ssh key of the Freedombone system. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/ssh_key_verify.jpg]] -#+END_CENTER Open another terminal window then run: @@ -120,15 +114,13 @@ ssh myusername@freedombone.local -p 2222 Use the password you wrote down earlier to log in. Select the *administrator control panel* with up and down cursor keys, space bar and enter key. You should see something like this, and you might need to re-enter your password. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/controlpanel/control_panel.jpg]] -#+END_CENTER Then select *About*. You'll see a list of sites and their onion addresses. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/controlpanel/control_panel_about.jpg]] -#+END_CENTER The About screen contains the ssh server public key hashes and you can compare the relevant one with the previous terminal window to verify that they're the same. If they're not then you might have a /machine-in-the-middle/ snooping on you. @@ -136,9 +128,8 @@ You have now confirmed a secure connection. Probably. If you're still sceptical Press any key to exit from the About screen. You can then select *Add/Remove apps* and add whatever applications you wish to run. Note that some apps will only run on x86 systems, but most will install and run on ARM single board computers. More details on particular apps can be [[./apps.html][found here]]. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/controlpanel/control_panel_apps.jpg]] -#+END_CENTER Once your apps have installed you can go back to the About screen, pick an onion address and try it within a Tor compatible browser. You'll need to know the login passwords and those can be found within the /Passwords/ section of the administrator control panel. An axiom of the Freedombone system is that /if given the choice users will usually use insecure passwords/, so on this system passwords are generated randomly. If you need to then you can transfer the passwords into your favourite password manager and remove them from the server by going to the *Security Settings* section of the administrator control panel and choosing *Export passwords* and *Password storage*. @@ -152,6 +143,5 @@ Of course, this is just one way in which you can install the Freedombone system. man freedombone-image #+end_src -#+BEGIN_CENTER -This site can also be accessed via a Tor browser at http://yjxlc3imv7obva4grjae6u3qw527koaytrgjgdp364hmthrst3jodiid.onion -#+END_CENTER +#+attr_html: :width 10% :height 2% :align center +[[file:fdl-1.3.txt][file:images/gfdl.png]] diff --git a/doc/EN/index.org b/doc/EN/index.org index ae54ada9..1ef2e528 100644 --- a/doc/EN/index.org +++ b/doc/EN/index.org @@ -1,48 +1,25 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server +#+KEYWORDS: freedombone +#+DESCRIPTION: Freedombone project #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -[[file:images/bbb3.png]] -#+END_CENTER -#+begin_quote -"/With the increasing move of our computing to cloud infrastructures, we give up the control of our computing to the managers of those infrastructures. Our terminals (laptops, desktops) might now be running entirely on Free Software, but this is increasingly irrelevant given that most of what actually matters gets executed on a remote closed system that we don’t control. The Free Software community needs to work to help users keep the control of all their computing, by developing suitable alternatives and facilitating their deployment./" +So you want to run your own internet services? Email, chat, VoIP, web sites, file synchronisation, wikis, blogs, social networks, media hosting, backups, VPN. Freedombone is a home server system which enables you to self-host all of these things. --- Lucas Nussbaum -#+end_quote +You can run Freedombone on an old laptop or a single board computer. See the [[./installmethods.html][list of installation methods]]. You can also use it to [[./mesh.html][set up a mesh network]] in your local area. -So you want to run your own internet services? Email, chat, VoIP, web sites, file synchronisation, wikis, blogs, social networks, media hosting, backups, VPN. Freedombone enables you to do all of that in a self-hosted way, where you keep control of your data and it resides in your own home. - -A list of other supported ARM boards [[./boards.html][can be found here]], or you can install onto an old laptop or netbook. Some installation instructions for different use cases are: - - * [[./homeserver.html][Typical installation]] - * Installing [[./beaglebone.html][on a Beaglebone Black]] - * Installing on an [[./debianinstall.html][existing Debian system]] - * Installing [[./armbian.html][on Armbian]], for unsupported ARM boards such as Raspberry Pi - * Creating a dedicated [[./socialinstance.html][fediverse instance]] for a single user or to host a community - * Deploying a [[./mesh.html][mesh network]] which can operate with or without the internet - -After installation it's possible that you might want some advice on how to run your system and set up apps to work nicely with it. - - * [[./domains.html][How to get a domain name]] - * [[./security.html][Improving security]] - * [[./users.html][Adding or removing users]] - * [[./apps.html][Apps available on the system]] - * [[./faq.html][Frequently Asked Questions]] - * [[./mobile.html][Advice on setting up a mobile phone]] - * [[./support.html][I like this project. How can I help to support it?]] +Check out the [[./apps.html][list of available apps]] and [[./faq.html][Frequently Asked Questions]] section. Recent developments are also described on [[https://blog.freedombone.net/tag/freedombone][the blog]]. +Disk images which can be cloned straight to USB or microSD drives are [[./downloads/v31][available here]]. If you find bugs, or want to add a new app to this system see the [[./devguide.html][Developers Guide]] and [[./codeofconduct.html][Code of Conduct]]. There is a Matrix chat room available at *#fbone:matrix.freedombone.net*. -Ready made disk images which can be copied onto USB or microSD drives are [[./downloads/current][available here]]. +If you like this project and want to support continued development then [[./support.html][here's what to do]]. -#+BEGIN_CENTER -This site can also be accessed via a Tor browser at http://yjxlc3imv7obva4grjae6u3qw527koaytrgjgdp364hmthrst3jodiid.onion. This documentation is under the [[https://www.gnu.org/licenses/fdl-1.3.txt][GNU Free Documentation License version 1.3]] -#+END_CENTER +#+attr_html: :width 10% :height 2% :align center +[[file:fdl-1.3.txt][file:images/gfdl.png]] diff --git a/doc/EN/installation.org b/doc/EN/installation.org index 3fca1d84..f5d8acf1 100644 --- a/doc/EN/installation.org +++ b/doc/EN/installation.org @@ -1,20 +1,15 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, hubzilla, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server +#+KEYWORDS: freedombone, installation +#+DESCRIPTION: Freedombone installation #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Installation

-
-#+END_EXPORT +* Installation | [[Building an image for a Single Board Computer or Virtual Machine]] | | [[Checklist]] | diff --git a/doc/EN/installmethods.org b/doc/EN/installmethods.org new file mode 100644 index 00000000..a93226dc --- /dev/null +++ b/doc/EN/installmethods.org @@ -0,0 +1,31 @@ +#+TITLE: +#+AUTHOR: Bob Mottram +#+EMAIL: bob@freedombone.net +#+KEYWORDS: freedombone, installation +#+DESCRIPTION: Installation methods +#+OPTIONS: ^:nil toc:nil +#+HTML_HEAD: + +#+attr_html: :width 80% :height 10% :align center +[[file:images/logo.png]] + +Most people don't have a static external IP address, so you will need to have an account on a dymanic DNS service. [[https://freedns.afraid.org][FreeDNS]] is the one recommended, but others are available. + +If you want systems to be available within an ordinary web browser, such as Firefox, then you will need to [[./domains.html][obtain a domain name]]. + +A list of other supported ARM boards [[./boards.html][can be found here]], or you can install onto an old laptop or netbook. Some installation instructions for different use cases are: + + * [[./homeserver.html][Typical installation]] + * Installing [[./beaglebone.html][on a Beaglebone Black]] + * Installing on an [[./debianinstall.html][existing Debian system]] + * Installing [[./armbian.html][on Armbian]], for unsupported ARM boards such as Raspberry Pi + * Creating a dedicated [[./socialinstance.html][fediverse instance]] for a single user or to host a community + * Deploying a [[./mesh.html][mesh network]] which can operate with or without the internet + * [[./users.html][Adding or removing users]] + * [[./security.html][Improving security]] + * [[./mobile.html][Advice on setting up a mobile phone]] + * [[./apps.html][Apps available on the system]] + * [[./faq.html][Frequently Asked Questions]] + +#+attr_html: :width 10% :height 2% :align center +[[file:fdl-1.3.txt][file:images/gfdl.png]] diff --git a/doc/EN/mesh.org b/doc/EN/mesh.org index aab59e7f..9e8d8e97 100644 --- a/doc/EN/mesh.org +++ b/doc/EN/mesh.org @@ -1,18 +1,15 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server +#+KEYWORDS: freedombone, mesh +#+DESCRIPTION: Freedombone mesh network #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+begin_export html -

Mesh Network

-#+end_export +* Mesh Network The Freedombone Mesh is a wireless solution for autonomous or internet connected communication that can be rapidly deployed in temporary, emergency or post-disaster situations where internet access is unavailable or compromised. @@ -22,9 +19,8 @@ The Freedombone Mesh is a wireless solution for autonomous or internet connected * [[./mesh_custom.html][Customisation]] * [[./mesh_usage.html][How to use it]] -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/mesh_desktop1.png]] -#+END_CENTER Mesh networks are useful as a quick way to make a fully decentralised communications system which is not connected to or reliant upon the internet. Think festivals, hacker conferences, onboard ships at sea, disaster/war zones, small businesses who don't want the overhead of server maintenance, protests, remote areas of the world, temporary "digital blackouts", scientific expeditions and off-world space colonies. @@ -34,6 +30,5 @@ Systems only need to be within wifi range of each other for the mesh to be creat Like [[https://libremesh.org][LibreMesh]], this system uses a combination of [[https://en.wikipedia.org/wiki/B.A.T.M.A.N.][batman-adv]] on network layer 2 and [[http://bmx6.net][BMX]] on layer 3. Routing protocols [[http://www.olsr.org][OLSR2]] and [[https://www.irif.fr/~jch/software/babel][Babel]] are also selectable. -#+BEGIN_CENTER -This site can also be accessed via a Tor browser at http://yjxlc3imv7obva4grjae6u3qw527koaytrgjgdp364hmthrst3jodiid.onion -#+END_CENTER +#+attr_html: :width 10% :height 2% :align center +[[file:fdl-1.3.txt][file:images/gfdl.png]] diff --git a/doc/EN/mesh_capabilities.org b/doc/EN/mesh_capabilities.org index 5adf8d8e..fb6066da 100644 --- a/doc/EN/mesh_capabilities.org +++ b/doc/EN/mesh_capabilities.org @@ -1,18 +1,15 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server +#+KEYWORDS: freedombone, mesh +#+DESCRIPTION: Freedombone mesh network capabilities #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+begin_export html -

Mesh Network: Capabilities

-#+end_export +* Mesh Network: Capabilities The mesh system has the following capabilities: @@ -33,3 +30,6 @@ The mesh system has the following capabilities: - Publicly shared data is /content addressable/ This system should be quite scalable. Both qTox and IPFS are based upon distributed hash tables (DHT) so that each peer does not need to store the full index of data for the entire network. Gossiping between SSB peers may be slower, but the [[https://en.wikipedia.org/wiki/Small-world_network][small world effect]] will presumably still make for quite efficient delivery in a large network. Caching or pinning of IPFS data and its content addressability means that if a file or blog becomes popular then performance should improve as the number of downloads increases, which is the opposite of the client/server paradigm. + +#+attr_html: :width 10% :height 2% :align center +[[file:fdl-1.3.txt][file:images/gfdl.png]] diff --git a/doc/EN/mesh_custom.org b/doc/EN/mesh_custom.org index 29596d8e..82ca14ad 100644 --- a/doc/EN/mesh_custom.org +++ b/doc/EN/mesh_custom.org @@ -1,19 +1,20 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server +#+KEYWORDS: freedombone, mesh +#+DESCRIPTION: Freedombone mesh network customisation #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+begin_export html -

Mesh Network: Customisation

-#+end_export +* Mesh Network: Customisation If you want to make your own specially branded version, such as for a particular event, then to change the default desktop backgrounds edit the images within *img/backgrounds* and to change the available avatars and desktop icons edit the images within *img/avatars*. Re-create disk images using the instructions shown previously. If you need particular /dconf/ commands to alter desktop appearance or behavior then see the function /mesh_client_startup_applications/ within *src/freedombone-image-customise*. + + +#+attr_html: :width 10% :height 2% :align center +[[file:fdl-1.3.txt][file:images/gfdl.png]] diff --git a/doc/EN/mesh_images.org b/doc/EN/mesh_images.org index 20534c8b..64c16ad8 100644 --- a/doc/EN/mesh_images.org +++ b/doc/EN/mesh_images.org @@ -1,18 +1,15 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server +#+KEYWORDS: freedombone, mesh +#+DESCRIPTION: Freedombone mesh network images #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+begin_export html -

Mesh Network: Images

-#+end_export +* Mesh Network: Images * Pre-built Disk Images ** Writing many images quickly @@ -33,19 +30,16 @@ sudo apt-get install gnome-multi-writer The MultiWriter tool is also available within mesh client images, so that you can use mesh systems to create more copies of the same system. ** Client images -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/mesh_netbook.jpg]] -#+END_CENTER "Client" isn't exactly the right term, but it's a mesh peer with a user interface. These images can be copied to a USB drive, then you can plug it into a laptop/netbook/desktop machine and boot from it. You will probably also need an Atheros USB wifi dongle (the black protruding object on the left side of the netbook in the picture above), because most built-in wifi usually requires proprietary firmware. In the commands below substitute /dev/sdX with the USB drive device, excluding any trailing numbers (eg. /dev/sdb). The USB drive you're copying to will need to be at least 16GB in size. #+begin_src bash sudo apt-get install xz-utils wget -wget https://freedombone.net/downloads/current/freedombone-meshclient-i386.img.xz -wget https://freedombone.net/downloads/current/freedombone-meshclient-i386.img.xz.sig +wget https://freedombone.net/downloads/v31/freedombone-meshclient-i386.img.xz +wget https://freedombone.net/downloads/v31/freedombone-meshclient-i386.img.xz.sig gpg --verify freedombone-meshclient-i386.img.xz.sig -sha256sum freedombone-meshclient-i386.img.xz -49391230de6a4f1966db091813deb8f9d93c947677f5483baa52400d7fcba7d3 unxz freedombone-meshclient-i386.img.xz sudo dd if=/dev/zero of=/dev/sdX bs=1M count=8 sudo dd bs=1M if=freedombone-meshclient-i386.img of=/dev/sdX conv=fdatasync @@ -57,11 +51,9 @@ If you're in an emergency and don't have Atheros wifi dongles then there is also #+begin_src bash sudo apt-get install xz-utils wget -wget https://freedombone.net/downloads/current/freedombone-meshclient-insecure-i386.img.xz -wget https://freedombone.net/downloads/current/freedombone-meshclient-insecure-i386.img.xz.sig +wget https://freedombone.net/downloads/v31/freedombone-meshclient-insecure-i386.img.xz +wget https://freedombone.net/downloads/v31/freedombone-meshclient-insecure-i386.img.xz.sig gpg --verify freedombone-meshclient-insecure-i386.img.xz.sig -sha256sum freedombone-meshclient-insecure-i386.img.xz -c11783741e66df5072ffcbef8d9b04260a2298d84e33c72fefa4bb539d094810 unxz freedombone-meshclient-insecure-i386.img.xz sudo dd if=/dev/zero of=/dev/sdX bs=1M count=8 sudo dd bs=1M if=freedombone-meshclient-insecure-i386.img of=/dev/sdX conv=fdatasync @@ -70,16 +62,15 @@ sudo dd bs=1M if=freedombone-meshclient-insecure-i386.img of=/dev/sdX conv=fdata ** Router images Routers are intended to build network coverage for an area using small and low cost hardware. You can bolt them to walls or leave them on window ledges. They don't have any user interface and their only job is to haul network traffic across the mesh and to enable peers to find each other via running bootstrap nodes for Tox and IPFS. Copy the image to a microSD card and insert it into the router, plug in an Atheros wifi dongle and power on. That should be all you need to do. *** Beaglebone Black -#+BEGIN_CENTER +#+attr_html: :width 50% :align center [[file:images/mesh_router.jpg]] -#+END_CENTER The above picture shows a Beaglebone Black with the image copied onto a microSD card (there's no need to do anything with the internal EMMC). A USB Atheros wifi adaptor with a large antenna is attached and in this case power is from the mains, although it could be from a battery or solar power system capable of supplying 5 volts and maybe 1A (depending upon how active the router is). #+begin_src bash sudo apt-get install xz-utils wget -wget https://freedombone.net/downloads/current/freedombone-mesh_beaglebone-armhf.img.xz -wget https://freedombone.net/downloads/current/freedombone-mesh_beaglebone-armhf.img.xz.sig +wget https://freedombone.net/downloads/v31/freedombone-mesh_beaglebone-armhf.img.xz +wget https://freedombone.net/downloads/v31/freedombone-mesh_beaglebone-armhf.img.xz.sig gpg --verify freedombone-mesh_beaglebone-armhf.img.xz.sig sha256sum freedombone-mesh_beaglebone-armhf.img.xz ad8f22c0d46c98a80aa47b5809402971cf5cf26ebf587c59a667307b2386c3d2 @@ -98,11 +89,9 @@ First you will need to create an image. On a Debian based system (tested on Debi #+begin_src bash sudo apt-get -y install git wget build-essential -wget https://freedombone.net/downloads/current/freedombone.tar.gz -wget https://freedombone.net/downloads/current/freedombone.tar.gz.sig +wget https://freedombone.net/downloads/v31/freedombone.tar.gz +wget https://freedombone.net/downloads/v31/freedombone.tar.gz.sig gpg --verify freedombone.tar.gz.sig -sha256sum freedombone.tar.gz -afbb536564140aa28c6491d45b7474ced5a0b018539ffd3e96b13b242a41792e tar -xzvf freedombone.tar.gz cd freedombone git checkout stretch @@ -147,3 +136,7 @@ freedombone-image -t beaglebone -v mesh #+end_src The resulting image can be copied to a microSD card, inserted into a Beaglebone Black and booted. Don't forget to plug in an Atheros USB wifi dongle. + + +#+attr_html: :width 10% :height 2% :align center +[[file:fdl-1.3.txt][file:images/gfdl.png]] diff --git a/doc/EN/mesh_philosophic.org b/doc/EN/mesh_philosophic.org index b52f8cef..0bd9d168 100644 --- a/doc/EN/mesh_philosophic.org +++ b/doc/EN/mesh_philosophic.org @@ -1,18 +1,15 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, mesh -#+DESCRIPTION: Turn any laptop or a Beaglebone Black into an off-the-grid mesh peer +#+KEYWORDS: freedombone, mesh +#+DESCRIPTION: Philosophy of the Freedombone mesh #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+begin_export html -

Mesh Network: Philosophic

-#+end_export +* Mesh Network: Philosophic #+begin_quote "/I see mesh networks naturally evolving to become the dominant form of network over the next few decades, because it’s the most practical solution to a number of problems that will have to be solved in order to build the VR web as well as to connect the entire world to the internet. Centralized networks are only possible in highly developed countries with existing infrastructures like power and telephone grids, as well as roads. You can’t build a tower where you don’t have either power or access. For vast areas of the world, mesh networks will be the only feasible solution./" -- Valkyrie Ice @@ -49,3 +46,7 @@ While the network will have the capacity to exchange information with Internet u * Evolvable The network should be built with future development in mind. The platform should be flexible enough to support technologies, protocols and modes of usage that have not yet been developed. + + +#+attr_html: :width 10% :height 2% :align center +[[file:fdl-1.3.txt][file:images/gfdl.png]] diff --git a/doc/EN/mesh_usage.org b/doc/EN/mesh_usage.org index 477c0a69..64cb6590 100644 --- a/doc/EN/mesh_usage.org +++ b/doc/EN/mesh_usage.org @@ -1,18 +1,15 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server +#+KEYWORDS: mesh, network, freedombone +#+DESCRIPTION: How to use the Freedombone mesh network #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+begin_export html -

Mesh Network: How to use it

-#+end_export +* Mesh Network: How to use it * [[Boot trouble]] * [[Set the Date]] @@ -28,9 +25,9 @@ When you first boot from the USB drive the system will create some encryption keys, assign a unique network address to the system and then reboot itself. When that's done you should see a prompt asking for a username. This username just makes it easy for others to initially find you on the mesh and will appear in the list of users. -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/mesh_initial_login.jpg]] -#+END_CENTER + After a minute or two if you are within wifi range and there is at least one other user on the network then you should see additional icons appear on the desktop, such as /Other Users/ and /Chat/. @@ -47,17 +44,14 @@ Unlike with ordinary wifi, on the mesh you don't get a signal strength icon and Select the wifi icon on the desktop and enter the password '/freedombone/'. The network configuration will go into a monitoring mode and in the bottom right side of the window you will be able to see signal strength and other parameters. This can help you to locate systems or adjust antennas to get the best wifi performance. - -#+BEGIN_CENTER +#+attr_html: :width 70% :align center [[file:images/mesh_signal.jpg]] -#+END_CENTER When you are finished close the window and then select the /Network Restart/ desktop icon, which will restart the B.A.T.M.A.N. network. You can also use the restart icon if you are within range of the mesh network but the /Chat/ and /Other Users/ icons do not automatically appear after a few minutes. * Connecting to the internet -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/mesh_architecture2.jpg]] -#+END_CENTER If you need to be able to access the internet from the mesh then connect one of the peers to an internet router using an ethernet cable (shown as yellow above), then reboot it. Other peers in the mesh, including any attached mobile devices, will then be able to access the internet using the ethernet attached peer as a gateway. [[https://en.wikipedia.org/wiki/Freifunk][Freifunk]] works in a similar way. @@ -72,17 +66,15 @@ sudo openvpn myclient.ovpn Where /myclient.ovpn/ comes from your VPN provider and with the password "/freedombone/". * Connecting two meshes over the internet via a VPN tunnel -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/mesh_architecture_vpn.jpg]] -#+END_CENTER Maybe the internet exists, but you don't care about getting any content from it and just want to use it as a way to connect mesh networks from different geographical locations together. In your home directory on a system connected via ethernet to an internet router you'll find a file called *vpn.tar.gz*. If you want another mesh to be able to connect to yours then send them this file and get them to uncompress it into their home directory also on an internet gateway machine. If they have an external IP address or domain name for your router then they will be able to VPN connect using the *Connect Meshes* icon. They should also forward port 653 from their internet router to the mesh gateway machine. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/mesh_connect.png]] -#+END_CENTER You should create a new *vpn.tar.gz* file for every other mesh which wants to be able to connect to yours. If you are prompted for a password it is 'freedombone'. @@ -90,52 +82,45 @@ From a deep packet inspection point of view the traffic going over the internet * Mobile devices (phones, etc) -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/mesh_architecture3.jpg]] -#+END_CENTER To allow mobile devices to connect to the mesh you will need a second wifi adapter connected to your laptop/netbook/SBC. Plug in a second wifi adapter then reboot the system. The second adaptor will then create a wifi hotspot (the connection shown in green above) which mobile devices can connect to. The hotspot name also contains its local IP address (eg. "/mesh-192.168.1.83/"). On a typical Android device go to *Settings* then *Security* and ensure that *Unknown sources* is enabled. Also within *Wifi* from the *Settings* screen select the mesh hotspot. The password is "/freedombone/". Open a non-Tor browser and navigate to the IP address showing in the hotspot name. You can then download and install mesh apps. -#+BEGIN_CENTER +#+attr_html: :width 50% :align center [[file:images/mesh_mobileapps.jpg]] -#+END_CENTER On some android devices you may need to move the downloaded APK file from the *Downloads* directory to your *home* directory before you can install it. * Chat System Ensure that you're within wifi range of at least one other mesh peer (could be a router or client) and then you should see that the /Chat/ and /Other Users/ icons appear. Select the users icon and you should see a list of users on the mesh. -#+BEGIN_CENTER +#+attr_html: :width 50% :align center [[file:images/mesh_peerslist.png]] -#+END_CENTER Selecting a user followed by the Ok button will copy their Tox ID to the clipboard. Now select the /Chat/ icon and once you are connected you should see the status light turn green. If after a few minutes you don't get the green status light then try closing and re-opening the Tox chat application. Select the plus button to add a friend and then paste in a Tox ID. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/mesh_paste_tox_id.jpg]] -#+END_CENTER The other user can then accept or decline your friend request. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/mesh_friend_request.jpg]] -#+END_CENTER You can also select an avatar by selecting the grey head and shoulders image. -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/mesh_choose_avatar.jpg]] -#+END_CENTER And by selecting the user from the list on the left hand side the chat can begin. -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/mesh_text_chat.jpg]] -#+END_CENTER One important point is that by default the microphone is turned off. When doing voice chat you can select the microphone volume with the drop down slider in the top right corner of the screen. @@ -144,15 +129,13 @@ At present video doesn't work reliably, but text and voice chat do work well. * Collaborative document editing The mesh system includes the ability to collaboratively edit various sorts of documents using CryptPad. CryptPad is an almost peer-to-peer system in that it is designed for a client/server environment but that the server aspect of it is very minimal and limited to orchestrating the connected clients. With CryptPad installed on each mesh peer it effectively enables peer-to-peer collaborative editing. Documents are ephemeral and forgotten unless they're exported or copy-pasted to permanent storage. -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/mesh_cryptpad1.jpg]] -#+END_CENTER To create a document click on the CryptPad icon. Depending upon the specifications of your system it may take a few seconds to load, so don't be too disturned if the browser contents look blank for a while. Select _Rich Text Pad_ and give yourself a username. -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/mesh_cryptpad2.jpg]] -#+END_CENTER If you have the chat system running you can then copy and paste the URL for your pad into the chat, and the other user can then open the link and edit the document with you. You can repeat that for however many other users you wish to be able to edit. @@ -162,44 +145,42 @@ Patchwork is available as a social networking system for the mesh. Like all soci Double click on the "Social" icon to open the app, then add your nickname and optionally a description. If you want to choose an avatar image some can be found within the directory */usr/share/freedombone/avatars*. On older systems or systems without a hardware random number generator, Patchwork sometimes takes a long time (a few minutes) to open for the first time after clicking the icon. This is most likely due to the initial generation of encryption keys, so be patient. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/patchwork_setup.jpg]] -#+END_CENTER Other Patchwork users on the mesh will appear automatically under the *local* list and you can select and follow them if you wish. It's also possible to select the dark theme from *settings* on the drop down menu if you prefer. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/patchwork_public.jpg]] -#+END_CENTER The Secure Scuttlebutt protocol which Patchwork is based upon is intended to be robust to intermittent network connectivity, so you can write posts when out of range and they will sync once you are back in the network. * Sharing Files You can make files publicly available on the network simply by dragging and dropping them into the /Public/ folder on the desktop. To view the files belonging to another user select the desktop icon called /Visit a site/ and enter the username or Tox ID of the other user. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/mesh_share_files.jpg]] -#+END_CENTER * Blogging To create a blog post select the /Blog/ icon on the desktop and then select *New blog entry* and *Ok*. Edit the title of the entry and add your text. You can also include photos if you wish - just copy them to the *CreateBlog/content/images* directory and then link to them as shown. -#+BEGIN_CENTER +#+attr_html: :width 50% :align center [[file:images/mesh_blog.png]] -#+END_CENTER To finish your blog entry just select /Save/ and then close the editor. On older hardware it may take a while to publish the results, and this depends upon the amount of computation needed by IPFS to create file hashes. If you make no changes to the default text then the new blog entry will not be saved. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/mesh_new_blog2.jpg]] -#+END_CENTER -#+BEGIN_CENTER + +#+attr_html: :width 80% :align center [[file:images/mesh_view_blog.jpg]] -#+END_CENTER You can also visit other blogs, edit or delete your previous entry and change your blog theme. -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[file:images/mesh_select_blog_theme.png]] -#+END_CENTER + + +#+attr_html: :width 10% :height 2% :align center +[[file:fdl-1.3.txt][file:images/gfdl.png]] diff --git a/doc/EN/meshindex.org b/doc/EN/meshindex.org index 8fcf23aa..59cf2e9d 100644 --- a/doc/EN/meshindex.org +++ b/doc/EN/meshindex.org @@ -6,16 +6,11 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Welcome to the Freedombone Mesh

-The following apps are available: -
-#+END_EXPORT +* Welcome to the Freedombone Mesh +>>>>>>> 8161704e106728bec7e22d3211109faa06801081 #+BEGIN_EXPORT html
diff --git a/doc/EN/mirrors.org b/doc/EN/mirrors.org deleted file mode 100644 index f3f47737..00000000 --- a/doc/EN/mirrors.org +++ /dev/null @@ -1,47 +0,0 @@ -#+TITLE: -#+AUTHOR: Bob Mottram -#+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Mirroring git repositories -#+OPTIONS: ^:nil toc:nil -#+HTML_HEAD: - -#+BEGIN_CENTER -[[file:images/logo.png]] -#+END_CENTER - -#+BEGIN_EXPORT html -
-

Mirrors

-
-#+END_EXPORT - -| [[What are mirrors and why do they exist?]] | -| [[What security do mirrors have?]] | -| [[How do I set up mirrors?]] | -| [[Do mirrors include debian package repositories?]] | -| [[What do I need to do to keep the mirrored repositories updated?]] | - -* What are mirrors and why do they exist? -It would be nice if all of the applications used by this project were packaged for Debian, but currently they're not. This means that various upstream git repositories are used and these mostly reside on Github. What if Github were to go away, become paying only or be censored in some manner which was difficult to work around? To guard against this possibility the repositories are mirrored on each install and can then be made available to other users so that new installations or updates could still occur without the original default repos. -* What security do mirrors have? -On each install you have a /mirrors/ user created, whose only purpose is to mirror upstream repositories. A random password is generated for the /mirrors/ user which can be seen within the control panel and so given to other users who may need it. -* How do I set up mirrors? -The interactive installer will ask whether you want to configure the main respositories. Enter the URL, which will typically be an onion address, the ssh port number and the password for the mirrors on that system. -* Do mirrors include debian package repositories? -No. Packages for Debian will still be accessed in the conventional manner. -* Can I change mirrors after the system has been installed -Yes. From the control panel select "/Set the main repository/" - -#+BEGIN_CENTER -[[file:images/controlpanel/control_panel_mirrors.jpg]] -#+END_CENTER - -* What do I need to do to keep the mirrored repositories updated? -Nothing. That happens as part of regular automatic updates. - -#+BEGIN_EXPORT html -
-Return to the home page -
-#+END_EXPORT diff --git a/doc/EN/mobile.org b/doc/EN/mobile.org index 1fb82841..3e5811d1 100644 --- a/doc/EN/mobile.org +++ b/doc/EN/mobile.org @@ -1,20 +1,15 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server +#+KEYWORDS: freedombone, mobile +#+DESCRIPTION: Freedombone mobile setup #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Mobile

-
-#+END_EXPORT +* Mobile Mobile phones are insecure devices, but they're regarded as being so essential to modern life that telling people not to use them isn't a viable option. Here are some recommendations on setting up a mobile phone (aka "smartphone") to work with Freedombone. @@ -79,7 +74,7 @@ In F-droid under the *repositories* menu you can enable the *guardian project*, * Email The easiest way to access email is by installing the [[./app_mailpile.html][Mailpile]] app. This keeps your GPG keys off of possibly insecure mobile devices but still enables encrypted email communications in an easy way. You can use K9 mail if you prefer, but that will require installing OpenKeychain and having your GPG keys on the device, which is a lot more risky. * Services -For information on configuring various apps to work with Freedombone see the [[file:./usage.html][usage section]]. Also see advice on chat apps in the [[file:./faq.html][FAQ]]. +For information on configuring various apps to work with Freedombone see the [[file:./apps.html][apps section]]. Also see advice on chat apps in the [[file:./faq.html][FAQ]]. * Battery Even with free software apps it's not difficult to get into a situation where your battery doesn't last for long. To maximize battery life access RSS feeds via the onion-based mobile reader within a Tor-compatible browser and not from a locally installed RSS app. @@ -145,3 +140,7 @@ Once that's done you may want to set *Root access* on the device back to *Disabl Return to the home page
#+END_EXPORT + + +#+attr_html: :width 10% :height 2% :align center +[[file:fdl-1.3.txt][file:images/gfdl.png]] diff --git a/doc/EN/related.org b/doc/EN/related.org deleted file mode 100644 index b9a64e93..00000000 --- a/doc/EN/related.org +++ /dev/null @@ -1,49 +0,0 @@ -#+TITLE: -#+AUTHOR: Bob Mottram -#+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, hubzilla, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server -#+OPTIONS: ^:nil toc:nil -#+HTML_HEAD: - -#+BEGIN_CENTER -[[file:images/logo.png]] -#+END_CENTER - -#+BEGIN_EXPORT html -
-

Related Projects

-
-#+END_EXPORT - -#+BEGIN_EXPORT html -
-The following projects made Freedombone possible.
- - - - - - - - - - - - - - - - - - - - - - - - - -
Nginx
Openssl
Gnupg
Debian
Freedombox
Beagleboard
Dokuwiki
GNU Social
Hubzilla
Tor
Prosody
Syncthing
Tox
Bettercrypto
-
-#+END_EXPORT diff --git a/doc/EN/release3.org b/doc/EN/release3.org index ba8984e7..4c890a59 100644 --- a/doc/EN/release3.org +++ b/doc/EN/release3.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/release3.jpg]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Building an internet run by the users, for the users

-
-#+END_EXPORT +* Building an internet run by the users, for the users The internet may still be mostly in the clutches of a few giant megacorporations and dubious governments with sketchy agendas, but it doesn't have to remain that way. With the third version of the Freedombone system there is now more scope than before to take back your privacy, have ownership of personal data and run your own online communities without undesirable intermediaries. diff --git a/doc/EN/release31.org b/doc/EN/release31.org new file mode 100644 index 00000000..9df3bad0 --- /dev/null +++ b/doc/EN/release31.org @@ -0,0 +1,70 @@ +#+TITLE: +#+AUTHOR: Bob Mottram +#+EMAIL: bob@freedombone.net +#+KEYWORDS: freedombone +#+DESCRIPTION: Version 3.1 +#+OPTIONS: ^:nil toc:nil +#+HTML_HEAD: + +#+attr_html: :width 80% :height 10% :align center +[[file:images/logo.png]] + +* *Version 3.1* + +Newer and shinier than before, [[./index.html][Freedombone]] 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 [[./usage_email.html][email with onion and I2P addresses]]. New apps are: + + * [[./app_akaunting.html][Akaunting]]: Personal or small business accounts + * [[./app_bdsmail.html][bdsmail]]: Avoid PGP complexity by using email over I2P + * [[./app_bludit.html][Bludit]]: Painless markdown blogging + * [[./app_edith.html][Edith]]: The simplest possible note taking system + * [[./app_icecast.html][Icecast]]: Run your own internet radio station + * [[./app_peertube.html][PeerTube]]: Peer-to-peer video hosting system + * [[./app_pleroma.html][Pleroma]]: Ultra lightweight fediverse instance with Mastodon compatibility + +The [[./mesh.html][mesh version]] now supports BMX6, OLSR2 and Babel routing protocols on layer 3 and so is protocol compatible with [[https://libremesh.org][LibreMesh]]. 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. + +There is a new [[./socialinstance.html][social instance]] image build option, if you want to be able to rapidly deploy fediverse instances, and a [[./devguide.html][template command]] for quickly adding new apps to the system which automates a lot of the boilerplate. + +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 [[https://www.wired.co.uk/article/open-letter-mark-zuckerberg-congress][public criticism]] 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. + +This is where we make our stand. If the internet falls then so too does freedom. + +The future is decentralized. + +* Installation + +The simplest way to install is from a pre-made disk image. Images can be [[https://freedombone.net/downloads/v31][downloaded here]]. 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. + +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). + +#+BEGIN_SRC bash +unxz downloadedimagefile.img.xz +dd bs=1M if=downloadedimagefile.img of=/dev/sdX conv=fdatasync +#+END_SRC + +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 [[http://gparted.org][Gparted]]. Whether you need to do that will depend upon how many apps you intend to install and how much data they will store. + +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. + +As the system boots for the first time the login is: + +#+BEGIN_SRC bash +username: fbone +password: freedombone +#+END_SRC + +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: + +#+BEGIN_SRC bash +ssh fbone@freedombone.local -p 2222 +#+END_SRC + +Using the initial password "freedombone". If you have trouble accessing the server then make sure you have Avahi installed and [[https://en.wikipedia.org/wiki/Multicast_DNS][mDNS]] enabled. + +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. + +More detailed installation instructions are linked from [[./installmethods.html][the main site]]. + +* Upgrading from a previous install + +To upgrade from version 3 just go to the *administrator control panel* and select *check for updates*. diff --git a/doc/EN/security.org b/doc/EN/security.org index d2f21925..edcaaf23 100644 --- a/doc/EN/security.org +++ b/doc/EN/security.org @@ -6,9 +6,8 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER * Authentication with keys It's a lot more secure to log in to the Freedombone system using ssh keys rather than with a password. You can set that up by first running: diff --git a/doc/EN/socialinstance.org b/doc/EN/socialinstance.org index cade74e1..a57dd44c 100644 --- a/doc/EN/socialinstance.org +++ b/doc/EN/socialinstance.org @@ -6,15 +6,10 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT HTML -
-

Social Instance

-
-#+END_EXPORT +* Social Instance A social instance image allows you to easily set up a fediverse server, which federates using the OStatus or ActivityPub protocol. You will need: @@ -32,8 +27,8 @@ Substitute *sdX* with the device name for your USB drive. #+begin_src bash sudo apt-get install xz-utils wget -wget https://freedombone.net/downloads/current/freedombone-pleroma-amd64.img.xz -wget https://freedombone.net/downloads/current/freedombone-pleroma-amd64.img.xz.sig +wget https://freedombone.net/downloads/v31/freedombone-pleroma-amd64.img.xz +wget https://freedombone.net/downloads/v31/freedombone-pleroma-amd64.img.xz.sig gpg --verify freedombone-pleroma-amd64.img.xz.sig unxz freedombone-pleroma-amd64.img.xz sudo dd if=/dev/zero of=/dev/sdX bs=1M count=8 @@ -46,25 +41,22 @@ Also note that if the laptop has a removable SSD drive it's possible to copy the Plug the USB drive into the laptop and connect it to your internet router with the ethernet cable. -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/laptop_router.jpg]] -#+END_CENTER * Boot the laptop from the USB drive You may need to alter the BIOS settings to get this to work reliably. -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/bios_boot_usb.jpg]] -#+END_CENTER * Forward ports 80 (HTTP) and 443 (HTTPS) from your internet router to the laptop Log into your internet router using a non-Tor browser (usually it's on an address like 192.168.1.1 or 192.168.1.254). Often port forwarding settings are together with firewall settings. -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/port_forwarding.png]] -#+END_CENTER * From another machine ssh into the laptop @@ -82,12 +74,10 @@ Enter your user details, domain name and dynamic DNS settings. Navigate to your domain and register a new user. -#+BEGIN_CENTER +#+attr_html: :width 100% :align center [[file:images/pleroma_register.jpg]] -#+END_CENTER More details about setting up and using Pleroma [[./app_pleroma.html][can be found here]]. -#+BEGIN_CENTER +#+attr_html: :width 50% :align center [[file:images/tusky.jpg]] -#+END_CENTER diff --git a/doc/EN/support.org b/doc/EN/support.org index a8f8a514..33edf7a6 100644 --- a/doc/EN/support.org +++ b/doc/EN/support.org @@ -1,20 +1,15 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server +#+KEYWORDS: freedombone, support +#+DESCRIPTION: How to support the Freedombone project #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER -#+BEGIN_EXPORT html -
-

Support

-
-#+END_EXPORT +* Support * Contact details @@ -48,9 +43,9 @@ A better design for this website would be nice to have. Photos, icons or other a ** Howto videos If you're good at making videos then a howto for installing Freedombone onto various types of hardware, or testing the mesh system in realistic/exotic scenarios would be good. You could even host videos on PeerTube or Mediagoblin. ** More education and promotion -#+BEGIN_CENTER +#+attr_html: :width 50% :align center [[./images/educate.png]] -#+END_CENTER + Many people are unaware that running their own internet services /is even a possibility/. Many also believe that internet services can be provided only if they're supported by advertising or donations, and that only gigantic data centres have enough computing capacity to serve web pages on a worldwide scale. Others may be fearful of encryption due to misrepresentations or misunderstandings of it in the mainstream media. Some may be intimidated by the apparent complexity and think that you need to be some sort of silicon valley genius in order to run a web service on your own. Even many technically-minded folks often believe that they can't run a home server unless they have a static IP address, which isn't true, and others are put off by thinking that any such server will be immediately [[https://en.wikipedia.org/wiki/Pwn][pwned]] by blackhat hackers. Raising awareness beyond the near zero current level, overcoming fear and paranoia and dispelling some of the prevalent myths will definitely help. @@ -61,8 +56,5 @@ To add translations modify the json files within the *locale* subdirectory. Then ** Packaging Helping to package GNU Social and Hubzilla for Debian would be beneficial. -#+BEGIN_EXPORT html -
-Return to the home page -
-#+END_EXPORT +#+attr_html: :width 10% :height 2% :align center +[[file:fdl-1.3.txt][file:images/gfdl.png]] diff --git a/doc/EN/usage.org b/doc/EN/usage.org deleted file mode 100644 index 4bc059bd..00000000 --- a/doc/EN/usage.org +++ /dev/null @@ -1,96 +0,0 @@ -#+TITLE: -#+AUTHOR: Bob Mottram -#+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, hubzilla, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server -#+OPTIONS: ^:nil toc:nil -#+HTML_HEAD: - -#+BEGIN_CENTER -[[file:images/logo.png]] -#+END_CENTER - -#+BEGIN_EXPORT html -
-

Usage

-
-#+END_EXPORT - -| [[Improving security]] | -| [[Administrating the system via an onion address (Tor)]] | -| [[./mobile.html][Mobile advice]] | -| [[./usage_email.html][Using Email]] | -| [[./app_syncthing.html][Syncing to the Cloud]] | -| [[./app_dlna.html][Play Music]] | -| [[./app_gnusocial.html][Microblogging (GNU Social)]] | -| [[./app_postactiv.html][Microblogging (PostActiv)]] | -| [[./app_ghost.html][Blogging with Ghost]] | -| [[./app_htmly.html][Blogging with HTMLy]] | -| [[./app_hubzilla.html][Social Network]] | -| [[./app_lychee.html][Photo albums]] | -| [[./app_mediagoblin.html][Hosting video and audio content]] | -| [[./app_dokuwiki.html][Wiki]] | -| [[./app_etherpad.html][Collaborative document editing]] | -| [[./app_irc.html][Multi-user chat with IRC]] | -| [[./app_xmpp.html][XMPP/Jabber]] | -| [[./app_tox.html][Tox]] | -| [[./app_mumble.html][Mumble]] | -| [[./app_mailpile.jtml][Mailpile]] | -| [[./app_rss.html][RSS Reader]] | -| [[./app_radicale.html][CalDAV calendar server]] | -| [[./app_gogs.html][Git Projects]] | -| [[Adding or removing users]] | -| [[./app_pihole.html][Blocking Ads]] | -| [[./app_turtl.html][Making and sharing notes and images]] | - -* Improving security -It's a lot more secure to log in to the Freedombone system using ssh keys rather than with a password. You can set that up by first running: - -#+begin_src bash -freedombone-client -#+end_src - -On your local system (i.e. whatever you're logging in to the Freedombone system from, typically a laptop). Then: - -#+begin_src -ssh myusername@freedombone.local -p 2222 -#+end_src - -Select *Administrator controls* and re-enter your password, then *Manage Users* and *Change user ssh public key*. Copy and paste the ssh public keys which appeared after the *freedombone-client* command was run. Then go to *Security settings* and select *Allow ssh login with passwords* followed by *no*. - -You'll need to make sure that you have a copy of the ~/.ssh directory on your local system. You could just copy that directory to a USB drive and then keep that somewhere safe so that you can restore the keys if you need to. -* Administrating the system via an onion address (Tor) -You can also access your system via the Tor system using an onion address. To find out what the onion address for ssh access is you can do the following: - -#+BEGIN_SRC bash -ssh username@freedombone.local -p 2222 -#+END_SRC - -Select /Administrator controls/ then select "About this system" and look for the onion address for ssh. You can then close the terminal and open another, then do the following on your local system: - -#+BEGIN_SRC bash -freedombone-client -#+END_SRC - -This will set up your ssh environment to be able to handle onion addresses. Then you can test ssh with: - -#+BEGIN_SRC bash -ssh username@address.onion -p 2222 -#+END_SRC - -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. -* Adding or removing users -Log into the system with: - -#+BEGIN_SRC bash -ssh username@domainname -p 2222 -#+END_SRC - -Select *Administrator controls* then *User Management*. Depending upon the type of installation after selecting administrator controls you might need to enter: - -#+BEGIN_SRC bash -sudo su -control -#+END_SRC - -[[file:images/controlpanel/control_panel_manage_users.jpg]] diff --git a/doc/EN/usage_email.org b/doc/EN/usage_email.org index 75112993..b9de785b 100644 --- a/doc/EN/usage_email.org +++ b/doc/EN/usage_email.org @@ -1,14 +1,13 @@ #+TITLE: #+AUTHOR: Bob Mottram #+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, hubzilla, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server +#+KEYWORDS: freedombone, email +#+DESCRIPTION: How to use email on Freedombone #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER | [[Things to be aware of]] | | [[A technical note about email transport security]] | @@ -36,6 +35,8 @@ From https://motherboard.vice.com/read/email-encryption-is-broken: #+BEGIN_QUOTE /The researchers also uncovered mass scale attacks of STARTTLS sessions being stripped of their encryption. That attack itself isn't new: internet service providers sometimes do it to monitor users; organizations may use it to keep an eye on employees; or it may come from a malicious actor/ #+END_QUOTE + +A way to avoid these pitfalls altogether is to use onion addresses (see the section below) or [[./app_bdsmail.html][I2P addresses]] for email. These are not so convenient because they use long random strings which aren't memorable as addresses, but they do give a strong assurance that whoever recieves the message is the intended recipient and that emails can't be read passively during their transport across the internet. * Add a password to your GPG key If you didn't use existing GPG keys during the Freedombone installation then you'll need to add a password to your newly generated private key. This is highly recommended. Go through the following sequence of commands to ssh into the Freedombone and then change your GPG password. @@ -59,10 +60,8 @@ gpg --send-keys username@domainname exit #+END_SRC * Mutt email client - -#+BEGIN_CENTER +#+attr_html: :width 80% :align center [[./images/mutt.jpeg]] -#+END_CENTER Mutt is a terminal based email client which comes already installed onto the Freedombone. To access it you'll need to access it via ssh with: @@ -222,5 +221,13 @@ ssh username@domainname -p 2222 #+END_SRC Select /Administrator controls/ then *Email filtering rules* then *Block/Unblock and email address* or *Block/Unblock email with subject line*. Also see the manpage for *freedombone-ignore*. +* Using onion email addresses +By default this system comes with the ability to send and receive emails using onion addresses as the domain name. On the *user control panel* if you select *Show your email address* then you should find one ending with /dot onion/. You will also see a QR code for that address, which provides a simple way to transfer it to a mobile phone if necessary. + +If you want to give your onion email address to someone else securely then you can use the QR code to transfer it to a phone and copy and paste the address into an encrypted chat app, such as Conversations. Of course they will probably also need to be running Freedombone or some system capable of handling onion email addresses. + +When sending email from an onion address it's not strictly necessary to use GPG/PGP. Tor handles the transport security by itself. You can still use it though if you prefer to have an extra layer of message security. You can also still use onion email addresses even if your ISP blocks the typical email ports (25 and 465). + +If you don't make your onion email address public then it should be fairly resisent to spam, since spammers won't be able to randomly guess onion addresses (there are far too many), whereas it's a lot easier for them to do that with conventional domain names. * Using I2P for email transport For the most paranoid use cases it is also possible to use I2P as an email transport mechanism. This will of course require the people you're communicating with to have a similar setup in place. For details see the [[./app_bdsmail.html][bdsmail app]]. An advantage of this is that it's very unlikely that your email will get blocked. The disadvantage is that few others will be capable of receiving email this way, and it's only really usable via the Mutt email client. diff --git a/doc/EN/users.org b/doc/EN/users.org index 29be50d6..611adebc 100644 --- a/doc/EN/users.org +++ b/doc/EN/users.org @@ -6,9 +6,8 @@ #+OPTIONS: ^:nil toc:nil #+HTML_HEAD: -#+BEGIN_CENTER +#+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -#+END_CENTER Log into the system with: @@ -18,4 +17,8 @@ ssh username@domainname -p 2222 Select *Administrator controls* then *User Management*. +#+attr_html: :width 80% :align center [[file:images/controlpanel/control_panel_manage_users.jpg]] + +#+attr_html: :width 10% :height 2% :align center +[[file:fdl-1.3.txt][file:images/gfdl.png]] diff --git a/doc/EN/variants.org b/doc/EN/variants.org deleted file mode 100644 index a2bab6ab..00000000 --- a/doc/EN/variants.org +++ /dev/null @@ -1,50 +0,0 @@ -#+TITLE: -#+AUTHOR: Bob Mottram -#+EMAIL: bob@freedombone.net -#+KEYWORDS: freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber -#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server -#+OPTIONS: ^:nil toc:nil -#+HTML_HEAD: - -#+BEGIN_CENTER -[[file:images/logo.png]] -#+END_CENTER - -#+BEGIN_EXPORT html -
-

Variants

-
-#+END_EXPORT - -Freedombone may be installed either in its entirety or as different variants with a more specialised purpose. So for example if you just want to run a blog but don't care about any other services then you can do that. The following variants are available: - -#+BEGIN_EXPORT html -
- - - - - - - - - - - - - - - - - -
Mailbox
An email server with GPG encryption
Cloud
Sync and share files. Never lose important files again
Social
Social networking with Hubzilla and GNU Social
Media
Runs media services such as DLNA to play music or videos on your devices
Writer
Host your blog and wiki
Chat
Encrypted IRC, XMPP, Tox and VoIP services for one-to-one and many-to-many chat
Developer
Github-like system to host your software projects
Mesh
A wireless mesh network which is like the internet, but not the internet
-
-#+END_EXPORT - -Non-mesh installs also come with an RSS reader which provides strong reading privacy on desktop and mobile via the use of a Tor onion service. - -#+BEGIN_EXPORT html -
-Return to the home page -
-#+END_EXPORT diff --git a/img/backgrounds/freedombone_mesh_amnesic_background.png b/img/backgrounds/freedombone_mesh_amnesic_background.png index 561dc7b8..189e5788 100644 Binary files a/img/backgrounds/freedombone_mesh_amnesic_background.png and b/img/backgrounds/freedombone_mesh_amnesic_background.png differ diff --git a/img/backgrounds/freedombone_mesh_initial_background.png b/img/backgrounds/freedombone_mesh_initial_background.png index 6c7fa9b8..ad60df8f 100644 Binary files a/img/backgrounds/freedombone_mesh_initial_background.png and b/img/backgrounds/freedombone_mesh_initial_background.png differ diff --git a/img/controlpanel/control_panel.jpg b/img/controlpanel/control_panel.jpg index 99858df1..602ba789 100644 Binary files a/img/controlpanel/control_panel.jpg and b/img/controlpanel/control_panel.jpg differ diff --git a/img/gfdl.png b/img/gfdl.png new file mode 100644 index 00000000..6afde841 Binary files /dev/null and b/img/gfdl.png differ diff --git a/img/logo.png b/img/logo.png index add0f352..3611698c 100644 Binary files a/img/logo.png and b/img/logo.png differ diff --git a/img/logo_prev.png b/img/logo_prev.png new file mode 100644 index 00000000..add0f352 Binary files /dev/null and b/img/logo_prev.png differ diff --git a/img/mesh_initial_login.jpg b/img/mesh_initial_login.jpg index 8ecfaace..c414a4a0 100644 Binary files a/img/mesh_initial_login.jpg and b/img/mesh_initial_login.jpg differ diff --git a/img/onion.png b/img/onion.png new file mode 100644 index 00000000..dd239f5f Binary files /dev/null and b/img/onion.png differ diff --git a/man/freedombone-template.1.gz b/man/freedombone-template.1.gz index ecf1f597..8a2f18f5 100644 Binary files a/man/freedombone-template.1.gz and b/man/freedombone-template.1.gz differ diff --git a/src/freedombone-app-datserver b/src/freedombone-app-datserver new file mode 100755 index 00000000..11d4cb9b --- /dev/null +++ b/src/freedombone-app-datserver @@ -0,0 +1,377 @@ +#!/bin/bash +# +# _____ _ _ +# | __|___ ___ ___ _| |___ _____| |_ ___ ___ ___ +# | __| _| -_| -_| . | . | | . | . | | -_| +# |__| |_| |___|___|___|___|_|_|_|___|___|_|_|___| +# +# Freedom in the Cloud +# +# The main issue here is bootstrapping. What is running +# on the bootstrap server publicbits.org port 6881 ? +# +# Also it appears that users trying to clone have to +# register an account on datbase.org or another datbase +# server +# +# License +# ======= +# +# Copyright (C) 2018 Bob Mottram +# +# 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 . + +VARIANTS='full full-vim' + +IN_DEFAULT_INSTALL=0 +SHOW_ON_ABOUT=0 + +DATSERVER_DOMAIN_NAME= +DATSERVER_CODE= +DATSERVER_HYPERCORED_VERSION='1.4.1' +DATSERVER_DIRECTORY=/etc/datserver +DATSERVER_PORT=3282 + +# bootstrap servers are specified here +DATSERVER_BOOTSTRAP_FILE=$DATSERVER_DIRECTORY/node_modules/datland-swarm-defaults/index.js + +DATSERVER_DISCOVERY1='discovery1.publicbits.org' +DATSERVER_DISCOVERY2='discovery2.publicbits.org' +DATSERVER_BOOTSTRAP1='bootstrap1.publicbits.org:6881' +DATSERVER_BOOTSTRAP2='bootstrap2.publicbits.org:6881' +DATSERVER_BOOTSTRAP3='bootstrap3.publicbits.org:6881' +DATSERVER_BOOTSTRAP4='bootstrap4.publicbits.org:6881' + +datserver_variables=(MY_USERNAME + DATSERVER_DISCOVERY1 + DATSERVER_DISCOVERY2 + DATSERVER_BOOTSTRAP1 + DATSERVER_BOOTSTRAP2 + DATSERVER_BOOTSTRAP3 + DATSERVER_BOOTSTRAP4) + +function datserver_generate_bootstraps { + { echo "var extend = require('xtend')"; + echo ''; + echo "var DAT_DOMAIN = 'dat.local'"; + echo 'var DEFAULT_DISCOVERY = ['; + echo " '$DATSERVER_DISCOVERY1',"; + echo " '$DATSERVER_DISCOVERY2'"; + echo ']'; + echo 'var DEFAULT_BOOTSTRAP = ['; + echo " '$DATSERVER_BOOTSTRAP1',"; + echo " '$DATSERVER_BOOTSTRAP2',"; + echo " '$DATSERVER_BOOTSTRAP3',"; + echo " '$DATSERVER_BOOTSTRAP4'"; + echo ']'; + echo ''; + echo 'var DEFAULT_OPTS = {'; + echo ' dns: {server: DEFAULT_DISCOVERY, domain: DAT_DOMAIN},'; + echo ' dht: {bootstrap: DEFAULT_BOOTSTRAP}'; + echo '}'; + echo ''; + echo 'module.exports = function (opts) {'; + echo ' return extend(DEFAULT_OPTS, opts) // opts takes priority'; + echo '}'; } > $DATSERVER_BOOTSTRAP_FILE + + chown datserver:datserver $DATSERVER_BOOTSTRAP_FILE +} + +function datserver_configure_bootstraps { + read_config_param DATSERVER_DISCOVERY1 + read_config_param DATSERVER_DISCOVERY2 + + read_config_param DATSERVER_BOOTSTRAP1 + read_config_param DATSERVER_BOOTSTRAP2 + read_config_param DATSERVER_BOOTSTRAP3 + read_config_param DATSERVER_BOOTSTRAP4 + + data=$(mktemp 2>/dev/null) + dialog --backtitle $"Freedombone Control Panel" \ + --title $"dat bootstrap servers" \ + --form $"Specify discovery and bootstrap servers:\\n" 14 68 6 \ + $"Discovery 1:" 1 1 "$DATSERVER_DISCOVERY1" 1 15 50 99 \ + $"Discovery 2:" 2 1 "$DATSERVER_DISCOVERY2" 2 15 50 99 \ + $"Bootstrap 1:" 3 1 "$DATSERVER_BOOTSTRAP1" 3 15 50 99 \ + $"Bootstrap 2:" 4 1 $"$DATSERVER_BOOTSTRAP2" 4 15 50 99 \ + $"Bootstrap 3:" 5 1 $"$DATSERVER_BOOTSTRAP3" 5 15 50 99 \ + $"Bootstrap 4:" 6 1 $"$DATSERVER_BOOTSTRAP4" 6 15 50 99 \ + 2> "$data" + sel=$? + case $sel in + 1) rm -f "$data" + return;; + 255) rm -f "$data" + return;; + esac + DATSERVER_DISCOVERY1=$(sed -n 1p < "$data") + DATSERVER_DISCOVERY2=$(sed -n 2p < "$data") + DATSERVER_BOOTSTRAP1=$(sed -n 3p < "$data") + DATSERVER_BOOTSTRAP2=$(sed -n 4p < "$data") + DATSERVER_BOOTSTRAP3=$(sed -n 4p < "$data") + DATSERVER_BOOTSTRAP4=$(sed -n 4p < "$data") + rm "$data" + + write_config_param DATSERVER_DISCOVERY1 + write_config_param DATSERVER_DISCOVERY2 + + write_config_param DATSERVER_BOOTSTRAP1 + write_config_param DATSERVER_BOOTSTRAP2 + write_config_param DATSERVER_BOOTSTRAP3 + write_config_param DATSERVER_BOOTSTRAP4 + + datserver_generate_bootstraps + systemctl restart datserver +} + +function logging_on_datserver { + echo -n '' +} + +function logging_off_datserver { + echo -n '' +} + +function remove_user_datserver { + echo -n '' +} + +function add_user_datserver { + echo -n '' + echo '0' +} + +function change_password_datserver { + echo -n '' +} + +function install_interactive_datserver { + echo -n '' + APP_INSTALLED=1 +} + +function reconfigure_datserver { + # This is used if you need to switch identity. Dump old keys and generate new ones + echo -n '' +} + +function datserver_add_dat { + data=$(mktemp 2>/dev/null) + dialog --title $"Add a dat" \ + --backtitle $"Freedombone Control Panel" \ + --inputbox $"dat link:" 8 70 2>"$data" + sel=$? + case $sel in + 0) + dat_link=$(<"$data") + if [ "$dat_link" ]; then + if [ ${#dat_link} -gt 5 ]; then + if ! grep -q "$dat_link" $DATSERVER_DIRECTORY/feeds; then + echo "$dat_link" >> $DATSERVER_DIRECTORY/feeds + chown -R datserver:datserver $DATSERVER_DIRECTORY/feeds + systemctl restart datserver + fi + fi + fi + ;; + esac + rm -f "$data" +} + +function configure_interactive_datserver { + W=(1 $"Add a dat" + 2 $"Browse or edit feeds" + 3 $"Bootstrap servers") + + while true + do + # shellcheck disable=SC2068 + selection=$(dialog --backtitle $"Freedombone Administrator Control Panel" --title $"dat server" --menu $"Choose an operation, or ESC for main menu:" 11 70 4 "${W[@]}" 3>&2 2>&1 1>&3) + + if [ ! "$selection" ]; then + break + fi + case $selection in + 1) datserver_add_dat + ;; + 2) cd $DATSERVER_DIRECTORY || break + editor feeds + chown -R datserver:datserver $DATSERVER_DIRECTORY/feeds + systemctl restart datserver + ;; + 3) datserver_configure_bootstraps + ;; + esac + done +} + +function upgrade_datserver { + CURR_DATSERVER_HYPERCORED_VERSION=$(get_completion_param "datserver hypercored version") + if [[ "$CURR_DATSERVER_HYPERCORED_VERSION" != "$DATSERVER_HYPERCORED_VERSION" ]]; then + cd $DATSERVER_DIRECTORY || exit 254274 + systemctl stop datserver + if npm update hypercored@$DATSERVER_HYPERCORED_VERSION; then + set_completion_param "datserver hypercored version" "$DATSERVER_HYPERCORED_VERSION" + fi + datserver_generate_bootstraps + chown -R datserver:datserver "$DATSERVER_DIRECTORY" + systemctl restart datserver + fi +} + +function backup_local_datserver { + source_directory=$DATSERVER_DIRECTORY + + systemctl stop datserver + + dest_directory=datserver + backup_directory_to_usb "$source_directory" $dest_directory + + systemctl start datserver +} + +function restore_local_datserver { + systemctl stop datserver + + temp_restore_dir=/root/tempdatserver + datserver_dir=$DATSERVER_DIRECTORY + + restore_directory_from_usb $temp_restore_dir datserver + if [ -d $temp_restore_dir ]; then + if [ -d "$temp_restore_dir$datserver_dir" ]; then + cp -rp "$temp_restore_dir$datserver_dir"/* "$datserver_dir"/ + else + if [ ! -d "$datserver_dir" ]; then + mkdir "$datserver_dir" + fi + cp -rp "$temp_restore_dir"/* "$datserver_dir"/ + fi + chown -R datserver:datserver "$datserver_dir" + rm -rf $temp_restore_dir + fi + systemctl start datserver + +} + +function backup_remote_datserver { + source_directory=$DATSERVER_DIRECTORY + systemctl stop datserver + + dest_directory=datserver + backup_directory_to_friend "$source_directory" $dest_directory + + systemctl start datserver +} + +function restore_remote_datserver { + systemctl stop datserver + + temp_restore_dir=/root/tempdatserver + datserver_dir=$DATSERVER_DIRECTORY + + restore_directory_from_friend $temp_restore_dir datserver + if [ -d $temp_restore_dir ]; then + if [ -d "$temp_restore_dir$datserver_dir" ]; then + cp -rp "$temp_restore_dir$datserver_dir"/* "$datserver_dir"/ + else + if [ ! -d "$datserver_dir" ]; then + mkdir "$datserver_dir" + fi + cp -rp $temp_restore_dir/* "$datserver_dir"/ + fi + chown -R datserver:datserver "$datserver_dir" + rm -rf $temp_restore_dir + fi + systemctl start datserver + +} + +function remove_datserver { + if [ -f /etc/systemd/system/datserver.service ]; then + systemctl stop datserver + systemctl disable datserver + rm /etc/systemd/system/datserver.service + fi + userdel -r datserver + + remove_nodejs datserver + + if [ -d $DATSERVER_DIRECTORY ]; then + rm -rf $DATSERVER_DIRECTORY + fi + + remove_app datserver + remove_completion_param install_datserver + sed -i '/datserver/d' "$COMPLETION_FILE" + firewall_remove $DATSERVER_PORT +} + +function install_datserver { + apt-get -yq install wget + + install_nodejs datserver + + if [ -d $DATSERVER_DIRECTORY ]; then + rm -rf $DATSERVER_DIRECTORY + fi + mkdir $DATSERVER_DIRECTORY + cd $DATSERVER_DIRECTORY || exit 3658356 + + if ! npm install hypercored@$DATSERVER_HYPERCORED_VERSION; then + echo $'hypercored was not installed' + exit 4635439 + fi + + if ! npm install lil-pids@2.6.1; then + echo $'lil-pids was not installed' + exit 36483463 + fi + + echo "$DATSERVER_DIRECTORY/node_modules/.bin/hypercored --cwd $DATSERVER_DIRECTORY" > $DATSERVER_DIRECTORY/services + + set_completion_param "datserver hypercored version" "$DATSERVER_HYPERCORED_VERSION" + + adduser --system --home="$DATSERVER_DIRECTORY" --group datserver + if [ ! -d $DATSERVER_DIRECTORY ]; then + echo $'dat directory was not created' + exit 9568356 + fi + + datserver_generate_bootstraps + + chown -R datserver:datserver "$DATSERVER_DIRECTORY" + + firewall_add datserver $DATSERVER_PORT + + { echo '[Unit]'; + echo 'After=syslog.target network.target remote-fs.target nss-lookup.target'; + echo ''; + echo '[Service]'; + echo 'User=datserver'; + echo 'Group=datserver'; + echo "ExecStart=$DATSERVER_DIRECTORY/node_modules/.bin/lil-pids $DATSERVER_DIRECTORY/services $DATSERVER_DIRECTORY/pids"; + echo 'Restart=always'; + echo "WorkingDirectory=$DATSERVER_DIRECTORY"; + echo 'StandardError=syslog'; + echo ''; + echo '[Install]'; + echo 'WantedBy=multi-user.target'; } > /etc/systemd/system/datserver.service + + systemctl enable datserver + systemctl start datserver + + APP_INSTALLED=1 +} + +# NOTE: deliberately there is no "exit 0" diff --git a/src/freedombone-app-peertube b/src/freedombone-app-peertube index 96ec463f..f98bb178 100755 --- a/src/freedombone-app-peertube +++ b/src/freedombone-app-peertube @@ -269,10 +269,7 @@ function peertube_import_from_file { nodecmd='torsocks node' fi - data2=$(mktemp 2>/dev/null) - dialog --title "Choose the video file (select with spacebar)" --fselect "/home/$MY_USERNAME/" 30 60 2> "$data2" - selected_file=$(cat "$data2") - rm -f "$data2" + selected_file=$(dialog --title "Choose the video file (select with spacebar)" --fselect "/home/$MY_USERNAME/" 30 60) if [ ! "$selected_file" ]; then return fi diff --git a/src/freedombone-app-pleroma b/src/freedombone-app-pleroma index 645b4d9d..c41c8483 100755 --- a/src/freedombone-app-pleroma +++ b/src/freedombone-app-pleroma @@ -36,7 +36,7 @@ PLEROMA_CODE= PLEROMA_PORT=4000 PLEROMA_ONION_PORT=8011 PLEROMA_REPO="https://git.pleroma.social/pleroma/pleroma.git" -PLEROMA_COMMIT='303289d7daac3a51f991bb8603f36628a5d944c1' +PLEROMA_COMMIT='fef8daa454ab04ac2394e02efcc2b48c1fbad91c' PLEROMA_ADMIN_PASSWORD= PLEROMA_DIR=/etc/pleroma PLEROMA_SECRET_KEY="" diff --git a/src/freedombone-app-scuttlebot b/src/freedombone-app-scuttlebot index 035ad683..ceee82b5 100755 --- a/src/freedombone-app-scuttlebot +++ b/src/freedombone-app-scuttlebot @@ -35,7 +35,7 @@ SHOW_ICANN_ADDRESS_ON_ABOUT=0 SCUTTLEBOT_DOMAIN_NAME= SCUTTLEBOT_CODE= -SCUTTLEBOT_VERSION='10.4.6' +SCUTTLEBOT_VERSION='11.2.0' SCUTTLEBOT_PORT=8010 SCUTTLEBOT_ONION_PORT=8623 GIT_SSB_PORT=7718 @@ -56,7 +56,7 @@ function logging_off_scuttlebot { } function scuttlebot_create_invite { - invite_string=$(su -c "sbot invite.create 1" - scuttlebot | sed 's/"//g') + invite_string=$(su -c "/etc/scuttlebot/node_modules/.bin/sbot invite.create 1" - scuttlebot | sed 's/"//g') clear echo -e "\\n\\nYour Scuttlebot invite code is:\\n\\n${invite_string}\\n\\n" @@ -259,14 +259,15 @@ function git_ssb_script { function scuttlebot_git_setup { if [[ "$1" == "mesh" ]]; then - if [ ! -d "$rootdir/usr/local/lib/node_modules/git-ssb/node_modules/git-ssb-web/highlight" ]; then - mkdir "$rootdir/usr/local/lib/node_modules/git-ssb/node_modules/git-ssb-web/highlight" + + if [ ! -d "$rootdir/root/.npm-global/lib/node_modules/git-ssb/node_modules/git-ssb-web/highlight" ]; then + mkdir "$rootdir/root/.npm-global/lib/node_modules/git-ssb/node_modules/git-ssb-web/highlight" fi - if [ ! -f "$rootdir/usr/local/lib/node_modules/git-ssb/node_modules/highlight.js/styles/foundation.css" ]; then + if [ ! -f "$rootdir/root/.npm-global/lib/node_modules/git-ssb/node_modules/highlight.js/styles/foundation.css" ]; then echo $'Could not find foundation.css' exit 347687245 fi - cp "$rootdir/usr/local/lib/node_modules/git-ssb/node_modules/highlight.js/styles/foundation.css" "$rootdir/usr/local/lib/node_modules/git-ssb/node_modules/git-ssb-web/highlight/foundation.css" + cp "$rootdir/root/.npm-global/lib/node_modules/git-ssb/node_modules/highlight.js/styles/foundation.css" "$rootdir/root/.npm-global/lib/node_modules/git-ssb/node_modules/git-ssb-web/highlight/foundation.css" git_ssb_nginx_site=$rootdir/etc/nginx/sites-available/git_ssb { echo 'server {'; @@ -284,14 +285,14 @@ function scuttlebot_git_setup { exit 7357225 fi - if [ ! -d /usr/local/lib/node_modules/git-ssb/node_modules/git-ssb-web/highlight ]; then - mkdir /usr/local/lib/node_modules/git-ssb/node_modules/git-ssb-web/highlight + if [ ! -d /root/.npm-global/lib/node_modules/git-ssb/node_modules/git-ssb-web/highlight ]; then + mkdir /root/.npm-global/lib/node_modules/git-ssb/node_modules/git-ssb-web/highlight fi - if [ ! -f /usr/local/lib/node_modules/git-ssb/node_modules/highlight.js/styles/foundation.css ]; then + if [ ! -f /root/.npm-global/lib/node_modules/git-ssb/node_modules/highlight.js/styles/foundation.css ]; then echo $'Could not find foundation.css' exit 347687245 fi - cp /usr/local/lib/node_modules/git-ssb/node_modules/highlight.js/styles/foundation.css /usr/local/lib/node_modules/git-ssb/node_modules/git-ssb-web/highlight/foundation.css + cp /root/.npm-global/lib/node_modules/git-ssb/node_modules/highlight.js/styles/foundation.css /root/.npm-global/lib/node_modules/git-ssb/node_modules/git-ssb-web/highlight/foundation.css git_ssb_nginx_site=/etc/nginx/sites-available/${SCUTTLEBOT_DOMAIN_NAME} function_check nginx_http_redirect @@ -313,7 +314,7 @@ function scuttlebot_git_setup { fi { echo ''; - echo ' root /usr/local/lib/node_modules/git-ssb/node_modules/git-ssb-web;'; + echo ' root /root/.npm-global/lib/node_modules/git-ssb/node_modules/git-ssb-web;'; echo ''; echo ' location = / {'; echo " proxy_pass http://localhost:${GIT_SSB_PORT};"; @@ -339,7 +340,7 @@ function scuttlebot_git_setup { echo ' add_header X-Content-Type-Options nosniff;'; echo ' add_header X-Frame-Options SAMEORIGIN;'; echo ''; - echo ' root /usr/local/lib/node_modules/git-ssb/node_modules/git-ssb-web;'; + echo ' root /root/.npm-global/lib/node_modules/git-ssb/node_modules/git-ssb-web;'; echo ''; echo ' location = / {'; echo " proxy_pass http://localhost:${GIT_SSB_PORT};"; @@ -359,6 +360,7 @@ function scuttlebot_git_setup { function mesh_install_dat { get_npm_arch + mesh_setup_npm cat < "$rootdir/usr/bin/install_dat" #!/bin/bash @@ -379,28 +381,50 @@ function mesh_install_scuttlebot { mesh_install_dat get_npm_arch - - cat < "$rootdir/usr/bin/install_scuttlebot" -#!/bin/bash -npm install --arch=$NPM_ARCH -g scuttlebot@${SCUTTLEBOT_VERSION} -npm install --arch=$NPM_ARCH -g git-ssb -npm install --arch=$NPM_ARCH -g git-remote-ssb -EOF - chroot "$rootdir" /bin/chmod +x /usr/bin/install_scuttlebot - chroot "$rootdir" /usr/bin/install_scuttlebot - rm "$rootdir/usr/bin/install_scuttlebot" - - if [ ! -f "$rootdir/usr/local/bin/sbot" ]; then - echo $'Scuttlebot was not installed' - exit 528253 - fi + mesh_setup_npm if [ ! -d "$rootdir/etc/scuttlebot" ]; then mkdir -p "$rootdir/etc/scuttlebot" fi - # an unprivileged user to run as + # an unprivileged user to install and run as chroot "$rootdir" useradd -d /etc/scuttlebot/ scuttlebot + chroot "$rootdir" chown -R scuttlebot:scuttlebot /etc/scuttlebot + + cat < "$rootdir/usr/bin/install_scuttlebot" +#!/bin/bash +cd /etc/scuttlebot || exit 1 +if ! npm install --arch=$NPM_ARCH scuttlebot@${SCUTTLEBOT_VERSION}; then + exit 2 +fi +exit 0 +EOF + chroot "$rootdir" /bin/chmod +x /usr/bin/install_scuttlebot + chroot "$rootdir" sudo -u scuttlebot /usr/bin/install_scuttlebot + rm "$rootdir/usr/bin/install_scuttlebot" + + if [ ! -f "$rootdir/etc/scuttlebot/node_modules/.bin/sbot" ]; then + echo $'Scuttlebot was not installed' + exit 528253 + fi + + cat < "$rootdir/usr/bin/install_git_ssb" +#!/bin/bash +npm config set prefix '~/.npm-global' +export PATH=~/.npm-global/bin:$PATH +export NPM_CONFIG_PREFIX=~/.npm-global +source ~/.profile +if ! npm install --arch=$NPM_ARCH -g git-ssb; then + exit 1 +fi +if ! npm install --arch=$NPM_ARCH -g git-remote-ssb; then + exit 2 +fi +exit 0 +EOF + chroot "$rootdir" /bin/chmod +x /usr/bin/install_git_ssb + chroot "$rootdir" /usr/bin/install_git_ssb + rm "$rootdir/usr/bin/install_git_ssb" # daemon { echo '[Unit]'; @@ -413,7 +437,7 @@ EOF echo 'User=scuttlebot'; echo 'Group=scuttlebot'; echo "WorkingDirectory=/etc/scuttlebot"; - echo 'ExecStart=/usr/local/bin/sbot server'; + echo 'ExecStart=/etc/scuttlebot/node_modules/.bin/sbot server'; echo 'Restart=always'; echo 'Environment="USER=scuttlebot"'; echo ''; @@ -428,8 +452,28 @@ function install_scuttlebot { function_check install_nodejs install_nodejs scuttlebot - npm install -g scuttlebot@${SCUTTLEBOT_VERSION} - if [ ! -f /usr/local/bin/sbot ]; then + if [ ! -d /etc/scuttlebot ]; then + mkdir -p /etc/scuttlebot + fi + + # an unprivileged user to install and run as + useradd -d /etc/scuttlebot/ scuttlebot + chown -R scuttlebot:scuttlebot /etc/scuttlebot + + cat < /usr/bin/install_scuttlebot +#!/bin/bash +cd /etc/scuttlebot || exit 1 +if ! npm install scuttlebot@${SCUTTLEBOT_VERSION}; then + exit 2 +fi +exit 0 +EOF + chmod +x /usr/bin/install_scuttlebot + su -c '/usr/bin/install_scuttlebot' - scuttlebot + rm /usr/bin/install_scuttlebot + + if [ ! -f /etc/scuttlebot/node_modules/.bin/sbot ]; then + echo $'Scuttlebot was not installed' exit 528253 fi @@ -437,15 +481,6 @@ function install_scuttlebot { npm install -g git-ssb npm install -g git-remote-ssb - if [ ! -d /etc/scuttlebot ]; then - mkdir -p /etc/scuttlebot - fi - - npm install -g dat - - # an unprivileged user to run as - useradd -d /etc/scuttlebot/ scuttlebot - # daemon { echo '[Unit]'; echo 'Description=Scuttlebot (messaging system)'; @@ -457,7 +492,7 @@ function install_scuttlebot { echo 'User=scuttlebot'; echo 'Group=scuttlebot'; echo "WorkingDirectory=/etc/scuttlebot"; - echo 'ExecStart=/usr/local/bin/sbot server'; + echo 'ExecStart=/etc/scuttlebot/node_modules/.bin/sbot server'; echo 'Restart=always'; echo 'Environment="USER=scuttlebot"'; echo ''; diff --git a/src/freedombone-base-tripwire b/src/freedombone-base-tripwire index 67baa7fa..9c1cc444 100755 --- a/src/freedombone-base-tripwire +++ b/src/freedombone-base-tripwire @@ -122,6 +122,9 @@ function install_tripwire { if ! grep -q '!/usr/local/lib/node_modules' /etc/tripwire/twpol.txt; then sed -i '\|/etc\t\t->.*|a\ !/usr/local/lib/node_modules ;' /etc/tripwire/twpol.txt fi + if ! grep -q '!/root/.npm-global/lib/node_modules' /etc/tripwire/twpol.txt; then + sed -i '\|/etc\t\t->.*|a\ !/root/.npm-global/lib/node_modules ;' /etc/tripwire/twpol.txt + fi # Events here are likely due to USB HRNG activity if ! grep -q '!/dev/char' /etc/tripwire/twpol.txt; then sed -i '\|/dev\t\t->.*|a\ !/dev/char ;' /etc/tripwire/twpol.txt diff --git a/src/freedombone-client b/src/freedombone-client index 1ebcd7f9..385e2f8f 100755 --- a/src/freedombone-client +++ b/src/freedombone-client @@ -40,7 +40,7 @@ ENABLE_MONKEYSPHERE= SETUP_CLIENT_APP_NAME= # Version number of this script -VERSION="2.00" +VERSION="3.1" # get the main project file, so that some values can be extracted MAIN_PROJECT_FILE=/usr/local/bin/${PROJECT_NAME} diff --git a/src/freedombone-image-customise b/src/freedombone-image-customise index e2d82c08..4ed4ce4c 100755 --- a/src/freedombone-image-customise +++ b/src/freedombone-image-customise @@ -593,6 +593,7 @@ install_patchwork() { fi get_npm_arch + mesh_setup_npm git clone "$PATCHWORK_REPO" "$rootdir/etc/patchwork" if [ ! -d "$rootdir/etc/patchwork" ]; then @@ -938,7 +939,7 @@ initialise_mesh() { install_avahi install_batman install_bmx6 - install_bmx7 + #install_bmx7 install_olsr2 install_babel mesh_shutdown_script diff --git a/src/freedombone-image-mesh b/src/freedombone-image-mesh index 79415cf5..5e30257b 100755 --- a/src/freedombone-image-mesh +++ b/src/freedombone-image-mesh @@ -1449,9 +1449,11 @@ if [ -f $MESH_INSTALL_SETUP ]; then systemctl disable bmx6 echo $'BMX6 disabled' >> $INSTALL_LOG - systemctl stop bmx7 - systemctl disable bmx7 - echo $'BMX7 disabled' >> $INSTALL_LOG + if [ -d /etc/bmx7 ]; then + systemctl stop bmx7 + systemctl disable bmx7 + echo $'BMX7 disabled' >> $INSTALL_LOG + fi systemctl stop olsr2 systemctl disable olsr2 diff --git a/src/freedombone-mesh-batman b/src/freedombone-mesh-batman index cce0bbf4..1b5ad086 100755 --- a/src/freedombone-mesh-batman +++ b/src/freedombone-mesh-batman @@ -60,7 +60,9 @@ function stop { fi systemctl stop bmx6 - systemctl stop bmx7 + if [ -d /etc/bmx7 ]; then + systemctl stop bmx7 + fi systemctl stop olsr2 systemctl stop babel systemctl disable bmx6 diff --git a/src/freedombone-template b/src/freedombone-template index 4a244da5..bf09f156 100755 --- a/src/freedombone-template +++ b/src/freedombone-template @@ -291,16 +291,20 @@ echo '}' echo '' echo "function install_interactive_${app_name} {" if [ ! $app_onion_only ]; then - echo " if [ ! \"\$ONION_ONLY\" ]; then" - echo " ONION_ONLY='no'" - echo ' fi' - echo '' - echo " if [[ \"\$ONION_ONLY\" != \"no\" ]]; then" - echo " ${app_name_upper}_DOMAIN_NAME='${app_name}.local'" - echo " write_config_param \"${app_name_upper}_DOMAIN_NAME\" \"\$${app_name_upper}_DOMAIN_NAME\"" - echo ' else' - echo " interactive_site_details \"${app_name}\" \"${app_name_upper}_DOMAIN_NAME\" \"${app_name_upper}_CODE\"" - echo ' fi' + if [ $app_webui ]; then + echo " if [ ! \"\$ONION_ONLY\" ]; then" + echo " ONION_ONLY='no'" + echo ' fi' + echo '' + echo " if [[ \"\$ONION_ONLY\" != \"no\" ]]; then" + echo " ${app_name_upper}_DOMAIN_NAME='${app_name}.local'" + echo " write_config_param \"${app_name_upper}_DOMAIN_NAME\" \"\$${app_name_upper}_DOMAIN_NAME\"" + echo ' else' + echo " interactive_site_details \"${app_name}\" \"${app_name_upper}_DOMAIN_NAME\" \"${app_name_upper}_CODE\"" + echo ' fi' + else + echo " echo -n ''" + fi else echo " echo -n ''" fi @@ -310,8 +314,10 @@ echo '' echo "function change_password_${app_name} {" echo " curr_username=\"\$1\"" echo " new_user_password=\"\$2\"" -echo '' -echo " read_config_param '${app_name_upper}_DOMAIN_NAME'" +if [ $app_webui ]; then + echo '' + echo " read_config_param '${app_name_upper}_DOMAIN_NAME'" +fi echo '' echo " \"\${PROJECT_NAME}-pass\" -u \"\$curr_username\" -a ${app_name} -p \"\$new_user_password\"" echo '}' @@ -348,31 +354,23 @@ echo " echo -n ''" echo '}' echo '' echo "function configure_interactive_${app_name} {" +echo ' W=(1 $"Option 1"' +echo ' 2 $"Option 2")' +echo '' echo ' while true' echo ' do' -echo " data=\$(mktemp 2>/dev/null)" -echo " dialog --backtitle \$\"Freedombone Control Panel\" \\" -echo " --title \$\"${app_name}\" \\" -echo " --radiolist \$\"Choose an operation:\" 16 70 3 \\" -echo " 1 \$\"Option 1\" off \\" -echo " 2 \$\"Option 2\" off \\" -echo " 3 \$\"Exit\" on 2> \"\$data\"" -echo ' sel=$?' -echo " case \$sel in" -echo " 1) rm -f \"\$data\"" -echo ' return;;' -echo " 255) rm -f \"\$data\"" -echo ' return;;' -echo ' esac' -echo " case \$(cat \"\$data\") in" +echo ' # shellcheck disable=SC2068' +echo " selection=\$(dialog --backtitle \$\"Freedombone Administrator Control Panel\" --title \$\"${app_name}\" --menu \$\"Choose an operation, or ESC for main menu:\" 14 70 3 \"\${W[@]}\" 3>&2 2>&1 1>&3)" +echo '' +echo " if [ ! \"\$selection\" ]; then" +echo ' break' +echo ' fi' +echo " case \$selection in" echo ' 1) # call some function for option 1' echo ' ;;' echo ' 2) # call some function for option 2' echo ' ;;' -echo " 3) rm -f \"\$data\"" -echo ' break;;' echo ' esac' -echo " rm -f \"\$data\"" echo ' done' echo '}' echo '' @@ -381,34 +379,44 @@ echo " CURR_${app_name_upper}_COMMIT=\$(get_completion_param \"${app_name} co echo " if [[ \"\$CURR_${app_name_upper}_COMMIT\" == \"\$${app_name_upper}_COMMIT\" ]]; then" echo ' return' echo ' fi' -echo '' -echo " if grep -q \"${app_name} domain\" \"\$COMPLETION_FILE\"; then" -echo " ${app_name_upper}_DOMAIN_NAME=\$(get_completion_param \"${app_name} domain\")" -echo ' fi' +if [ $app_webui ]; then + echo '' + echo " if grep -q \"${app_name} domain\" \"\$COMPLETION_FILE\"; then" + echo " ${app_name_upper}_DOMAIN_NAME=\$(get_completion_param \"${app_name} domain\")" + echo ' fi' +fi echo '' echo ' # update to the next commit' if [ ! "$app_dir" ]; then - echo " set_repo_commit \"/var/www/\$${app_name_upper}_DOMAIN_NAME/htdocs\" \"${app_name} commit\" \"\$${app_name_upper}_COMMIT\" \$${app_name_upper}_REPO" + echo " set_repo_commit \"/var/www/\$${app_name_upper}_DOMAIN_NAME/htdocs\" \"${app_name} commit\" \"\$${app_name_upper}_COMMIT\" \"\$${app_name_upper}_REPO\"" echo " chown -R www-data:www-data \"/var/www/\${${app_name_upper}_DOMAIN_NAME}/htdocs\"" else - echo " set_repo_commit \"${app_dir}\" \"${app_name} commit\" \"\$${app_name_upper}_COMMIT\" \$${app_name_upper}_REPO" + echo " set_repo_commit \"${app_dir}\" \"${app_name} commit\" \"\$${app_name_upper}_COMMIT\" \"\$${app_name_upper}_REPO\"" echo " chown -R ${app_name}:${app_name} \"${app_dir}\"" fi echo '}' echo '' echo "function backup_local_${app_name} {" -echo " ${app_name_upper}_DOMAIN_NAME='${app_name}'" -echo " if grep -q \"${app_name} domain\" \"\$COMPLETION_FILE\"; then" -echo " ${app_name_upper}_DOMAIN_NAME=\$(get_completion_param \"${app_name} domain\")" -echo ' fi' -echo '' +if [ $app_webui ]; then + echo " ${app_name_upper}_DOMAIN_NAME='${app_name}'" + echo " if grep -q \"${app_name} domain\" \"\$COMPLETION_FILE\"; then" + echo " ${app_name_upper}_DOMAIN_NAME=\$(get_completion_param \"${app_name} domain\")" + echo ' fi' + echo '' +fi if [ ! "$app_dir" ]; then echo " source_directory=/var/www/\${${app_name_upper}_DOMAIN_NAME}/htdocs" else echo " source_directory=${app_dir}" fi -echo '' -echo " suspend_site \"\${${app_name_upper}_DOMAIN_NAME}\"" +if [ $app_webui ]; then + echo '' + echo " suspend_site \"\${${app_name_upper}_DOMAIN_NAME}\"" +fi +if [ $app_daemon ]; then + echo '' + echo " systemctl stop ${app_name}" +fi echo '' echo " dest_directory=${app_name}" echo " backup_directory_to_usb \"\$source_directory\" \$dest_directory" @@ -422,71 +430,103 @@ if [[ "$database_type" == "postgres"* ]]; then echo " backup_database_to_usb ${app_name}" echo '' fi -echo ' restart_site' +if [ $app_webui ]; then + echo ' restart_site' +fi +if [ $app_daemon ]; then + echo " systemctl start ${app_name}" +fi echo '}' echo '' echo "function restore_local_${app_name} {" -echo " if ! grep -q \"${app_name} domain\" \"\$COMPLETION_FILE\"; then" -echo ' return' -echo ' fi' -echo " ${app_name_upper}_DOMAIN_NAME=\$(get_completion_param \"${app_name} domain\")" -echo " if [ \"\$${app_name_upper}_DOMAIN_NAME\" ]; then" -echo " temp_restore_dir=/root/temp${app_name}" +if [ $app_webui ]; then + echo " if ! grep -q \"${app_name} domain\" \"\$COMPLETION_FILE\"; then" + echo ' return' + echo ' fi' + echo " ${app_name_upper}_DOMAIN_NAME=\$(get_completion_param \"${app_name} domain\")" + echo " if [ ! \"\$${app_name_upper}_DOMAIN_NAME\" ]; then" + echo " return" + echo " fi" +fi +if [ $app_webui ]; then + echo " suspend_site \"\${${app_name_upper}_DOMAIN_NAME}\"" +fi +if [ $app_daemon ]; then + echo " systemctl stop ${app_name}" + echo '' +fi +echo " temp_restore_dir=/root/temp${app_name}" if [ ! "$app_dir" ]; then - echo " ${app_name}_dir=/var/www/\${${app_name_upper}_DOMAIN_NAME}/htdocs" + echo " ${app_name}_dir=/var/www/\${${app_name_upper}_DOMAIN_NAME}/htdocs" else - echo " ${app_name}_dir=${app_dir}" + echo " ${app_name}_dir=${app_dir}" fi echo '' if [[ "$database_type" == "mariadb" || "$database_type" == "mysql" ]]; then - echo " ${app_name}_create_database" + echo " ${app_name}_create_database" echo '' - echo " restore_database ${app_name}" - echo " if [ -d \$temp_restore_dir ]; then" - echo " rm -rf \$temp_restore_dir" - echo ' fi' + echo " restore_database ${app_name}" + echo " if [ -d \$temp_restore_dir ]; then" + echo " rm -rf \$temp_restore_dir" + echo ' fi' echo '' fi if [[ "$database_type" == "postgres"* ]]; then - echo " ${app_name}_create_database" + echo " ${app_name}_create_database" echo '' - echo ' USE_POSTGRESQL=1' - echo " restore_database ${app_name}" - echo " if [ -d \$temp_restore_dir ]; then" - echo " rm -rf \$temp_restore_dir" - echo ' fi' + echo ' USE_POSTGRESQL=1' + echo " restore_database ${app_name}" + echo " if [ -d \$temp_restore_dir ]; then" + echo " rm -rf \$temp_restore_dir" + echo ' fi' echo '' fi -echo " restore_directory_from_usb \$temp_restore_dir ${app_name}" -echo " if [ -d \$temp_restore_dir ]; then" -echo " if [ -d \"\$temp_restore_dir\$${app_name}_dir\" ]; then" -echo " cp -rp \"\$temp_restore_dir\$${app_name}_dir\"/* \"\$${app_name}_dir\"/" -echo ' else' -echo " if [ ! -d \"\$${app_name}_dir\" ]; then" -echo " mkdir \"\$${app_name}_dir\"" -echo ' fi' -echo " cp -rp \"\$temp_restore_dir\"/* \"\$${app_name}_dir\"/" +echo " restore_directory_from_usb \$temp_restore_dir ${app_name}" +echo " if [ -d \$temp_restore_dir ]; then" +echo " if [ -d \"\$temp_restore_dir\$${app_name}_dir\" ]; then" +echo " cp -rp \"\$temp_restore_dir\$${app_name}_dir\"/* \"\$${app_name}_dir\"/" +echo ' else' +echo " if [ ! -d \"\$${app_name}_dir\" ]; then" +echo " mkdir \"\$${app_name}_dir\"" echo ' fi' -echo " chown -R www-data:www-data \"\$${app_name}_dir\"" -echo " rm -rf \$temp_restore_dir" +echo " cp -rp \"\$temp_restore_dir\"/* \"\$${app_name}_dir\"/" echo ' fi' -echo '' +if [[ ! "$app_dir" ]]; then + echo " chown -R www-data:www-data \"\$${app_name}_dir\"" +else + echo " chown -R ${app_name}:${app_name} \"\$${app_name}_dir\"" +fi +echo " rm -rf \$temp_restore_dir" echo ' fi' +if [ $app_daemon ]; then + echo " systemctl start ${app_name}" + echo '' +fi +if [ $app_webui ]; then + echo ' restart_site' +fi echo '}' echo '' echo "function backup_remote_${app_name} {" -echo " ${app_name_upper}_DOMAIN_NAME='${app_name}'" -echo " if grep -q \"${app_name} domain\" \"\$COMPLETION_FILE\"; then" -echo " ${app_name_upper}_DOMAIN_NAME=\$(get_completion_param \"${app_name} domain\")" -echo ' fi' -echo '' +if [ $app_webui ]; then + echo " ${app_name_upper}_DOMAIN_NAME='${app_name}'" + echo " if grep -q \"${app_name} domain\" \"\$COMPLETION_FILE\"; then" + echo " ${app_name_upper}_DOMAIN_NAME=\$(get_completion_param \"${app_name} domain\")" + echo ' fi' + echo '' +fi if [ ! "$app_dir" ]; then echo " source_directory=/var/www/\${${app_name_upper}_DOMAIN_NAME}/htdocs" else echo " source_directory=${app_dir}" fi -echo '' -echo " suspend_site \"\${${app_name_upper}_DOMAIN_NAME}\"" +if [ $app_webui ]; then + echo '' + echo " suspend_site \"\${${app_name_upper}_DOMAIN_NAME}\"" +fi +if [ $app_daemon ]; then + echo " systemctl stop ${app_name}" +fi echo '' echo " dest_directory=${app_name}" echo " backup_directory_to_friend \"\$source_directory\" \$dest_directory" @@ -499,67 +539,91 @@ if [[ "$database_type" == "postgres"* ]]; then echo " backup_database_to_friend ${app_name}" echo '' fi -echo '' -echo ' restart_site' +if [ $app_daemon ]; then + echo '' + echo " systemctl start ${app_name}" +fi +if [ $app_webui ]; then + echo '' + echo ' restart_site' +fi echo '}' echo '' echo "function restore_remote_${app_name} {" -echo " if ! grep -q \"${app_name} domain\" \"\$COMPLETION_FILE\"; then" -echo ' return' -echo ' fi' -echo " ${app_name_upper}_DOMAIN_NAME=\$(get_completion_param \"${app_name} domain\")" -echo " if [ \"\$${app_name_upper}_DOMAIN_NAME\" ]; then" -echo " temp_restore_dir=/root/temp${app_name}" +if [ $app_webui ]; then + echo " if ! grep -q \"${app_name} domain\" \"\$COMPLETION_FILE\"; then" + echo ' return' + echo ' fi' + echo " ${app_name_upper}_DOMAIN_NAME=\$(get_completion_param \"${app_name} domain\")" + echo " if [ ! \"\$${app_name_upper}_DOMAIN_NAME\" ]; then" + echo " return" + echo " fi" +fi +if [ $app_webui ]; then + echo " suspend_site \"\${${app_name_upper}_DOMAIN_NAME}\"" +fi +if [ $app_daemon ]; then + echo " systemctl stop ${app_name}" + echo '' +fi +echo " temp_restore_dir=/root/temp${app_name}" if [ ! "$app_dir" ]; then - echo " ${app_name}_dir=/var/www/\${${app_name_upper}_DOMAIN_NAME}/htdocs" + echo " ${app_name}_dir=/var/www/\${${app_name_upper}_DOMAIN_NAME}/htdocs" else - echo " ${app_name}_dir=${app_dir}" + echo " ${app_name}_dir=${app_dir}" fi echo '' if [[ "$database_type" == "mariadb" || "$database_type" == "mysql" ]]; then - echo " ${app_name}_create_database" + echo " ${app_name}_create_database" echo '' - echo " restore_database_from_friend ${app_name}" - echo " if [ -d \"\$temp_restore_dir\" ]; then" - echo " rm -rf \$temp_restore_dir" - echo ' fi' + echo " restore_database_from_friend ${app_name}" + echo " if [ -d \"\$temp_restore_dir\" ]; then" + echo " rm -rf \$temp_restore_dir" + echo ' fi' echo '' fi if [[ "$database_type" == "postgres"* ]]; then - echo " ${app_name}_create_database" + echo " ${app_name}_create_database" echo '' - echo ' USE_POSTGRESQL=1' - echo " restore_database_from_friend ${app_name}" - echo " if [ -d \"\$temp_restore_dir\" ]; then" - echo " rm -rf \$temp_restore_dir" - echo ' fi' + echo ' USE_POSTGRESQL=1' + echo " restore_database_from_friend ${app_name}" + echo " if [ -d \"\$temp_restore_dir\" ]; then" + echo " rm -rf \$temp_restore_dir" + echo ' fi' echo '' fi -echo " restore_directory_from_friend \$temp_restore_dir ${app_name}" -echo " if [ -d \$temp_restore_dir ]; then" -echo " if [ -d \"\$temp_restore_dir\$${app_name}_dir\" ]; then" -echo " cp -rp \"\$temp_restore_dir\$${app_name}_dir\"/* \"\$${app_name}_dir\"/" -echo ' else' -echo " if [ ! -d \"\$${app_name}_dir\" ]; then" -echo " mkdir \"\$${app_name}_dir\"" -echo ' fi' -echo " cp -rp \$temp_restore_dir/* \"\$${app_name}_dir\"/" +echo " restore_directory_from_friend \$temp_restore_dir ${app_name}" +echo " if [ -d \$temp_restore_dir ]; then" +echo " if [ -d \"\$temp_restore_dir\$${app_name}_dir\" ]; then" +echo " cp -rp \"\$temp_restore_dir\$${app_name}_dir\"/* \"\$${app_name}_dir\"/" +echo ' else' +echo " if [ ! -d \"\$${app_name}_dir\" ]; then" +echo " mkdir \"\$${app_name}_dir\"" echo ' fi' -echo " chown -R www-data:www-data \"\$${app_name}_dir\"" -echo " rm -rf \$temp_restore_dir" +echo " cp -rp \$temp_restore_dir/* \"\$${app_name}_dir\"/" echo ' fi' -echo '' +if [[ ! "$app_dir" ]]; then + echo " chown -R www-data:www-data \"\$${app_name}_dir\"" +else + echo " chown -R ${app_name}:${app_name} \"\$${app_name}_dir\"" +fi +echo " rm -rf \$temp_restore_dir" echo ' fi' +if [ $app_daemon ]; then + echo " systemctl start ${app_name}" + echo '' +fi +if [ $app_webui ]; then + echo ' restart_site' +fi echo '}' echo '' echo "function remove_${app_name} {" -if [[ "$app_node" == 'yes' ]]; then - echo " remove_nodejs ${app_name}" +if [ $app_webui ]; then + echo " nginx_dissite \"\$${app_name_upper}_DOMAIN_NAME\"" + echo " remove_certs \"\$${app_name_upper}_DOMAIN_NAME\"" echo '' fi -echo " nginx_dissite \"\$${app_name_upper}_DOMAIN_NAME\"" -echo " remove_certs \"\$${app_name_upper}_DOMAIN_NAME\"" -echo '' if [ $app_daemon ]; then echo " if [ -f /etc/systemd/system/${app_name}.service ]; then" echo " systemctl stop ${app_name}" @@ -568,20 +632,30 @@ if [ $app_daemon ]; then echo ' fi' echo " userdel -r ${app_name}" fi -echo '' -echo " if [ -d \"/var/www/\$${app_name_upper}_DOMAIN_NAME\" ]; then" -echo " rm -rf \"/var/www/\$${app_name_upper}_DOMAIN_NAME\"" -echo ' fi' -echo " if [ -f \"/etc/nginx/sites-available/\$${app_name_upper}_DOMAIN_NAME\" ]; then" -echo " rm \"/etc/nginx/sites-available/\$${app_name_upper}_DOMAIN_NAME\"" -echo ' fi' +if [ "$app_nodeapp" ]; then + echo " npm uninstall -g ${app_nodeapp}" + echo '' +fi +if [[ "$app_node" == 'yes' ]]; then + echo " remove_nodejs ${app_name}" + echo '' +fi +if [ $app_webui ]; then + echo '' + echo " if [ -d \"/var/www/\$${app_name_upper}_DOMAIN_NAME\" ]; then" + echo " rm -rf \"/var/www/\$${app_name_upper}_DOMAIN_NAME\"" + echo ' fi' + echo " if [ -f \"/etc/nginx/sites-available/\$${app_name_upper}_DOMAIN_NAME\" ]; then" + echo " rm \"/etc/nginx/sites-available/\$${app_name_upper}_DOMAIN_NAME\"" + echo ' fi' +fi if [[ "$database_type" == "mariadb" || "$database_type" == "mysql" ]]; then echo " drop_database ${app_name}" fi if [[ "$database_type" == "postgres"* ]]; then echo " drop_database_postgresql ${app_name}" fi -echo " remove_onion_service ${app_name} \${${app_name_upper}_ONION_PORT}" +echo " remove_onion_service ${app_name} \"\${${app_name_upper}_ONION_PORT}\"" echo " if grep -q \"${app_name}\" /etc/crontab; then" echo " sed -i \"/${app_name}/d\" /etc/crontab" echo ' fi' @@ -592,8 +666,10 @@ if [ "$app_port" ]; then echo '' echo " firewall_remove ${app_port} tcp" fi -echo '' -echo " remove_ddns_domain \"\$${app_name_upper}_DOMAIN_NAME\"" +if [ $app_webui ]; then + echo '' + echo " remove_ddns_domain \"\$${app_name_upper}_DOMAIN_NAME\"" +fi echo '}' echo '' echo "function install_${app_name} {" @@ -608,10 +684,10 @@ if [[ "$database_type" == "postgres"* ]]; then echo '' fi if [[ "$app_node" == 'yes' ]]; then - echo "install_nodejs ${app_name}" + echo " install_nodejs ${app_name}" fi if [ "$app_nodeapp" ]; then - echo "npm install -g ${app_nodeapp}" + echo " npm install -g ${app_nodeapp}" fi if [[ "$app_php" == 'yes' ]]; then echo ' apt-get -yq install php-gettext php-curl php-gd php-mysql git curl' @@ -619,64 +695,69 @@ if [[ "$app_php" == 'yes' ]]; then echo '' fi -echo " if [ ! \"\$${app_name_upper}_DOMAIN_NAME\" ]; then" -echo " echo \$'No domain name was given'" -echo ' exit 3568356' -echo ' fi' - if [ $app_webui ]; then + echo " if [ ! \"\$${app_name_upper}_DOMAIN_NAME\" ]; then" + echo " echo \$'No domain name was given'" + echo ' exit 3568356' + echo ' fi' echo '' echo " if [ -d \"/var/www/\$${app_name_upper}_DOMAIN_NAME/htdocs\" ]; then" echo " rm -rf \"/var/www/\$${app_name_upper}_DOMAIN_NAME/htdocs\"" echo ' fi' fi -echo " if [ -d /repos/${app_name} ]; then" -echo " mkdir \"/var/www/\$${app_name_upper}_DOMAIN_NAME/htdocs\"" -if [ ! "$app_dir" ]; then - echo " cp -r -p /repos/${app_name}/. \"/var/www/\$${app_name_upper}_DOMAIN_NAME/htdocs\"" - echo " cd \"/var/www/\$${app_name_upper}_DOMAIN_NAME/htdocs\" || exit 324687356" -else - echo " cp -r -p /repos/${app_name}/. \"${app_dir}\"" - echo " cd \"${app_dir}\" || exit 36487365" +echo " if [ -d /repos/${app_name} ]; then" +if [ $app_webui ]; then + echo " mkdir \"/var/www/\$${app_name_upper}_DOMAIN_NAME/htdocs\"" fi -echo ' git pull' -echo ' else' if [ ! "$app_dir" ]; then - echo " git_clone \$${app_name_upper}_REPO \"/var/www/\$${app_name_upper}_DOMAIN_NAME/htdocs\"" + echo " cp -r -p /repos/${app_name}/. \"/var/www/\$${app_name_upper}_DOMAIN_NAME/htdocs\"" + echo " cd \"/var/www/\$${app_name_upper}_DOMAIN_NAME/htdocs\" || exit 324687356" else - echo " git_clone \$${app_name_upper}_REPO \"${app_dir}\"" + echo " cp -r -p /repos/${app_name}/. \"${app_dir}\"" + echo " cd \"${app_dir}\" || exit 36487365" fi -echo ' fi' +echo ' git pull' +echo ' else' +if [ ! "$app_dir" ]; then + echo " git_clone \"\$${app_name_upper}_REPO\" \"/var/www/\$${app_name_upper}_DOMAIN_NAME/htdocs\"" +else + echo " git_clone \"\$${app_name_upper}_REPO\" \"${app_dir}\"" +fi +echo ' fi' echo '' if [ ! "$app_dir" ]; then - echo " if [ ! -d \"/var/www/\$${app_name_upper}_DOMAIN_NAME/htdocs\" ]; then" + echo " if [ ! -d \"/var/www/\$${app_name_upper}_DOMAIN_NAME/htdocs\" ]; then" else - echo " if [ ! -d \"${app_dir}\" ]; then" + echo " if [ ! -d \"${app_dir}\" ]; then" fi -echo " echo \$'Unable to clone ${app_name} repo'" -echo ' exit 87525' -echo ' fi' +echo " echo \$'Unable to clone ${app_name} repo'" +echo ' exit 87525' +echo ' fi' echo '' if [ ! "$app_dir" ]; then echo " cd \"/var/www/\$${app_name_upper}_DOMAIN_NAME/htdocs\" || exit 36587356" else echo " cd \"${app_dir}\" || exit 3463754637" fi -echo " git checkout \$${app_name_upper}_COMMIT -b \$${app_name_upper}_COMMIT" +echo " git checkout \"\$${app_name_upper}_COMMIT\" -b \"\$${app_name_upper}_COMMIT\"" echo " set_completion_param \"${app_name} commit\" \"\$${app_name_upper}_COMMIT\"" -echo '' -echo " chmod g+w \"/var/www/\$${app_name_upper}_DOMAIN_NAME/htdocs\"" -echo " chown -R www-data:www-data \"/var/www/\$${app_name_upper}_DOMAIN_NAME/htdocs\"" +if [ $app_webui ]; then + echo '' + echo " chmod g+w \"/var/www/\$${app_name_upper}_DOMAIN_NAME/htdocs\"" + echo " chown -R www-data:www-data \"/var/www/\$${app_name_upper}_DOMAIN_NAME/htdocs\"" +fi if [[ "$database_type" == "mariadb" || "$database_type" == "mysql" || "$database_type" == "postgres"* ]]; then echo '' echo " ${app_name}_create_database" fi +if [ $app_webui ]; then + echo '' + echo " add_ddns_domain \"\$${app_name_upper}_DOMAIN_NAME\"" +fi echo '' -echo " add_ddns_domain \"\$${app_name_upper}_DOMAIN_NAME\"" -echo '' -echo " ${app_name_upper}_ONION_HOSTNAME=\$(add_onion_service ${app_name} 80 \${${app_name_upper}_ONION_PORT})" +echo " ${app_name_upper}_ONION_HOSTNAME=\$(add_onion_service ${app_name} 80 \"\${${app_name_upper}_ONION_PORT}\")" if [ $app_webui ]; then echo '' @@ -791,7 +872,11 @@ fi if [ $app_daemon ]; then echo '' - echo " useradd -d \"TODO_PATH_TO_INSTALL\" -s /bin/false ${app_name}" + if [[ ! "$app_dir" ]]; then + echo " adduser --system --home=\"TODO_PATH_TO_INSTALL\" --group ${app_name}" + else + echo " adduser --system --home=\"${app_dir}\" --group ${app_name}" + fi echo '' echo " { echo '[Unit]';" echo " echo 'Description=${app_name}';" @@ -801,15 +886,26 @@ if [ $app_daemon ]; then echo " echo '[Service]';" echo " echo 'Type=simple';" echo " echo 'User=${app_name}';" - echo " echo 'Group=${app_name}'; } > \"/etc/systemd/system/${app_name}.service\"" + echo " echo 'Group=${app_name}';" if [ ! "$app_dir" ]; then - echo " echo 'WorkingDirectory=TODO' >> \"/etc/systemd/system/${app_name}.service\"" + echo " echo 'WorkingDirectory=TODO';" else - echo " echo 'WorkingDirectory=${app_dir}' >> \"/etc/systemd/system/${app_name}.service\"" + echo " echo 'WorkingDirectory=${app_dir}';" fi - echo " { echo 'ExecStart=TODO';" + if [[ ! "$app_nodeapp" ]]; then + if [ ! $app_node ]; then + echo " echo 'ExecStart=TODO';" + else + echo " echo 'ExecStart=/usr/local/bin/npm start';" + echo " echo 'ExecStop=/usr/local/bin/npm stop';" + fi + else + echo " echo 'ExecStart=/usr/local/bin/node $app_nodeapp';" + echo " echo 'Environment=NODE_ENV=production';" + fi + echo " echo 'Environment=USER=${app_name}';" echo " echo 'Restart=always';" - echo " echo 'Environment=\"USER=${app_name}\"';" + echo " echo 'StandardError=syslog';" echo " echo '';" echo " echo '[Install]';" echo " echo 'WantedBy=multi-user.target'; } >> \"/etc/systemd/system/${app_name}.service\"" @@ -819,21 +915,29 @@ if [ $app_daemon ]; then fi echo " systemctl start ${app_name}" fi -echo '' -echo " create_site_certificate \"\$${app_name_upper}_DOMAIN_NAME\" 'yes'" -echo '' -echo " nginx_ensite \"\$${app_name_upper}_DOMAIN_NAME\"" -echo '' +if [ $app_webui ]; then + echo '' + echo " create_site_certificate \"\$${app_name_upper}_DOMAIN_NAME\" 'yes'" + echo '' + echo " nginx_ensite \"\$${app_name_upper}_DOMAIN_NAME\"" +fi if [[ "$database_type" == "mariadb" || "$database_type" == "mysql" ]]; then + echo '' echo ' systemctl restart mariadb' fi -if [[ "$app_php" == 'yes' ]]; then - echo ' systemctl restart php7.0-fpm' +if [ $app_webui ]; then + if [[ "$app_php" == 'yes' ]]; then + echo '' + echo ' systemctl restart php7.0-fpm' + fi + echo '' + echo ' systemctl restart nginx' fi -echo ' systemctl restart nginx' echo '' echo " \"\${PROJECT_NAME}-pass\" -u \"\$MY_USERNAME\" -a ${app_name} -p \"\$${app_name_upper}_ADMIN_PASSWORD\"" -echo " set_completion_param \"${app_name} domain\" \"\$${app_name_upper}_DOMAIN_NAME\"" +if [ $app_webui ]; then + echo " set_completion_param \"${app_name} domain\" \"\$${app_name_upper}_DOMAIN_NAME\"" +fi if [ "$app_port" ]; then echo '' echo " firewall_add ${app_name} ${app_port} tcp" diff --git a/src/freedombone-utils-firewall b/src/freedombone-utils-firewall index bacc488d..06d2f98e 100755 --- a/src/freedombone-utils-firewall +++ b/src/freedombone-utils-firewall @@ -36,6 +36,9 @@ EXTERNAL_IPV4_ADDRESS= function save_firewall_settings { iptables-save > /etc/firewall.conf ip6tables-save > /etc/firewall6.conf + if [ ! -d /etc/network/if-up.d ]; then + mkdir /etc/network/if-up.d + fi printf '#!/bin/sh\n' > /etc/network/if-up.d/iptables printf 'iptables-restore < /etc/firewall.conf\n' >> /etc/network/if-up.d/iptables printf 'ip6tables-restore < /etc/firewall6.conf\n' >> /etc/network/if-up.d/iptables @@ -465,6 +468,33 @@ function firewall_add_range { fi } +function firewall_handle_port_scans { + if [[ $(is_completed "${FUNCNAME[0]}") == "1" ]]; then + return + fi + # only works for high frequency port scanning + + # flooding of RST packets, smurf attack Rejection + iptables -A INPUT -p tcp -m tcp --tcp-flags RST RST -m limit --limit 2/second --limit-burst 2 -j ACCEPT + + # Protecting portscans + # Attacking IP will be locked for 24 hours (3600 x 24 = 86400 Seconds) + iptables -A INPUT -m recent --name portscan --rcheck --seconds 86400 -j DROP + iptables -A FORWARD -m recent --name portscan --rcheck --seconds 86400 -j DROP + + # Remove attacking IP after 24 hours + iptables -A INPUT -m recent --name portscan --remove + iptables -A FORWARD -m recent --name portscan --remove + + # These rules add scanners to the portscan list, and log the attempt. + iptables -A INPUT -p tcp -m tcp --dport 139 -m recent --name portscan --set -j LOG --log-prefix "portscan:" + iptables -A INPUT -p tcp -m tcp --dport 139 -m recent --name portscan --set -j DROP + + iptables -A FORWARD -p tcp -m tcp --dport 139 -m recent --name portscan --set -j LOG --log-prefix "portscan:" + iptables -A FORWARD -p tcp -m tcp --dport 139 -m recent --name portscan --set -j DROP + save_firewall_settings + mark_completed "${FUNCNAME[0]}" +} function firewall_remove { firewall_port=$1 diff --git a/src/freedombone-utils-network b/src/freedombone-utils-network index f55506b9..87d4e212 100755 --- a/src/freedombone-utils-network +++ b/src/freedombone-utils-network @@ -34,7 +34,6 @@ IPV6_NETWORK='2001:470:26:307' # OpenDNS ipv6 DNS 2620:0:ccc::2 IPV4_ADDRESS_TEST_DESTINATION='85.214.73.63' IPV6_ADDRESS_TEST_DESTINATION='2620:0:ccc::2' -EXTERNAL_IP_LOOKUP_URL='ifcfg.me' # The static IP address of the system within the local network # By default the IP address is dynamic within your LAN @@ -100,7 +99,7 @@ function install_static_network { } function get_external_ipv4_address { - nslookup . $EXTERNAL_IP_LOOKUP_URL | grep Address | tail -n 1 | awk -F ' ' '{print $2}' + curl -s ipinfo.io/ip } function get_ipv4_address { @@ -117,7 +116,7 @@ function update_external_ip { ip_update_script=/usr/bin/externalipupdate { echo '#!/bin/bash'; echo "existing_ip=\$(cat $CONFIGURATION_FILE | grep \"EXTERNAL_IPV4_ADDRESS=\" | head -n 1 | awk -F '=' '{print \$2}')'"; - echo "curr_ip=\$(nslookup . $EXTERNAL_IP_LOOKUP_URL | grep Address | tail -n 1 | awk -F ' ' '{print \$2}')"; + echo "curr_ip=\$(curl -s ipinfo.io/ip)"; echo "if [[ \"\$curr_ip\" != \"\$existing_ip\" ]]; then"; echo " sed -i \"s|EXTERNAL_IPV4_ADDRESS=.*|EXTERNAL_IPV4_ADDRESS=\${curr_ip}|g\" $CONFIGURATION_FILE"; echo " echo \"\$(date)\" >> ~/${PROJECT_NAME}-external-ip-changes.txt"; diff --git a/src/freedombone-utils-nodejs b/src/freedombone-utils-nodejs index 9d4b5aee..b86e7f57 100755 --- a/src/freedombone-utils-nodejs +++ b/src/freedombone-utils-nodejs @@ -244,6 +244,26 @@ function nodejs_upgrade { npm update -g } +function mesh_setup_npm { + cat < "$rootdir/usr/bin/install_npm_global" +#!/bin/bash +if [ ! -d ~/.npm-global ]; then + mkdir ~/.npm-global +fi +npm config set prefix '~/.npm-global' +if [[ "$PATH" != *'~/.npm-global/bin'* ]]; then + export PATH=~/.npm-global/bin:$PATH + echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc +fi +export NPM_CONFIG_PREFIX=~/.npm-global +echo 'export NPM_CONFIG_PREFIX=~/.npm-global' >> ~/.bashrc +source ~/.profile +EOF + chroot "$rootdir" /bin/chmod +x /usr/bin/install_npm_global + chroot "$rootdir" /usr/bin/install_npm_global + rm "$rootdir/usr/bin/install_npm_global" +} + function nodejs_setup_global_modules { if [ ! -f /usr/local/bin/node ]; then return diff --git a/src/freedombone-utils-setup b/src/freedombone-utils-setup index 1836db2a..fd208d61 100755 --- a/src/freedombone-utils-setup +++ b/src/freedombone-utils-setup @@ -700,6 +700,9 @@ function setup_firewall { function_check configure_firewall_ping configure_firewall_ping + function_check firewall_handle_port_scans + firewall_handle_port_scans + function_check firewall_drop_telnet firewall_drop_telnet diff --git a/src/freedombone-vars b/src/freedombone-vars index 6e0f02e0..6165b3fd 100755 --- a/src/freedombone-vars +++ b/src/freedombone-vars @@ -50,7 +50,7 @@ PROJECT_REPO="https://github.com/bashrc/${PROJECT_NAME}" INSTALLING_ON_BBB="no" # Version number of this script -VERSION="3.00" +VERSION="3.1" # if yes then this minimises the number of descisions presented during install MINIMAL_INSTALL="yes" diff --git a/website/EN/app_akaunting.html b/website/EN/app_akaunting.html index dc28ca1c..4e1e959f 100644 --- a/website/EN/app_akaunting.html +++ b/website/EN/app_akaunting.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - - + + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,30 +144,31 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

Akaunting

-
+
+

Akaunting

+

The Freedombone system isn't primarily aimed at companies or institutions, but if you're a one person company or freelancer then having the ability to run your own accounting system and keep the data private and also backed up is useful. Akaunting provides a nice web based system for small business accounts, and is also quite usable within a mobile web browser.

+
+
-
-

Installation

-
+
+

Installation

+

Log into your system with:

+
ssh myusername@mydomain -p 2222
 
@@ -280,25 +189,21 @@ From the Administrator control panel select Passwords and look up Now in a browser navigate to your subdomain. You will need to enter some details for the database. The password should be the mariadb one.

-
-

akaunting_setup.jpg +

akaunting_setup.jpg

-

After that you'll need to enter a company name and an email address. You can make the administrator password anything you prefer, and a suggestion can be found within the Passwords section of the Administrator control panel under akaunting.

-
-

akaunting_setup_company.jpg +

akaunting_setup_company.jpg

-

From then on the system should be usable. Accounts software can often be quite complex, and so you'll probably want to refer to the official documentation for details. diff --git a/website/EN/app_bdsmail.html b/website/EN/app_bdsmail.html index 8d22c13a..0a1a760d 100644 --- a/website/EN/app_bdsmail.html +++ b/website/EN/app_bdsmail.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - - + + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,18 +144,16 @@ for the JavaScript code in this tag.

-
+

-

logo.png +

logo.png

-
- -
-

BDS Mail

-
+
+

BDS Mail

+

BDS Mail (aka "Brain Dead Simple Mail") is an optional addition to the existing email server which comes installed as default. It creates an extra folder within the Mutt client which allows you to send and receive email using i2p as the transport layer. This solves the problem of being blocked by dubious systems and also the problem of user friendly email encryption. If you're behind a hostile firewall which you don't control and which blocks all ports, this system is still likely to work. You can use GPG as an additional encryption layer if you prefer, but it's not strictly necessary because you already have the i2p public key system to ensure end-to-end security.

@@ -255,15 +161,18 @@ BDS Mail (aka "Brain Dead Simple Mail") is an optional addition to the existing

It's unlikely that many people will use this. If it's hard to persuade anyone to use GPG or Enigmail then it will be next to impossible to persuade them to switch to BDS Mail unless they're already obsessive about technical security. However, this provides yet another option for reasonably secure communications if other methods fail or are untrustable.

+
+
-
-

Installation

-
+
+

Installation

+

ssh into the system with:

+
ssh myusername@mydomain.com -p 2222
 
diff --git a/website/EN/app_bludit.html b/website/EN/app_bludit.html index a5bc9a0b..b8196b8f 100644 --- a/website/EN/app_bludit.html +++ b/website/EN/app_bludit.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - - + + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,30 +144,31 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

Bludit

-
+
+

Bludit

+

This is a databaseless blogging system which uses markdown files. It's not very complex and so there is not much to go wrong, and it should run well on any server hardware.

+
+
-
-

Installation

-
+
+

Installation

+

Log into your system with:

+
ssh myusername@mydomain -p 2222
 
diff --git a/website/EN/app_cryptpad.html b/website/EN/app_cryptpad.html index f0564961..dec9b0f9 100644 --- a/website/EN/app_cryptpad.html +++ b/website/EN/app_cryptpad.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,25 +144,21 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
-
-

CryptPad

-
- -
+
+

CryptPad

+
-

cryptpad.jpg +

cryptpad.jpg

-

This is similar to EtherPad but with better security and more document types which can be collaboratively edited in real time. It includes not just text editing but also creating presentations, voting and editing source code. @@ -271,17 +175,20 @@ Enabling someone to edit a document is as simple as sending them the URL via a c

Documents are stored locally within the browser of each user and the server just acts as a coordinator. No documents are stored on the server.

+
+
-
-

Installation

-
+
+

Installation

+

Log into your system with:

-
ssh myusername@mydomain -p 2222
-
+ +
ssh myusername@mydomain -p 2222
+

diff --git a/website/EN/app_dokuwiki.html b/website/EN/app_dokuwiki.html index 380ff49c..fcb1c56c 100644 --- a/website/EN/app_dokuwiki.html +++ b/website/EN/app_dokuwiki.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - + + + + - + @@ -235,31 +144,31 @@ for the JavaScript code in this tag.

-
+

-

logo.png +

logo.png

-
- -
-

Dokuwiki

-
+
+

Dokuwiki

+

Dokuwiki is a wiki which stores its content in text files. Having no database makes maintaining it simpler, and it's not tied to any particular domain name so you can easily copy the files to a different domain if you need to.

+
+
- -
-

Installation

-
+
+

Installation

+

Log into your system with:

+
ssh myusername@mydomain -p 2222
 
@@ -278,9 +187,9 @@ After the install has completed go to Security settings and select Cre
-
-

Initial setup

-
+
+

Initial setup

+

If you have just obtained a Lets Encrypt certificate as above then go to About on the administrator control panel and you should see your Dokuwiki domain listed there along with an onion address. You can then navigate to your site in a browser.

diff --git a/website/EN/app_edith.html b/website/EN/app_edith.html index fb31fd66..e61039f9 100644 --- a/website/EN/app_edith.html +++ b/website/EN/app_edith.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - - + + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,18 +144,16 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

Edith Notes

-
+
+

Edith Notes

+

Edith notes is the simplest and quickest kind of notes system. It has no complicated user interface. Just enter your domain and a title and a note will be created. Everything typed is saved automatically.

@@ -261,6 +167,7 @@ ssh into the system with:

+
ssh myusername@mydomain.com -p 2222
 
@@ -269,18 +176,18 @@ ssh into the system with: Select Administrator controls then App Settings then edith. Enter a subdomain name, such as notes.mydomain.com, and optionally a freedns code. When the installation is complete you can then look up the password for the site within the Passwords section of the Administrator control panel, then navigate to the subdomain. Log in, then enter something like notes.mydomain.com/testnote and start typing.

-
-

edith_notes.jpg +

edith_notes.jpg

-

It is possible to turn off the login via App Settings/edith if you wish, but this will enable anyone on the internet to view or edit notes on your system, which could have obvious privacy or stability implications. From App settings/edith it's also possible to browse through your notes files.

+
+
@@ -235,30 +144,31 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

Emacs

-
+
+

Emacs

+

Emacs is a text editor popular with software developers or anyone who needs to take notes at high speed or be able to customise their editing environment to a high degree. When installed on Freedombone it can be used together the Mutt email client to edit new emails or if you need to manually edit configuration files.

+
+
-
-

Installation

-
+
+

Installation

+

Log into your system with:

+
ssh myusername@mydomain -p 2222
 
@@ -273,9 +183,9 @@ Select Add/Remove Apps. If Vim is selected then you might want to unselec
-
-

Common key combinations

-
+
+

Common key combinations

+

For anyone new to Emacs some common keys are:

@@ -284,64 +194,64 @@ For anyone new to Emacs some common keys are: - + - + -CTRL-x CTRL-s -Save +CTRL-x CTRL-s +Save -CTRL-x CTRL-c -Exit +CTRL-x CTRL-c +Exit -CTRL-l -Go to a line number +CTRL-l +Go to a line number -CTRL-x CTRL-f -Open a file +CTRL-x CTRL-f +Open a file -SHIFT-ALT-< -Go to the top of the file +SHIFT-ALT-< +Go to the top of the file -SHIFT-ALT-> -Go to the end of the file +SHIFT-ALT-> +Go to the end of the file -SHIFT cursors -Select text +SHIFT cursors +Select text -CTRL-x CTRL-h -Highlight all text +CTRL-x CTRL-h +Highlight all text -ALT-w -Copy selected text +ALT-w +Copy selected text -CTRL-y -Paste selected text +CTRL-y +Paste selected text -ESC-ESC-ESC -Undo current selection +ESC-ESC-ESC +Undo current selection diff --git a/website/EN/app_etherpad.html b/website/EN/app_etherpad.html index 57088115..688572a6 100644 --- a/website/EN/app_etherpad.html +++ b/website/EN/app_etherpad.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,18 +144,16 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

Etherpad

-
+
+

Etherpad

+

This is a well known system for real time collaborative editing of documents. Just log in, choose a document title and then edit. Different users will appear in different colours, and can also chat in the sidebar. This is installed as a private system in which only users on your Freedombone server will be able to create and edit documents, so it's not open to any random users on the internet.

@@ -255,17 +161,20 @@ This is a well known system for real time collaborative editing of documents. Ju

If security is an especially important factor then you might also want to consider installing CryptPad instead. It has more features and doesn't store any documents on the server.

+
+
-
-

Installation

-
+
+

Installation

+

Log into your system with:

-
ssh myusername@mydomain -p 2222
-
+ +
ssh myusername@mydomain -p 2222
+

@@ -282,9 +191,9 @@ After the install has completed go to Security settings and select Cre

-
-

Initial setup

-
+
+

Initial setup

+

If you have just obtained a Lets Encrypt certificate as above then go to About on the administrator control panel and you should see your Etherpad domain listed there along with an onion address. You can then navigate to your site in a browser.

diff --git a/website/EN/app_fedwiki.html b/website/EN/app_fedwiki.html index 05a13b65..f145e518 100644 --- a/website/EN/app_fedwiki.html +++ b/website/EN/app_fedwiki.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - - + + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,30 +144,31 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

Federated Wiki

-
+
+

Federated Wiki

+

Federated wikis are a relatively new concept. There can be multiple copies of the same page on different servers and it's then easy to pick which version you prefer, or make something new. It's like wiki meets mashup meets federation, and so is different from many previous web paradigms and may take some recalibration of how you think the web should work.

+
+
-
-

Installation

-
+
+

Installation

+

Log into your system with:

+
ssh myusername@mydomain -p 2222
 
@@ -275,9 +184,9 @@ Select Add/Remove Apps then fedwiki. You will then be asked for a
-
-

Usage

-
+
+

Usage

+

First you'll need to get the login password, which can be found on the Administrator control panel under Passwords then fedwiki.

@@ -291,15 +200,24 @@ There are a few things to know about using the federated wiki.

    -
  • You can edit by clicking on the wiki button at the bottom of the screen
  • -
  • To edit a paragraph double click on it
  • -
  • To remove a paragraph just delete all of its text
  • -
  • Paragraphs can be dragged up and down to change their order, or moved between pages
  • -
  • To add a new paragraph use the + button
  • -
  • You can use left and right cursor keys to move through pages
  • -
  • To claim/fork a page from another server click on the flag icon
  • -
  • When done editing click on the wiki button again
  • -
  • Different versions of the same page on different servers are represented by boxes at the bottom right of the screen. You can double click on them to see the different versions, and use the flag icon to fork if you prefer that version
  • +
  • You can edit by clicking on the wiki button at the bottom of the screen +
  • +
  • To edit a paragraph double click on it +
  • +
  • To remove a paragraph just delete all of its text +
  • +
  • Paragraphs can be dragged up and down to change their order, or moved between pages +
  • +
  • To add a new paragraph use the + button +
  • +
  • You can use left and right cursor keys to move through pages +
  • +
  • To claim/fork a page from another server click on the flag icon +
  • +
  • When done editing click on the wiki button again +
  • +
  • Different versions of the same page on different servers are represented by boxes at the bottom right of the screen. You can double click on them to see the different versions, and use the flag icon to fork if you prefer that version +
diff --git a/website/EN/app_friendica.html b/website/EN/app_friendica.html index 8b06ebcd..302d58a2 100644 --- a/website/EN/app_friendica.html +++ b/website/EN/app_friendica.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,32 +144,33 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

Friendica

-
+
+

Friendica

+

Friendica is a federated social networking system. It can federate with other popular systems such as GNU Social and Diaspora. Currently Friendica only works on the clearnet and doesn't have an onion address.

+
+
-
-

Installation

-
+
+

Installation

+

Log into your system with:

-
ssh myusername@mydomain -p 2222
-
+ +
ssh myusername@mydomain -p 2222
+

@@ -279,9 +188,9 @@ After the install has completed go to Security settings and select Cre

-
-

Initial setup

-
+
+

Initial setup

+

If you have just obtained a Lets Encrypt certificate as above then go to About on the administrator control panel and you should see your Friendica domain listed there. You can then navigate to your site in a browser.

@@ -290,13 +199,11 @@ If you have just obtained a Lets Encrypt certificate as above then go to Abou On first visiting your Friendica site you'll see the login screen. The first thing you need to do is to select register to create a new Friendica administrator user. The first user on the system then becomes its administrator.

-
-

friendicaadmin.jpg +

friendicaadmin.jpg

-

Friendica has numerous addons which you might want to explore. Select the small icon next to the search box and you will get to the administrator settings. Select plugins and you can then configure which ones you want. From the site settings you can also force all links to use SSL/TLS for added security. diff --git a/website/EN/app_gnusocial.html b/website/EN/app_gnusocial.html index 132c1442..7b5ebb13 100644 --- a/website/EN/app_gnusocial.html +++ b/website/EN/app_gnusocial.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - - + + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,18 +144,16 @@ for the JavaScript code in this tag.

-
+

-

logo.png +

logo.png

-
- -
-

GNU Social

-
+
+

GNU Social

+

GNU Social is typically referred to as a microblogging system, although with a maximum post length much longer than Twitter it's really a sort of federated community blog with a stream-based appearance which also supports markdown formatting.

@@ -265,23 +171,23 @@ Some general advice about life in the fediverse can b

-
-
-

gnusocial_pleroma.jpg +

gnusocial_pleroma.jpg

+
-
-

Installation

-
+
+

Installation

+

Log into your system with:

+
ssh myusername@mydomain -p 2222
 
@@ -300,9 +206,9 @@ After the install has completed go to Security settings and select Cre
-
-

Initial setup

-
+
+

Initial setup

+

If you have just obtained a Lets Encrypt certificate as above then go to About on the administrator control panel and you should see your GNU Social domain listed there along with an onion address. You can then navigate to your site in a browser.

@@ -319,63 +225,61 @@ Once you have logged in to GNU Social you may then want to select Admin a GNU Social has a clutter-free mobile user interface which can be accessed via a Tor compatible browser (make sure to add a NoScript exception). Unlike similar proprietary sites there are no bribed posts.

-
-

gnusocial_mobile.jpg +

gnusocial_mobile.jpg

-
-
-

Switching user interfaces

-
+
+

Switching user interfaces

+

A few web based user interfaces are available for GNU SOcial. They are selectable by going to the Administrator control panel and choosing App settings then gnusocial.

-
-

gnusocial_settings.jpg +

gnusocial_settings.jpg

-
    -
  • Qvitter: Looks similar to Twitter during its golden era, before the ads and other antifeatures arrived
  • -
  • Pleroma: A modern and lightweight user interface
  • -
  • Classic: Like the original StatusNet UI. Minimal Javascript and has good support for threaded conversations.
  • +
  • Qvitter: Looks similar to Twitter during its golden era, before the ads and other antifeatures arrived +
  • +
  • Pleroma: A modern and lightweight user interface +
  • +
  • Classic: Like the original StatusNet UI. Minimal Javascript and has good support for threaded conversations. +
-
-

Using with Emacs

-
-
+
+

Using with Emacs

+
-

gnu-social-mode.jpg +

gnu-social-mode.jpg

-

If you are an Emacs user it's also possible to set up GNU Social mode as follows:

+
mkdir ~/elisp
 git clone https://github.com/bashrc/gnu-social-mode ~/elisp/gnu-social-mode
-echo "(add-to-list 'load-path \"~/elisp/gnu-social-mode\")" >> ~/.emacs
-echo "(require 'gnu-social-mode)" >> ~/.emacs
-echo "(setq gnu-social-server-textlimit 2000" >> ~/.emacs
-echo "      gnu-social-server \"yourgnusocialdomain\"" >> ~/.emacs
-echo "    gnu-social-username \"yourusername\"" >> ~/.emacs
-echo "    gnu-social-password \"gnusocialpassword\")" >> ~/.emacs
+echo "(add-to-list 'load-path \"~/elisp/gnu-social-mode\")" >> ~/.emacs
+echo "(require 'gnu-social-mode)" >> ~/.emacs
+echo "(setq gnu-social-server-textlimit 2000" >> ~/.emacs
+echo "      gnu-social-server \"yourgnusocialdomain\"" >> ~/.emacs
+echo "    gnu-social-username \"yourusername\"" >> ~/.emacs
+echo "    gnu-social-password \"gnusocialpassword\")" >> ~/.emacs
 
@@ -384,6 +288,7 @@ And as a quick reference the main keys are:

+
M-x gnu-social
 
@@ -396,54 +301,54 @@ The basics: - + - + -i -Show icons +i +Show icons -CTRL-c CTRL-s -Post status update +CTRL-c CTRL-s +Post status update -r -Repeat +r +Repeat -F -Favourite +F +Favourite -CTRL-c CTRL-h -Highlight +CTRL-c CTRL-h +Highlight -R -Reply to user +R +Reply to user -CTRL-c CTRL-r -Show replies +CTRL-c CTRL-r +Show replies -CTRL-c CTRL-f -Friends timeline +CTRL-c CTRL-f +Friends timeline -CTRL-c CTRL-v -View user profile +CTRL-c CTRL-v +View user profile @@ -456,19 +361,19 @@ Navigation: - + - + -j -Next +j +Next -k -Previous +k +Previous @@ -481,70 +386,68 @@ Showing timelines: - + - + -g -Current timeline +g +Current timeline -CTRL-c CTRL-a -Public timeline +CTRL-c CTRL-a +Public timeline -CTRL-c CTRL-g -Group timeline +CTRL-c CTRL-g +Group timeline -CTRL-c CTRL-t -Tag timeline +CTRL-c CTRL-t +Tag timeline -CTRL-c CTRL-k -Stop +CTRL-c CTRL-k +Stop -CTRL-c CTRL-u -User timeline +CTRL-c CTRL-u +User timeline -CTRL-c CTRL-c -Conversation timeline +CTRL-c CTRL-c +Conversation timeline -CTRL-c CTRL-o -Remote user timeline +CTRL-c CTRL-o +Remote user timeline -CTRL-c CTRL-d -Post direct Message +CTRL-c CTRL-d +Post direct Message
-
-

Blocking controls

-
-
+
+

Blocking controls

+
-

control_panel_blocking.jpg +

control_panel_blocking.jpg

-

The biggest hazard with GNU Social is that it's part of a public federated communications system. This means that conversations and replies from other servers may end up in your "whole known network" stream. The internet being what it is, some of these could be undesirable. You can block individual users or entire domains by going to the Administrator control panel and selecting Domain or User Blocking, then adding or removing entries. This blocks domains at the firewall level and also at the level of database and file storage. diff --git a/website/EN/app_gogs.html b/website/EN/app_gogs.html index 26c05ff5..8de916d8 100644 --- a/website/EN/app_gogs.html +++ b/website/EN/app_gogs.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - + + + + - + @@ -235,18 +144,16 @@ for the JavaScript code in this tag.

-
+

-

logo.png +

logo.png

-
- -
-

Gogs

-
+
-
-

Installation

-
+
+

Installation

+

Log into your system with:

+
ssh myusername@mydomain -p 2222
 
@@ -281,9 +191,9 @@ After the install has completed go to Security settings and select Cre
-
-

Initial setup

-
+
+

Initial setup

+

If you have just obtained a Lets Encrypt certificate as above then go to About on the administrator control panel and you should see your Gogs domain listed there along with an onion address. You can then navigate to your site in a browser.

@@ -293,6 +203,7 @@ In a browser navigate to your Gogs site and click the Register button. Th

+
sudo username@domainname -p 2222
 
diff --git a/website/EN/app_htmly.html b/website/EN/app_htmly.html index 6b0b9c69..9b045dc9 100644 --- a/website/EN/app_htmly.html +++ b/website/EN/app_htmly.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - + + + + - + @@ -235,30 +144,31 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

HTMLy

-
+
+

HTMLy

+

HTMLy is a databaseless blogging system.

+
+
-
-

Installation

-
+
+

Installation

+

Log into your system with:

+
ssh myusername@mydomain -p 2222
 
@@ -277,9 +187,9 @@ After the install has completed go to Security settings and select Cre
-
-

Initial setup

-
+
+

Initial setup

+

If you have just obtained a Lets Encrypt certificate as above then go to About on the administrator control panel and you should see your HTMLy blog domain listed there along with an onion address. You can then navigate to your site in a browser.

diff --git a/website/EN/app_hubzilla.html b/website/EN/app_hubzilla.html index 373d35a4..af416cb8 100644 --- a/website/EN/app_hubzilla.html +++ b/website/EN/app_hubzilla.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,32 +144,33 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

Hubzilla

-
+
+

Hubzilla

+

Hubzilla is a web publishing and social network system which includes wiki, web pages, photo albums and file storage. It also has privacy controls which allow you to define who can see which content. It's possible to write posts and have them visible only to a group of friends (known as "privacy groups"), with the encryption being handled automatically. Currently Hubzilla only works on the clearnet and doesn't have an onion address.

+
+
-
-

Installation

-
+
+

Installation

+

Log into your system with:

-
ssh myusername@mydomain -p 2222
-
+ +
ssh myusername@mydomain -p 2222
+

@@ -279,9 +188,9 @@ After the install has completed go to Security settings and select Cre

-
-

Initial setup

-
+
+

Initial setup

+

If you have just obtained a Lets Encrypt certificate as above then go to About on the administrator control panel and you should see your Hubzilla domain listed there. You can then navigate to your site in a browser.

@@ -290,16 +199,14 @@ If you have just obtained a Lets Encrypt certificate as above then go to Abou On first visiting your Hubzilla site you'll see the login screen. The first thing you need to do is register a new user. The first user on the system then becomes its administrator.

-
-

hubzilla_mobile.jpg +

hubzilla_mobile.jpg

-
@@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,18 +144,16 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

Icecast

-
+
+

Icecast

+

Icecast enables you to run something like an internet radio station. So if you have multiple audio files and want to be able to stream those in sequence from a web site then this can be useful.

@@ -255,15 +161,18 @@ Icecast enables you to run something like an internet radio station. So if you h

This system is available only via an onion address, which should mitigate the potential for copyright disputes over streamed content. By default it's only set up to stream to a small number of users so that it doesn't put too much stress on CPU or memory requirements, although you can increase the maximum limit if you have a more powerful system and enough bandwidth.

+
+
-
-

Installation

-
+
+

Installation

+

Log into your system with:

+
ssh myusername@mydomain -p 2222
 
@@ -278,9 +187,9 @@ If you then go to the About screen you'll see the onion address for Iceca
-
-

Adding files to be streamed

-
+
+

Adding files to be streamed

+

There are two ways to get files onto the system: either via ssh or via a USB drive. File types can be ogg, ogv, mp3 or mp4 format.

@@ -290,9 +199,9 @@ It may take a while for the files to import, especially on a low power single bo

-
-

From a USB drive

-
+
+

From a USB drive

+

Create a directory on the USB drive named icestream and copy your files into there. Plug the drive into your server.

@@ -303,14 +212,15 @@ Go to the Administrator control panel, select App settings, then <
-
-

Via ssh

-
+
+

Via ssh

+

Make a directory named icestream and copy your files into it. Then copy the directory to your server.

+
scp -r -P 2222 icestream myusername@mydomain:/home/myusername
 
@@ -320,6 +230,7 @@ Log into your server with:

+
ssh myusername@mydomain -p 2222
 
@@ -331,9 +242,9 @@ Select Administrator controls, enter your password, then go to App set
-
-

Access controls

-
+
+

Access controls

+

By default anyone who happens to find your Icecast onion address can listen to your stream. If you only want it to be available to a few friends or family then you can add an extra login password.

diff --git a/website/EN/app_irc.html b/website/EN/app_irc.html index 7a17e7e1..106427a1 100644 --- a/website/EN/app_irc.html +++ b/website/EN/app_irc.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - + + + + - + @@ -235,30 +144,31 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

IRC

-
+
+

IRC

+

IRC is useful for multi-user chat. The classic use case is for software development where many engineers might need to coordinate their activities, but it's also useful for meetings, parties and general socialising.

+
+
-
-

Irssi

-
+
+

Irssi

+

The easiest way to use irssi is to connect to your system, like this:

+
ssh myusername@mydomain -p 2222
 
@@ -269,9 +179,9 @@ Then select IRC from the menu. However, other than via this method using
-
-

HexChat

-
+
+

HexChat

+

HexChat (formerly XChat) is compatible with proxying via Tor and so provides the best security when connecting to your IRC server. It will allow you to connect to your IRC server's onion address.

@@ -281,6 +191,7 @@ First install HexChat and set up its configuration file. This can be done on you

+
freedombone-client --setup hexchat
 
@@ -290,6 +201,7 @@ Now look up the onion address for your IRC server

+
ssh username@mydomainname -p 2222
 
@@ -324,7 +236,7 @@ If you are using the ordinary domain name (clearnet/ICANN) then make sure that <
-

hexchat_setup_clearnet.jpg +

hexchat_setup_clearnet.jpg

@@ -334,7 +246,7 @@ If you are using the onion address then use SSL should be unchecked and t
-

hexchat_setup.jpg +

hexchat_setup.jpg

@@ -352,9 +264,9 @@ Click close and then connect.
-
-

Emacs

-
+
+

Emacs

+

If you are an Emacs user then you can also connect to your IRC server via Emacs.

@@ -364,6 +276,7 @@ Ensure that tor is installed onto your local system:

+
sudo apt-get install tor
 
@@ -373,6 +286,7 @@ Add the following to your Emacs configuration file:

+
(setq socks-noproxy '("localhost"))
 (require 'socks)
 (require 'tls)
@@ -386,14 +300,15 @@ Add the following to your Emacs configuration file:
 
-
-

Changing or removing the IRC password

-
+
+

Changing or removing the IRC password

+

By default the IRC server is set up to require a password for users to log in. The password is the same for all users. If you want to change or remove the password:

+
ssh myusername@mydomain -p 2222
 
diff --git a/website/EN/app_kanboard.html b/website/EN/app_kanboard.html index 4a3b1f55..e3cded05 100644 --- a/website/EN/app_kanboard.html +++ b/website/EN/app_kanboard.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,32 +144,33 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

KanBoard

-
+
+

KanBoard

+

Kanbans are one way of managing projects. They're traditionally used in businesses but can also be useful for personal TODO lists or within open source or DIY projects. If you have a list of things which need to be done and want to keep track of progress then this provides a way to do that.

+
+
-
-

Installation

-
+
+

Installation

+

Log into your system with:

-
ssh myusername@mydomain -p 2222
-
+ +
ssh myusername@mydomain -p 2222
+

@@ -278,9 +187,9 @@ After the install has completed go to Security settings and select Cre

-
-

Initial setup

-
+
+

Initial setup

+

If you have just obtained a Lets Encrypt certificate as above then go to About on the administrator control panel and you should see your KanBoard domain listed there along with an onion address. You can then navigate to your site in a browser.

diff --git a/website/EN/app_keyserver.html b/website/EN/app_keyserver.html index 1421b6f0..f173acd9 100644 --- a/website/EN/app_keyserver.html +++ b/website/EN/app_keyserver.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,18 +144,16 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

OpenPGP Key Server

-
+
+

OpenPGP Key Server

+

The web of trust is a nice idea, but how trustable is it? If you take a look at how many OpenPGP key servers are out there then there are a two or three main ones and not much else. Can you trust those servers? Who is maintaining them and how often? Is any censorship going on? How hard would it be for adversaries to get implants onto them? In terms of technology this infrastructure is quite old and it could have been neglected for a long time. Once vigilant maintainers might have turned lazy and gotten lax with server security, or been recruited over to the dark side.

@@ -256,24 +162,25 @@ The web of trust is a nice idea, but how trustable is it? If you take a l For these kinds of reasons you might prefer to run your own web of trust infrastructure. In simple terms it's a database of GPG public keys which provides a way for users to find out how to communicate with others securely via email. You can meet in person and exchange public keys via sneakernet on USB drives, but most users of GPG don't do that. Instead they just download the public key for a given email address from one of the key servers.

-
-

keyserver.jpg +

keyserver.jpg

+
-
-

Installation

-
+
+

Installation

+

ssh into the system with:

-
ssh myusername@mydomain.com -p 2222
-
+ +
ssh myusername@mydomain.com -p 2222
+

@@ -286,16 +193,17 @@ After the install has completed go to Security settings and select Cre

-
-

How to use it

-
+
+

How to use it

+

Interaction with the web user interface is pretty minimal and obvious, but most likely you will also want to be able to use your keyserver from the commandline. To do that use the –keyserver option. For example to search for a key on your server:

-
gpg --keyserver [your keyserver domain] --search-keys [email address]
-
+ +
gpg --keyserver [your keyserver domain] --search-keys [email address]
+
@@ -304,8 +212,9 @@ Or to send a key to it:

-
gpg --keyserver [your keyserver domain] --send-keys [email address or key ID]
-
+ +
gpg --keyserver [your keyserver domain] --send-keys [email address or key ID]
+

@@ -313,14 +222,15 @@ Or to get a key:

-
gpg --keyserver [your keyserver domain] --recv-keys [email address or key ID]
-
+ +
gpg --keyserver [your keyserver domain] --recv-keys [email address or key ID]
+
-
-

Sync with other keyservers

-
+
+

Sync with other keyservers

+

Key servers avoid censorship or errors by gossiping between each other and cross referencing the data. You can define which other servers your key server will gossip with by going to the Administrator control panel, selecting App Settings then keyserver then Sync with other keyserver.

@@ -330,9 +240,9 @@ It's a good idea not to try to sync with the popular OpenPGP key servers, becaus

-
-

Possible problems

-
+
+

Possible problems

+

OpenPGP key servers are not very well defended from flooding attacks. This means that an adversary could just upload a billion keys to destabilize the server and fill it with nonsense to make it unusable. Since key servers are fully open to the public there isn't anything to prevent that from happening.

diff --git a/website/EN/app_koel.html b/website/EN/app_koel.html index c4f729c0..5aad5e96 100644 --- a/website/EN/app_koel.html +++ b/website/EN/app_koel.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,40 +144,39 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

Koel

-
+
+

Koel

+

This enables you to store your music on the Freedombone server and then access it from any internet connected device. If you just want to make music accessible within your home network then DLNA is usually sufficient, but if you want to be able to play your music from anywhere then Koel is a better option.

-
-

koel.jpg +

koel.jpg

+
-
-

Installation

-
+
+

Installation

+

Log into your system with:

-
ssh myusername@mydomain -p 2222
-
+ +
ssh myusername@mydomain -p 2222
+

@@ -288,42 +195,39 @@ Go back to the Administrator control panel, select Passwords then Once logged in go to settings and set the media path to /music.

-
-

koelsettings.jpg +

koelsettings.jpg

-
-
-

Importing music

-
+
+

Importing music

+

This app doesn't have any way to upload music and instead just expects that there will be a directory on the server containing music files. There are a couple of ways to get new music files onto the system: either by using ssh or by putting them onto a USB drive.

-
-

control_panel_koel.jpg +

control_panel_koel.jpg

-
-
-

Via ssh

-
+
+

Via ssh

+

On your local system:

-
scp -P 2222 -r ~/Music username@domainname:/home/username
-
+ +
scp -P 2222 -r ~/Music username@domainname:/home/username
+

@@ -335,8 +239,9 @@ Now log in to your Freedombone system:

-
ssh username@domainname -p 2222
-
+ +
ssh username@domainname -p 2222
+

@@ -345,9 +250,9 @@ And select Administrator settings followed by App settings then

-
-

Via USB drive

-
+
+

Via USB drive

+

Create a LUKS formatted USB drive. It's possible to do this by plugging a new USB drive into the Freedombone system then going to the Administrator control panel, selecting App settings then koel then Format a USB drive. You will need to specify a password, which in this case doesn't need to be anything highly secure.

@@ -362,9 +267,9 @@ Once you have music on a LUKS formatted USB drive then plug it into the Freedomb
-
-

Synchronizing

-
+
+

Synchronizing

+

To detect the imported files you might need to re-synchronize. Within Koel go to settings and then select Scan. Any imported files should then be available to play.

diff --git a/website/EN/app_lychee.html b/website/EN/app_lychee.html index 1b15672c..a3da189d 100644 --- a/website/EN/app_lychee.html +++ b/website/EN/app_lychee.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - + + + + - + @@ -235,30 +144,31 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

Lychee

-
+
+

Lychee

+

Lychee is a simple and lightweight photo album for the web. Whether you're an amateur or professional photographer, or want to publish random holiday pics or cat pictures. Lychee just does what it says it does without any fuss. There is also a photo album feature within Hubzilla if you need more sophisticated social photo sharing with individualised permissions.

+
+
-
-

Installation

-
+
+

Installation

+

Log into your system with:

+
ssh myusername@mydomain -p 2222
 
@@ -277,9 +187,9 @@ After the install has completed go to Security settings and select Cre
-
-

Initial setup

-
+
+

Initial setup

+

If you have just obtained a Lets Encrypt certificate as above then go to About on the administrator control panel and you should see your Lychee domain listed there along with an onion address. You can then navigate to your site in a browser.

@@ -288,13 +198,11 @@ If you have just obtained a Lets Encrypt certificate as above then go to Abou Within a browser navigate to your lychee domain name or onion address. It should look like this:

-
-

lychee_setup.jpg +

lychee_setup.jpg

-

Within the Administrator control panel select App Settings and then lychee. This will show the initial login settings which you need to set up the database. To copy the password hold down the shift key, select the password then right click and copy. diff --git a/website/EN/app_mailpile.html b/website/EN/app_mailpile.html index df956335..d2de925e 100644 --- a/website/EN/app_mailpile.html +++ b/website/EN/app_mailpile.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - - + + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,18 +144,16 @@ for the JavaScript code in this tag.

-
+

-

logo.png +

logo.png

-
- -
-

Mailpile

-
+
+

Mailpile

+

Mailpile provides a nice looking webmail interface suitable for use on desktop or mobile clients. It has good support for email encryption and makes that quite an simple process. At present it's usable but still has a few bugs and limitations. If you need a fully functional email client with comprehensive encryption support then either use Mutt or Thunderbird/Icedove.

@@ -259,15 +165,18 @@ An advantage of this type of webmail is that it keeps your GPG keys off of an

One down side is that this appears to be a single user system, so if you have multiple users on your Freedombone server only the administrator will actually be able to use mailpile.

+
+
-
-

Installation

-
+
+

Installation

+

Log into your system with:

+
ssh myusername@mydomain -p 2222
 
@@ -286,9 +195,9 @@ After the install has completed go to Security settings and select Cre
-
-

Initial setup

-
+
+

Initial setup

+

If you have just obtained a Lets Encrypt certificate as above then go to About on the administrator control panel and you should see your Mailpile domain listed there along with an onion address. You can then navigate to your site in a browser.

@@ -329,25 +238,21 @@ Uncheck Detect Settings and click Next. Under Sending Mail select local or if you need to proxy outgoing email through your ISP's server select SMTP/TLS and enter the details, then click Next.

-
-

mailpile_setup.jpg +

mailpile_setup.jpg

-

Under Receiving files select IMAP, the domain as localhost, port 143 and your username, then click Next. Astute readers may well be concerned that IMAP over port 143 is not encrypted, but since this is only via localhost communication between the Mail Transport Agent and Mailpile doesn't travel over the internet and port 143 is not opened on the firewall so it's not possible to accidentally connect an external mail client insecurely.

-
-

mailpile_setup_keys.jpg +

mailpile_setup_keys.jpg

-

Under Security and Privacy either select your existing encryption key or if you only get the option to create a new one then do so, then click Add or Save. diff --git a/website/EN/app_matrix.html b/website/EN/app_matrix.html index b1a35c4e..d57fa176 100644 --- a/website/EN/app_matrix.html +++ b/website/EN/app_matrix.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - - + + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,25 +144,21 @@ for the JavaScript code in this tag.

-
+

-

logo.png +

logo.png

-
-
-

Matrix

-
- -
+
+

Matrix

+
-

matrix_riotweb.jpg +

matrix_riotweb.jpg

-

Matrix is a federated communications system, typically for multi-user chat, with end-to-end content security features. You can consider it to be like a modernized version of IRC chat where the crypto and access controls have been built in by default. At present Matrix is really only a creature of the clearnet and so there isn't any way to protect the metadata. Despite the talk of security the lack of metadata defenses make this really only suitable for public communications, similar to microblogging or public IRC channels. @@ -263,15 +167,18 @@ Matrix is a federated communications system, typically for multi-user chat, with

Another consideration is that since matrix operates on the usual HTTPS port number (443) this may make it difficult for ISPs or governments to censor this type of communications via port blocking without significant blowback.

+
+
-
-

Installation

-
+
+

Installation

+

Log into your system with:

+
ssh myusername@mydomain -p 2222
 
@@ -286,9 +193,9 @@ Select Add/Remove Apps then matrix. You will then be asked for a d
-
-

Initial setup

-
+
+

Initial setup

+

Go to the Administrator control panel and select Passwords then matrix. This will give you the password to initially log in to the system and you can change it later from a client app if needed.

@@ -303,14 +210,15 @@ Other client apps are available but are currently mostly only at the alpha stage
-
-

DNS setup

-
+
+

DNS setup

+

It's recommended that you add an SRV record for Matrix to your DNS setup. How you do this will depend upon your dynamic DNS provider and their web interface. On FreeDNS on the subdomains settings in addition to the subdomain which you are using for the matrix server create an extra entry as follows:

+
Type: SRV
 Subdomain: _matrix._tcp
 Domain: [youdomain]
@@ -324,9 +232,9 @@ You may also want to make another entry with the same settings but replacing 
 
-
-

Mobile app

-
+
+

Mobile app

+

If you're using the Riot mobile app to access your Matrix homeserver then you can significantly improve battery performance by going to the settings and changing Sync request timeout to 30 seconds and Delay between two sync requests to 600 seconds. Also turning off msgs in group chats will help, since it will avoid getting a notification whenever a group chat event happens, which then wakes up the screen.

diff --git a/website/EN/app_mediagoblin.html b/website/EN/app_mediagoblin.html index ab90dc05..824a798b 100644 --- a/website/EN/app_mediagoblin.html +++ b/website/EN/app_mediagoblin.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - - + + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,18 +144,16 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

Mediagoblin

-
+
+

Mediagoblin

+

With Mediagoblin you can host video and audio content in a similar manner to the proprietary systems such as YouTube and SoundCloud. This system supports free media formats such as webm, ogv and ogg. Another similar system which might be better fitted for small servers is PeerTube, since it uses webtorrent to distribute video files. Webtorrent will only work with WebRTC enabled browsers though.

@@ -256,22 +162,25 @@ With Mediagoblin you can host video and audio content in a similar manner to the When hosting media files you should take into consideration that since anyone on the internet can view your content then this could significantly increase your bandwidth usage and overall strain on the server. Also unless you are just hosting images then hardware such as the Beaglebone Black won't be powerful enough for a good user experience when either uploading or playing back videos. It's recommended that you use one of the more powerful quad (or more) core single board computers or an old laptop if you want to run Mediagoblin on it.

-
+

mediagoblin.jpg

+
+
-
-

Installation

-
+
+

Installation

+

Log into your system with:

+
ssh myusername@mydomain -p 2222
 
@@ -291,9 +200,9 @@ After the install has completed go to Security settings and select Cre
-
-

Initial setup

-
+
+

Initial setup

+

If you have just obtained a Lets Encrypt certificate as above then go to About on the administrator control panel and you should see your Mediagoblin domain listed there along with an onion address. You can then navigate to your site in a browser.

@@ -309,14 +218,15 @@ You should repeat that for however many accounts you want on the system and then
-
-

File formats

-
+
+

File formats

+

It's a good idea to upload videos in webm format. In that case Mediagoblin will skip the transcoding step (which can take hours for videos of non-trivial length) and the whole process will be quicker. Transcoding just converts whatever file format you submit into a standard resolution and file type. On your local system you can convert a video to webm with:

+
ffmpeg -i myvideo.mp4 myvideo.webm
 
@@ -326,6 +236,7 @@ Or if you are moving a video from YouTube to your own site:

+
youtube-dl -f webm [my_video_url]
 
diff --git a/website/EN/app_mumble.html b/website/EN/app_mumble.html index 2c3723af..ca8a2579 100644 --- a/website/EN/app_mumble.html +++ b/website/EN/app_mumble.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - - + + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,39 +144,40 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

Mumble

-
+
+

Mumble

+

Mumble is a well known VoIP system originally used for gaming, but which works just as well for any general conference calls or meetings.

+
+
-
-

Text chat

-
+
+

Text chat

+

In addition to voice it is also possible to do text chat via mumble. The security of this is pretty good provided that you do it via Plumble and Orbot on mobile, but compared to other options such as XMPP/Conversations or Tox the security is not as good, since the mumble server currently doesn't support forward secrecy.

-
-

Using with Ubuntu

-
+
+

Using with Ubuntu

+

First ensure that tor is installed. Within a terminal:

+
sudo apt-get install tor
 
@@ -281,13 +190,11 @@ Within the software center search for "mumble" and install the client then run i From the menu select Configure then Settings. Select the Advanced checkbox then select Network. Select Force TCP mode and proxy type Socks5. Hostname should be set to localhost and port should be 9050.

-
-

mumble_config.jpg +

mumble_config.jpg

-

Select Apply and Ok, then on the menu Server and Connect. @@ -299,9 +206,9 @@ Click on "add new" to add a new server and enter the default domain name

-
-

Using with Android

-
+
+

Using with Android

+

Install F-Droid

diff --git a/website/EN/app_nextcloud.html b/website/EN/app_nextcloud.html index e148fcf0..6b9faaa1 100644 --- a/website/EN/app_nextcloud.html +++ b/website/EN/app_nextcloud.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,25 +144,21 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
-
-

NextCloud

-
- -
+
+

NextCloud

+
-

nextcloud.jpg +

nextcloud.jpg

-

NextCloud is a system for file synchronisation and also has many other plugins for calendar, videoconferencing, collaborative document editing and federated file sharing. It's a lot more elaborate than Syncthing, but there may be situations where centralized control of your files on your server is better than a purely peer-to-peer approach (eg. if you need to remove a user's access to files). @@ -263,25 +167,28 @@ NextCloud is a system for file synchronisation and also has many other plugins f

The videoconferencing plugin requires a browser with WebRTC support and so is unlikely to work in a Tor browser, but may still be a better option than using proprietary systems.

+
+
-
-

Operational considerations

-
+
+

Operational considerations

+

If your ISP or the government in your area is part of your threat model then NextCloud may not be the best choice for hosting files and Syncthing could be preferable. In the past the NextCloud company is known to have remotely scanned servers without permission and reported server admins who don't immediately update to the latest version of the software to their ISPs or to questionable government agencies. Depending upon where you are located such activities by the developer, which are not really in the spirit of independent self-hosting, could have very undesirable results.

-
-

Installation

-
+
+

Installation

+

Log into your system with:

-
ssh myusername@mydomain -p 2222
-
+ +
ssh myusername@mydomain -p 2222
+

@@ -294,9 +201,9 @@ Select Add/Remove Apps then nextcloud. You will then be asked for

-
-

Initial setup

-
+
+

Initial setup

+

Go to the Administrator control panel and select Passwords then nextcloud. This will give you the password to initially log in to the system and you can change it later from a client app if needed.

diff --git a/website/EN/app_peertube.html b/website/EN/app_peertube.html index 454b0fae..767ed128 100644 --- a/website/EN/app_peertube.html +++ b/website/EN/app_peertube.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - - + + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,34 +144,32 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
-
-

peertube.jpg +

peertube.jpg

-

This is a video hosting system similar to Mediagoblin but using webtorrent to help distribute the files to or between clients. This should be more practical for situations where a video becomes popular because the load is then spread across the network, with performance increasing with the number of nodes. However, the torrenting aspect of it only works with WebRTC enabled browsers and so this means it's unlikely to fully work with a Tor browser. Without WebRTC then from a user point of view it's effectively the same thing as Mediagoblin.

-
-

Installation

-
+
+

Installation

+

Log into your system with:

+
ssh myusername@mydomain -p 2222
 
@@ -278,9 +184,9 @@ Select Add/Remove Apps then peertube. You will then be asked for a
-
-

Initial setup

-
+
+

Initial setup

+

Navigate to your site and select Signup to create a new account. By default the maximum number of accounts on your system is limited to a small number so that millions of random internet users can't then begin uploading dubious content. After that it's pretty straightforward.

@@ -291,9 +197,9 @@ If you wish it's possible to turn off further signups via the Administrator c
-
-

Importing videos from YouTube/Vimeo/Dailymotion

-
+
+

Importing videos from YouTube/Vimeo/Dailymotion

+

It's possible to import videos from the main proprietary video hosting sites. Only do this if they're videos which you made, or if the license is Creative Commons. Hosting arbitrary videos under nonfree licenses is likely to get you into trouble, and we know how that works out from the P2P wars of the 2000s (i.e. badly).

@@ -304,9 +210,9 @@ Go to the Administrator control panel, select App settings then
-
-

Importing videos from your desktop

-
+
+

Importing videos from your desktop

+

The most convenient way to add new videos to PeerTube is if you have the syncthing app installed. Set up syncthing with a folder called ~/Sync in your home directory. Create a subdirectory called ~/Sync/peertube_upload. Within that directory make a text file called login.txt. This will contain your PeerTube login details.

diff --git a/website/EN/app_pihole.html b/website/EN/app_pihole.html index 65a57a41..6c40c55f 100644 --- a/website/EN/app_pihole.html +++ b/website/EN/app_pihole.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,18 +144,16 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

PI-Hole: The Black Hole for Web Adverts

-
+
+

PI-Hole: The Black Hole for Web Adverts

+

Idiots who have an inflated sense of self-entitlement will tell you that it's your moral duty to view their mind-numbingly tedious corporate ads on their web site or YouTube channel, or else their kids will starve and the sky will fall because their revenue stream will dry up. But that's bullshit. There is nothing intrinsic or morally mandatory about adverts propping up the livelihoods of netizens, and indeed a web not primarily based on advertising money might have been a much better and more interesting place by now, with a lot less spying.

@@ -263,10 +169,12 @@ You can block ads for any devices connected to your local network by installing

Also don't expect perfection. Though many ads may be blocked by this system some will still get through. It's a constant cat and mouse game between advertisers and blockers.

+
+
-
-

Set a static IP address

-
+
+

Set a static IP address

+

Ensure that your system has a static local IP address (typically 192.168..) using the option on the control panel. You will also need to know the IP address of your internet router, which is usually 192.168.1.1 or 192.168.1.254.

@@ -277,17 +185,18 @@ When that's done select About this system from the control panel and see
-
-

On each client system within your local network

-
+
+

On each client system within your local network

+

Make sure that you add the static IP address for the server to /etc/hosts.

-
STATIC_IP=[your server static IP]
-sudo echo "$STATIC_IP [your domain name]" >> /etc/hosts
-
+ +
STATIC_IP=[your server static IP]
+sudo echo "$STATIC_IP [your domain name]" >> /etc/hosts
+

@@ -295,12 +204,13 @@ On Arch/Parabola:

-
sudo pacman -S openresolv
-sudo sed -i "s|#name_servers=.*|name_servers=$STATIC_IP|g" /etc/resolvconf.conf
-sudo sed -i "s|name_servers=.*|name_servers=$STATIC_IP|g" /etc/resolvconf.conf
+
+
sudo pacman -S openresolv
+sudo sed -i "s|#name_servers=.*|name_servers=$STATIC_IP|g" /etc/resolvconf.conf
+sudo sed -i "s|name_servers=.*|name_servers=$STATIC_IP|g" /etc/resolvconf.conf
 sudo chattr -i /etc/resolv.conf
 sudo resolvconf -u
-
+

@@ -308,21 +218,22 @@ Or on a Debian based system:

-
sudo apt-get install resolvconf
-echo 'domain localdomain' > /tmp/resolvconf
-echo 'search localdomain' >> /tmp/resolvconf
-echo "nameserver $STATIC_IP" >> /tmp/resolvconf
+
+
sudo apt-get install resolvconf
+echo 'domain localdomain' > /tmp/resolvconf
+echo 'search localdomain' >> /tmp/resolvconf
+echo "nameserver $STATIC_IP" >> /tmp/resolvconf
 sudo mv /tmp/resolvconf /etc/resolvconf/resolv.conf.d/head
 sudo chattr -i /etc/resolv.conf
 sudo resolvconf -u
-
+
-
-

On your internet router

-
+
+

On your internet router

+

If you can access the settings on your local internet router then this is the simplest way to provide ad blocking for all devices which connect to it. Unfortunately some router models don't let you edit the DNS settings and if that's the case you might want to consider getting a different router.

@@ -332,9 +243,9 @@ Edit the DNS settings and add the IPv4 address which you got from the control pa

-
-

LibreCMC

-
+
+

LibreCMC

+

On a router running LibreCMC from the Network menu select DHCP and DNS. Enter the static IP address of your Freedombone system within DNS Forwardings, then at the bottom of the page click on Save & Apply. Any devices which connect to your router will now have ad blocking.

@@ -342,18 +253,23 @@ On a router running LibreCMC from the Network menu select DHCP and DNS
-
-

Configuring block lists

-
+
+

Configuring block lists

+

You can configure the block lists which the system uses by going to the administrator control panel, selecting App Settings then choosing pihole. You can also add any extra domain names to the whitelist if they're being wrongly blocked or to the blacklist if they're not blocked by the current lists.

-
-Return to the home page -
+
+

+<center> +Return to the <a href="index.html">home page</a> +</center> +

+ +
diff --git a/website/EN/app_pleroma.html b/website/EN/app_pleroma.html index 1a3fa739..632408ae 100644 --- a/website/EN/app_pleroma.html +++ b/website/EN/app_pleroma.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + @@ -236,21 +236,11 @@ for the JavaScript code in this tag.
-
-

logo.png +

logo.png

-
- -
- -
-

pleroma-logo.png -

-
-

@@ -266,17 +256,15 @@ Pleroma is an OStatus and ActivityPub compatible social networking server, compa Some general advice about life in the fediverse can be found here.

-
-

pleroma.jpg +

pleroma.jpg

-
-
-

Installation

-
+
+

Installation

+

Log into your system with:

@@ -296,9 +284,9 @@ Select Add/Remove Apps then pleroma. You will then be asked for a
-
-

Initial setup

-
+
+

Initial setup

+

The first thing you'll need to do is register a new account. You can set your profile details and profile image by selecting the small settings icon to the right of your name.

@@ -309,49 +297,44 @@ Once you have done that then you can disable further registrations from the A
-
-

Mastodon user interface

-
+
+

Mastodon user interface

+

If you prefer a Tweetdeck-style user interface, similar to Mastodon, then once you have registered an account navigate to /yourpleromadomainname/web and log in.

-
-

pleromamastodon.jpg +

pleromamastodon.jpg

-
-
-

Mobile apps

-
+
+

Mobile apps

+

It's also possible to use Mastodon apps together with Pleroma, such as Tusky, since it supports the Mastodon API. You may need to install IcecatMobile and set it as your default browser (under Settings/Apps/Menu) in order for the initial oauth registration process to work.

-
-

tusky.jpg +

tusky.jpg

-
-
-

Blocking controls

-
-
+ +
+

Blocking controls

+
-

control_panel_blocking.jpg +

control_panel_blocking.jpg

-

The biggest hazard with Pleroma is that it's part of a public federated communications system. This means that conversations and replies from other servers may end up in your "whole known network" stream. The internet being what it is, some of these could be undesirable. You can block individual users or entire domains by going to the Administrator control panel and selecting Domain or User Blocking, then adding or removing entries. This blocks domains at the firewall level and also at the level of database and file storage. diff --git a/website/EN/app_postactiv.html b/website/EN/app_postactiv.html index 25a462bf..4286e336 100644 --- a/website/EN/app_postactiv.html +++ b/website/EN/app_postactiv.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,18 +144,16 @@ for the JavaScript code in this tag.

-
+

-

logo.png +

logo.png

-
- -
-

PostActiv

-
+
+

PostActiv

+

PostActiv is a fork of GNU Social which includes some extra fixes and optimisations to improve performance. It federates just like GNU Social does and so whether you choose GNU Social or PostActiv is really just down to personal prefernce.

@@ -256,24 +162,25 @@ PostActiv is a fork of GNU Social which inclu Some general advice about life in the fediverse can be found here.

-
-

postactiv_pleroma.jpg +

postactiv_pleroma.jpg

+
-
-

Installation

-
+
+

Installation

+

Log into your system with:

-
ssh myusername@mydomain -p 2222
-
+ +
ssh myusername@mydomain -p 2222
+

@@ -290,9 +197,9 @@ After the install has completed go to Security settings and select Cre

-
-

Initial setup

-
+
+

Initial setup

+

If you have just obtained a Lets Encrypt certificate as above then go to About on the administrator control panel and you should see your Postactiv domain listed there along with an onion address. You can then navigate to your site in a browser.

@@ -307,54 +214,54 @@ Navigate to your PostActiv domain name and log in.
-
-

Switching user interfaces

-
+
+

Switching user interfaces

+

A few web based user interfaces are available for PostActiv. They are selectable by going to the Administrator control panel and choosing App settings then postactiv.

-
-

postactiv_settings.jpg +

postactiv_settings.jpg

-
    -
  • Qvitter: Looks similar to Twitter during its golden era, before the ads and other antifeatures arrived
  • -
  • Pleroma: A modern and lightweight user interface
  • -
  • Classic: Like the original StatusNet UI. Minimal Javascript and has good support for threaded conversations.
  • +
  • Qvitter: Looks similar to Twitter during its golden era, before the ads and other antifeatures arrived +
  • +
  • Pleroma: A modern and lightweight user interface +
  • +
  • Classic: Like the original StatusNet UI. Minimal Javascript and has good support for threaded conversations. +
-
-

Using with Emacs

-
-
+
+

Using with Emacs

+
-

gnu-social-mode.jpg +

gnu-social-mode.jpg

-

If you are an Emacs user it's also possible to set up GNU Social mode, which is compatible with PostActiv. You can do that as follows:

-
mkdir ~/elisp
+
+
mkdir ~/elisp
 git clone https://github.com/bashrc/gnu-social-mode ~/elisp/gnu-social-mode
-echo "(add-to-list 'load-path \"~/elisp/gnu-social-mode\")" >> ~/.emacs
-echo "(require 'gnu-social-mode)" >> ~/.emacs
-echo "(setq gnu-social-server-textlimit 2000" >> ~/.emacs
-echo "      gnu-social-server \"yourpostactivdomain\"" >> ~/.emacs
-echo "    gnu-social-username \"yourusername\"" >> ~/.emacs
-echo "    gnu-social-password \"postactivpassword\")" >> ~/.emacs
-
+echo "(add-to-list 'load-path \"~/elisp/gnu-social-mode\")" >> ~/.emacs +echo "(require 'gnu-social-mode)" >> ~/.emacs +echo "(setq gnu-social-server-textlimit 2000" >> ~/.emacs +echo " gnu-social-server \"yourpostactivdomain\"" >> ~/.emacs +echo " gnu-social-username \"yourusername\"" >> ~/.emacs +echo " gnu-social-password \"postactivpassword\")" >> ~/.emacs +

@@ -362,8 +269,9 @@ And as a quick reference the main keys are:

-
M-x gnu-social
-
+ +
M-x gnu-social
+

@@ -374,54 +282,54 @@ The basics: - + - + -i -Show icons +i +Show icons -CTRL-c CTRL-s -Post status update +CTRL-c CTRL-s +Post status update -r -Repeat +r +Repeat -F -Favourite +F +Favourite -CTRL-c CTRL-h -Highlight +CTRL-c CTRL-h +Highlight -R -Reply to user +R +Reply to user -CTRL-c CTRL-r -Show replies +CTRL-c CTRL-r +Show replies -CTRL-c CTRL-f -Friends timeline +CTRL-c CTRL-f +Friends timeline -CTRL-c CTRL-v -View user profile +CTRL-c CTRL-v +View user profile @@ -434,19 +342,19 @@ Navigation: - + - + -j -Next +j +Next -k -Previous +k +Previous @@ -459,70 +367,68 @@ Showing timelines: - + - + -g -Current timeline +g +Current timeline -CTRL-c CTRL-a -Public timeline +CTRL-c CTRL-a +Public timeline -CTRL-c CTRL-g -Group timeline +CTRL-c CTRL-g +Group timeline -CTRL-c CTRL-t -Tag timeline +CTRL-c CTRL-t +Tag timeline -CTRL-c CTRL-k -Stop +CTRL-c CTRL-k +Stop -CTRL-c CTRL-u -User timeline +CTRL-c CTRL-u +User timeline -CTRL-c CTRL-c -Conversation timeline +CTRL-c CTRL-c +Conversation timeline -CTRL-c CTRL-o -Remote user timeline +CTRL-c CTRL-o +Remote user timeline -CTRL-c CTRL-d -Post direct Message +CTRL-c CTRL-d +Post direct Message

-
-

Blocking controls

-
-
+
+

Blocking controls

+
-

control_panel_blocking.jpg +

control_panel_blocking.jpg

-

The biggest hazard with PostActiv is that it's part of a public federated communications system. This means that conversations and replies from other servers may end up in your "whole known network" stream. The internet being what it is, some of these could be undesirable. You can block individual users or entire domains by going to the Administrator control panel and selecting Domain or User Blocking, then adding or removing entries. This blocks domains at the firewall level and also at the level of database and file storage. diff --git a/website/EN/app_privatebin.html b/website/EN/app_privatebin.html index 67ec1dfc..436f4ae8 100644 --- a/website/EN/app_privatebin.html +++ b/website/EN/app_privatebin.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - - + + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,18 +144,16 @@ for the JavaScript code in this tag.

-
+

-

logo.png +

logo.png

-
- -
-

PrivateBin

-
+
+

PrivateBin

+

This is an encrypted pastebin, such that the server has zero knowledge of the content. It's intended for small amounts of text less than 32K in length. It's not intended for transfering large files, or for storing pastes for more than a day.

@@ -255,15 +161,18 @@ This is an encrypted pastebin, such that the server has zero knowledge of the co

Because this is completely open to any user on the internet you should be wary of the potential for DDoS, and only install this app if you really need to avoid using other pastebins or if other pastebin sites are censored or untrustable. There are traffic limits set within this app to attempt to minimize the potential for flooding attacks, but that might still not be sufficient in the worst cases.

+
+
-
-

Installation

-
+
+

Installation

+

Log into your system with:

+
ssh myusername@mydomain -p 2222
 
diff --git a/website/EN/app_profanity.html b/website/EN/app_profanity.html index 30faa505..4842c790 100644 --- a/website/EN/app_profanity.html +++ b/website/EN/app_profanity.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,18 +144,16 @@ for the JavaScript code in this tag.
@@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,40 +144,39 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
-
-

Riot Web

-
- -
+
+

Riot Web

+
-

riotweb.jpg +

riotweb.jpg

-

Riot Web is a browser based user interface for the Matrix federated communications system. It allows you to do encrypted one-to-one or group chat, and has some fancy WebRTC features for voice and video conversations. The WebRTC stuff won't work in a Tor browser though. This type of system is fine for general public communications and collaboration on open source projects or gaming groups. For things which require real privacy though stick to XMPP with OMEMO.

+
+
-
-

Installation

-
+
+

Installation

+

Log into your system with:

-
ssh myusername@mydomain -p 2222
-
+ +
ssh myusername@mydomain -p 2222
+

@@ -282,9 +189,9 @@ Select Add/Remove Apps then riot and also make sure that matrix

-
-

Initial setup

-
+
+

Initial setup

+

Go to the Administrator control panel and select Passwords then matrix. This will give you the password to initially log in using the Riot Web user interface. Log in, and that's it. Happy chatting.

diff --git a/website/EN/app_rss.html b/website/EN/app_rss.html index 78872b04..fe169a99 100644 --- a/website/EN/app_rss.html +++ b/website/EN/app_rss.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - + + + + - + @@ -235,38 +144,37 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

RSS Reader

-
+
+

RSS Reader

+

The way that RSS reading is set up on Freedombone gives you strong reading privacy. Not only is there onion routing between you and the server but also between the server and the source of the RSS feed. The only down side is that many RSS feeds are still http only, and so could be vulnerable to injection attacks, but it's expected that more of this will go to https in the foreseeable future due to a combination of growing recognition of security issues and systems like Let's Encrypt which make obtaining certificates much easier.

-
-

rss_reader_mobile.jpg +

rss_reader_mobile.jpg

+
-
-
-

With Emacs

-
+
+

With Emacs

+

If you are an Emacs user then you can also read your RSS feeds via the Avandu mode.

@@ -311,6 +219,7 @@ Add the following to your configuration, changing the address and password as ap

+
(setq avandu-tt-rss-api-url "http://rss_reader_onion_address/api/"
       avandu-user "admin"
       avandu-password "mypassword")
@@ -322,6 +231,7 @@ If you don't already have Emacs set up to route through Tor then also add the fo
 

+
(setq socks-noproxy '("localhost"))
 (require 'socks)
 (require 'tls)
@@ -334,6 +244,7 @@ And ensure that the Tor daemon is installed. On a debian based system:
 

+
sudo apt-get install tor
 
@@ -343,6 +254,7 @@ or on Arch/Parabola:

+
sudo pacman -S tor
 sudo systemctl enable tor
 sudo systemctl start tor
diff --git a/website/EN/app_searx.html b/website/EN/app_searx.html
index 7b400650..e47c07eb 100644
--- a/website/EN/app_searx.html
+++ b/website/EN/app_searx.html
@@ -3,33 +3,26 @@
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
 
 
-
-
-
-
-
-
-
+
+
+
+
+
-
+
 
 
@@ -189,7 +97,7 @@
 @licstart  The following is the entire license notice for the
 JavaScript code in this tag.
 
-Copyright (C) 2012-2017 Free Software Foundation, Inc.
+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
@@ -236,18 +144,16 @@ for the JavaScript code in this tag.
 
 
-
+

-

logo.png +

logo.png

-
- -
-

SearX

-
+
+

SearX

+

SearX is a metasearch engine. That means it returns results from other selected search engines. It's accessible via an onion address and provides a private search ability. Really the only advantage it gives you over searching directly from a Tor browser is the ability to customise your search experience.

@@ -257,22 +163,22 @@ In terms of security both the connection between you and the server, and the out

-
-
-

searx.jpg +

searx.jpg

+
-
-

Installation

-
+
+

Installation

+

ssh into the system with:

+
ssh myusername@mydomain.com -p 2222
 
@@ -287,18 +193,18 @@ Once it has installed go to About on the Administrator control panel
-
-

Make it your default search

-
+
+

Make it your default search

+

In a Tor browser click on the magnifying glass icon next to the search box and you can then add your metasearch site. A small icon will appear called "Freedombone Metasearch" and you can then right click on it and make it the default search.

-
-

Enabling password login

-
+
+

Enabling password login

+

It's possible that you might not want just anyone on the interwebs to be able to use your metasearch engine. Even with the onion routing this might carry some legal risk or make you a target for denial-of-service attempts (although Tor's rate limits and the firewall will give you some defense against that).

@@ -309,9 +215,9 @@ To enable password login go to the Administrator control panel then Ap
-
-

Customization

-
+
+

Customization

+

It's also possible to customise the background image if you go to App settings then select searx.

diff --git a/website/EN/app_syncthing.html b/website/EN/app_syncthing.html index 5709c808..5d477593 100644 --- a/website/EN/app_syncthing.html +++ b/website/EN/app_syncthing.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - + + + + - + @@ -235,18 +144,16 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

Syncthing

-
+
+

Syncthing

+

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, "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.

@@ -254,17 +161,20 @@ Syncthing provides a similar capability to proprietary systems such as Dropbox,

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.

+
+
-
-

On a laptop

-
+
+

On a laptop

+

Install syncthing on a Debian based distro:

+
curl -s https://syncthing.net/release-key.txt | sudo apt-key add -
-echo "deb http://apt.syncthing.net/ syncthing release" | sudo tee /etc/apt/sources.list.d/syncthing.list
+echo "deb http://apt.syncthing.net/ syncthing release" | sudo tee /etc/apt/sources.list.d/syncthing.list
 sudo apt-get update
 sudo apt-get install syncthing
 
@@ -275,6 +185,7 @@ Or on Arch/Parabola:

+
sudo pacman -S syncthing
 
@@ -288,6 +199,7 @@ In another terminal log into Freedombone:

+
ssh username@domainname -p 2222
 
@@ -296,13 +208,11 @@ In another terminal log into Freedombone: Then select File Synchronization.

-
-

control_panel_file_sync.jpg +

control_panel_file_sync.jpg

-

Select Show device ID 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. @@ -312,13 +222,11 @@ Select Show device ID and copy the long string of letters and numbers sho Open a non-Tor browser and enter http://127.0.0.1:8384 as the URL. You should now see the minimalistic user interface. Under Remote Devices select Add Remote Device. In the Device ID field paste the string you just copied (CTRL+v). The Device name can be anything. Under Share Folders with Device check default (or whatever folder you created on your local machine), then save.

-
-

syncthing_browser.jpg +

syncthing_browser.jpg

-

From the top menu select Actions and then Show ID, then copy the ID string (usually select then CTRL+c). Go back to the terminal control panel menu and select Add an ID 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. @@ -330,9 +238,9 @@ Now wait for a few minutes. Eventually you will see two messages appear within t

-
-

On Android

-
+
+

On Android

+

Install Syncthing and Connectbot from F-droid.

diff --git a/website/EN/app_tahoelafs.html b/website/EN/app_tahoelafs.html index 905d246b..fe675aba 100644 --- a/website/EN/app_tahoelafs.html +++ b/website/EN/app_tahoelafs.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,32 +144,33 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

Tahoe-LAFS

-
+
+

Tahoe-LAFS

+

This is a robust system for encrypted file storage on one or more servers. Files are accessed via a URL which contains the public key with which it was encrypted.

+
+
-
-

Installation

-
+
+

Installation

+

Log into your system with:

-
ssh myusername@mydomain -p 2222
-
+ +
ssh myusername@mydomain -p 2222
+

@@ -274,9 +183,9 @@ Select Add/Remove Apps then tahoelafs. This system is entirely bas

-
-

Initial setup

-
+
+

Initial setup

+

Get the login password for your Tahoe-LAFS system by going to Passwords on the Administrator control panel and selecting tahoelafs.

@@ -287,20 +196,18 @@ Go to the About screen on the Administrator control panel and look
-
-

Adding more servers

-
+
+

Adding more servers

+

You can add more servers to the system to increase its storage capacity. In a typical Tahoe-LAFS new data storage servers are automatically discovered via an introducer node, but that creates a single centralised point of failure. The installation on Freedombone has no introducer node and so details for the servers of your friends need to be entered manually.

-
-

control_panel_tahoelafs.jpg +

control_panel_tahoelafs.jpg

-

Other servers will typically be Freedombone systems with Tahoe-LAFS installed. Your Tahoe-LAFS server settings can be found on the About screen of the Administrator control panel. Use an end-to-end encrypted chat app to copy and paste those details and send them to other friends. To add the server details go to App settings on the Administrator control panel then select tahoelafs and Add server. diff --git a/website/EN/app_tox.html b/website/EN/app_tox.html index 2895b7dc..91e9b77b 100644 --- a/website/EN/app_tox.html +++ b/website/EN/app_tox.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - + + + + - + @@ -235,30 +144,31 @@ for the JavaScript code in this tag.

-
+

-

logo.png +

logo.png

-
- -
-

Tox

-
+
+

Tox

+

Tox is an encrypted peer-to-peer messaging system and so should work without Freedombone. It uses a system of nodes which act as a sort of directory service allowing users to find and connect to each other. The Tox node ID on the Freedombone can be found within App Settings under tox within the Administrator control panel. If you have other users connect to your node then you will be able to continue chatting even when no other nodes are available.

+
+
-
-

The Toxic client

-
+
+

The Toxic client

+

Log into your system with:

+
ssh myusername@mydomain -p 2222
 
@@ -267,16 +177,14 @@ Log into your system with: Then from the menu select Run an app followed by tox. Tox is encrypted by default and also routed through Tor, so it should be reasonably secure both in terms of message content and metadata.

-
-

toxic.jpg +

toxic.jpg

-
@@ -235,18 +144,16 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

Turtl

-
+
+

Turtl

+

"Now is a very important time in history. Every aspect of our lives is moving into the digital world faster than we realize. We use apps like Dropbox or Evernote because of their convenience, but in doing so we sacrifice our privacy. What data isn't sold to advertisers or stolen by hackers is carved up by government surveillance." @@ -262,22 +169,22 @@ Since the data at rest is stored in PGP encrypted format this is a good system t

-
-
-

turtl.jpg +

turtl.jpg

+
-
-

Installation

-
+
+

Installation

+

Log into your system with:

+
ssh myusername@mydomain -p 2222
 
@@ -296,9 +203,9 @@ After the install has completed go to Security settings and select Cre
-
-

Initial setup

-
+
+

Initial setup

+

The most common use case will be with Android devices. The Android app isn't currently available within F-droid (see the FAQ for details) but can be downloaded from the Turtl site.

@@ -313,10 +220,9 @@ You should then be able to log in and start using the app. You might also want t
- -
-

Locking it down

-
+
+

Locking it down

+

Once you have created accounts it's a good idea to turn off new turtl signups. This will prevent millions of random users on the interwebs from creating accounts on your system and killing your server, or possibly other nefarious security scenarios. Go to the administrator control panel and select App Settings then turtl. You will then be able to disable new user registrations and also set the data storage limit for users. If you need additional users later you can always temporarily re-enable signups.

diff --git a/website/EN/app_vpn.html b/website/EN/app_vpn.html index 964c4599..f0f8f43e 100644 --- a/website/EN/app_vpn.html +++ b/website/EN/app_vpn.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - - + + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,18 +144,16 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

OpenVPN

-
+
+

OpenVPN

+

"The Net interprets censorship as damage and routes around it." – John Gilmore @@ -265,15 +171,18 @@ Using a Tor browser is another way to get around censorship, but there might be

On Freedombone the VPN is wrapped within a TLS layer of encryption, making it difficult for any deep packet inspection systems to know whether you are using a VPN or not. Since there is lots of TLS traffic on the internet your connection looks like any other TLS connection to a server, and this may help to avoid being censored. It's probably not possible for your local ISP to block TLS traffic without immediately generating a lot of irate customers, and stopping any kind of commercial activity.

+
+
-
-

Installation

-
+
+

Installation

+

ssh into the system with:

+
ssh myusername@mydomainname -p 2222
 
@@ -288,14 +197,15 @@ Only use ports 443 or 80 for VPN as an absolute last resort, since doing
-
-

Usage

-
+
+

Usage

+

When the installation is complete you can download your VPN keys and configuration files onto your local machine.

+
scp -P 2222 myusername@mydomainname:/home/myusername/client.ovpn .
 scp -P 2222 myusername@mydomainname:/home/myusername/stunnel* .
 
@@ -306,6 +216,7 @@ You will need to ensure that the openvpn and stunnel packages are

+
sudo pacman -S openvpn stunnel4
 
@@ -315,6 +226,7 @@ Or on a Debian based system:

+
sudo apt-get install openvpn stunnel4
 
@@ -324,6 +236,7 @@ Now you can connect to your VPN with:

+
sudo stunnel stunnel-client.conf
 sudo openvpn client.ovpn
 
@@ -335,29 +248,30 @@ You should see a series of messages with "Initialization Sequence Completed
-
-

Changing port number

-
+
+

Changing port number

+

Avoiding censorship can be a cat and mouse game, and so if the port you're using for VPN gets blocked then you may want to change it.

+
ssh myusername@mydomainname -p 2222
 

-Select Administrator controls then App Settings then vpn. Choose Change TLS port and enter a new port value. You can then either manually change the port within your VPN configuration files, or download them again as described in the Usage section above. +Select Administrator controls then App Settings then vpn. Choose Change TLS port and enter a new port value. You can then either manually change the port within your VPN configuration files, or download them again as described in the Usage section above.

-
-

Generating new keys

-
+
+

Generating new keys

+

-It's possible that your VPN keys might get lost or compromised on your local machine. If that happens you can generate new ones from the Administrator controls by going to App Settings then vpn then choosing Regenerate keys for a user and downloading the new keys as described in the Usage section above. +It's possible that your VPN keys might get lost or compromised on your local machine. If that happens you can generate new ones from the Administrator controls by going to App Settings then vpn then choosing Regenerate keys for a user and downloading the new keys as described in the Usage section above.

diff --git a/website/EN/app_xmpp.html b/website/EN/app_xmpp.html index 25aa7682..4f5a5c6f 100644 --- a/website/EN/app_xmpp.html +++ b/website/EN/app_xmpp.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - - + + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,18 +144,16 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

XMPP/Jabber

-
+
+

XMPP/Jabber

+

Most people know XMPP as "Jabber" and it's sometimes regarded and an old protocol once used by Google and Facebook but which is no longer relevant. However, it still works and if appropriately configured, as it is on Freedombone, can provide the best chat messaging security currently available.

@@ -259,31 +165,34 @@ With regard to chat apps you might have read a lot of stuff about end-to-end

A well written article on the state of XMPP and how it compares to other chat protocols can be found here.

+
+
-
-

Using with Profanity

-
+
+

Using with Profanity

+

You can install the profanity app via Add/remove apps on the Administrator control panel. Logging in and then selecting Run App and profanity will start it.

-
-

Using with Gajim

-
+
+

Using with Gajim

+

In mid 2016 Gajim became the first desktop XMPP client to support the OMEMO end-to-end security standard, which is superior to the more traditional OTR since it also includes multi-user chat and the ratcheting mechanism pioneered by Open Whisper Systems. To install it:

-
su -c 'echo "deb ftp://ftp.gajim.org/debian unstable main" > /etc/apt/sources.list.d/gajim.list'
+
+
su -c 'echo "deb ftp://ftp.gajim.org/debian unstable main" > /etc/apt/sources.list.d/gajim.list'
 sudo apt-get update
 sudo apt-get -y install gajim-dev-keyring
 sudo apt-get -y install git tor python-dev python-pip gajim-nightly
 mkdir ~/.local/share/gajim/plugins -p
-cd ~/.local/share/gajim/plugins
+cd ~/.local/share/gajim/plugins
 git clone https://github.com/omemo/gajim-omemo
-sudo pip install protobuf==2.6.1, python-axolotl==0.1.35
+sudo pip install protobuf==2.6.1, python-axolotl==0.1.35
 
@@ -308,6 +217,7 @@ If you wish to make backups of the OMEMO keys then they can be found within:

+
~/.local/share/gajim
 
@@ -318,9 +228,9 @@ If you wish to use OpenPGP to encrypt your messages then go to Edit/Accounts<
-
-

Using with Jitsi

-
+
+

Using with Jitsi

+

Jitsi can be downloaded from https://jitsi.org

@@ -347,9 +257,9 @@ You can also see this vide
-
-

Using with Ubuntu

-
+
+

Using with Ubuntu

+

The default XMPP client in Ubuntu is Empathy. Using Empathy isn't as secure as using Jitsi, since it doesn't include the off the record feature, but since it's the default it's what many users will have easy access to.

@@ -368,18 +278,18 @@ Click on Advanced and make sure that Encryption required and Ig
-
-

Using Tor Messenger

-
+ -
-

Using with Android/Conversations

-
+
+

Using with Android/Conversations

+

Install F-Droid

@@ -401,6 +311,7 @@ From the menu select Manage accounts and add a new account.

+
Jabber ID: myusername@mydomain
 Password:  your XMPP password
 Hostname:  mydomain (preferably your xmpp onion address)
diff --git a/website/EN/apps.html b/website/EN/apps.html
index 37b3f77a..ee24ddd0 100644
--- a/website/EN/apps.html
+++ b/website/EN/apps.html
@@ -3,33 +3,26 @@
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
 
 
-
-
-
-
-
-
-
+
+
+
+
+
-
+
 
 
@@ -189,7 +97,7 @@
 @licstart  The following is the entire license notice for the
 JavaScript code in this tag.
 
-Copyright (C) 2012-2017 Free Software Foundation, Inc.
+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
@@ -236,13 +144,12 @@ for the JavaScript code in this tag.
 
 
-
+

-

logo.png +

logo.png

-

@@ -254,18 +161,15 @@ for the JavaScript code in this tag. The base install of the system just contains an email server and Mutt client, but not much else. In addition from within the Administrator control panel under Add/remove apps the following are installable. This list only applies on the home server version, with the mesh network version having a different and smaller set of apps.

-
-

control_panel_apps.jpg +

control_panel_apps.jpg

-
- -
-

Akaunting

-
+
+

Akaunting

+

A web based accounts system for small businesses or freelancers.

@@ -275,9 +179,9 @@ A web based accounts system for small businesses or freelancers.

-
-

BDS Mail

-
+
+

BDS Mail

+

It's like ordinary email, but with i2p as the transport mechanism.

@@ -287,9 +191,9 @@ It's like ordinary email, but with i

-
-

Bludit

-
+
+

Bludit

+

This is a simple databaseless blogging system which uses markdown files. It should run well on any hardware.

@@ -299,9 +203,9 @@ This is a simple databaseless blogging system which uses markdown files. It shou

-
-

CryptPad

-
+
+

CryptPad

+

Collaborate on editing documents, presentations and source code, or vote on things. All with a good level of security.

@@ -311,9 +215,9 @@ Collaborate on editing documents, presentations and source code, or vote on thin

-
-

DLNA

-
+
+

DLNA

+

Enables you to use the system as a music server which any DLNA compatible devices can connect to within your home network.

@@ -323,9 +227,9 @@ Enables you to use the system as a music server which any DLNA compatible device

-
-

Dokuwiki

-
+
+

Dokuwiki

+

A databaseless wiki system.

@@ -335,9 +239,9 @@ A databaseless wiki system.

-
-

Edith

-
+
+

Edith

+

Extremely simple and distraction-free notes system.

@@ -347,9 +251,9 @@ Extremely simple and distraction-free notes system.

-
-

Emacs

-
+
+

Emacs

+

If you use the Mutt client to read your email then this will set it up to use emacs for composing new mail.

@@ -359,17 +263,17 @@ If you use the Mutt client to read your email then this will set it up to use em

-
-

Email Server

-
+
+

Email Server

+

Since many apps require email registration an email server is installed by default. You can find advice on using the email system here.

-
-

Etherpad

-
+
+

Etherpad

+

Collaborate on creating documents in real time. Maybe you're planning a holiday with other family members or creating documentation for a Free Software project along with other volunteers. Etherpad is hard to beat for simplicity and speed. Only users of the system will be able to access it.

@@ -379,9 +283,9 @@ Collaborate on creating documents in real time. Maybe you're planning a holiday

-
-

Federated wiki

-
+
+

Federated wiki

+

A new approach to creating wiki content.

@@ -391,9 +295,9 @@ A new approach to creating wiki content.

-
-

Friendica

-
+
+

Friendica

+

Federated social network system.

@@ -403,9 +307,9 @@ Federated social network system.

-
-

GNU Social

-
+
+

GNU Social

+

Federated social network based on the OStatus protocol. You can "remote follow" other users within the GNU Social federation.

@@ -415,9 +319,9 @@ Federated social network based on the OStatus protocol. You can "remote follo

-
-

Gogs

-
+
+

Gogs

+

Lightweight git project hosting system. You can mirror projects from Github, or if Github turns evil then just host your own projects while retaining the familiar fork-and-pull workflow. If you can use Github then you can also use Gogs.

@@ -427,9 +331,9 @@ Lightweight git project hosting system. You can mirror projects from Github, or

-
-

HTMLy

-
+
+

HTMLy

+

Databaseless blogging system. Quite simple and with a markdown-like format.

@@ -439,9 +343,9 @@ Databaseless blogging system. Quite simple and with a markdown-like format.

-
-

Hubzilla

-
+
+

Hubzilla

+

Web publishing platform with social network like features and good privacy controls so that it's possible to specify who can see which content. Includes photo albums, calendar, wiki and file storage.

@@ -451,9 +355,9 @@ Web publishing platform with social network like features and good privacy contr

-
-

Icecast media stream

-
+
+

Icecast media stream

+

Make your own internet radio station.

@@ -463,9 +367,9 @@ Make your own internet radio station.

-
-

IRC Server (ngirc)

-
+
+

IRC Server (ngirc)

+

Run your own IRC chat channel which can be secured with a password and accessible via an onion address. A bouncer is included so that you can receive messages sent while you were offline. Works with Hexchat and other popular clients.

@@ -475,18 +379,18 @@ Run your own IRC chat channel which can be secured with a password and accessibl

-
-

Jitsi Meet

-
+
+

Jitsi Meet

+

Experimental WebRTC video conferencing system, similar to Google Hangouts. This may not be fully functional, but is hoped to be in the near future.

-
-

KanBoard

-
+
+

KanBoard

+

A simple kanban system for managing projects or TODO lists.

@@ -496,9 +400,9 @@ A simple kanban system for managing projects or TODO lists.

-
-

Key Server

-
+
+

Key Server

+

An OpenPGP key server for storing and retrieving GPG public keys.

@@ -508,9 +412,9 @@ An OpenPGP key server for storing and retrieving GPG public keys.

-
-

Koel

-
+
+

Koel

+

Access your music collection from any internet connected device.

@@ -520,9 +424,9 @@ Access your music collection from any internet connected device.

-
-

Lychee

-
+
+

Lychee

+

Make your photo albums available on the web.

@@ -532,9 +436,9 @@ Make your photo albums available on the web.

-
-

Mailpile

-
+
+

Mailpile

+

Modern email client which supports GPG encryption.

@@ -544,9 +448,9 @@ Modern email client which supports GPG encryption.

-
-

Matrix

-
+
+

Matrix

+

Multi-user chat with some security and moderation controls.

@@ -556,9 +460,9 @@ Multi-user chat with some security and moderation controls.

-
-

Mediagoblin

-
+
+

Mediagoblin

+

Publicly host video and audio files so that you don't need to use YouTube/Vimeo/etc.

@@ -568,9 +472,9 @@ Publicly host video and audio files so that you don't need to use YouTube/Vimeo/

-
-

Mumble

-
+
+

Mumble

+

The popular VoIP and text chat system. Say goodbye to old-fashioned telephony conferences with silly dial codes. Also works well on mobile.

@@ -580,9 +484,9 @@ The popular VoIP and text chat system. Say goodbye to old-fashioned telephony co

-
-

NextCloud

-
+
+

NextCloud

+

Store files on your server and sync them with laptops or mobile devices. Includes many plugins including videoconferencing and collaborative document editing.

@@ -592,9 +496,9 @@ Store files on your server and sync them with laptops or mobile devices. Include

-
-

PeerTube

-
+
+

PeerTube

+

Peer-to-peer video hosting. Similar to Mediagoblin, but the P2P aspect better enables the streaming load to be shared across servers.

@@ -604,9 +508,9 @@ Peer-to-peer video hosting. Similar to Mediagoblin, but the P2P aspect better en

-
-

PI-Hole

-
+
+

PI-Hole

+

The black hole for web adverts. Block adverts at the domain name level within your local network. It can significantly reduce bandwidth, speed up page load times and protect your systems from being tracked by spyware.

@@ -616,9 +520,9 @@ The black hole for web adverts. Block adverts at the domain name level within yo

-
-

Pleroma

-
+
+

Pleroma

+

Fediverse instance which is compatible with GNU Social and Mastodon, and suited for systems without much RAM or CPU resource.

@@ -628,9 +532,9 @@ Fediverse instance which is compatible with GNU Social and Mastodon, and suited

-
-

PostActiv

-
+
+

PostActiv

+

An alternative federated social networking system compatible with GNU Social, Pleroma and Mastodon. It includes some optimisations and fixes currently not available within the main GNU Social project.

@@ -640,9 +544,9 @@ An alternative federated social networking system compatible with GNU Social, Pl

-
-

PrivateBin

-
+
+

PrivateBin

+

A pastebin where the server has zero knowledge of the content being pasted.

@@ -652,9 +556,9 @@ A pastebin where the server has zero knowledge of the content being pasted.

-
-

Profanity

-
+
+

Profanity

+

A shell based XMPP client which you can run on the Freedombone server via ssh.

@@ -664,9 +568,9 @@ A shell based XMPP client which you can run on the Freedombone server via ssh.

-
-

Riot Web

-
+
+

Riot Web

+

A browser based user interface for the Matrix federated communications system, including WebRTC audio and video chat.

@@ -676,9 +580,9 @@ A browser based user interface for the Matrix federated communications system, i

-
-

SearX

-
+
+

SearX

+

A metasearch engine for customised and private web searches.

@@ -688,9 +592,9 @@ A metasearch engine for customised and private web searches.

-
-

tt-rss

-
+
+

tt-rss

+

Private RSS reader. Pulls in RSS/Atom feeds via Tor and is only accessible via an onion address. Have "the right to read" without the Surveillance State knowing what you're reading. Also available with a user interface suitable for viewing on mobile devices via a browser such as OrFox.

@@ -700,9 +604,9 @@ Private RSS reader. Pulls in RSS/Atom feeds via Tor and is only accessible via a

-
-

Syncthing

-
+
+

Syncthing

+

Possibly the best way to synchronise files across all of your devices. Once it has been set up it "just works" with no user intervention needed.

@@ -712,9 +616,9 @@ Possibly the best way to synchronise files across all of your devices. Once it h

-
-

Tahoe-LAFS

-
+
+

Tahoe-LAFS

+

Robust and encrypted storage of files on one or more server.

@@ -724,9 +628,9 @@ Robust and encrypted storage of files on one or more server.

-
-

Tox

-
+
+

Tox

+

Client and bootstrap node for the Tox chat/VoIP system.

@@ -736,9 +640,9 @@ Client and bootstrap node for the Tox chat/VoIP system.

-
-

Turtl

-
+
+

Turtl

+

A system for privately creating and sharing notes and images, similar to Evernote but without the spying.

@@ -748,18 +652,18 @@ A system for privately creating and sharing notes and images, similar to Evernot

-
-

Vim

-
+
+

Vim

+

If you use the Mutt client to read your email then this will set it up to use vim for composing new mail.

-
-

Virtual Private Network (VPN)

-
+
+

Virtual Private Network (VPN)

+

Set up a VPN on your server so that you can bypass local internet censorship.

@@ -769,9 +673,9 @@ Set up a VPN on your server so that you can bypass local internet censorship.

-
-

XMPP

-
+
+

XMPP

+

Chat server which can be used together with client such as Gajim or Conversations to provide end-to-end content security and also onion routed metadata security. Includes advanced features such as client state notification to save battery power on your mobile devices, support for seamless roaming between networks and message carbons so that you can receive the same messages while being simultaneously logged in to your account on more than one device.

@@ -779,6 +683,13 @@ Chat server which can be used together with client such as Gajim or Conversation

How to use it

+ + + +
+

gfdl.png +

+
diff --git a/website/EN/armbian.html b/website/EN/armbian.html index 729c26a6..0fdaa34e 100644 --- a/website/EN/armbian.html +++ b/website/EN/armbian.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - - + + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,17 +144,21 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

+ + +
+

+<center><h1>Installing on Armbian</h1></center> +

+
- -

Installing on Armbian

-

"we are the music makers, we are the dreamers of dreams. cyberpunks and pirates. chaotic spectres haunting cyberspace. engineers, artists, hackers." @@ -262,7 +174,8 @@ Download the Armbian image for your board. It must be version 9 (Stretch), other

-
sudo dd bs=1M if=[Armbian .img file] of=/dev/sdX conv=fdatasync
+
+
sudo dd bs=1M if=[Armbian .img file] of=/dev/sdX conv=fdatasync
 
@@ -287,6 +200,7 @@ Once you know the local IP address of your ARM board then you can log into it wi

+
ssh root@[local IP address]
 
@@ -295,19 +209,18 @@ Once you know the local IP address of your ARM board then you can log into it wi Using the default Armbian password of 1234. You should see the Armbian welcome message and will be asked to change the password, then create a new user account.

-
-

armbian_setup.jpg +

armbian_setup.jpg

-

When the user account is created type exit to leave the ssh session then log back in with your new user account.

+
ssh myusername@[local IP address]
 
@@ -317,6 +230,7 @@ Become the root user:

+
sudo su
 
@@ -326,9 +240,10 @@ Then clone the Freedombone repository and checkout the stretch development branc

+
apt-get -y install git dialog build-essential
 git clone https://github.com/bashrc/freedombone
-cd freedombone
+cd freedombone
 git checkout stretch
 
@@ -338,6 +253,7 @@ Install the Freedombone commands:

+
make install
 
@@ -347,6 +263,7 @@ And now you can begin installing the Freedombone system. There are two ways of d

+
freedombone menuconfig
 
@@ -356,6 +273,7 @@ Alternatively, if you don't own a domain name, don't have administrator access t

+
freedombone menuconfig-onion
 
@@ -365,6 +283,7 @@ You will then be taken through a few questions and the system will install. Afte

+
ssh myusername@freedombone.local -p 2222
 
diff --git a/website/EN/backups.html b/website/EN/backups.html index 7ca0b0cf..55e937f7 100644 --- a/website/EN/backups.html +++ b/website/EN/backups.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - - + + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,57 +144,58 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
-
-

Backups

-
- -
+ -
-

Backup keys

-
+
+

Backup keys

+

As part of the Freedombone installation the GPG key used to encrypt backups will have been added to the .gnupg keyring in your home directory. Ensure that you have a copy of all your keys by plugging in a LUKS encrypted USB drive and then running the commands:

+
ssh username@domainname -p 2222
 
@@ -304,9 +213,9 @@ A pro-tip for the best possible security is to create multiple USB drives contai

-
-

Backup to USB

-
+
+

Backup to USB

+

First and foremost - encrypt your USB drives! Even if you think you have "nothing to hide" if you accidentally lose a USB thumb drive (it's easy to lose small objects) and it's not encrypted then potentially someone might be able to obtain enough information about you to commit identity fraud, take out loans, open bank accounts, etc. Use LUKS encryption. In Ubuntu you can do this using the Disk Utility application. Some instructions can be found here.

@@ -320,6 +229,7 @@ Log into the system and become the root user, then run the backup command

+
ssh username@domainname -p 2222
 
@@ -337,14 +247,15 @@ When the backup ends remove the USB drive and keep it somewhere safe. Even if it

-
-

Restore from USB

-
+
+

Restore from USB

+

Log into the system and become the root user:

+
ssh username@domainname -p 2222
 
@@ -362,9 +273,9 @@ Enter the LUKS password for the USB drive. When the restore is complete you can

-
-

Distributed/remote backups

-
+
+

Distributed/remote backups

+

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.

@@ -374,6 +285,7 @@ Firstly you will need to have a user account on one or more of your friends serv

+
ssh username@domainname -p 2222
 
@@ -387,13 +299,12 @@ You can then enter the usernames, domains and ssh logins for one or more remote

-
-

Restore from a friend

-
-
-
-

With a completely new Freedombone installation

-
+
+

Restore from a friend

+
+
+

With a completely new Freedombone installation

+

This is the ultimate disaster recovery scenario in which you are beginning completely from scratch with new hardware and a new Freedombone installation (configured with the same username and domain names). It is assumed that the old hardware was destroyed, but that you have the backup key stored on a USB thumb drive.

@@ -403,6 +314,7 @@ First log in and if you don't already have one then create a new friends list:

+
ssh username@domainname -p 2222
 
@@ -420,9 +332,9 @@ Finally select Restore from remote backup and enter the domain name of th

-
-

On an existing Freedombone installation

-
+
+

On an existing Freedombone installation

+

This is for more common situations in which maybe some data became corrupted and you want to restore it.

@@ -432,6 +344,7 @@ Log in as root:

+
ssh username@domainname -p 2222
 
@@ -440,9 +353,14 @@ Log in as root: Select Administrator controls then Backup and Restore then Restore from remote backup and enter the domain name of the remote server that you wish to restore from.

-
-Return to the home page -
+
+

+<center> +Return to the <a href="index.html">home page</a> +</center> +

+ +
diff --git a/website/EN/beaglebone.html b/website/EN/beaglebone.html index dddba8f8..f3822cd9 100644 --- a/website/EN/beaglebone.html +++ b/website/EN/beaglebone.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - - + + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,18 +144,16 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

Installing Freedombone on a Beaglebone Black

-
+
+

Installing Freedombone on a Beaglebone Black

+

The Beaglebone Black is small, cheap, a fully open hardware design, has a hardware random number generator and consumes very little electrical power, making it suitable for all kinds of uses. There is also a wireless version.

@@ -256,25 +162,29 @@ The Beaglebone Black is small, cheap, a fully open hardware design, has a hardwa You can easily use one to run your own internet services from home.

-
-

bbb_board.jpg +

bbb_board.jpg

-

You will need:

    -
  • A Beaglebone Black. The exact revision of the hardware isn't very important, but it should have an ethernet socket.
  • -
  • Optionally a plastic or metal case to protect the electronics.
  • -
  • An ethernet cable. Typically these are colour coded either blue or yellow. Either colour will do. If you're using the Wireless version of the Beaglebone Black then you don't need this.
  • -
  • Either a 5v power supply with 5.5mm barrel plug, or a miniUSB type B cable (typically supplied with the Beaglebone) and USB to mains adaptor.
  • -
  • A microSD card at least 8 gigabytes in size. In tests Sandisk class 10 works well. Prefer smaller but faster I/O rating to larger but slower.
  • -
  • A microSD card adaptor for your laptop or desktop system, so that you can copy the disk image to the card.
  • +
  • A Beaglebone Black. The exact revision of the hardware isn't very important, but it should have an ethernet socket. +
  • +
  • Optionally a plastic or metal case to protect the electronics. +
  • +
  • An ethernet cable. Typically these are colour coded either blue or yellow. Either colour will do. If you're using the Wireless version of the Beaglebone Black then you don't need this. +
  • +
  • Either a 5v power supply with 5.5mm barrel plug, or a miniUSB type B cable (typically supplied with the Beaglebone) and USB to mains adaptor. +
  • +
  • A microSD card at least 8 gigabytes in size. In tests Sandisk class 10 works well. Prefer smaller but faster I/O rating to larger but slower. +
  • +
  • A microSD card adaptor for your laptop or desktop system, so that you can copy the disk image to the card. +

@@ -286,9 +196,10 @@ On your laptop or desktop prepare a microSD card image as follows. To create an

+
sudo apt-get install git dialog build-essential
 git clone https://github.com/bashrc/freedombone
-cd freedombone
+cd freedombone
 git checkout stretch
 sudo make install
 freedombone-image --setup debian
@@ -300,22 +211,21 @@ Or on Arch/Parabola:
 

+
sudo pacman -S git dialog
 git clone https://github.com/bashrc/freedombone
-cd freedombone
+cd freedombone
 git checkout stretch
 sudo make install
 freedombone-image --setup parabola
 
-
-

microsd_reader.jpg +

microsd_reader.jpg

-

If you own a domain name and have it linked to a dynamic DNS account (eg. freeDNS) and want to make a system accessible via an ordinary browser then run: @@ -337,25 +247,21 @@ freedombone-image -t beaglebone --onion-addresses-only yes Onion addresses have the advantage of being difficult to censor and you don't need to buy a domain or have a dynamic DNS account. An onion based system also means you don't need to think about NAT traversal type issues. This does not mean that everything gets routed through Tor, it just means that the sites for apps which you install will be available through Tor's address system.

-
-

bbb_back.jpg +

bbb_back.jpg

-

Now follow the instructions given here to copy the image to the microSD drive beginning with running the freedombone-client command. Wherever it says "USB drive" substitute "microSD drive". When the microSD drive is ready plug it into the front of the Beaglebone. The photo below also includes an Atheros wifi USB dongle plugged into the front, but that's not necessary unless you want to set up the system to run on a wifi network.

-
-

bbb_front.jpg +

bbb_front.jpg

-

Connect the power and for the non-wireless versions of the Beaglebone Black also connect the ethernet cable and plug it into your internet router. @@ -373,6 +279,8 @@ Follow the rest of the instructions given here t There are many apps available within the Freedombone system and trying to install them all is probably not a good idea, since this hardware is very resource constrained on CPU and especially on RAM. If the system seems to be becoming unstable and crashing then the most likely cause is running out of RAM, in which case you can try uninstalling some apps. It is possible to monitor RAM usage by logging in with ssh, exiting to the command line and then running the top command.

+
+
@@ -235,18 +144,16 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

Code

-
+
+

Code

+

Freedombone is really just a couple of bash scripts which install and configure software on a Debian GNU/Linux system. If you're a system administrator, software engineer or Linux hobbyist you'll probably be familiar with command line scripting and be able to make your own modifications or custom variants to suit your needs. Freedombone is licensed under the GNU Affero General Public License version 3 (or later).

@@ -271,9 +178,16 @@ Github is closed source. Sooner or later it will probably turn evil or become li Longer term it is expected that the source code for this project will also be self-hosted, with Github acting only as a mirror to increase visibility.

-
-Return to the home page -
+
+

+<center> +Return to the <a href="index.html">home page</a> +</center> +

+ +
+
+
diff --git a/website/EN/codeofconduct.html b/website/EN/codeofconduct.html index 146f9a90..1080c5b9 100644 --- a/website/EN/codeofconduct.html +++ b/website/EN/codeofconduct.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - - + + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,37 +144,38 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

+ +
+

Code of Conduct

-

Code of Conduct

- -
-

Be respectful

-
+
+

Be respectful

+

In any Free Software project with more than one participant inevitably there may be people with whom you may disagree, or find it difficult to cooperate. Accept that, but even so, remain respectful. Disagreement is no excuse for poor behaviour or personal attacks, and a community in which people feel threatened is not a healthy community.

-
-

Assume good faith

-
+
+

Assume good faith

+

Freedombone Contributors have many ways of reaching our common goal of providing freedom respecting internet or mesh systems which may differ from your ways. Assume that other people are working towards this goal.

-
-

Be collaborative

-
+
+

Be collaborative

+

Freedombone is a moderately complex project, though nothing big and professional like GNU. It's good to ask for help when you need it. Similarly, offers for help should be seen in the context of our shared goal of improving the system.

@@ -277,9 +186,9 @@ When you make something for the benefit of the project, be willing to explain to
-
-

Try to be concise

-
+
+

Try to be concise

+

If you're submitting documentation then keep in mind that what you write once could be read by many other people. To avoid TL;DR keep it as short and concise as possible. This will also reduce the amount of translations effort needed.

@@ -290,9 +199,9 @@ If you're discussing an issue or bug, try to stay on topic, especially in discus
-
-

Be open

-
+
+

Be open

+

Most ways of communication used within Freedombone (eg Matrix/XMPP) allow for public and private communication. Prefer public methods of communication for Freedombone-related messages, unless posting something sensitive.

@@ -303,9 +212,9 @@ This applies to messages for help, too; not only is a public support request muc
-
-

In case of problems

-
+
+

In case of problems

+

While this code of conduct should be adhered to by participants, we recognize that sometimes people may have a bad day, or be unaware of some of the guidelines in this code of conduct. When that happens, you may reply to them and point out this code of conduct. Such messages may be in public or in private, whatever is most appropriate. However, regardless of whether the message is public or not, it should still adhere to the relevant parts of this code of conduct; in particular, it should not be abusive or disrespectful. Assume good faith; it is more likely that participants are unaware of their bad behaviour than that they intentionally try to degrade the quality of the discussion.

@@ -317,6 +226,12 @@ Serious or persistent offenders will be kicked from chat rooms and any of their

This is not a big project and so there is no division of labor or special enforcement committee or bureaucratic process. Complaints should be made (in private) to the maintainer or chat room admin. The typical email address can be found in the source code headers. Preferably use GPG if you can, or XMPP with OpenPGP/OMEMO to bob@freedombone.net. XMPP messages are likely to get a quicker response.

+ + +
+

gfdl.png +

+
diff --git a/website/EN/controlpanel.html b/website/EN/controlpanel.html deleted file mode 100644 index a8bcbccb..00000000 --- a/website/EN/controlpanel.html +++ /dev/null @@ -1,547 +0,0 @@ - - - - - - - - - - - - - - - - - -
- -
-
-
- -
-

logo.png -

-
-
- -
-

Control panel

-
- - - - --- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Main menu
User control panel
About screen
Email filtering rules
Hubzilla menu
IRC menu
Media menu
Repository mirrors
Backup and restore menu
Security menu
User management menu
- -
-

Main menu

-
-

-You can access the main menu by logging into the system. -

- -
-
ssh myusername@mydomain -p 2222
-
-
- -

-Then selecting Administrator controls. -

- -

-It should look like this: -

- -
- -
-

control_panel.jpg -

-
-
- -

-To select anythng on the control panel use the up and down cursor keys and space bar to tag, then press Enter. -

-
-
- -
-

User control panel

-
-

-When a user initially logs in they will see a version of the control panel with restricted options aimed at the kinds of things which someone who isn't the administrator might wish to do. An expected scenario is that you might have a few friends or family members on the system, and this is who this menu is intended for. -

- -

-From this menu checking email or running chat applications is very easy, and they are configured in a safe manner without the user needing to do anything special. Email uses mutt, XMPP uses profanity and IRC uses irssi. -

- -
- -
-

control_panel_user.jpg -

-
-
- -

-It's also possible for the user to define email filtering rules, add a ssh public key for key based login and also add or remove GPG public keys. They can also do this via the commandline if they prefer, but the menu system may provide an easier user interface. -

-
-
-
-

About screen

-
-

-To find out your current domain names select the About screen from the main menu. This is especially useful for finding your onion addresses. For improved security by compartmentalisation, and also simpler implementation, each application has its own onion address. -

- -
- -
-

control_panel_about.jpg -

-
-
- -

-You can also see the SIP extension numbers for each user and how much disk space each user is consuming (typically this corresponds with email use). -

- -

-The Local Mirrors contains mirrored copies of the git repositories used by the system. If they don't have access to default repositories (mostly Github) then you can give these details to other users and then they can set their main repository such that they can pull from your system. Obviously any users doing this need to trust that you havn't modified the mirrored repositories in any way. -

-
-
- -
-

Email filtering rules

-
-

-You can add users to mailing lists, or block particular email addresses or subject lines in this menu. -

- -
- -
-

control_panel_filtering.jpg -

-
-
-
-
- -
-

Hubzilla menu

-
-

-This allows you to set the global directory location and obtain an SSL/TLS certificate if necessary. -

- -
- -
-

control_panel_hubzilla.jpg -

-
-
-
-
- -
-

IRC menu

-
-

-You can view the current IRC password or change it from here. Currently the IRC server does not work equally well on clrearnet and via Tor, so there is an option to switch from one to the other. Initially the IRC server will be running on clearnet (i.e. no onion routing). -

- -
- -
-

control_panel_irc.jpg -

-
-
-
-
- -
-

Media menu

-
-

-It's possible to add playable media to a USB drive and plug it into the system, then make it accessible to other devices such as tablets or phones on your local network via DLNA. -

- -
- -
-

control_panel_media.jpg -

-
-
-
-
- -
-

Repository mirrors

-
-

-If you don't want to use the default repositories, or don't have access to them, then you can obtain them from another Freedombone server (the details can be found on the other server on the About screen of the control panel). -

- -
- -
-

control_panel_mirrors.jpg -

-
-
-
-
- -
-

Backup and restore menu

-
-

-You can create backups or restore from backup here. It's also possible to create keydrives which store the backup key. -

- -
- -
-

control_panel_backup_restore.jpg -

-
-
-
-
- -
-

Security menu

-
-

-If you need to generate SSL/TLS certificates or change cypher details due to changing recommendations then you can do that here. If you are changing cypher details be extra careful not to make mistakes/typos, which could reduce the security of your system. -

- -
- -
-

control_panel_security.jpg -

-
-
-
-
- -
-

User management menu

-
-

-Users can be added or removed here. -

- -
- -
-

control_panel_users.jpg -

-
-
-
-
-
-
- - - - -
- - diff --git a/website/EN/debianinstall.html b/website/EN/debianinstall.html index d20da23a..10cce6b7 100644 --- a/website/EN/debianinstall.html +++ b/website/EN/debianinstall.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - - + + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,18 +144,16 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

How to install on an existing Debian system

-
+
+

How to install on an existing Debian system

+

"The antagonism of surveillance is not privacy but the making of communities in struggle" @@ -267,11 +173,12 @@ It's still possible to install the system onto these unsupported devices if you

+
su
 apt-get update
 apt-get -qy install build-essential git dialog
 git clone https://github.com/bashrc/freedombone
-cd freedombone
+cd freedombone
 git checkout stretch
 make install
 freedombone menuconfig (or freedombone menuconfig-onion)
@@ -287,10 +194,13 @@ Once installed you can then log in from another system with:
 

+
ssh yourusername@freedombone.local -p 2222
 
+
+
@@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,27 +144,28 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

+ +
+

Developers Guide

-

Developers Guide

- -
-

Introduction

-
+
+

Introduction

+

Freedombone consists of a set of bash scripts. There are a lot of them, but they're not very complicated. If you're familiar with the GNU/Linux commandline and can hack a bash script then you can probably add a new app or fix a bug in the system. There are no trendy development frameworks to learn or to get in your way. You might also want to consult the Code of Conduct, and there is a Matrix room at #fbone:matrix.freedombone.net

-
-

Adding extra apps

-
+
+

Adding extra apps

+

Suppose you have some internet application which you want to add to the system. To do this you need to create an app script which tells the system how to install/remove and also backup/restore. The script should be designed to work with the current stable version of Debian.

@@ -270,8 +179,9 @@ To create a script for a generic PHP plus MySql/MariaDB web app:

-
freedombone-template --app [name] -e [email] -r [repo url] \
-                     -c [commit] --php yes -d mariadb > \
+
+
freedombone-template --app [name] -e [email] -r [repo url] \
+                     -c [commit] --php yes -d mariadb > \
                      src/freedombone-app-myappname
 
@@ -281,9 +191,10 @@ For a Nodejs app with MySql/MariaDB database:

-
freedombone-template --app [name] -e [email] -r [repo url] \
-                     -c [commit] --node yes -d mariadb \
-                     --dir /etc/myappname --daemon yes > \
+
+
freedombone-template --app [name] -e [email] -r [repo url] \
+                     -c [commit] --node yes -d mariadb \
+                     --dir /etc/myappname --daemon yes > \
                      src/freedombone-app-myappname
 
@@ -293,9 +204,10 @@ For a Python app with Postgresql database:

-
freedombone-template --app [name] -e [email] -r [repo url] \
-                     -c [commit] -d postgresql \
-                     --dir /etc/myappname --daemon yes > \
+
+
freedombone-template --app [name] -e [email] -r [repo url] \
+                     -c [commit] -d postgresql \
+                     --dir /etc/myappname --daemon yes > \
                      src/freedombone-app-myappname
 
@@ -305,9 +217,10 @@ For a Python app without any database, communicating between the daemon and the

-
freedombone-template --app [name] -e [email] -r [repo url] \
-                     -c [commit] --dir /etc/myappname \
-                     --daemon yes --portinternal 1234 > \
+
+
freedombone-template --app [name] -e [email] -r [repo url] \
+                     -c [commit] --dir /etc/myappname \
+                     --daemon yes --portinternal 1234 > \
                      src/freedombone-app-myappname
 
@@ -317,9 +230,10 @@ For an app without any database which communicates directly on a particular port

-
freedombone-template --app [name] -e [email] -r [repo url] \
-                     -c [commit] --dir /etc/myappname \
-                     --daemon yes --port 5000 > \
+
+
freedombone-template --app [name] -e [email] -r [repo url] \
+                     -c [commit] --dir /etc/myappname \
+                     --daemon yes --port 5000 > \
                      src/freedombone-app-myappname
 
@@ -329,9 +243,10 @@ A generic PHP plus MySql/MariaDB web app which is only available on an onion add

-
freedombone-template --app [name] -e [email] -r [repo url] \
-                     -c [commit] --php yes -d mariadb \
-                     --onion yes > \
+
+
freedombone-template --app [name] -e [email] -r [repo url] \
+                     -c [commit] --php yes -d mariadb \
+                     --onion yes > \
                      src/freedombone-app-myappname
 
@@ -341,6 +256,7 @@ For more details see the manpage:

+
man freedombone-template
 
@@ -354,6 +270,7 @@ When your new script is ready for testing you can install it with:

+
make install
 
@@ -368,9 +285,9 @@ Submit your working app to -

Customising mesh images

-
diff --git a/website/EN/domains.html b/website/EN/domains.html index 1fcc6d65..b8883fe9 100644 --- a/website/EN/domains.html +++ b/website/EN/domains.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - + + + + - + @@ -235,19 +144,20 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

+ +
+

How to get a domain name

-

How to get a domain name

- -
-

The domain name itself

-
+
+

The domain name itself

+

If you want your sites or chat systems to be available via an ordinary web browser (i.e. not a Tor browser) then you'll need to obtain a domain name. The domain name system is ultimately controlled by ICANN and to obtain a domain name for which you can also get a TLS certificate you'll need to buy one. There are various sites which sell domain names, and fortunately they can often be quite cheap - especially if you can think of an obscure name for your site. Prefer sites where the domain name subscription can be automatically renewed, because otherwise trolls can quickly buy your domain when it expires and then hold it for ransom. If you're planning to self-host for more than an ephemeral purpose, such as a conference or festival, then choose the longest subscription period you can afford (typically a few years).

@@ -258,9 +168,9 @@ You probably only need one ICANN domain name and then the various Freedombone ap
-
-

Dynamic DNS

-
+
+

Dynamic DNS

+

You will also need a dynamic DNS account, and again this might be something you have to pay a subscription for. Your Freedombone system will have a local network address (typically 192.168.x.y or 10.x.y.z) and also a public IP address assigned by your ISP. Your ISP will change your public IP address every so often (that's why it's called "dynamic") and so there needs to be some way to link the domain name which you've obtained to your changing public IP address. That's what the dynamic DNS service does.

@@ -278,6 +188,7 @@ The dynamic DNS service will have their own DNS servers maintaining the IP addre

+
NS1.AFRAID.ORG
 NS2.AFRAID.ORG
 NS3.AFRAID.ORG
@@ -290,9 +201,9 @@ It might take a few minutes for the changes to take effect, so don't be too hast
 

-
-

Configuring with FreeDNS

-
+
+

Configuring with FreeDNS

+

If you are using FreeDNS as a dynamic DNS provider then on their site select "Domains" and add your domain name (this might only be available to paid subscribers). Make sure that they're marked as "private" so that subdomains of your domain name are not used by other users of the site.

@@ -304,18 +215,18 @@ Select "Subdomains" from the menu on the left then select the MX entry for your
-
-

Setting up with Freedombone

-
+
+

Setting up with Freedombone

+

When you start the base installation of the system it will ask you to choose a dynamic DNS provider and then enter the login details for the dynamic DNS service.

-
-

A note about Tor

-
+
+

A note about Tor

+

If you only want your sites to be available via Tor then none of the above is needed and you can access your sites and systems via their onion addresses. Tor has its own naming system which is independent from ICANN, and you also won't need TLS/SSL certificates since it also manages transport encryption itself. When building disk images use the –onion yes option, or choose one of the ready made onion disk images from downloads.

diff --git a/website/EN/faq.html b/website/EN/faq.html index 69874ea7..bcce05a3 100644 --- a/website/EN/faq.html +++ b/website/EN/faq.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + @@ -11,7 +11,7 @@ - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,17 +144,17 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
-

Home Server

- +
+

Home Server

+

The quickest way to get started is as follows. You will need to be running a Debian based system (version 8 or later), have an old but still working laptop or netbook which you can use as a server, and 8GB or larger USB thumb drive and an ethernet cable to connect the laptop to your internet router.

@@ -256,9 +164,10 @@ First install freedombone onto your local system (not the target hardware that y

+
sudo apt-get install git dialog build-essential
 git clone https://github.com/bashrc/freedombone
-cd freedombone
+cd freedombone
 git checkout stretch
 sudo make install
 freedombone-image --setup debian
@@ -271,9 +180,10 @@ Or on Arch/Parabola:
 

+
sudo pacman -S git dialog
 git clone https://github.com/bashrc/freedombone
-cd freedombone
+cd freedombone
 git checkout stretch
 sudo make install
 freedombone-image --setup parabola
@@ -286,17 +196,16 @@ Now prepare your local system to talk to the freedombone by running the followin
 

+
freedombone-client
 
-
-

tor_onion.jpg +

tor_onion.jpg

-

The version in which sites are available only via onion addresses is the easiest to get started with, since you can evaluate the system without committing to buying an ICANN domain name or needing to get involved with SSL/TLS certificates at all. However, if you do want your sites to be available typically as subdomains of a domain name which you own then remove the –onion-addresses-only yes option from the last command shown above. Also see the guide on setting up an ICANN domain name. @@ -310,13 +219,11 @@ The onion-addresses-only option does not mean that everything gets If you want to create images for microSD cards used within various single board computers then replace the i386 with beaglebone / cubieboard2 / cubietruck / a20-olinuxino-lime / a20-olinuxino-lime2 / a20-olinuxino-micro or apu.

-
-

beaglebone_black9.jpg +

beaglebone_black9.jpg

-

This takes a while. Maybe an hour or so, depending on the speed of your system and the internets. The good news though is that once created you can use the resulting image any number of times, and you don't need to trust some pre-built image. @@ -327,6 +234,7 @@ List what drives are on your system with:

+
ls /dev/sd*
 
@@ -340,8 +248,9 @@ You can now copy the image to the USB thumb drive, replacing sdX with the

-
dd if=/dev/zero of=/dev/sdX bs=1M count=8
-dd bs=1M if=myimagefile.img of=/dev/sdX conv=fdatasync
+
+
dd if=/dev/zero of=/dev/sdX bs=1M count=8
+dd bs=1M if=myimagefile.img of=/dev/sdX conv=fdatasync
 
@@ -354,6 +263,7 @@ As the system boots for the first time the login is:

+
username: fbone
 password: freedombone
 
@@ -364,6 +274,7 @@ If you're installing from a microSD card on a single board computer without a sc

+
ssh fbone@freedombone.local -p 2222
 
@@ -385,6 +296,7 @@ When it's installed on your local system open a terminal and verify the ssh serv

+
freedombone-client --verify
 
@@ -393,19 +305,18 @@ When it's installed on your local system open a terminal and verify the ssh serv This will show the hash code for the public ssh key of the Freedombone system.

-
-

ssh_key_verify.jpg +

ssh_key_verify.jpg

-

Open another terminal window then run:

+
freedombone-client
 ssh myusername@freedombone.local -p 2222
 
@@ -415,25 +326,21 @@ ssh myusername@freedombone.local -p 2222 Use the password you wrote down earlier to log in. Select the administrator control panel with up and down cursor keys, space bar and enter key. You should see something like this, and you might need to re-enter your password.

-
-

control_panel.jpg +

control_panel.jpg

-

Then select About. You'll see a list of sites and their onion addresses.

-
-

control_panel_about.jpg +

control_panel_about.jpg

-

The About screen contains the ssh server public key hashes and you can compare the relevant one with the previous terminal window to verify that they're the same. If they're not then you might have a machine-in-the-middle snooping on you. @@ -447,13 +354,11 @@ You have now confirmed a secure connection. Probably. If you're still sceptical Press any key to exit from the About screen. You can then select Add/Remove apps and add whatever applications you wish to run. Note that some apps will only run on x86 systems, but most will install and run on ARM single board computers. More details on particular apps can be found here.

-
-

control_panel_apps.jpg +

control_panel_apps.jpg

-

Once your apps have installed you can go back to the About screen, pick an onion address and try it within a Tor compatible browser. You'll need to know the login passwords and those can be found within the Passwords section of the administrator control panel. An axiom of the Freedombone system is that if given the choice users will usually use insecure passwords, so on this system passwords are generated randomly. If you need to then you can transfer the passwords into your favourite password manager and remove them from the server by going to the Security Settings section of the administrator control panel and choosing Export passwords and Password storage. @@ -472,16 +377,19 @@ Of course, this is just one way in which you can install the Freedombone system.

+
man freedombone-image
 
-
-

-This site can also be accessed via a Tor browser at http://yjxlc3imv7obva4grjae6u3qw527koaytrgjgdp364hmthrst3jodiid.onion + +

+

gfdl.png

+
+
@@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,66 +144,40 @@ for the JavaScript code in this tag.
-
-

-logo.png -bbb3.png +

+ +
+

logo.png

-

-"With the increasing move of our computing to cloud infrastructures, we give up the control of our computing to the managers of those infrastructures. Our terminals (laptops, desktops) might now be running entirely on Free Software, but this is increasingly irrelevant given that most of what actually matters gets executed on a remote closed system that we don’t control. The Free Software community needs to work to help users keep the control of all their computing, by developing suitable alternatives and facilitating their deployment." +So you want to run your own internet services? Email, chat, VoIP, web sites, file synchronisation, wikis, blogs, social networks, media hosting, backups, VPN. Freedombone is a home server system which enables you to self-host all of these things.

-– Lucas Nussbaum -

-
- -

-So you want to run your own internet services? Email, chat, VoIP, web sites, file synchronisation, wikis, blogs, social networks, media hosting, backups, VPN. Freedombone enables you to do all of that in a self-hosted way, where you keep control of your data and it resides in your own home. +You can run Freedombone on an old laptop or a single board computer. See the list of installation methods. You can also use it to set up a mesh network in your local area.

-A list of other supported ARM boards can be found here, or you can install onto an old laptop or netbook. Some installation instructions for different use cases are: +Check out the list of available apps and Frequently Asked Questions section. Recent developments are also described on the blog.

- -

-After installation it's possible that you might want some advice on how to run your system and set up apps to work nicely with it. +Disk images which can be cloned straight to USB or microSD drives are available here.

- - -

If you find bugs, or want to add a new app to this system see the Developers Guide and Code of Conduct. There is a Matrix chat room available at #fbone:matrix.freedombone.net.

-Ready made disk images which can be copied onto USB or microSD drives are available here. +If you like this project and want to support continued development then here's what to do.

-
-

-This site can also be accessed via a Tor browser at http://yjxlc3imv7obva4grjae6u3qw527koaytrgjgdp364hmthrst3jodiid.onion. This documentation is under the GNU Free Documentation License version 1.3 + +

+

gfdl.png

diff --git a/website/EN/installation.html b/website/EN/installation.html index 0db8eb6b..4ce78c49 100644 --- a/website/EN/installation.html +++ b/website/EN/installation.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,66 +144,66 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

Installation

-
+ -
-

Building an image for a Single Board Computer or Virtual Machine

-
+
+

Building an image for a Single Board Computer or Virtual Machine

+

You don't have to trust images downloaded from random internet locations signed with untrusted keys. You can build one from scratch yourself, and this is the recommended procedure for maximum security. For guidance on how to build images see the manpage for the freedombone-image command.

@@ -305,12 +213,13 @@ Install the freedombone commands onto your laptop/desktop:

-
sudo apt-get install git build-essential dialog
+
+
sudo apt-get install git build-essential dialog
 git clone https://github.com/bashrc/freedombone
-cd freedombone
+cd freedombone
 git checkout stretch
 sudo make install
-
+

@@ -318,8 +227,9 @@ Then install packages needed for building images:

-
freedombone-image --setup debian
-
+ +
freedombone-image --setup debian
+

@@ -327,8 +237,9 @@ or on an Arch/Parabola system:

-
freedombone-image --setup parabola
-
+ +
freedombone-image --setup parabola
+

@@ -336,8 +247,9 @@ A typical use case to build an 8GB image for a Beaglebone Black is as follows. Y

-
freedombone-image -t beaglebone -s 8G
-
+ +
freedombone-image -t beaglebone -s 8G
+

@@ -345,8 +257,9 @@ If you prefer an advanced installation with all of the options available then us

-
freedombone-image -t beaglebone -s 8G --minimal no
-
+ +
freedombone-image -t beaglebone -s 8G --minimal no
+

@@ -354,8 +267,9 @@ To build a 64bit Qemu image:

-
freedombone-image -t qemu-x86_64 -s 8G
-
+ +
freedombone-image -t qemu-x86_64 -s 8G
+

@@ -367,72 +281,86 @@ If the image build fails with an error such as "Error reading from server. Re

-
freedombone-image -t beaglebone -s 8G -m http://ftp.de.debian.org/debian
-
+ +
freedombone-image -t beaglebone -s 8G -m http://ftp.de.debian.org/debian
+
-
-

Checklist

-
+
+

Checklist

+

Before installing Freedombone you will need a few things.

    -
  • Have some domains, or subdomains, registered with a dynamic DNS service. For the full install you may need two "official" purchased domains or be using a subdomain provider which is supported by Let's Encrypt.
  • -
  • System with a new installation of Debian Stretch or a downloaded/prepared disk image
  • -
  • Ethernet connection between the system and your internet router
  • -
  • That it is possible to forward ports from the internet router to the system, typically via firewall settings
  • -
  • Have ssh access to the system, typically via fbone@freedombone.local on port 2222
  • +
  • Have some domains, or subdomains, registered with a dynamic DNS service. For the full install you may need two "official" purchased domains or be using a subdomain provider which is supported by Let's Encrypt. +
  • +
  • System with a new installation of Debian Stretch or a downloaded/prepared disk image +
  • +
  • Ethernet connection between the system and your internet router +
  • +
  • That it is possible to forward ports from the internet router to the system, typically via firewall settings +
  • +
  • Have ssh access to the system, typically via fbone@freedombone.local on port 2222 +
-
-

Installation

-
+
+

Installation

+

There are three install options: Laptop/Desktop/Netbook, SBC and Virtual Machine.

-
-

On a Laptop, Netbook or Desktop machine

-
+
+

On a Laptop, Netbook or Desktop machine

+

If you have an existing system, such as an old laptop or netbook which you can leave running as a server, then install a new version of Debian Stretch onto it. During the Debian install you won't need the print server or the desktop environment, and unchecking those will reduce the attack surface. Once Debian enter the following commands:

-
su
+
+
su
 apt-get update
 apt-get -y install git dialog build-essential
 git clone https://github.com/bashrc/freedombone
-cd freedombone
+cd freedombone
 git checkout stretch
 make install
 freedombone menuconfig
-
+
-
-

On a single board computer (SBC)

-
+
+

On a single board computer (SBC)

+

Currently the following boards are supported:

@@ -440,8 +368,9 @@ If there is no existing image available then you can build one from scratch. See

-
gpg --verify filename.img.asc
-
+ +
gpg --verify filename.img.asc
+

@@ -449,8 +378,9 @@ And the hash with:

-
sha256sum filename.img
-
+ +
sha256sum filename.img
+

@@ -458,8 +388,9 @@ If the image is compressed then decompress it with:

-
unxz filename.img.xz
-
+ +
unxz filename.img.xz
+

@@ -467,8 +398,9 @@ Then copy it to a microSD card. Depending on your system you may need an adaptor

-
sudo dd bs=1M if=filename.img of=/dev/sdX conv=fdatasync
-
+ +
sudo dd bs=1M if=filename.img of=/dev/sdX conv=fdatasync
+

@@ -476,8 +408,9 @@ Where sdX is the microSD drive. You can check which drive is the microSD

-
ls /dev/sd*
-
+ +
ls /dev/sd*
+

@@ -489,8 +422,9 @@ With the board connected and running you can ssh into the system with:

-
ssh fbone@freedombone.local -p 2222
-
+ +
ssh fbone@freedombone.local -p 2222
+

@@ -499,16 +433,17 @@ Using the password 'freedombone'. Take a note of the new login password and then

-
-

As a Virtual Machine

-
+
+

As a Virtual Machine

+

Qemu is currently supported, since it's s fully free software system. You can run a 64 bit Qemu image with:

-
qemu-system-x86_64 -m 1G filename.img
-
+ +
qemu-system-x86_64 -m 1G filename.img
+

@@ -518,42 +453,42 @@ The default login will be username 'fbone' and password 'freedombone'. Take a no

-
-

Social Key Management - the 'Unforgettable Key'

-
+
+

Social Key Management - the 'Unforgettable Key'

+

During the install procedure you will be asked if you wish to import GPG keys. If you don't already possess GPG keys then just select "Ok" and they will be generated during the install. If you do already have GPG keys then there are a few possibilities

-
-

You have the gnupg keyring on an encrypted USB drive

-
+
+

You have the gnupg keyring on an encrypted USB drive

+

If you previously made a master keydrive containing the full keyring (the .gnupg directory). This is the most straightforward case, but not as secure as splitting the key into fragments.

-
-

You have a number of key fragments on USB drives retrieved from friends

-
+
+

You have a number of key fragments on USB drives retrieved from friends

+

-If you previously made some USB drives containing key fragments then retrieve them from your friends and plug them in one after the other. After the last drive has been read then remove it and just select "Ok". The system will then try to reconstruct the key. For this to work you will need to have previously made three or more Keydrives. +If you previously made some USB drives containing key fragments then retrieve them from your friends and plug them in one after the other. After the last drive has been read then remove it and just select "Ok". The system will then try to reconstruct the key. For this to work you will need to have previously made three or more Keydrives.

-
-

You can specify some ssh login details for friends servers containing key fragments

-
+
+

You can specify some ssh login details for friends servers containing key fragments

+

Enter three or more sets of login details and the installer will try to retrieve key fragments and then assemble them into the full key. This only works if you previously were using remote backups and had social key management enabled.

-
-

Final Setup

-
+
+

Final Setup

+

Any manual post-installation setup instructions or passwords can be found in /home/username/README.

@@ -566,128 +501,129 @@ On your internet router, typically under firewall settings, open the following p - + - + -Service -Ports +Service +Ports -HTTP -80 +HTTP +80 -HTTPS -443 +HTTPS +443 -SSH -2222 +SSH +2222 -DLNA -1900 +DLNA +1900 -DLNA -8200 +DLNA +8200 -XMPP -5222..5223 +XMPP +5222..5223 -XMPP -5269 +XMPP +5269 -XMPP -5280..5281 +XMPP +5280..5281 -IRC -6697 +IRC +6697 -Git -9418 +Git +9418 -Email -25 +Email +25 -Email -587 +Email +587 -Email -465 +Email +465 -Email -993 +Email +993 -VoIP -64738 +VoIP +64738 -VoIP -5060 +VoIP +5060 -Tox -33445 +Tox +33445 -Syncthing -22000 +Syncthing +22000
-
-

Keydrives

-
+
+

Keydrives

+

After installing for the first time it's a good idea to create some keydrives. These will store your gpg key so that if all else fails you will still be able to restore from backup. There are two ways to do this:

-
-

Master Keydrive

-
+
+

Master Keydrive

+

This is the traditional security model in which you carry your full keyring on an encrypted USB drive. To make a master keydrive first format a USB drive as a LUKS encrypted drive. In Ubuntu this can be done from the Disk Utility application. Then plug it into the Freedombone system, then from your local machine run:

-
ssh myusername@mydomainname -p 2222
-
+ +
ssh myusername@mydomainname -p 2222
+

@@ -695,16 +631,17 @@ Select Administrator controls then Backup and Restore then Back

-
-

Fragment keydrives

-
+
+

Fragment keydrives

+

This breaks your GPG key into a number of fragments and randomly selects one to add to the USB drive. First format a USB drive as a LUKS encrypted drive. In Ubuntu this can be done from the Disk Utility application. Plug it into the Freedombone system then from your local machine run the following commands:

-
ssh myusername@mydomainname -p 2222
-
+ +
ssh myusername@mydomainname -p 2222
+

@@ -717,45 +654,52 @@ Fragments are randomly assigned and so you will need at least three or four keyd

-
-

On Client Machines

-
+
+

On Client Machines

+

You can configure laptops or desktop machines which connect to the Freedombone server in the following way. This alters encryption settings to improve overall security.

-
sudo apt-get update
+
+
sudo apt-get update
 sudo apt-get install git dialog haveged build-essential
 git clone https://github.com/bashrc/freedombone
-cd freedombone
+cd freedombone
 git checkout stretch
 sudo make install
 freedombone-client
-
+
-
-

Administering the system

-
+
+

Administering the system

+

To administer the system after installation log in via ssh, become the root user and then launch the control panel.

-
ssh myusername@freedombone.local -p 2222
-
+ +
ssh myusername@freedombone.local -p 2222
+

Select Administrator controls then from there you will be able to perform various tasks, such as backups, adding and removing users and so on. You can also do this via commands, which are typically installed as /usr/local/bin/freedombone* and the corresponding manpages.

-
-Return to the home page -
+
+

+<center> +Return to the <a href="index.html">home page</a> +</center> +

+ +
diff --git a/website/EN/installmethods.html b/website/EN/installmethods.html new file mode 100644 index 00000000..e0d80f0d --- /dev/null +++ b/website/EN/installmethods.html @@ -0,0 +1,222 @@ + + + + + + + + + + + + + + + + +
+ +
+
+

+ +
+

logo.png +

+
+ +

+Most people don't have a static external IP address, so you will need to have an account on a dymanic DNS service. FreeDNS is the one recommended, but others are available. +

+ +

+If you want systems to be available within an ordinary web browser, such as Firefox, then you will need to obtain a domain name. +

+ +

+A list of other supported ARM boards can be found here, or you can install onto an old laptop or netbook. Some installation instructions for different use cases are: +

+ + + + +
+

gfdl.png +

+
+
+
+ + + + +
+ + diff --git a/website/EN/mesh.html b/website/EN/mesh.html index dd0cf430..afb30f6d 100644 --- a/website/EN/mesh.html +++ b/website/EN/mesh.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - - + + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,35 +144,38 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -

Mesh Network

+
+

Mesh Network

+

The Freedombone Mesh is a wireless solution for autonomous or internet connected communication that can be rapidly deployed in temporary, emergency or post-disaster situations where internet access is unavailable or compromised.

-
-

mesh_desktop1.png +

mesh_desktop1.png

-

Mesh networks are useful as a quick way to make a fully decentralised communications system which is not connected to or reliant upon the internet. Think festivals, hacker conferences, onboard ships at sea, disaster/war zones, small businesses who don't want the overhead of server maintenance, protests, remote areas of the world, temporary "digital blackouts", scientific expeditions and off-world space colonies. @@ -282,12 +193,14 @@ Systems only need to be within wifi range of each other for the mesh to be creat Like LibreMesh, this system uses a combination of batman-adv on network layer 2 and BMX on layer 3. Routing protocols OLSR2 and Babel are also selectable.

-
-

-This site can also be accessed via a Tor browser at http://yjxlc3imv7obva4grjae6u3qw527koaytrgjgdp364hmthrst3jodiid.onion + +

+

gfdl.png

+
+
@@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,41 +144,64 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -

Mesh Network: Capabilities

+
+

Mesh Network: Capabilities

+

The mesh system has the following capabilities:

    -
  • Discovery of other users on the network
  • -
  • Text based chat, one-to-one and in groups
  • -
  • Voice chat (VoIP) and video calls
  • -
  • Private and public sharing of files
  • -
  • Blogging
  • -
  • Collaborative editing of documents and presentations
  • -
  • Creating and broadcasting audio media/podcasts
  • -
  • Social network stream. Follow/unfollow other peers
  • -
  • No network administration required
  • -
  • No servers
  • -
  • Internet connection is optional
  • -
  • Works from bootable USB drives or microSD drives
  • -
  • Data is mesh routed between systems
  • -
  • Private communications is end-to-end secured and forward secret
  • -
  • Publicly shared data is content addressable
  • +
  • Discovery of other users on the network +
  • +
  • Text based chat, one-to-one and in groups +
  • +
  • Voice chat (VoIP) and video calls +
  • +
  • Private and public sharing of files +
  • +
  • Blogging +
  • +
  • Collaborative editing of documents and presentations +
  • +
  • Creating and broadcasting audio media/podcasts +
  • +
  • Social network stream. Follow/unfollow other peers +
  • +
  • No network administration required +
  • +
  • No servers +
  • +
  • Internet connection is optional +
  • +
  • Works from bootable USB drives or microSD drives +
  • +
  • Data is mesh routed between systems +
  • +
  • Private communications is end-to-end secured and forward secret +
  • +
  • Publicly shared data is content addressable +

This system should be quite scalable. Both qTox and IPFS are based upon distributed hash tables (DHT) so that each peer does not need to store the full index of data for the entire network. Gossiping between SSB peers may be slower, but the small world effect will presumably still make for quite efficient delivery in a large network. Caching or pinning of IPFS data and its content addressability means that if a file or blog becomes popular then performance should improve as the number of downloads increases, which is the opposite of the client/server paradigm.

+ + +
+

gfdl.png +

+
+
+
diff --git a/website/EN/mesh_custom.html b/website/EN/mesh_custom.html index f7adf440..d80c3121 100644 --- a/website/EN/mesh_custom.html +++ b/website/EN/mesh_custom.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - - + + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,16 +144,16 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -

Mesh Network: Customisation

+
+

Mesh Network: Customisation

+

If you want to make your own specially branded version, such as for a particular event, then to change the default desktop backgrounds edit the images within img/backgrounds and to change the available avatars and desktop icons edit the images within img/avatars. Re-create disk images using the instructions shown previously.

@@ -253,6 +161,15 @@ If you want to make your own specially branded version, such as for a particular

If you need particular dconf commands to alter desktop appearance or behavior then see the function mesh_client_startup_applications within src/freedombone-image-customise.

+ + + +
+

gfdl.png +

+
+
+
diff --git a/website/EN/mesh_images.html b/website/EN/mesh_images.html index f4f8bf04..7fdd8db9 100644 --- a/website/EN/mesh_images.html +++ b/website/EN/mesh_images.html @@ -3,15 +3,15 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + - - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,16 +144,16 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -

Mesh Network: Philosophic

+
+

Mesh Network: Philosophic

+

"I see mesh networks naturally evolving to become the dominant form of network over the next few decades, because it’s the most practical solution to a number of problems that will have to be solved in order to build the VR web as well as to connect the entire world to the internet. Centralized networks are only possible in highly developed countries with existing infrastructures like power and telephone grids, as well as roads. You can’t build a tower where you don’t have either power or access. For vast areas of the world, mesh networks will be the only feasible solution." – Valkyrie Ice @@ -255,94 +163,103 @@ for the JavaScript code in this tag.

The Freedombone mesh roughly follows MondoNet's ten social specifications:

+
+
-
-

Decentralized

-
+
+

Decentralized

+

The network should not be operated, maintained, or in any way reliant upon a single or minimally differentiated set of entities or technologies. No individual, entity or group should be central to the network to the extent that their absence would measurably impact its functionality or scope. Network participation should not require access to fixed, physical infrastructure of any sort.

-
-

Universally Accessible

-
+
+

Universally Accessible

+

The requisite technology and expertise required to participate in the network should be available at minimal cost and effort to every human being on the planet. Furthermore, all users should be able to extend the network’s content and functionality to suit their own needs, or those of others. No aspect of the network’s functioning should be reliant upon proprietary technologies, information or capital.

-
-

Censor-proof

-
+
+

Censor-proof

+

The network should be resistant to both regulatory and technical attempts to limit the nature of the information shared, restrict usage by given individuals or communities, or render the network, or any portion of it, inoperable or inaccessible.

-
-

Surveillance-proof

-
+
+

Surveillance-proof

+

The network should enable users to choose exactly what information they share with whom, and to participate anonymously if they so desire. Users should only have access to information if they are the designated recipients, or if it has been published openly.

-
-

Secure

-
+
+

Secure

+

The network should be organized in a way that minimizes the risk of malicious attacks or engineering failure. Information exchanged on the network should meet or exceed the delivery rate and reliability of information exchanged via the Internet.

-
-

Scalable

-
+
+

Scalable

+

The network should be organized with the expectation that its scale could reach or even exceed that of today’s Internet. Special care should be taken to address to the challenge of maintaining efficiency without the presence of a centralized backbone.

-
-

Permanent

-
+
+

Permanent

+

The network’s density and redundancy should be great enough that, despite its ad hoc nature, it will persistently operate on a broad scale, and be available in full to any user within range of another peer.

-
-

Fast (enough)

-
+
+

Fast (enough)

+

The network should always achieve whatever speed is required for a “bottom line” level of social and cultural participation. At present, we assert that the network’s data transfer rate should, at a minimum, be enough for voice-over-IP (VoIP) communications, and low-bitrate streaming video.

-
-

Independent

-
+
+

Independent

+

While the network will have the capacity to exchange information with Internet users and nodes, it should be able to operate independently, as well. A large-scale failure or closure of Internet infrastructure and content should have minimal effect on the network’s operations.

-
-

Evolvable

-
+
+

Evolvable

+

The network should be built with future development in mind. The platform should be flexible enough to support technologies, protocols and modes of usage that have not yet been developed.

+ + + +
+

gfdl.png +

+
diff --git a/website/EN/mesh_usage.html b/website/EN/mesh_usage.html index 1b9cf3c6..d4bf10fe 100644 --- a/website/EN/mesh_usage.html +++ b/website/EN/mesh_usage.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - - + + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,49 +144,61 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -

Mesh Network: How to use it

+
+

Mesh Network: How to use it

+

When you first boot from the USB drive the system will create some encryption keys, assign a unique network address to the system and then reboot itself. When that's done you should see a prompt asking for a username. This username just makes it easy for others to initially find you on the mesh and will appear in the list of users.

-
-

mesh_initial_login.jpg +

mesh_initial_login.jpg

-
+

After a minute or two if you are within wifi range and there is at least one other user on the network then you should see additional icons appear on the desktop, such as Other Users and Chat.

+
+
-
-

Boot trouble

-
+
+

Boot trouble

+

If the system doesn't boot and reports an error which includes /dev/mapper/loop0p1 then reboot with Ctrl-Alt-Del and when you see the grub menu press e and manually change /dev/mapper/loop0p1 to /dev/sdb1, then press Ctrl-x. If that doesn't work then reboot and try /dev/sdc1 instead.

@@ -288,9 +208,9 @@ After the system has booted successfully the problem should resolve itself on su

-
-

Set the Date

-
+
+

Set the Date

+

On the ordinary internet the date and time of your system would be set automatically via NTP. But this is not the internet and so you will need to manually ensure that your date and time settings are correct. You might need to periodically do this if your clock drifts. It's not essential that the time on your system be highly accurate, but if it drifts too far or goes back to epoch then things could become a little confusing in regard to the order of blog posts.

@@ -300,9 +220,9 @@ On the ordinary internet the date and time of your system would be set automatic

-
-

Check network status

-
+
+

Check network status

+

Unlike with ordinary wifi, on the mesh you don't get a signal strength icon and so it's not simple to see if you have a good connection.

@@ -312,29 +232,24 @@ Select the wifi icon on the desktop and enter the password 'freedombone'.

-
-
-

mesh_signal.jpg +

mesh_signal.jpg

-

When you are finished close the window and then select the Network Restart desktop icon, which will restart the B.A.T.M.A.N. network. You can also use the restart icon if you are within range of the mesh network but the Chat and Other Users icons do not automatically appear after a few minutes.

-
-

Connecting to the internet

-
-
+
+

Connecting to the internet

+
-

mesh_architecture2.jpg +

mesh_architecture2.jpg

-

If you need to be able to access the internet from the mesh then connect one of the peers to an internet router using an ethernet cable (shown as yellow above), then reboot it. Other peers in the mesh, including any attached mobile devices, will then be able to access the internet using the ethernet attached peer as a gateway. Freifunk works in a similar way. @@ -349,6 +264,7 @@ If for legal reasons you need to connect to the internet via a VPN then openvpn

+
sudo openvpn myclient.ovpn
 
@@ -358,16 +274,14 @@ Where myclient.ovpn comes from your VPN provider and with the password "<

-
-

Connecting two meshes over the internet via a VPN tunnel

-
-
+
+

Connecting two meshes over the internet via a VPN tunnel

+
-

mesh_architecture_vpn.jpg +

mesh_architecture_vpn.jpg

-

Maybe the internet exists, but you don't care about getting any content from it and just want to use it as a way to connect mesh networks from different geographical locations together. @@ -377,13 +291,11 @@ Maybe the internet exists, but you don't care about getting any content from it In your home directory on a system connected via ethernet to an internet router you'll find a file called vpn.tar.gz. If you want another mesh to be able to connect to yours then send them this file and get them to uncompress it into their home directory also on an internet gateway machine. If they have an external IP address or domain name for your router then they will be able to VPN connect using the Connect Meshes icon. They should also forward port 653 from their internet router to the mesh gateway machine.

-
-

mesh_connect.png +

mesh_connect.png

-

You should create a new vpn.tar.gz file for every other mesh which wants to be able to connect to yours. If you are prompted for a password it is 'freedombone'. @@ -395,16 +307,14 @@ From a deep packet inspection point of view the traffic going over the internet

-
-

Mobile devices (phones, etc)

-
-
+
+

Mobile devices (phones, etc)

+
-

mesh_architecture3.jpg +

mesh_architecture3.jpg

-

To allow mobile devices to connect to the mesh you will need a second wifi adapter connected to your laptop/netbook/SBC. Plug in a second wifi adapter then reboot the system. The second adaptor will then create a wifi hotspot (the connection shown in green above) which mobile devices can connect to. The hotspot name also contains its local IP address (eg. "mesh-192.168.1.83"). @@ -414,33 +324,29 @@ To allow mobile devices to connect to the mesh you will need a second wifi adapt On a typical Android device go to Settings then Security and ensure that Unknown sources is enabled. Also within Wifi from the Settings screen select the mesh hotspot. The password is "freedombone". Open a non-Tor browser and navigate to the IP address showing in the hotspot name. You can then download and install mesh apps.

-
-

mesh_mobileapps.jpg +

mesh_mobileapps.jpg

-

On some android devices you may need to move the downloaded APK file from the Downloads directory to your home directory before you can install it.

-
-

Chat System

-
+
+

Chat System

+

Ensure that you're within wifi range of at least one other mesh peer (could be a router or client) and then you should see that the Chat and Other Users icons appear. Select the users icon and you should see a list of users on the mesh.

-
-

mesh_peerslist.png +

mesh_peerslist.png

-

Selecting a user followed by the Ok button will copy their Tox ID to the clipboard. @@ -450,49 +356,41 @@ Selecting a user followed by the Ok button will copy their Tox ID to the clipboa Now select the Chat icon and once you are connected you should see the status light turn green. If after a few minutes you don't get the green status light then try closing and re-opening the Tox chat application. Select the plus button to add a friend and then paste in a Tox ID.

-
-

mesh_paste_tox_id.jpg +

mesh_paste_tox_id.jpg

-

The other user can then accept or decline your friend request.

-
-

mesh_friend_request.jpg +

mesh_friend_request.jpg

-

You can also select an avatar by selecting the grey head and shoulders image.

-
-

mesh_choose_avatar.jpg +

mesh_choose_avatar.jpg

-

And by selecting the user from the list on the left hand side the chat can begin.

-
-

mesh_text_chat.jpg +

mesh_text_chat.jpg

-

One important point is that by default the microphone is turned off. When doing voice chat you can select the microphone volume with the drop down slider in the top right corner of the screen. @@ -504,32 +402,28 @@ At present video doesn't work reliably, but text and voice chat do work well.

-
-

Collaborative document editing

-
+
+

Collaborative document editing

+

The mesh system includes the ability to collaboratively edit various sorts of documents using CryptPad. CryptPad is an almost peer-to-peer system in that it is designed for a client/server environment but that the server aspect of it is very minimal and limited to orchestrating the connected clients. With CryptPad installed on each mesh peer it effectively enables peer-to-peer collaborative editing. Documents are ephemeral and forgotten unless they're exported or copy-pasted to permanent storage.

-
-

mesh_cryptpad1.jpg +

mesh_cryptpad1.jpg

-

To create a document click on the CryptPad icon. Depending upon the specifications of your system it may take a few seconds to load, so don't be too disturned if the browser contents look blank for a while. Select Rich Text Pad and give yourself a username.

-
-

mesh_cryptpad2.jpg +

mesh_cryptpad2.jpg

-

If you have the chat system running you can then copy and paste the URL for your pad into the chat, and the other user can then open the link and edit the document with you. You can repeat that for however many other users you wish to be able to edit. @@ -537,9 +431,9 @@ If you have the chat system running you can then copy and paste the URL for your

-
-

Social Network

-
+
+

Social Network

+

Patchwork is available as a social networking system for the mesh. Like all social network systems it has a stream of posts and you can follow or unfollow other users. You can also send private messages to other users with end-to-end encryption.

@@ -548,25 +442,21 @@ Patchwork is available as a social networking system for the mesh. Like all soci Double click on the "Social" icon to open the app, then add your nickname and optionally a description. If you want to choose an avatar image some can be found within the directory /usr/share/freedombone/avatars. On older systems or systems without a hardware random number generator, Patchwork sometimes takes a long time (a few minutes) to open for the first time after clicking the icon. This is most likely due to the initial generation of encryption keys, so be patient.

-
-

patchwork_setup.jpg +

patchwork_setup.jpg

-

Other Patchwork users on the mesh will appear automatically under the local list and you can select and follow them if you wish. It's also possible to select the dark theme from settings on the drop down menu if you prefer.

-
-

patchwork_public.jpg +

patchwork_public.jpg

-

The Secure Scuttlebutt protocol which Patchwork is based upon is intended to be robust to intermittent network connectivity, so you can write posts when out of range and they will sync once you are back in the network. @@ -574,68 +464,66 @@ The Secure Scuttlebutt protocol which Patchwork is based upon is intended to be

-
-

Sharing Files

-
+
+

Sharing Files

+

You can make files publicly available on the network simply by dragging and dropping them into the Public folder on the desktop. To view the files belonging to another user select the desktop icon called Visit a site and enter the username or Tox ID of the other user.

-
-

mesh_share_files.jpg +

mesh_share_files.jpg

-
-
-

Blogging

-
+
+

Blogging

+

To create a blog post select the Blog icon on the desktop and then select New blog entry and Ok. Edit the title of the entry and add your text. You can also include photos if you wish - just copy them to the CreateBlog/content/images directory and then link to them as shown.

-
-

mesh_blog.png +

mesh_blog.png

-

To finish your blog entry just select Save and then close the editor. On older hardware it may take a while to publish the results, and this depends upon the amount of computation needed by IPFS to create file hashes. If you make no changes to the default text then the new blog entry will not be saved.

-
-

mesh_new_blog2.jpg +

mesh_new_blog2.jpg

-
-
+
-

mesh_view_blog.jpg +

mesh_view_blog.jpg

-

You can also visit other blogs, edit or delete your previous entry and change your blog theme.

-
-

mesh_select_blog_theme.png +

mesh_select_blog_theme.png

+ + + +
+

gfdl.png +

diff --git a/website/EN/meshindex.html b/website/EN/meshindex.html index 30aecd5b..023e83e2 100644 --- a/website/EN/meshindex.html +++ b/website/EN/meshindex.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - - + + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,27 +144,35 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
-
-

Welcome to the Freedombone Mesh

+
+

Welcome to the Freedombone Mesh

+
+

The following apps are available: -

+

-
- - - - - -

Secure Scuttlebutt

Tox
-
+
+

+ <center> + <table style="width:80%; border:0"> + <tr> + <td><center><b><a href="ssb.apk"><img src="images/ssb.png"/></a></b><br><a href="ssb.apk">Secure Scuttlebutt</a></center></td> + <td><center><b><a href="trifa.apk"><img src="images/trifa.png"/></a></b><br><a href="trifa.apk">Tox</a></center></td> + </tr> +</table> +</center> +

+ +
+
+
diff --git a/website/EN/mobile.html b/website/EN/mobile.html index cc71090d..4eb61faa 100644 --- a/website/EN/mobile.html +++ b/website/EN/mobile.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - - + + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,50 +144,55 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

-
- -
-

Mobile

-
+
+

Mobile

+

Mobile phones are insecure devices, but they're regarded as being so essential to modern life that telling people not to use them isn't a viable option. Here are some recommendations on setting up a mobile phone (aka "smartphone") to work with Freedombone.

-
- - - - - - - - - - - - - - - - - - - - - -

Open


Use a free and open source operating system. Open means more trustworthy

Remove


If there are any proprietary apps then remove or deactivate them

Encrypt


Make sure your phone is encrypted with a password which isn't easy to guess

Apps


Use F-droid to install new apps

Lock


Enable a lock screen with a maximum number of password guesses

Onion


Onion route your connections to avoid bulk metadata collection

Email


Access webmail in a browser

Services


Connect to the Freedombone services

Battery


Avoid battery-eating apps and disable some optimisations

Block


Prevent access to know bad domains
-
+
+

+ <center> + <table style="width:80%; border:0"> + <tr> + <td><center><b><h3>Open</h3></b><br>Use a free and open source operating system. Open means more trustworthy</center></td> + <td><center><b><h3>Remove</h3></b><br>If there are any proprietary apps then remove or deactivate them</center></td> + </tr> + <tr> + <td><center><b><h3>Encrypt</h3></b><br>Make sure your phone is encrypted with a password which isn't easy to guess</center></td> + <td><center><b><h3>Apps</h3></b><br>Use F-droid to install new apps</center></td> + </tr> + <tr> + <td><center><b><h3>Lock</h3></b><br>Enable a lock screen with a maximum number of password guesses</center></td> + <td><center><b><h3>Onion</h3></b><br>Onion route your connections to avoid bulk metadata collection</center></td> + </tr> + <tr> + <td><center><b><h3>Email</h3></b><br>Access webmail in a browser</center></td> + <td><center><b><h3>Services</h3></b><br>Connect to the Freedombone services</center></td> + </tr> + <tr> + <td><center><b><h3>Battery</h3></b><br>Avoid battery-eating apps and disable some optimisations</center></td> + <td><center><b><h3>Block</h3></b><br>Prevent access to know bad domains</center></td> + </tr> +</table> +</center> +

-
-

Open

-
+
+
+
+ +
+

Open

+

Use a Linux based phone operating system. Typically this will mean Android, but could also mean LineageOS or Replicant. LineageOS is the most preferable, because you can usually get an up to date image with a recent kernel which will give you better security against exploits. If you're buying a phone then look for a model which is supported by LineageOS. Replicant is the most free (as in freedom) but only runs on a small number of phone models. If you have a phone which runs a full GNU/Linux system then that's fantastic, and you can probably use it in much the same way as a desktop system and the rest of the advice on this page won't apply. If you don't have a phone capable of running a Linux based operating system then consider selling, giving away or bartering your existing one.

@@ -294,27 +207,27 @@ In the end it comes down to the fact that if the source code for the device c
-
-

Remove

-
+
+

Remove

+

So maybe you're running Android and the phone came with some apps already installed. Almost certainly they'll be proprietary. Go to Settings/Apps and then uninstall or deactivate any apps which you really don't need. Mostly preinstalled apps are intended to send your data to companies who will then sell it to advertisers or governments under the business model of surveillance capital. It's not a good idea to get caught up in that, and to avoid becoming addicted to apps which are surveilling you without consent or installing spyware in the background without your knowledge.

-
-

Encrypt

-
+
+

Encrypt

+

Encrypt your phone. This can usually be done via Settings/Security and you may need to fully charge the phone first. Encryption means that if you lose your phone or it gets stolen then there is less chance that anyone who picks it up will get access to your data, photos and so on.

-
-

Apps

-
+
+

Apps

+

Installing F-droid and only adding any new apps via F-droid will ensure that you are always using free and open source software. Open source is not a panacea, since bugs can and do still occur, but it will help you to avoid the worst security and privacy pitfalls.

@@ -325,18 +238,18 @@ Avoid using the Open Whisper Systems Signal app if you can, no matter what "expe
-
-

Lock

-
+
+

Lock

+

Add a lock screen, preferably with a password which is not easy for other people to guess or for quicker access with a PIN number. Install an app called Locker, activate it and set the maximum number of password guesses to ten (or whatever you feel comfortable with). If bad people get hold of your phone then they may try to brute force your lock screen password or PIN (i.e. automatically trying millions of common word and number combinations) and the locker app will prevent them from succeeding by resetting the phone back to its factory default condition and wiping the data.

-
-

Onion

-
+
+

Onion

+

Both governments and corporations want to compile matadata dossiers about you. Who you communicated with, when and how often. They want this so that they can data mine, simulate, predict and then ultimately influence (sometimes also called "nudge") your actions and preferences in the directions they prefer. By routing your connections through a number of proxy servers (Tor routers) you can make it perhaps not theoretically impossible but at least very hard for them to have a complete and accurate list of who your friends are, your religion, politics, likely health issues, sexual orientation and what news sites or books you read.

@@ -347,26 +260,26 @@ In F-droid under the repositories menu you can enable the guardian pro
-
-

Email

-
+
+

Email

+

The easiest way to access email is by installing the Mailpile app. This keeps your GPG keys off of possibly insecure mobile devices but still enables encrypted email communications in an easy way. You can use K9 mail if you prefer, but that will require installing OpenKeychain and having your GPG keys on the device, which is a lot more risky.

-
-

Services

-
+
+

Services

+

-For information on configuring various apps to work with Freedombone see the usage section. Also see advice on chat apps in the FAQ. +For information on configuring various apps to work with Freedombone see the apps section. Also see advice on chat apps in the FAQ.

-
-

Battery

-
+
+

Battery

+

Even with free software apps it's not difficult to get into a situation where your battery doesn't last for long. To maximize battery life access RSS feeds via the onion-based mobile reader within a Tor-compatible browser and not from a locally installed RSS app.

@@ -385,9 +298,9 @@ It's also recommended to disable battery optimisations for Conversations and Orb
-
-

Blocking bad domains

-
+
+

Blocking bad domains

+

You can block known bad domains by editing the /system/etc/hosts file on your device. It is possible to use extensive ad-blocking hosts files used by other ad-blocking systems such as pi-hole, but merely blocking Facebook and Google Analytics will protect you against much of the corporate surveillance which goes on. Even if you don't have a Facebook account this may still be useful since they will still try to create a "ghost profile" of you, so the less data they have the better.

@@ -405,6 +318,7 @@ On your system (not the device) install the android-tools package. For ex

+
sudo pacman -S android-tools
 
@@ -414,6 +328,7 @@ Connect the device to your system via a USB cable, then:

+
adb root
 adb remount
 adb pull /system/etc/hosts
@@ -425,6 +340,7 @@ Now edit the hosts file which was pulled and append:
 

+
127.0.0.1       www.facebook.com
 127.0.0.1       facebook.com
 127.0.0.1       static.ak.fbcdn.net
@@ -449,6 +365,7 @@ Then upload the hosts file back again with:
 

+
adb push hosts /system/etc/hosts
 
@@ -457,9 +374,21 @@ Then upload the hosts file back again with: Once that's done you may want to set Root access on the device back to Disabled and turn Android debugging off.

-
-Return to the home page -
+
+

+<center> +Return to the <a href="index.html">home page</a> +</center> +

+ +
+ + + +
+

gfdl.png +

+
diff --git a/website/EN/related.html b/website/EN/related.html deleted file mode 100644 index 47da1bfd..00000000 --- a/website/EN/related.html +++ /dev/null @@ -1,305 +0,0 @@ - - - - - - - - - - - - - - - - - -
- -
-
-
- -
-

logo.png -

-
-
- -
-

Related Projects

-
- -
-The following projects made Freedombone possible.
- - - - - - - - - - - - - - - - - - - - - - - - - -
Nginx
Openssl
Gnupg
Debian
Freedombox
Beagleboard
Dokuwiki
GNU Social
Hubzilla
Tor
Prosody
Syncthing
Tox
Bettercrypto
-
-
-
- - - - -
- - diff --git a/website/EN/release3.html b/website/EN/release3.html index e78b461a..6f006557 100644 --- a/website/EN/release3.html +++ b/website/EN/release3.html @@ -3,33 +3,26 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - + + + + - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,18 +144,16 @@ for the JavaScript code in this tag.
-
+

-

release3.jpg +

release3.jpg

-
- -
-

Building an internet run by the users, for the users

-
+
+

Building an internet run by the users, for the users

+

The internet may still be mostly in the clutches of a few giant megacorporations and dubious governments with sketchy agendas, but it doesn't have to remain that way. With the third version of the Freedombone system there is now more scope than before to take back your privacy, have ownership of personal data and run your own online communities without undesirable intermediaries.

@@ -257,18 +163,27 @@ Freedombone version 3 is based on Debian 9 (Stretch). It was released in July 20

    -
  • Faster initial setup
  • -
  • More installable apps, including CryptPad, Koel, NextCloud, PostActiv, Friendica and Matrix/RiotWeb
  • -
  • Automated security tests
  • -
  • Improved XMPP configuration for support of the Conversations app features
  • -
  • Improved blocking controls for a better federated network experience
  • -
  • Uses elliptic curve based GPG keys for better performance on low power single board computers
  • -
  • Pre-downloaded repos distributed within images for faster and more autonomous app installs
  • +
  • Faster initial setup +
  • +
  • More installable apps, including CryptPad, Koel, NextCloud, PostActiv, Friendica and Matrix/RiotWeb +
  • +
  • Automated security tests +
  • +
  • Improved XMPP configuration for support of the Conversations app features +
  • +
  • Improved blocking controls for a better federated network experience +
  • +
  • Uses elliptic curve based GPG keys for better performance on low power single board computers +
  • +
  • Pre-downloaded repos distributed within images for faster and more autonomous app installs +
+
+
-
-

Installation

-
+
+

Installation

+

The simplest way to install is from a pre-made disk image. Images can be downloaded here. You will need to have previously obtained a domain name and have a dynamic DNS account somewhere.

@@ -278,9 +193,10 @@ Copy the image to a microSD card or USB thumb drive, replacing sdX with the iden

-
unxz downloadedimagefile.img.xz
-dd bs=1M if=downloadedimagefile.img of=/dev/sdX conv=fdatasync
-
+ +
unxz downloadedimagefile.img.xz
+dd bs=1M if=downloadedimagefile.img of=/dev/sdX conv=fdatasync
+

@@ -296,9 +212,10 @@ As the system boots for the first time the login is:

-
username: fbone
+
+
username: fbone
 password: freedombone
-
+

@@ -306,8 +223,9 @@ If you're installing from a microSD card on a single board computer without a sc

-
ssh fbone@freedombone.local -p 2222
-
+ +
ssh fbone@freedombone.local -p 2222
+

@@ -324,9 +242,9 @@ More detailed installation instructions are linked from t

-
-

Upgrading from a previous install

-
+
+

Upgrading from a previous install

+

To upgrade from the Debian Jessie version first create a master keydrive. Go to the Administrator control panel and select Backup and restore then Backup GPG key to USB (master keydrive). Insert a LUKS encrypted USB drive. When that is done Create a full backup by selecting Backup data to USB drive and using another LUKS encrypted USB drive.

diff --git a/website/EN/mirrors.html b/website/EN/release31.html similarity index 63% rename from website/EN/mirrors.html rename to website/EN/release31.html index 1e721178..608226ba 100644 --- a/website/EN/mirrors.html +++ b/website/EN/release31.html @@ -3,15 +3,15 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + - + - - + @@ -189,7 +97,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2017 Free Software Foundation, Inc. +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 @@ -236,21 +144,20 @@ for the JavaScript code in this tag.
-
+

-

logo.png +

logo.png

+ +
+

Support

-
-

Support

-
- -
-

Contact details

-
+
+

Contact details

+

This site can also be accessed via a Tor browser at http://yjxlc3imv7obva4grjae6u3qw527koaytrgjgdp364hmthrst3jodiid.onion

@@ -277,22 +184,21 @@ This site can also be accessed via a Tor browser at -

Things which would be nice to have

-
-
-
-

Ideas

-
+
+

Things which would be nice to have

+
+
+

Ideas

+

Know of some fabulous web system which could run on Freedombone, but currently doesn't? Contact the above, and be prepared to make a compelling argument for why it should be included.

-
-

Money

-
+
+

Money

+
-
-

Testing and reporting bugs

-
+
+

Testing and reporting bugs

+

Testing of the install on different hardware. Also pentesting on test installations to find vulnerabilities.

-
-

Web design and artwork

-
+ -
-

Howto videos

-
+
+

Howto videos

+

If you're good at making videos then a howto for installing Freedombone onto various types of hardware, or testing the mesh system in realistic/exotic scenarios would be good. You could even host videos on PeerTube or Mediagoblin.

-
-

More education and promotion

-
-
+
+

More education and promotion

+
-

educate.png +

educate.png

-
+

Many people are unaware that running their own internet services is even a possibility. Many also believe that internet services can be provided only if they're supported by advertising or donations, and that only gigantic data centres have enough computing capacity to serve web pages on a worldwide scale. Others may be fearful of encryption due to misrepresentations or misunderstandings of it in the mainstream media. Some may be intimidated by the apparent complexity and think that you need to be some sort of silicon valley genius in order to run a web service on your own. Even many technically-minded folks often believe that they can't run a home server unless they have a static IP address, which isn't true, and others are put off by thinking that any such server will be immediately pwned by blackhat hackers.

@@ -349,25 +254,27 @@ Raising awareness beyond the near zero current level, overcoming fear and parano
-
-

Translations

-
+
+

Translations

+

To add translations modify the json files within the locale subdirectory. Then make a pull request on the Github site.

-
-

Packaging

-
+
+

Packaging

+

Helping to package GNU Social and Hubzilla for Debian would be beneficial.

-
-Return to the home page -
+ +
+

gfdl.png +

+
diff --git a/website/EN/usage.html b/website/EN/usage.html deleted file mode 100644 index 5c35e3ce..00000000 --- a/website/EN/usage.html +++ /dev/null @@ -1,482 +0,0 @@ - - - - - - - - - - - - - - - - - -
- -
-
-
- -
-

logo.png -

-
-
- -
-

Usage

-
- - - - --- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Improving security
Administrating the system via an onion address (Tor)
Mobile advice
Using Email
Syncing to the Cloud
Play Music
Microblogging (GNU Social)
Microblogging (PostActiv)
Blogging with Ghost
Blogging with HTMLy
Social Network
Photo albums
Hosting video and audio content
Wiki
Collaborative document editing
Multi-user chat with IRC
XMPP/Jabber
Tox
Mumble
Mailpile
RSS Reader
CalDAV calendar server
Git Projects
Adding or removing users
Blocking Ads
Making and sharing notes and images
- -
-

Improving security

-
-

-It's a lot more secure to log in to the Freedombone system using ssh keys rather than with a password. You can set that up by first running: -

- -
-
freedombone-client
-
-
- -

-On your local system (i.e. whatever you're logging in to the Freedombone system from, typically a laptop). Then: -

- -
-ssh myusername@freedombone.local -p 2222
-
- -

-Select Administrator controls and re-enter your password, then Manage Users and Change user ssh public key. Copy and paste the ssh public keys which appeared after the freedombone-client command was run. Then go to Security settings and select Allow ssh login with passwords followed by no. -

- -

-You'll need to make sure that you have a copy of the ~/.ssh directory on your local system. You could just copy that directory to a USB drive and then keep that somewhere safe so that you can restore the keys if you need to. -

-
-
-
-

Administrating the system via an onion address (Tor)

-
-

-You can also access your system via the Tor system using an onion address. To find out what the onion address for ssh access is you can do the following: -

- -
-
ssh username@freedombone.local -p 2222
-
-
- -

-Select Administrator controls then select "About this system" and look for the onion address for ssh. You can then close the terminal and open another, then do the following on your local system: -

- -
-
freedombone-client
-
-
- -

-This will set up your ssh environment to be able to handle onion addresses. Then you can test ssh with: -

- -
-
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. -

-
-
-
-

Adding or removing users

-
-

-Log into the system with: -

- -
-
ssh username@domainname -p 2222
-
-
- -

-Select Administrator controls then User Management. Depending upon the type of installation after selecting administrator controls you might need to enter: -

- -
-
sudo su
-control
-
-
- - -
-

control_panel_manage_users.jpg -

-
-
-
-
-
- - - - -
- - diff --git a/website/EN/usage_email.html b/website/EN/usage_email.html index 28b814e9..67bdfd5f 100644 --- a/website/EN/usage_email.html +++ b/website/EN/usage_email.html @@ -3,26 +3,33 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - + + + + + + - + @@ -97,7 +189,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2013 Free Software Foundation, Inc. +Copyright (C) 2012-2017 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 @@ -144,71 +236,68 @@ for the JavaScript code in this tag.
-

-
-

logo.png +

logo.png

-
-+ - + - + - + - + - + - + - + - + - + - + - +
Things to be aware ofThings to be aware of
A technical note about email transport securityA technical note about email transport security
Add a password to your GPG keyAdd a password to your GPG key
Publishing your GPG public keyPublishing your GPG public key
Mutt email clientMutt email client
Thunderbird/IcedoveThunderbird/Icedove
Android appsAndroid apps
Subscribing to mailing listsSubscribing to mailing lists
Adding email addresses to a group/folderAdding email addresses to a group/folder
Ignoring incoming emailsIgnoring incoming emails
Using I2P for email transportUsing I2P for email transport
-
-

Things to be aware of

-
+
+

Things to be aware of

+

Even though this system makes it easy to set up an email server, running your own email system is still not easy and this is mainly due to the huge amount of collatoral damage caused by spammers over a long period of time, which in turn is due to the inherent insecurity of email protocols which enabled spam to become a big problem. Email is still very popular though and most internet services require that you have an email address in order to register.

@@ -222,9 +311,9 @@ So if you want to use your own email address hosted on your own system you do ne

-
-

A technical note about email transport security

-
+
+

A technical note about email transport security

+

Port 465 is used for SMTP and this is supposedly deprecated for secure email. However, using TLS from the start of the communications seems far more secure than starting off with insecure communications and then trying to upgrade it with a command to begin TLS, as happens with STARTTLS. There are possible attacks against STARTTLS in which the command to begin secure communications is removed or overwritten which could then result in email being transferred in plain text over the internet and be readable by third parties.

@@ -238,23 +327,26 @@ From http The researchers also uncovered mass scale attacks of STARTTLS sessions being stripped of their encryption. That attack itself isn't new: internet service providers sometimes do it to monitor users; organizations may use it to keep an eye on employees; or it may come from a malicious actor

+ +

+A way to avoid these pitfalls altogether is to use onion addresses (see the section below) or I2P addresses for email. These are not so convenient because they use long random strings which aren't memorable as addresses, but they do give a strong assurance that whoever recieves the message is the intended recipient and that emails can't be read passively during their transport across the internet. +

-
-

Add a password to your GPG key

-
+
+

Add a password to your GPG key

+

If you didn't use existing GPG keys during the Freedombone installation then you'll need to add a password to your newly generated private key. This is highly recommended. Go through the following sequence of commands to ssh into the Freedombone and then change your GPG password.

-
ssh username@domainname -p 2222
 gpg --edit-key username@domain
 passwd
 save
 quit
-exit
+exit
 
@@ -264,39 +356,35 @@ Having a password on your GPG key will prevent someone from reading your email <
-
-

Publishing your GPG public key

-
+
+

Publishing your GPG public key

+

If you havn't already then you should publish your GPG public key so that others can find it.

-
ssh username@domainname -p 2222
 gpg --send-keys username@domainname
-exit
+exit
 
-
-

Mutt email client

-
-
+
+

Mutt email client

+
-

mutt.jpeg +

mutt.jpeg

-

Mutt is a terminal based email client which comes already installed onto the Freedombone. To access it you'll need to access it via ssh with:

-
ssh username@domainname -p 2222
 
@@ -317,124 +405,124 @@ Some useful keys to know are: - + - + -"/" -Search for text within headers +"/" +Search for text within headers -* -Move to the last message +* +Move to the last message -TAB -Move to the next unread message +TAB +Move to the next unread message -d -Delete a message +d +Delete a message -u -Undelete a mail which is pending deletion +u +Undelete a mail which is pending deletion -$ -Delete all messages selected and check for new messages +$ +Delete all messages selected and check for new messages -a -Add to the address book +a +Add to the address book -m -Send a new mail +m +Send a new mail -ESC-m -Mark all messages as having been read +ESC-m +Mark all messages as having been read -S -Mark a message as spam +S +Mark a message as spam -H -Mark a message as ham +H +Mark a message as ham -CTRL-b -Toggle side bar on/off +CTRL-b +Toggle side bar on/off -CTRL-n -Next mailbox (on side bar) +CTRL-n +Next mailbox (on side bar) -CTRL-p -Previous mailbox (on side bar) +CTRL-p +Previous mailbox (on side bar) -CTRL-o -Open mailbox (on side bar) +CTRL-o +Open mailbox (on side bar) -r -Reply to an email +r +Reply to an email -L -Reply to a mailing list email +L +Reply to a mailing list email -] -Expand or collapse all threads +] +Expand or collapse all threads -[ -Expand of collapse the current thread +[ +Expand of collapse the current thread -CTRL-k -Import a PGP/GPG public key +CTRL-k +Import a PGP/GPG public key -v -View current email in different formats, such as HTML +v +View current email in different formats, such as HTML -CTRL-u -View long URLs +CTRL-u +View long URLs -q -Quit +q +Quit @@ -457,9 +545,9 @@ There is one irksome thing about email within mutt, and that's if you get sent a
-
-

Thunderbird/Icedove

-
+
+

Thunderbird/Icedove

+

Another common way in which you may want to access email is via Thunderbird (also known as Icedove on Debian). This may be especially useful if you're trying to convert former Windows users who may previously have been using some version of Outlook.

@@ -469,9 +557,9 @@ The following instructions should be carried out on the client machines (laptop,

-
-

Initial setup

-
+
+

Initial setup

+

Install Thunderbird and Enigmail. How you do this just depends upon your distro and software manager or "app store".

@@ -497,12 +585,9 @@ The settings should be as follows, substituting mydomainname.com for your

    -
  • Incoming: IMAP, mydomainname.com, 993, SSL/TLS, Normal Password -
  • -
  • Outgoing: SMTP, mydomainname.com, 465, SSL/TLS, Normal Password -
  • -
  • Username: myusername -
  • +
  • Incoming: IMAP, mydomainname.com, 993, SSL/TLS, Normal Password
  • +
  • Outgoing: SMTP, mydomainname.com, 465, SSL/TLS, Normal Password
  • +
  • Username: myusername

@@ -530,15 +615,14 @@ Select "yes" to change default settings.

-
-

Import your GPG keys

-
+
+

Import your GPG keys

+

On the Freedombone export your GPG public and private keys.

-
ssh username@domainname -p 2222
 gpg --list-keys username@domainname
 gpg --output ~/public_key.gpg --armor --export KEY_ID
@@ -551,7 +635,6 @@ On your laptop or desktop you can import the keys with:
 

-
scp -P 2222 username@domain:/home/username/*.gpg ~/
 
@@ -573,7 +656,6 @@ Remove your exported key files, both on your laptop/desktop and also on the Free

-
shred -zu ~/public_key.gpg
 shred -zu ~/private_key.gpg
 
@@ -581,9 +663,9 @@ shred -zu ~/private_key.gpg
-
-

Using for the first time

-
+
+

Using for the first time

+

Click on the Thunderbird menu, which looks like three horizontal bars on the right hand side.

@@ -618,9 +700,9 @@ Get into the habit of using email encryption and encourage others to do so. Rem
-
-

Making folders visible

-
+
+

Making folders visible

+

By default you won't be able to see any folders which you may have created earlier using the mailinglistrule script. To make folders visible select:

@@ -636,23 +718,22 @@ Make sure that "show only subscribed folders" is not checked. Then click
-
-

Android apps

-
+
+

Android apps

+

Mobile devices have a reputation for being quite insecure, so it's recommended that you don't store emails or GPG keys on your phone. Instead install Mailpile and access your email via the webmail interface.

-
-

Subscribing to mailing lists

-
+
+

Subscribing to mailing lists

+

To subscribe to a mailing list log in as your user (i.e. not the root user).

-
ssh username@domainname -p 2222
 
@@ -662,15 +743,14 @@ Select Administrator controls then Email filtering rules then A

-
-

Adding email addresses to a group/folder

-
+
+

Adding email addresses to a group/folder

+

Similar to adding mailing list folders you can also add specified email addresses into a group/folder.

-
ssh username@domainname -p 2222
 
@@ -680,15 +760,14 @@ Select Administrator controls then Email filtering rules then A

-
-

Ignoring incoming emails

-
+
+

Ignoring incoming emails

+

It is possible to ignore incoming emails if they are from a particular email address or if the subject line contains particular text.

-
ssh username@domainname -p 2222
 
@@ -698,9 +777,29 @@ Select Administrator controls then Email filtering rules then B

-
-

Using I2P for email transport

-
+
+

Using onion email addresses

+
+

+By default this system comes with the ability to send and receive emails using onion addresses as the domain name. On the user control panel if you select Show your email address then you should find one ending with dot onion. You will also see a QR code for that address, which provides a simple way to transfer it to a mobile phone if necessary. +

+ +

+If you want to give your onion email address to someone else securely then you can use the QR code to transfer it to a phone and copy and paste the address into an encrypted chat app, such as Conversations. Of course they will probably also need to be running Freedombone or some system capable of handling onion email addresses. +

+ +

+When sending email from an onion address it's not strictly necessary to use GPG/PGP. Tor handles the transport security by itself. You can still use it though if you prefer to have an extra layer of message security. You can also still use onion email addresses even if your ISP blocks the typical email ports (25 and 465). +

+ +

+If you don't make your onion email address public then it should be fairly resisent to spam, since spammers won't be able to randomly guess onion addresses (there are far too many), whereas it's a lot easier for them to do that with conventional domain names. +

+
+
+
+

Using I2P for email transport

+

For the most paranoid use cases it is also possible to use I2P as an email transport mechanism. This will of course require the people you're communicating with to have a similar setup in place. For details see the bdsmail app. An advantage of this is that it's very unlikely that your email will get blocked. The disadvantage is that few others will be capable of receiving email this way, and it's only really usable via the Mutt email client.

diff --git a/website/EN/users.html b/website/EN/users.html index 5532e051..62f1e7b7 100644 --- a/website/EN/users.html +++ b/website/EN/users.html @@ -4,7 +4,7 @@ - + @@ -145,13 +145,11 @@ for the JavaScript code in this tag.

-
-

logo.png +

logo.png

-

Log into the system with: @@ -169,7 +167,13 @@ Select Administrator controls then User Management.

-

control_panel_manage_users.jpg +

control_panel_manage_users.jpg +

+
+ + +
+

gfdl.png

diff --git a/website/EN/variants.html b/website/EN/variants.html deleted file mode 100644 index 8fed739a..00000000 --- a/website/EN/variants.html +++ /dev/null @@ -1,308 +0,0 @@ - - - - - - - - - - - - - - - - - -
- -
-
-
- -
-

logo.png -

-
-
- -
-

Variants

-
- -

-Freedombone may be installed either in its entirety or as different variants with a more specialised purpose. So for example if you just want to run a blog but don't care about any other services then you can do that. The following variants are available: -

- -
- - - - - - - - - - - - - - - - - -
Mailbox
An email server with GPG encryption
Cloud
Sync and share files. Never lose important files again
Social
Social networking with Hubzilla and GNU Social
Media
Runs media services such as DLNA to play music or videos on your devices
Writer
Host your blog and wiki
Chat
Encrypted IRC, XMPP, Tox and VoIP services for one-to-one and many-to-many chat
Developer
Github-like system to host your software projects
Mesh
A wireless mesh network which is like the internet, but not the internet
-
- -

-Non-mesh installs also come with an RSS reader which provides strong reading privacy on desktop and mobile via the use of a Tor onion service. -

- -
-Return to the home page -
-
-
- - - - -
- - diff --git a/website/freedombone.css b/website/freedombone.css index 4067b8f0..270ded04 100644 --- a/website/freedombone.css +++ b/website/freedombone.css @@ -42,7 +42,6 @@ img.resize{ } img { - width: 90%; float: center; clear: right; padding: 10px;