From b28b1f50db3056a4c6ad7cc39f50110f2ca321ff Mon Sep 17 00:00:00 2001 From: James Valleroy Date: Tue, 4 Sep 2018 21:58:28 -0400 Subject: [PATCH] Fetch manual pages from wiki Signed-off-by: James Valleroy --- doc/Configure.raw.xml | 264 +--- doc/Coquelicot.raw.xml | 264 +--- doc/DateTime.raw.xml | 213 +--- doc/Deluge.raw.xml | 311 +---- doc/Diagnostics.raw.xml | 197 +-- doc/DynamicDNS.raw.xml | 401 +----- doc/Firewall.raw.xml | 2223 +-------------------------------- doc/Ikiwiki.raw.xml | 327 +---- doc/LetsEncrypt.raw.xml | 324 +---- doc/MatrixSynapse.raw.xml | 238 +--- doc/MediaWiki.raw.xml | 305 +---- doc/Minetest.raw.xml | 217 +--- doc/Monkeysphere.raw.xml | 197 +-- doc/Mumble.raw.xml | 244 +--- doc/NameServices.raw.xml | 207 +-- doc/Networks.raw.xml | 615 +-------- doc/OpenVPN.raw.xml | 294 +---- doc/PageKite.raw.xml | 293 +---- doc/Power.raw.xml | 202 +-- doc/Privoxy.raw.xml | 320 +---- doc/Quassel.raw.xml | 316 +---- doc/Radicale.raw.xml | 635 +--------- doc/Repro.raw.xml | 286 +---- doc/Roundcube.raw.xml | 233 +--- doc/Searx.raw.xml | 279 +---- doc/SecureShell.raw.xml | 324 +---- doc/Security.raw.xml | 213 +--- doc/ServiceDiscovery.raw.xml | 204 +-- doc/Shadowsocks.raw.xml | 221 +--- doc/Snapshots.raw.xml | 217 +--- doc/Storage.raw.xml | 243 +--- doc/Syncthing.raw.xml | 264 +--- doc/TinyTinyRSS.raw.xml | 401 +----- doc/Tor.raw.xml | 338 +---- doc/Transmission.raw.xml | 272 +--- doc/Upgrades.raw.xml | 240 +--- doc/Users.raw.xml | 236 +--- doc/ejabberd.raw.xml | 297 +---- doc/freedombox-manual.raw.xml | 4 +- 39 files changed, 178 insertions(+), 12701 deletions(-) diff --git a/doc/Configure.raw.xml b/doc/Configure.raw.xml index 3de5bb86a..ddedc95bd 100644 --- a/doc/Configure.raw.xml +++ b/doc/Configure.raw.xml @@ -1,261 +1,5 @@ - -
- - FreedomBox/Manual/Configure - - - 7 - 2018-07-25 08:38:53 - JosephNuthalapati - Remove /home as an alias to /freedombox - - - 6 - 2018-07-24 17:51:28 - SunilMohanAdapa - Rename FreedomBox Plinth to FreedomBox Service (Plinth) - - - 5 - 2018-07-24 16:12:49 - JosephNuthalapati - Add tip about bookmarking FreedomBox Plinth - - - 4 - 2018-07-24 13:52:47 - JosephNuthalapati - Add wiki entry about Default App - - - 3 - 2016-12-31 04:11:43 - JamesValleroy - mention how domain name is used - - - 2 - 2016-12-31 04:07:26 - JamesValleroy - fix outline - - - 1 - 2016-08-21 16:35:55 - Drahtseil - Created Configure - - - -
- Configure - Configure has some general configuration options: - - - Hostname - - - Hostname is the local name by which other devices on the local network can reach your FreedomBox. Default is freedombox. - - - - - Domain Name - - - Domain name is the global name by which other devices on the Internet can reach your FreedomBox. The value set here is used by the Chat Server (XMPP), Certificates (Let's Encrypt), and Monkeysphere. - - - - - Default App - - - This is an advanced option that allows you to set something other than FreedomBox Service (Plinth) as the default application to be served on the domain name of the FreedomBox. For example, if your FreedomBox's domain name is and you set MediaWiki as the default app, visiting will take you to instead of the usual . Only web applications served from FreedomBox are allowed as choices. - - - Warning: Once some other app is set as the default app, you can only navigate to the FreedomBox Service (Plinth) by typing into the browser. /freedombox can also be used as an alias to /plinth - - - Tip: Bookmark the URL of FreedomBox Service (Plinth) before changing the default app to some other app. - - - - - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
+ +
FreedomBox/Manual/Configure72018-07-25 08:38:53JosephNuthalapatiRemove /home as an alias to /freedombox62018-07-24 17:51:28SunilMohanAdapaRename FreedomBox Plinth to FreedomBox Service (Plinth)52018-07-24 16:12:49JosephNuthalapatiAdd tip about bookmarking FreedomBox Plinth42018-07-24 13:52:47JosephNuthalapatiAdd wiki entry about Default App32016-12-31 04:11:43JamesValleroymention how domain name is used22016-12-31 04:07:26JamesValleroyfix outline12016-08-21 16:35:55DrahtseilCreated Configure
ConfigureConfigure has some general configuration options: Hostname Hostname is the local name by which other devices on the local network can reach your FreedomBox. Default is freedombox. Domain Name Domain name is the global name by which other devices on the Internet can reach your FreedomBox. The value set here is used by the Chat Server (XMPP), Certificates (Let's Encrypt), and Monkeysphere. Default App This is an advanced option that allows you to set something other than FreedomBox Service (Plinth) as the default application to be served on the domain name of the FreedomBox. For example, if your FreedomBox's domain name is and you set MediaWiki as the default app, visiting will take you to instead of the usual . Only web applications served from FreedomBox are allowed as choices. Warning: Once some other app is set as the default app, you can only navigate to the FreedomBox Service (Plinth) by typing into the browser. /freedombox can also be used as an alias to /plinth Tip: Bookmark the URL of FreedomBox Service (Plinth) before changing the default app to some other app. Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/Coquelicot.raw.xml b/doc/Coquelicot.raw.xml index b6e630664..dbce993b6 100644 --- a/doc/Coquelicot.raw.xml +++ b/doc/Coquelicot.raw.xml @@ -1,261 +1,5 @@ - -
- - FreedomBox/Manual/Coquelicot - - - 5 - 2018-03-05 09:15:01 - JosephNuthalapati - coquelicot: Fix broken links - - - 4 - 2018-02-26 17:14:51 - JamesValleroy - included in 0.24 - - - 3 - 2018-02-12 23:48:10 - JamesValleroy - bump version - - - 2 - 2018-02-12 23:47:14 - JamesValleroy - replace fancy quote characters with plain quote characters - - - 1 - 2018-02-10 03:14:55 - JosephNuthalapati - Create new page for Coquelicot - - - -
- File Sharing (Coquelicot) -
- About Coquelicot - Coquelicot is a "one-click" file sharing web application with a focus on protecting users' privacy. - Read more about Coquelicot at the Coquelicot README - Available since: version 0.24.0 -
-
- When to use Coquelicot - Coquelicot is best used to quickly share a single file. If you want to share a folder, - - - for a single use, compress the folder and share it over Coquelicot - - - which must be kept synchronized between computers, use Syncthing instead - - - Coquelicot can only provide a reasonable degree of privacy. If anonymity is required, you should consider using the desktop application Onionshare instead. - Since Coquelicot fully uploads the file to the server, your FreedomBox will incur both upload and download bandwidth costs. For very large files, consider sharing them using BitTorrent by creating a private torrent file. If anonymity is required, use Onionshare. It is P2P and doesn't require a server. -
-
- Coquelicot on FreedomBox - With Coquelicot installed, you can upload files to your FreedomBox server and privately share them. - Post installation, the Coquelicot page offers two settings. - - - Upload Password: Coquelicot on FreedomBox is currently configured to use simple password authentication for ease of use. Remember that it's one global password for this Coquelicot instance and not your user password for FreedomBox. You need not remember this password. You can set a new one from the Plinth interface anytime. - - - Maximum File Size: You can alter the maximum size of the file that can be transferred through Coquelicot using this setting. The size is in Mebibytes. The maximum file size is only limited by the disk size of your FreedomBox. - - -
-
- Privacy - Someone monitoring your network traffic might find out that some file is being transferred through your FreedomBox and also possibly its size, but will not know the file name. Coquelicot encrypts files on the server and also fills the file contents with 0s when deleting them. This eliminates the risk of file contents being revealed in the event of your FreedomBox being confiscated or stolen. The real risk to mitigate here is a third-party also downloading your file along with the intended recipient. -
- Sharing over instant messengers - Some instant messengers which have previews for websites might download your file in order to show a preview in the conversation. If you set the option of one-time download on a file, you might notice that the one download will be used up by the instant messenger. If sharing over such messengers, please use a download password in combination with a one-time download option. -
-
- Sharing download links privately - It is recommended to share your file download links and download passwords over encrypted channels. You can simply avoid all the above problems with instant messenger previews by using instant messengers that support encrypted conversations like Riot with Matrix Synapse or XMPP (ejabberd server on FreedomBox) with clients that support end-to-end encryption. Send the download link and the download password in two separate messages (helps if your messenger supports perfect forward secrecy like XMPP with OTR). You can also share your links over PGP-encrypted email using Thunderbird. - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
-
+ +
FreedomBox/Manual/Coquelicot52018-03-05 09:15:01JosephNuthalapaticoquelicot: Fix broken links42018-02-26 17:14:51JamesValleroyincluded in 0.2432018-02-12 23:48:10JamesValleroybump version22018-02-12 23:47:14JamesValleroyreplace fancy quote characters with plain quote characters12018-02-10 03:14:55JosephNuthalapatiCreate new page for Coquelicot
File Sharing (Coquelicot)
About CoquelicotCoquelicot is a "one-click" file sharing web application with a focus on protecting users' privacy. Read more about Coquelicot at the Coquelicot README Available since: version 0.24.0
When to use CoquelicotCoquelicot is best used to quickly share a single file. If you want to share a folder, for a single use, compress the folder and share it over Coquelicot which must be kept synchronized between computers, use Syncthing instead Coquelicot can only provide a reasonable degree of privacy. If anonymity is required, you should consider using the desktop application Onionshare instead. Since Coquelicot fully uploads the file to the server, your FreedomBox will incur both upload and download bandwidth costs. For very large files, consider sharing them using BitTorrent by creating a private torrent file. If anonymity is required, use Onionshare. It is P2P and doesn't require a server.
Coquelicot on FreedomBoxWith Coquelicot installed, you can upload files to your FreedomBox server and privately share them. Post installation, the Coquelicot page offers two settings. Upload Password: Coquelicot on FreedomBox is currently configured to use simple password authentication for ease of use. Remember that it's one global password for this Coquelicot instance and not your user password for FreedomBox. You need not remember this password. You can set a new one from the Plinth interface anytime. Maximum File Size: You can alter the maximum size of the file that can be transferred through Coquelicot using this setting. The size is in Mebibytes. The maximum file size is only limited by the disk size of your FreedomBox.
PrivacySomeone monitoring your network traffic might find out that some file is being transferred through your FreedomBox and also possibly its size, but will not know the file name. Coquelicot encrypts files on the server and also fills the file contents with 0s when deleting them. This eliminates the risk of file contents being revealed in the event of your FreedomBox being confiscated or stolen. The real risk to mitigate here is a third-party also downloading your file along with the intended recipient.
Sharing over instant messengersSome instant messengers which have previews for websites might download your file in order to show a preview in the conversation. If you set the option of one-time download on a file, you might notice that the one download will be used up by the instant messenger. If sharing over such messengers, please use a download password in combination with a one-time download option.
Sharing download links privatelyIt is recommended to share your file download links and download passwords over encrypted channels. You can simply avoid all the above problems with instant messenger previews by using instant messengers that support encrypted conversations like Riot with Matrix Synapse or XMPP (ejabberd server on FreedomBox) with clients that support end-to-end encryption. Send the download link and the download password in two separate messages (helps if your messenger supports perfect forward secrecy like XMPP with OTR). You can also share your links over PGP-encrypted email using Thunderbird. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox CategoryFreedomBox
\ No newline at end of file diff --git a/doc/DateTime.raw.xml b/doc/DateTime.raw.xml index 8d011c978..9ad654c24 100644 --- a/doc/DateTime.raw.xml +++ b/doc/DateTime.raw.xml @@ -1,210 +1,5 @@ - -
- - FreedomBox/Manual/DateTime - - - 2 - 2017-03-31 20:20:57 - Drahtseil - Screenshot DateTime - - - 1 - 2016-08-21 09:26:45 - Drahtseil - Created Date & Time - - - -
- Date & Time - This network time server is a program that maintains the system time in synchronization with servers on the Internet. - You can select your time zone by picking a big city nearby (they are sorted by Continent/City) or select directly the zone with respect to GMT (Greenwich Mean Time). - - - - - - - DateTime.png - - - - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
+ +
FreedomBox/Manual/DateTime22017-03-31 20:20:57DrahtseilScreenshot DateTime12016-08-21 09:26:45DrahtseilCreated Date & Time
Date & TimeThis network time server is a program that maintains the system time in synchronization with servers on the Internet. You can select your time zone by picking a big city nearby (they are sorted by Continent/City) or select directly the zone with respect to GMT (Greenwich Mean Time). DateTime.png Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/Deluge.raw.xml b/doc/Deluge.raw.xml index 76f6de394..d1bf93934 100644 --- a/doc/Deluge.raw.xml +++ b/doc/Deluge.raw.xml @@ -1,308 +1,5 @@ - -
- - FreedomBox/Manual/Deluge - - - 11 - 2016-12-31 01:32:15 - JamesValleroy - add initial setup directions - - - 10 - 2016-12-30 19:20:00 - JamesValleroy - reword - - - 9 - 2016-12-30 19:14:16 - JamesValleroy - add intro paragraph - - - 8 - 2016-12-30 19:00:50 - JamesValleroy - no space in "BitTorrent" - - - 7 - 2016-12-26 18:07:46 - JamesValleroy - add screenshot - - - 6 - 2016-09-01 19:05:24 - Drahtseil - adapted title to Plinth wording - - - 5 - 2016-04-10 07:26:48 - PhilippeBaret - Added bottom navigation link - - - 4 - 2015-12-15 20:41:02 - PhilippeBaret - Correction - - - 3 - 2015-12-15 20:40:16 - PhilippeBaret - Correction - - - 2 - 2015-12-15 18:16:28 - PhilippeBaret - Added Deluge definition - - - 1 - 2015-12-15 16:59:01 - PhilippeBaret - Created new Deluge page for manual - - - -
- BitTorrent (Deluge) -
- What is Deluge? - BitTorrent is a communications protocol using peer-to-peer (P2P) file sharing. It is not anonymous; you should assume that others can see what files you are sharing. There are two BitTorrent web clients available in FreedomBox: Transmission and Deluge. They have similar features, but you may prefer one over the other. - Deluge is a lightweight BitTorrent client that is highly configurable. Additional functionality can be added by installing plugins. -
-
- Screenshot - - - - - - - Deluge Web UI - - - -
-
- Initial Setup - After installing Deluge, it can be accessed by pointing your browser to https://<your freedombox>/deluge. You will need to enter a password to login: - - - - - - - Deluge Login - - - - The initial password is "deluge". The first time that you login, Deluge will ask if you wish to change the password. You should change it to something that is harder to guess. - Next you will be shown the connection manager. Click on the first entry (Offline - 127.0.0.1:58846). Then click "Start Daemon" to start the Deluge service that will run in the background. - - - - - - - Deluge Connection Manager (Offline) - - - - Now it should say "Online". Click "Connect" to complete the setup. - - - - - - - Deluge Connection Manager (Online) - - - - At this point, you are ready to begin using Deluge. You can make further changes in the Preferences, or add a torrent file or URL. - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
+ +
FreedomBox/Manual/Deluge112016-12-31 01:32:15JamesValleroyadd initial setup directions102016-12-30 19:20:00JamesValleroyreword92016-12-30 19:14:16JamesValleroyadd intro paragraph82016-12-30 19:00:50JamesValleroyno space in "BitTorrent"72016-12-26 18:07:46JamesValleroyadd screenshot62016-09-01 19:05:24Drahtseiladapted title to Plinth wording52016-04-10 07:26:48PhilippeBaretAdded bottom navigation link42015-12-15 20:41:02PhilippeBaretCorrection32015-12-15 20:40:16PhilippeBaretCorrection22015-12-15 18:16:28PhilippeBaretAdded Deluge definition12015-12-15 16:59:01PhilippeBaretCreated new Deluge page for manual
BitTorrent (Deluge)
What is Deluge?BitTorrent is a communications protocol using peer-to-peer (P2P) file sharing. It is not anonymous; you should assume that others can see what files you are sharing. There are two BitTorrent web clients available in FreedomBox: Transmission and Deluge. They have similar features, but you may prefer one over the other. Deluge is a lightweight BitTorrent client that is highly configurable. Additional functionality can be added by installing plugins.
ScreenshotDeluge Web UI
Initial SetupAfter installing Deluge, it can be accessed by pointing your browser to https://<your freedombox>/deluge. You will need to enter a password to login: Deluge Login The initial password is "deluge". The first time that you login, Deluge will ask if you wish to change the password. You should change it to something that is harder to guess. Next you will be shown the connection manager. Click on the first entry (Offline - 127.0.0.1:58846). Then click "Start Daemon" to start the Deluge service that will run in the background. Deluge Connection Manager (Offline) Now it should say "Online". Click "Connect" to complete the setup. Deluge Connection Manager (Online) At this point, you are ready to begin using Deluge. You can make further changes in the Preferences, or add a torrent file or URL. Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/Diagnostics.raw.xml b/doc/Diagnostics.raw.xml index f3af6c92d..193e9778c 100644 --- a/doc/Diagnostics.raw.xml +++ b/doc/Diagnostics.raw.xml @@ -1,194 +1,5 @@ - -
- - FreedomBox/Manual/Diagnostics - - - 1 - 2016-08-21 09:43:52 - Drahtseil - Created Diagnostics - - - -
- Diagnostics - The system diagnostic test will run a number of checks on your system to confirm that applications and services are working as expected. - Just click Run Diagnostics. This may take some minutes. - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
+ +
FreedomBox/Manual/Diagnostics12016-08-21 09:43:52DrahtseilCreated Diagnostics
DiagnosticsThe system diagnostic test will run a number of checks on your system to confirm that applications and services are working as expected. Just click Run Diagnostics. This may take some minutes. Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/DynamicDNS.raw.xml b/doc/DynamicDNS.raw.xml index 65bebb355..422a7092f 100644 --- a/doc/DynamicDNS.raw.xml +++ b/doc/DynamicDNS.raw.xml @@ -1,398 +1,5 @@ - -
- - FreedomBox/Manual/DynamicDNS - - - 14 - 2018-03-11 03:11:04 - JosephNuthalapati - Fix oversized image - - - 13 - 2017-03-31 20:35:42 - Drahtseil - updated screenshot - - - 12 - 2016-09-09 15:40:08 - SunilMohanAdapa - Minor indentation fix with screenshot - - - 11 - 2016-09-01 19:18:48 - Drahtseil - adapted title to Plinth wording - - - 10 - 2016-08-15 18:46:51 - Drahtseil - Screenshot GNU-DIP - - - 9 - 2016-04-14 14:22:41 - PhilippeBaret - Added accurate How to create a DNS name with GnuDIP - - - 8 - 2016-04-10 07:15:47 - PhilippeBaret - Added bottom navigation link - - - 7 - 2016-01-11 06:28:36 - PhilippeBaret - Correction - - - 6 - 2015-12-15 18:48:25 - PhilippeBaret - Added definition title to Dynamic DNS page - - - 5 - 2015-09-13 15:02:37 - SunilMohanAdapa - Demote headings one level for inclusion into manual - - - 4 - 2015-09-13 13:14:41 - SunilMohanAdapa - Move DynamicDNS page to manual - - - 3 - 2015-08-13 13:03:13 - SunilMohanAdapa - Add more introduction and re-organize. - - - 2 - 2015-08-09 21:38:52 - DanielSteglich - - - 1 - 2015-08-09 21:23:48 - DanielSteglich - - - -
- Dynamic DNS Client -
- What is Dynamic DNS? - In order to reach a server on the Internet, the server needs to have permanent address also know as the static IP address. Many Internet service providers don't provide home users with a static IP address or they charge more providing a static IP address. Instead they provide the home user with an IP address that changes every time the user connects to the Internet. Clients wishing to contact the server will have difficulty reaching the server. - Dynamic DNS service providers assist in working around a problem. First they provide you with a domain name, such as 'myhost.example.org'. Then they associate your IP address, whenever it changes, with this domain name. Then anyone intending to reach the server will be to contact the server using the domain name 'myhost.example.org' which always points to the latest IP address of the server. - For this to work, every time you connect to the Internet, you will have to tell your Dynamic DNS provider what your current IP address is. Hence you need special software on your server to perform this operation. The Dynamic DNS function in FreedomBox will allow users without a static public IP address to push the current public IP address to a Dynamic DNS Server. This allows you to expose services on FreedomBox, such as ownCloud, to the Internet. -
-
- GnuDIP vs. Update URL - There are two main mechanism to notify the Dynamic DNS server of your new IP address; using the GnuDIP protocol and using the Update URL mechanism. - If a service provided using update URL is not properly secured using HTTPS, your credentials may be visible to an adversary. Once an adversary gains your credentials, they will be able to replay your request your server and hijack your domain. - On the other hand, the GnuDIP protocol will only transport a salted MD5 value of your password, in a way that is secure against replay attacks. -
-
- Using the GnuDIP protocol - - - Register an account with any Dynamic DNS service provider. A free service provided by the FreedomBox community is available at . - - - In FreedomBox UI, enable the Dynamic DNS Service. - - - Select GnuDIP as Service type, enter your Dynamic DNS service provider address (for example, gnudip.datasystems24.net) into GnuDIP Server Address field. - - - - - - - Dynamic DNS Settings - - - - - - Fill Domain Name, Username, Password information given by your provider into the corresponding fields. - - -
-
- Using an Update URL - This feature is implemented because the most popular Dynamic DNS providers are using Update URLs mechanism. - - - Register an account with a Dynamic DNS service provider providing their service using Update URL mechanism. Some example providers are listed in the configuration page itself. - - - In FreedomBox UI, enable the Dynamic DNS service. - - - Select other Update URL as Service type, enter the update URL given by your provider into Update URL field. - - - If you browse the update URL with your Internet browser and a warning message about untrusted certificate appears, then enable accept all SSL certificates. WARNING: your credentials may be readable here because man-in-the-middle attacks are possible! Consider choosing a better service provider instead. - - - If you browse the update URL with your Internet browser and the username/password box appears, enable use HTTP basic authentication checkbox and provide the Username and Password. - - - If the update URL contains your current IP address, replace the IP address with the string <Ip>. - - -
-
- Checking If It Works - - - Make sure that external services you have enabled such as /jwchat, /roundcube and /ikiwiki are available on your domain address. - - - Go to the Status page, make sure that the NAT type is detected correctly. If your FreedomBox is behind a NAT device, this should be detected over there (Text: Behind NAT). If your FreedomBox has a public IP address assigned, the text should be "Direct connection to the Internet". - - - Check that the last update status is not failed. - - -
-
- Recap: How to create a DNS name with GnuDIP - - to delete or to replace the old text - - - - Access to GnuIP login page (answer Yes to all pop ups) - - - Click on "Self Register" - - - Fill the registration form (Username and domain will form the public IP address [username.domain]) - - - Take note of the username/hostname and password that will be used on the FreedomBox app. - - - Save and return to the GnuDIP login page to verify your username, domain and password (enter the datas, click login). - - - Login output should display your new domain name along with your current public IP address (this is a unique address provided by your router for all your local devices). - - - Leave the GnuDIP interface and open the Dynamic DNS Client app page in your FreedomBox. - - - Click on "Set Up" in the top menu. - - - Activate Dynamic DNS - - - Choose GnuDIP service. - - - Add server address (gnudip.datasystems24.net) - - - Add your fresh domain name (username.domain, ie [username].freedombox.rocks) - - - Add your fresh username (the one used in your new IP address) and password - - - Add your GnuDIP password - - - Fill the option with (try this url in your browser, you will figure out immediatly) - - - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
+ +
FreedomBox/Manual/DynamicDNS142018-03-11 03:11:04JosephNuthalapatiFix oversized image132017-03-31 20:35:42Drahtseilupdated screenshot122016-09-09 15:40:08SunilMohanAdapaMinor indentation fix with screenshot112016-09-01 19:18:48Drahtseiladapted title to Plinth wording102016-08-15 18:46:51DrahtseilScreenshot GNU-DIP92016-04-14 14:22:41PhilippeBaretAdded accurate How to create a DNS name with GnuDIP82016-04-10 07:15:47PhilippeBaretAdded bottom navigation link72016-01-11 06:28:36PhilippeBaretCorrection62015-12-15 18:48:25PhilippeBaretAdded definition title to Dynamic DNS page52015-09-13 15:02:37SunilMohanAdapaDemote headings one level for inclusion into manual42015-09-13 13:14:41SunilMohanAdapaMove DynamicDNS page to manual32015-08-13 13:03:13SunilMohanAdapaAdd more introduction and re-organize.22015-08-09 21:38:52DanielSteglich12015-08-09 21:23:48DanielSteglich
Dynamic DNS Client
What is Dynamic DNS?In order to reach a server on the Internet, the server needs to have permanent address also know as the static IP address. Many Internet service providers don't provide home users with a static IP address or they charge more providing a static IP address. Instead they provide the home user with an IP address that changes every time the user connects to the Internet. Clients wishing to contact the server will have difficulty reaching the server. Dynamic DNS service providers assist in working around a problem. First they provide you with a domain name, such as 'myhost.example.org'. Then they associate your IP address, whenever it changes, with this domain name. Then anyone intending to reach the server will be to contact the server using the domain name 'myhost.example.org' which always points to the latest IP address of the server. For this to work, every time you connect to the Internet, you will have to tell your Dynamic DNS provider what your current IP address is. Hence you need special software on your server to perform this operation. The Dynamic DNS function in FreedomBox will allow users without a static public IP address to push the current public IP address to a Dynamic DNS Server. This allows you to expose services on FreedomBox, such as ownCloud, to the Internet.
GnuDIP vs. Update URLThere are two main mechanism to notify the Dynamic DNS server of your new IP address; using the GnuDIP protocol and using the Update URL mechanism. If a service provided using update URL is not properly secured using HTTPS, your credentials may be visible to an adversary. Once an adversary gains your credentials, they will be able to replay your request your server and hijack your domain. On the other hand, the GnuDIP protocol will only transport a salted MD5 value of your password, in a way that is secure against replay attacks.
Using the GnuDIP protocolRegister an account with any Dynamic DNS service provider. A free service provided by the FreedomBox community is available at . In FreedomBox UI, enable the Dynamic DNS Service. Select GnuDIP as Service type, enter your Dynamic DNS service provider address (for example, gnudip.datasystems24.net) into GnuDIP Server Address field. Dynamic DNS Settings Fill Domain Name, Username, Password information given by your provider into the corresponding fields.
Using an Update URLThis feature is implemented because the most popular Dynamic DNS providers are using Update URLs mechanism. Register an account with a Dynamic DNS service provider providing their service using Update URL mechanism. Some example providers are listed in the configuration page itself. In FreedomBox UI, enable the Dynamic DNS service. Select other Update URL as Service type, enter the update URL given by your provider into Update URL field. If you browse the update URL with your Internet browser and a warning message about untrusted certificate appears, then enable accept all SSL certificates. WARNING: your credentials may be readable here because man-in-the-middle attacks are possible! Consider choosing a better service provider instead. If you browse the update URL with your Internet browser and the username/password box appears, enable use HTTP basic authentication checkbox and provide the Username and Password. If the update URL contains your current IP address, replace the IP address with the string <Ip>.
Checking If It WorksMake sure that external services you have enabled such as /jwchat, /roundcube and /ikiwiki are available on your domain address. Go to the Status page, make sure that the NAT type is detected correctly. If your FreedomBox is behind a NAT device, this should be detected over there (Text: Behind NAT). If your FreedomBox has a public IP address assigned, the text should be "Direct connection to the Internet". Check that the last update status is not failed.
Recap: How to create a DNS name with GnuDIPto delete or to replace the old text Access to GnuIP login page (answer Yes to all pop ups) Click on "Self Register" Fill the registration form (Username and domain will form the public IP address [username.domain]) Take note of the username/hostname and password that will be used on the FreedomBox app. Save and return to the GnuDIP login page to verify your username, domain and password (enter the datas, click login). Login output should display your new domain name along with your current public IP address (this is a unique address provided by your router for all your local devices). Leave the GnuDIP interface and open the Dynamic DNS Client app page in your FreedomBox. Click on "Set Up" in the top menu. Activate Dynamic DNS Choose GnuDIP service. Add server address (gnudip.datasystems24.net) Add your fresh domain name (username.domain, ie [username].freedombox.rocks) Add your fresh username (the one used in your new IP address) and password Add your GnuDIP password Fill the option with (try this url in your browser, you will figure out immediatly) Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/Firewall.raw.xml b/doc/Firewall.raw.xml index 088b9dcc3..45b671f24 100644 --- a/doc/Firewall.raw.xml +++ b/doc/Firewall.raw.xml @@ -1,2208 +1,17 @@ - -
- - FreedomBox/Manual/Firewall - - - 25 - 2018-03-11 03:12:12 - JosephNuthalapati - Fix oversized image - - - 24 - 2017-03-31 20:25:36 - Drahtseil - Screenshot Firewall - - - 23 - 2017-01-08 02:18:51 - JamesValleroy - add minetest - - - 22 - 2017-01-08 02:17:46 - JamesValleroy - fix table spacing - - - 21 - 2017-01-08 02:16:47 - JamesValleroy - add repro - - - 20 - 2017-01-08 02:10:57 - JamesValleroy - add mumble - - - 19 - 2017-01-08 02:08:58 - JamesValleroy - add quassel - - - 18 - 2017-01-08 01:55:02 - JamesValleroy - reorder to match Plinth Firewall page - - - 17 - 2017-01-07 21:07:25 - JamesValleroy - update managed by plinth - - - 16 - 2017-01-07 20:54:21 - JamesValleroy - update statuses shown in plinth - - - 15 - 2017-01-07 20:51:16 - JamesValleroy - updated services enabled by default - - - 14 - 2017-01-07 20:49:50 - JamesValleroy - fix table spacing - - - 13 - 2017-01-07 20:47:32 - JamesValleroy - jwchat replaced with jsxc - - - 12 - 2017-01-07 20:45:27 - JamesValleroy - remove owncloud from ports list - - - 11 - 2016-01-13 23:19:49 - JamesValleroy - port -> service - - - 10 - 2015-12-15 00:51:46 - JamesValleroy - few corrections - - - 9 - 2015-09-16 11:06:29 - SunilMohanAdapa - Update an oudated link - - - 8 - 2015-09-16 08:18:17 - SunilMohanAdapa - Remove unnecessary automatic links - - - 7 - 2015-09-13 15:06:40 - SunilMohanAdapa - Modify structure for inclusion into manual - - - 6 - 2015-09-12 11:19:31 - SunilMohanAdapa - Move the firewall page to Manual paths - - - 5 - 2015-09-12 09:37:40 - SunilMohanAdapa - Move networking related information to Networks page, cleanup - - - 4 - 2015-02-13 04:53:16 - SunilMohanAdapa - Include FreedomBox portal in footer - - - 3 - 2014-05-08 08:02:39 - SunilMohanAdapa - Add section on internet connection sharing and minor corrections - - - 2 - 2014-05-08 07:49:29 - PaulWise - link to the plinth source - - - 1 - 2014-05-08 07:36:15 - SunilMohanAdapa - New page documenting firewall operation and default port status - - - -
- Firewall - Firewall is a network security system that controls the incoming and outgoing network traffic. Keeping a firewall enabled and properly configured reduces risk of security threat from the Internet. - The operation of the firewall in Plinth web interface of FreedomBox is automatic. When you enable a service it is automatically permitted in the firewall and when you disable a service it is automatically disabled in the firewall. For services which are enabled by default on FreedomBox, firewall ports are also enabled by default during the first run process. - - - - - - - Firewall - - - - Firewall management in FreedomBox is done using FirewallD. -
- Interfaces - Each interface is needs to be assigned to one (and only one) zone. Whatever rules are in effect for a zone, those rules start to apply for that interface. For example, if HTTP traffic is allowed in a particular zone, then web requests will be accepted on all the addresses configured for all the interfaces assigned to that zone. - There are primarily two firewall zones used. The internal zone is meant for services that are provided to all machines on the local network. This may include services such as streaming media and simple file sharing. The external zone is meant for services that are provided publicly on the Internet. This may include services such as blog, website, email web client etc. - For details on how network interfaces are configured by default, see the Networks section. -
-
- Ports/Services - The following table attempts to document the ports, services and their default statuses in FreedomBox. If you find this page outdated, see the Plinth source for lib/freedombox/first-run.d/90_firewall and Firewall status page in Plinth UI. - - - - - - - - - - - - - Service - - - - - Port - - - - - External - - - - - Enabled by default - - - - - Status shown in Plinth - - - - - Managed by Plinth - - - - - - Minetest - - - 30000/udp - - - - - - - - - {*} - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - XMPP Client - - - 5222/tcp - - - - - - - - - {*} - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - XMPP Server - - - 5269/tcp - - - - - - - - - {*} - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - XMPP Bosh - - - 5280/tcp - - - - - - - - - {*} - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - NTP - - - 123/udp - - - - - - - - - {o} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - Plinth - - - 443/tcp - - - - - - - - - {*} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - - - - - {X} - - - - - - - - Quassel - - - 4242/tcp - - - - - - - - - {*} - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - SIP - - - 5060/tcp - - - - - - - - - {*} - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - SIP - - - 5060/udp - - - - - - - - - {*} - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - SIP-TLS - - - 5061/tcp - - - - - - - - - {*} - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - SIP-TLS - - - 5061/udp - - - - - - - - - {*} - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - RTP - - - 1024-65535/udp - - - - - - - - - {*} - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - SSH - - - 22/tcp - - - - - - - - - {*} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - - - - - {X} - - - - - - - - mDNS - - - 5353/udp - - - - - - - - - {o} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - Tor (Socks) - - - 9050/tcp - - - - - - - - - {o} - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - Obfsproxy - - - <random>/tcp - - - - - - - - - {*} - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - OpenVPN - - - 1194/udp - - - - - - - - - {*} - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - Mumble - - - 64378/tcp - - - - - - - - - {*} - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - Mumble - - - 64378/udp - - - - - - - - - {*} - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - Privoxy - - - 8118/tcp - - - - - - - - - {o} - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - JSXC - - - 80/tcp - - - - - - - - - {*} - - - - - - - - - - - - {X} - - - - - - - - - - - - {X} - - - - - - - - - - - - {X} - - - - - - - - JSXC - - - 443/tcp - - - - - - - - - {*} - - - - - - - - - - - - {X} - - - - - - - - - - - - {X} - - - - - - - - - - - - {X} - - - - - - - - DNS - - - 53/tcp - - - - - - - - - {o} - - - - - - - - - - - - {X} - - - - - - - - - - - - {X} - - - - - - - - - - - - {X} - - - - - - - - DNS - - - 53/tdp - - - - - - - - - {o} - - - - - - - - - - - - {X} - - - - - - - - - - - - {X} - - - - - - - - - - - - {X} - - - - - - - - DHCP - - - 67/udp - - - - - - - - - {o} - - - - - - - - - - - - (./) - - - - - - - - - - - - {X} - - - - - - - - - - - - {X} - - - - - - - - Bootp - - - 67/tcp - - - - - - - - - {o} - - - - - - - - - - - - {X} - - - - - - - - - - - - {X} - - - - - - - - - - - - {X} - - - - - - - - Bootp - - - 67/udp - - - - - - - - - {o} - - - - - - - - - - - - {X} - - - - - - - - - - - - {X} - - - - - - - - - - - - {X} - - - - - - - - Bootp - - - 68/tcp - - - - - - - - - {o} - - - - - - - - - - - - {X} - - - - - - - - - - - - {X} - - - - - - - - - - - - {X} - - - - - - - - Bootp - - - 68/udp - - - - - - - - - {o} - - - - - - - - - - - - {X} - - - - - - - - - - - - {X} - - - - - - - - - - - - {X} - - - - - - - - LDAP - - - 389/tcp - - - - - - - - - {o} - - - - - - - - - - - - {X} - - - - - - - - - - - - {X} - - - - - - - - - - - - {X} - - - - - - - - LDAPS - - - 636/tcp - - - - - - - - - {o} - - - - - - - - - - - - {X} - - - - - - - - - - - - {X} - - - - - - - - - - - - {X} - - - - - - - - -
-
- Manual operation - See FirewallD documentation for more information on the basic concepts and comprehensive documentation. -
- Enable/disable firewall - To disable firewall - - or with systemd - - To re-enable firewall - - or with systemd - -
-
- Modifying services/ports - You can manually add or remove a service from a zone. - To see list of services enabled: - --list-services]]> - Example: - - To see list of ports enabled: - --list-ports]]> - Example: - - To remove a service from a zone: - --remove-service= -firewall-cmd --permanent --zone= --remove-service=]]> - Example: - - To remove a port from a zone: - / -firewall-cmd --permanent --zone=internal --remove-port=/]]> - Example: - - To add a service to a zone: - --add-service= -firewall-cmd --permanent --zone= --add-service=]]> - Example: - - To add a port to a zone: - / -firewall-cmd --permanent --zone=internal --add-port=/]]> - Example: - -
-
- Modifying the zone of interfaces - You can manually change the assignment of zones of each interfaces after they have been autuomatically assigned by the first boot process. - To see current assignment of interfaces to zones: - - To remove an interface from a zone: - --remove-interface= -firewall-cmd --permanent --zone= --remove-interface=]]> - Example: - - To add an interface to a zone: - --add-interface= -firewall-cmd --permanent --zone= --add-interface=]]> - Example: - - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
-
+ +
FreedomBox/Manual/Firewall252018-03-11 03:12:12JosephNuthalapatiFix oversized image242017-03-31 20:25:36DrahtseilScreenshot Firewall232017-01-08 02:18:51JamesValleroyadd minetest222017-01-08 02:17:46JamesValleroyfix table spacing212017-01-08 02:16:47JamesValleroyadd repro202017-01-08 02:10:57JamesValleroyadd mumble192017-01-08 02:08:58JamesValleroyadd quassel182017-01-08 01:55:02JamesValleroyreorder to match Plinth Firewall page172017-01-07 21:07:25JamesValleroyupdate managed by plinth162017-01-07 20:54:21JamesValleroyupdate statuses shown in plinth152017-01-07 20:51:16JamesValleroyupdated services enabled by default142017-01-07 20:49:50JamesValleroyfix table spacing132017-01-07 20:47:32JamesValleroyjwchat replaced with jsxc122017-01-07 20:45:27JamesValleroyremove owncloud from ports list112016-01-13 23:19:49JamesValleroyport -> service102015-12-15 00:51:46JamesValleroyfew corrections92015-09-16 11:06:29SunilMohanAdapaUpdate an oudated link82015-09-16 08:18:17SunilMohanAdapaRemove unnecessary automatic links72015-09-13 15:06:40SunilMohanAdapaModify structure for inclusion into manual62015-09-12 11:19:31SunilMohanAdapaMove the firewall page to Manual paths52015-09-12 09:37:40SunilMohanAdapaMove networking related information to Networks page, cleanup42015-02-13 04:53:16SunilMohanAdapaInclude FreedomBox portal in footer32014-05-08 08:02:39SunilMohanAdapaAdd section on internet connection sharing and minor corrections22014-05-08 07:49:29PaulWiselink to the plinth source12014-05-08 07:36:15SunilMohanAdapaNew page documenting firewall operation and default port status
FirewallFirewall is a network security system that controls the incoming and outgoing network traffic. Keeping a firewall enabled and properly configured reduces risk of security threat from the Internet. The operation of the firewall in Plinth web interface of FreedomBox is automatic. When you enable a service it is automatically permitted in the firewall and when you disable a service it is automatically disabled in the firewall. For services which are enabled by default on FreedomBox, firewall ports are also enabled by default during the first run process. Firewall Firewall management in FreedomBox is done using FirewallD.
InterfacesEach interface is needs to be assigned to one (and only one) zone. Whatever rules are in effect for a zone, those rules start to apply for that interface. For example, if HTTP traffic is allowed in a particular zone, then web requests will be accepted on all the addresses configured for all the interfaces assigned to that zone. There are primarily two firewall zones used. The internal zone is meant for services that are provided to all machines on the local network. This may include services such as streaming media and simple file sharing. The external zone is meant for services that are provided publicly on the Internet. This may include services such as blog, website, email web client etc. For details on how network interfaces are configured by default, see the Networks section.
Ports/ServicesThe following table attempts to document the ports, services and their default statuses in FreedomBox. If you find this page outdated, see the Plinth source for lib/freedombox/first-run.d/90_firewall and Firewall status page in Plinth UI. ServicePort ExternalEnabled by defaultStatus shown in PlinthManaged by Plinth Minetest 30000/udp {*} {X} (./) (./) XMPP Client 5222/tcp {*} {X} (./) (./) XMPP Server 5269/tcp {*} {X} (./) (./) XMPP Bosh 5280/tcp {*} {X} (./) (./) NTP 123/udp {o} (./) (./) (./) Plinth 443/tcp {*} (./) (./) {X} Quassel 4242/tcp {*} {X} (./) (./) SIP 5060/tcp {*} {X} (./) (./) SIP 5060/udp {*} {X} (./) (./) SIP-TLS 5061/tcp {*} {X} (./) (./) SIP-TLS 5061/udp {*} {X} (./) (./) RTP 1024-65535/udp {*} {X} (./) (./) SSH 22/tcp {*} (./) (./) {X} mDNS 5353/udp {o} (./) (./) (./) Tor (Socks) 9050/tcp {o} {X} (./) (./) Obfsproxy <random>/tcp {*} {X} (./) (./) OpenVPN 1194/udp {*} {X} (./) (./) Mumble 64378/tcp {*} {X} (./) (./) Mumble 64378/udp {*} {X} (./) (./) Privoxy 8118/tcp {o} {X} (./) (./) JSXC 80/tcp {*} {X} {X} {X} JSXC 443/tcp {*} {X} {X} {X} DNS 53/tcp {o} {X} {X} {X} DNS 53/tdp {o} {X} {X} {X} DHCP 67/udp {o} (./) {X} {X} Bootp 67/tcp {o} {X} {X} {X} Bootp 67/udp {o} {X} {X} {X} Bootp 68/tcp {o} {X} {X} {X} Bootp 68/udp {o} {X} {X} {X} LDAP 389/tcp {o} {X} {X} {X} LDAPS 636/tcp {o} {X} {X} {X}
Manual operationSee FirewallD documentation for more information on the basic concepts and comprehensive documentation.
Enable/disable firewallTo disable firewall or with systemd To re-enable firewall or with systemd
Modifying services/portsYou can manually add or remove a service from a zone. To see list of services enabled: --list-services]]>Example: To see list of ports enabled: --list-ports]]>Example: To remove a service from a zone: --remove-service= +firewall-cmd --permanent --zone= --remove-service=]]>Example: To remove a port from a zone: / +firewall-cmd --permanent --zone=internal --remove-port=/]]>Example: To add a service to a zone: --add-service= +firewall-cmd --permanent --zone= --add-service=]]>Example: To add a port to a zone: / +firewall-cmd --permanent --zone=internal --add-port=/]]>Example:
Modifying the zone of interfacesYou can manually change the assignment of zones of each interfaces after they have been autuomatically assigned by the first boot process. To see current assignment of interfaces to zones: To remove an interface from a zone: --remove-interface= +firewall-cmd --permanent --zone= --remove-interface=]]>Example: To add an interface to a zone: --add-interface= +firewall-cmd --permanent --zone= --add-interface=]]>Example: InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/Ikiwiki.raw.xml b/doc/Ikiwiki.raw.xml index d163b8aee..ce42f6e86 100644 --- a/doc/Ikiwiki.raw.xml +++ b/doc/Ikiwiki.raw.xml @@ -1,324 +1,5 @@ - -
- - FreedomBox/Manual/Ikiwiki - - - 9 - 2016-12-26 19:18:01 - JamesValleroy - add screenshots - - - 8 - 2016-09-01 19:15:54 - Drahtseil - adapted title to Plinth wording - - - 7 - 2016-05-26 17:19:45 - JamesValleroy - new section on adding users as wiki admins - - - 6 - 2016-04-13 01:10:28 - PhilippeBaret - Added blog to quick start entry in Ikiwiki Manual - - - 5 - 2016-04-13 01:00:22 - PhilippeBaret - Added a "Quick Start" entry in Ikiwiki manual - - - 4 - 2016-04-10 07:21:53 - PhilippeBaret - Added bottom navigation link - - - 3 - 2015-12-15 19:54:35 - PhilippeBaret - Added Ikiwiki definition - - - 2 - 2015-11-29 19:13:55 - PhilippeBaret - added ## BEGIN_INCLUDE - - - 1 - 2015-09-13 17:06:14 - JamesValleroy - add ikiwiki page for manual - - - -
- Wiki and Blog (Ikiwiki) -
- What is Ikiwiki? - Ikiwiki converts wiki pages into HTML pages suitable for publishing on a website. It provides particularly blogging, podcasting, calendars and a large selection of plugins. -
-
- Quick Start - After the app installation on your box administration interface: - - - Go to "Create" section and create a wiki or a blog - - - Go back to "Configure" section and click on /ikiwiki link - - - Click on your new wiki or blog name under "Parent directory" - - - Enjoy your new publication page. - - -
-
- Creating a wiki or blog - You can create a wiki or blog to be hosted on your FreedomBox through the Wiki & Blog (Ikiwiki) page in Plinth. The first time you visit this page, it will ask to install packages required by Ikiwiki. - After the package install has completed, select the Create tab. You can select the type to be Wiki or Blog. Also type in a name for the wiki or blog, and the username and password for the wiki's/blog's admin account. Then click Update setup and you will see the wiki/blog added to your list. Note that each wiki/blog has its own admin account. - - - - - - - ikiwiki: Create - - - -
-
- Accessing your wiki or blog - From the Wiki & Blog (Ikiwiki) page, select the Manage tab and you will see a list of your wikis and blogs. Click a name to navigate to that wiki or blog. - - - - - - - ikiwiki: Manage - - - - From here, if you click Edit or Preferences, you will be taken to a login page. To log in with the admin account that you created before, select the Other tab, enter the username and password, and click Login. -
-
- User login through SSO - Besides the wiki/blog admin, other FreedomBox users can be given access to login and edit wikis and blogs. However, they will not have all the same permissions as the wiki admin. They can add or edit pages, but cannot change the wiki's configuration. - To add a wiki user, go to the Users and Groups page in Plinth (under System configuration, the gear icon at the top right corner of the page). Create or modify a user, and add them to the wiki group. (Users in the admin group will also have wiki access.) - To login as a FreedomBox user, go to the wiki/blog's login page and select the Other tab. Then click the "Login with HTTP auth" button. The browser will show a popup dialog where you can enter the username and password of the FreedomBox user. -
-
- Adding FreedomBox users as wiki admins - - - Login to the wiki, using the admin account that was specified when the wiki was created. - - - Click "Preferences", then "Setup". - - - Under "main", in the "users who are wiki admins", add the name of a user on the FreedomBox. - - - (Optional) Under "auth plugin: passwordauth", uncheck the "enable passwordauth?" option. (Note: This will disable the old admin account login. Only SSO login using HTTP auth will be possible.) - - - Click "Save Setup". - - - Click "Preferences", then "Logout". - - - Login as the new admin user using "Login with HTTP auth". - - - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
+ +
FreedomBox/Manual/Ikiwiki92016-12-26 19:18:01JamesValleroyadd screenshots82016-09-01 19:15:54Drahtseiladapted title to Plinth wording72016-05-26 17:19:45JamesValleroynew section on adding users as wiki admins62016-04-13 01:10:28PhilippeBaretAdded blog to quick start entry in Ikiwiki Manual52016-04-13 01:00:22PhilippeBaretAdded a "Quick Start" entry in Ikiwiki manual42016-04-10 07:21:53PhilippeBaretAdded bottom navigation link32015-12-15 19:54:35PhilippeBaretAdded Ikiwiki definition22015-11-29 19:13:55PhilippeBaretadded ## BEGIN_INCLUDE12015-09-13 17:06:14JamesValleroyadd ikiwiki page for manual
Wiki and Blog (Ikiwiki)
What is Ikiwiki?Ikiwiki converts wiki pages into HTML pages suitable for publishing on a website. It provides particularly blogging, podcasting, calendars and a large selection of plugins.
Quick StartAfter the app installation on your box administration interface: Go to "Create" section and create a wiki or a blog Go back to "Configure" section and click on /ikiwiki link Click on your new wiki or blog name under "Parent directory" Enjoy your new publication page.
Creating a wiki or blogYou can create a wiki or blog to be hosted on your FreedomBox through the Wiki & Blog (Ikiwiki) page in Plinth. The first time you visit this page, it will ask to install packages required by Ikiwiki. After the package install has completed, select the Create tab. You can select the type to be Wiki or Blog. Also type in a name for the wiki or blog, and the username and password for the wiki's/blog's admin account. Then click Update setup and you will see the wiki/blog added to your list. Note that each wiki/blog has its own admin account. ikiwiki: Create
Accessing your wiki or blogFrom the Wiki & Blog (Ikiwiki) page, select the Manage tab and you will see a list of your wikis and blogs. Click a name to navigate to that wiki or blog. ikiwiki: Manage From here, if you click Edit or Preferences, you will be taken to a login page. To log in with the admin account that you created before, select the Other tab, enter the username and password, and click Login.
User login through SSOBesides the wiki/blog admin, other FreedomBox users can be given access to login and edit wikis and blogs. However, they will not have all the same permissions as the wiki admin. They can add or edit pages, but cannot change the wiki's configuration. To add a wiki user, go to the Users and Groups page in Plinth (under System configuration, the gear icon at the top right corner of the page). Create or modify a user, and add them to the wiki group. (Users in the admin group will also have wiki access.) To login as a FreedomBox user, go to the wiki/blog's login page and select the Other tab. Then click the "Login with HTTP auth" button. The browser will show a popup dialog where you can enter the username and password of the FreedomBox user.
Adding FreedomBox users as wiki adminsLogin to the wiki, using the admin account that was specified when the wiki was created. Click "Preferences", then "Setup". Under "main", in the "users who are wiki admins", add the name of a user on the FreedomBox. (Optional) Under "auth plugin: passwordauth", uncheck the "enable passwordauth?" option. (Note: This will disable the old admin account login. Only SSO login using HTTP auth will be possible.) Click "Save Setup". Click "Preferences", then "Logout". Login as the new admin user using "Login with HTTP auth". Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/LetsEncrypt.raw.xml b/doc/LetsEncrypt.raw.xml index 6a99c7e9a..84be7f1d4 100644 --- a/doc/LetsEncrypt.raw.xml +++ b/doc/LetsEncrypt.raw.xml @@ -1,321 +1,5 @@ - -
- - FreedomBox/Manual/LetsEncrypt - - - 8 - 2018-03-11 03:16:47 - JosephNuthalapati - - - 7 - 2017-01-19 00:18:41 - JamesValleroy - replace quote character - - - 6 - 2017-01-07 19:48:45 - JamesValleroy - add port forwarding info - - - 5 - 2017-01-07 18:21:14 - JamesValleroy - clarify step - - - 4 - 2016-08-21 19:00:07 - Drahtseil - - - 3 - 2016-08-21 18:59:20 - Drahtseil - Screencast of the setting up - - - 2 - 2016-08-21 17:57:07 - Drahtseil - screenshots - - - 1 - 2016-08-21 17:43:20 - Drahtseil - Created Let's Encypt - - - -
- Certificates (Let's Encrypt) - A digital certficate allows users of a web service to verify the identity of the service and to securely communicate with it. FreedomBox can automatically obtain and setup digital certificates for each available domain. It does so by proving itself to be the owner of a domain to Let's Encrypt, a certificate authority (CA). - Let's Encrypt is a free, automated, and open certificate authority, run for the public's benefit by the Internet Security Research Group (ISRG). Please read and agree with the Let's Encrypt Subscriber Agreement before using this service. -
- Why using Certificates - The communication with your FreedomBox can be secured so that it is not possible to intercept the content of the web pages viewed and about the content exchanged. -
-
- How to setup - - - If your FreedomBox is behind a router, you will need to set up port forwarding on your router. You should forward the following ports: - - - TCP 80 (http) - - - TCP 443 (https) - - - - - Make the domain name known: - - - In Configure insert your domain name, e.g. MyWebName.com Let's Encrypt - - - - - Verify the domain name was accepted - - - Check that it is enabled in Name Services - - - - - - - Let's Encrypt Name Services - - - - - - - - Go to the Certificates (Let's Encrypt) page, and complete the module install if needed. Then click the "Obtain" button for your domain name. - - - After some minutes a valid certificate is available - - - - - - - Let's Encrypt - - - - - - - - Verify in your browser by checking https://MyWebName.com - - - - - - - - - Let's Encrypt Certificate - - - - - - - - Screencast: Let's Encrypt -
-
- Using - The certificate is valid for 3 months. It is renewed automatically and can also be re-obtained or revoked manually. - With running diagnostics the certificate can also be verified. - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
+ +
FreedomBox/Manual/LetsEncrypt82018-03-11 03:16:47JosephNuthalapati72017-01-19 00:18:41JamesValleroyreplace quote character62017-01-07 19:48:45JamesValleroyadd port forwarding info52017-01-07 18:21:14JamesValleroyclarify step42016-08-21 19:00:07Drahtseil32016-08-21 18:59:20DrahtseilScreencast of the setting up22016-08-21 17:57:07Drahtseilscreenshots12016-08-21 17:43:20DrahtseilCreated Let's Encypt
Certificates (Let's Encrypt)A digital certficate allows users of a web service to verify the identity of the service and to securely communicate with it. FreedomBox can automatically obtain and setup digital certificates for each available domain. It does so by proving itself to be the owner of a domain to Let's Encrypt, a certificate authority (CA). Let's Encrypt is a free, automated, and open certificate authority, run for the public's benefit by the Internet Security Research Group (ISRG). Please read and agree with the Let's Encrypt Subscriber Agreement before using this service.
Why using CertificatesThe communication with your FreedomBox can be secured so that it is not possible to intercept the content of the web pages viewed and about the content exchanged.
How to setupIf your FreedomBox is behind a router, you will need to set up port forwarding on your router. You should forward the following ports: TCP 80 (http) TCP 443 (https) Make the domain name known: In Configure insert your domain name, e.g. MyWebName.com Let's Encrypt Verify the domain name was accepted Check that it is enabled in Name Services Let's Encrypt Name Services Go to the Certificates (Let's Encrypt) page, and complete the module install if needed. Then click the "Obtain" button for your domain name. After some minutes a valid certificate is available Let's Encrypt Verify in your browser by checking https://MyWebName.com Let's Encrypt Certificate Screencast: Let's Encrypt
UsingThe certificate is valid for 3 months. It is renewed automatically and can also be re-obtained or revoked manually. With running diagnostics the certificate can also be verified. Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/MatrixSynapse.raw.xml b/doc/MatrixSynapse.raw.xml index 77ae36ae7..e3db408ba 100644 --- a/doc/MatrixSynapse.raw.xml +++ b/doc/MatrixSynapse.raw.xml @@ -1,235 +1,5 @@ - -
- - FreedomBox/Manual/MatrixSynapse - - - 6 - 2018-03-02 12:06:08 - JosephNuthalapati - - - 5 - 2018-03-02 10:44:12 - JosephNuthalapati - Naming was inconsistent - - - 4 - 2017-06-27 05:13:41 - JosephNuthalapati - - - 3 - 2017-03-24 06:42:49 - SunilMohanAdapa - Update for explaining more features etc. - - - 2 - 2017-03-23 06:36:05 - rahulde - - - 1 - 2017-03-23 06:33:43 - rahulde - - - -
- Chat Server (Matrix Synapse) -
- What is the Matrix? - Matrix is an open standard for interoperable, decentralized, real-time communication over IP. Synapse is the reference implementation of a Matrix server. It can be used to setup instant messaging on FreedomBox to host large chat rooms, end to end encrypted communication and audio/video calls. Each instance of a Matrix server federates with other instances such that all your contacts need not hold accounts on your server. See more detailed info about Matrix. - Note: The Matrix Synapse is available in FreedomBox starting with Plinth version 0.14. -
-
- How to access the Matrix? - We recommend the Riot client to access the Matrix server. You can download Riot for desktops. Mobile applications for Android and iOS are available from app stores. -
-
- Setting up your FreedomBox for Matrix - To enable Matrix, first navigate to the Chat Server (Matrix Synapse) page and install it. Matrix needs a valid domain name to be configured. After installation, you will be asked to configure it. You will be able to select a domain from a drop down menu of available domains. Domains are configured using System -> Configure page. After configuring a domain, you will see that the service is running. The service will be accessible on the configured FreedomBox domain. All the registered users will have their Matrix IDs as @username:domain. Currently, you will not be able to change the domain once is it configured. -
-
- Federating with other Matrix instances - You will be able to interact with any other person running another Matrix instance. This is done by simply starting a conversation with them using their matrix ID which is of the format @their-username:their-domain. You can also join rooms which are in another server and have audio/video calls with contacts on other server. - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
+ +
FreedomBox/Manual/MatrixSynapse62018-03-02 12:06:08JosephNuthalapati52018-03-02 10:44:12JosephNuthalapatiNaming was inconsistent42017-06-27 05:13:41JosephNuthalapati32017-03-24 06:42:49SunilMohanAdapaUpdate for explaining more features etc.22017-03-23 06:36:05rahulde12017-03-23 06:33:43rahulde
Chat Server (Matrix Synapse)
What is the Matrix?Matrix is an open standard for interoperable, decentralized, real-time communication over IP. Synapse is the reference implementation of a Matrix server. It can be used to setup instant messaging on FreedomBox to host large chat rooms, end to end encrypted communication and audio/video calls. Each instance of a Matrix server federates with other instances such that all your contacts need not hold accounts on your server. See more detailed info about Matrix. Note: The Matrix Synapse is available in FreedomBox starting with Plinth version 0.14.
How to access the Matrix?We recommend the Riot client to access the Matrix server. You can download Riot for desktops. Mobile applications for Android and iOS are available from app stores.
Setting up your FreedomBox for MatrixTo enable Matrix, first navigate to the Chat Server (Matrix Synapse) page and install it. Matrix needs a valid domain name to be configured. After installation, you will be asked to configure it. You will be able to select a domain from a drop down menu of available domains. Domains are configured using System -> Configure page. After configuring a domain, you will see that the service is running. The service will be accessible on the configured FreedomBox domain. All the registered users will have their Matrix IDs as @username:domain. Currently, you will not be able to change the domain once is it configured.
Federating with other Matrix instancesYou will be able to interact with any other person running another Matrix instance. This is done by simply starting a conversation with them using their matrix ID which is of the format @their-username:their-domain. You can also join rooms which are in another server and have audio/video calls with contacts on other server. Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/MediaWiki.raw.xml b/doc/MediaWiki.raw.xml index 9c05131bc..a836a4da5 100644 --- a/doc/MediaWiki.raw.xml +++ b/doc/MediaWiki.raw.xml @@ -1,302 +1,5 @@ - -
- - FreedomBox/Manual/MediaWiki - - - 8 - 2018-08-27 23:58:16 - JamesValleroy - try to close last section - - - 7 - 2018-08-27 23:43:48 - JamesValleroy - add consistent newlines after headings - - - 6 - 2018-08-27 23:41:37 - JamesValleroy - spelling - - - 5 - 2018-08-21 07:33:32 - JosephNuthalapati - - - 4 - 2018-08-21 07:32:43 - JosephNuthalapati - Update wiki to include new features - - - 3 - 2018-01-31 06:02:30 - SunilMohanAdapa - Add footer and category - - - 2 - 2018-01-17 10:26:45 - JosephNuthalapati - Fix headings - - - 1 - 2018-01-13 04:01:22 - JosephNuthalapati - New wiki entry for MediaWiki on FreedomBox - - - -
- Wiki (MediaWiki) -
- About MediaWiki - MediaWiki is the software that powers the Wikimedia suite of wikis. - Read more about MediaWiki on Wikipedia - Available since: version 0.20.0 -
-
- MediaWiki on FreedomBox - MediaWiki on FreedomBox is configured to be publicly readable and privately editable. Only logged in users can make edits to the wiki. This configuration prevents spam and vandalism on the wiki. -
- User management - Users can be created by the MediaWiki administrator (user "admin") only. The "admin" user can also be used to reset passwords of MediaWiki users. The administrator password, if forgotten can be reset anytime from the MediaWiki page in the Plinth UI. -
-
- Use cases - MediaWiki is quite versatile and can be put to many creative uses. It also comes with a lot of plugins and themes and is highly customizable. -
- Personal Knowledge Repository - - - MediaWiki on FreedomBox can be your own personal knowledge repository. Since MediaWiki has good multimedia support, you can write notes, store images, create checklists, store references and bookmarks etc. in an organized manner. You can store the knowledge of a lifetime in your MediaWiki instance. - - -
-
- Community Wiki - - - A community of users can use MediaWiki as their common repository of knowledge and reference material. It can used as a college notice board, documentation server for a small company, common notebook for study groups or as a fan wiki like wikia. - - -
-
- Personal Wiki-based Website - - - Several websites on the internet are simply MediaWiki instances. MediaWiki on FreedomBox is read-only to visitors. Hence, it can be adapted to serve as your personal website and/or blog. MediaWiki content is easy to export and can be later moved to use another blog engine. - - -
-
-
- Editing Wiki Content -
- Visual Editor - - - MediaWiki's new Visual Editor gives a WYSIWYG user interface to creating wiki pages. Unfortunately, it is not yet available in the current version of MediaWiki on Debian. A workaround is to use write your content using the Visual Editor in Wikipedia's Sandbox, switching to source editing mode and copying the content into your wiki. - - -
-
- Other Formats - - - You don't have to necessarily learn the MediaWiki formatting language. You can write in your favorite format (Markdown, Org-mode, LaTeX etc.) and convert it to the MediaWiki format using Pandoc. - - -
-
- Image Uploads - - - Image uploads have been enabled since FreedomBox version 0.36.0. You can also directly use images from Wikimedia Commons using a feature called Instant Commons. - - - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
-
-
+ +
FreedomBox/Manual/MediaWiki92018-08-28 09:42:01JosephNuthalapatiRemove internal links to MediaWiki82018-08-27 23:58:16JamesValleroytry to close last section72018-08-27 23:43:48JamesValleroyadd consistent newlines after headings62018-08-27 23:41:37JamesValleroyspelling52018-08-21 07:33:32JosephNuthalapati42018-08-21 07:32:43JosephNuthalapatiUpdate wiki to include new features32018-01-31 06:02:30SunilMohanAdapaAdd footer and category22018-01-17 10:26:45JosephNuthalapatiFix headings12018-01-13 04:01:22JosephNuthalapatiNew wiki entry for MediaWiki on FreedomBox
Wiki (MediaWiki)
About MediaWikiMediaWiki is the software that powers the Wikimedia suite of wikis. Read more about MediaWiki on Wikipedia Available since: version 0.20.0
MediaWiki on FreedomBoxMediaWiki on FreedomBox is configured to be publicly readable and privately editable. Only logged in users can make edits to the wiki. This configuration prevents spam and vandalism on the wiki.
User managementUsers can be created by the MediaWiki administrator (user "admin") only. The "admin" user can also be used to reset passwords of MediaWiki users. The administrator password, if forgotten can be reset anytime from the MediaWiki page in the Plinth UI.
Use casesMediaWiki is quite versatile and can be put to many creative uses. It also comes with a lot of plugins and themes and is highly customizable.
Personal Knowledge RepositoryMediaWiki on FreedomBox can be your own personal knowledge repository. Since MediaWiki has good multimedia support, you can write notes, store images, create checklists, store references and bookmarks etc. in an organized manner. You can store the knowledge of a lifetime in your MediaWiki instance.
Community WikiA community of users can use MediaWiki as their common repository of knowledge and reference material. It can used as a college notice board, documentation server for a small company, common notebook for study groups or as a fan wiki like wikia.
Personal Wiki-based WebsiteSeveral websites on the internet are simply MediaWiki instances. MediaWiki on FreedomBox is read-only to visitors. Hence, it can be adapted to serve as your personal website and/or blog. MediaWiki content is easy to export and can be later moved to use another blog engine.
Editing Wiki Content
Visual EditorMediaWiki's new Visual Editor gives a WYSIWYG user interface to creating wiki pages. Unfortunately, it is not yet available in the current version of MediaWiki on Debian. A workaround is to use write your content using the Visual Editor in Wikipedia's Sandbox, switching to source editing mode and copying the content into your wiki.
Other FormatsYou don't have to necessarily learn the MediaWiki formatting language. You can write in your favorite format (Markdown, Org-mode, LaTeX etc.) and convert it to the MediaWiki format using Pandoc.
Image UploadsImage uploads have been enabled since FreedomBox version 0.36.0. You can also directly use images from Wikimedia Commons using a feature called Instant Commons. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/Minetest.raw.xml b/doc/Minetest.raw.xml index 824d6a09e..cb1849c85 100644 --- a/doc/Minetest.raw.xml +++ b/doc/Minetest.raw.xml @@ -1,214 +1,5 @@ - -
- - FreedomBox/Manual/Minetest - - - 3 - 2017-01-02 13:29:19 - JamesValleroy - fix list - - - 2 - 2017-01-02 13:26:03 - JamesValleroy - add port forwarding info - - - 1 - 2016-09-04 10:20:44 - Drahtseil - stub created - - - -
- Block Sandbox (Minetest) - Minetest is a multiplayer infinite-world block sandbox. This module enables the Minetest server to be run on this FreedomBox, on the default port (30000). To connect to the server, a Minetest client is needed. -
- Port Forwarding - If your FreedomBox is behind a router, you will need to set up port forwarding on your router. You should forward the following ports for Minetest: - - - UDP 30000 - - - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
+ +
FreedomBox/Manual/Minetest32017-01-02 13:29:19JamesValleroyfix list22017-01-02 13:26:03JamesValleroyadd port forwarding info12016-09-04 10:20:44Drahtseilstub created
Block Sandbox (Minetest)Minetest is a multiplayer infinite-world block sandbox. This module enables the Minetest server to be run on this FreedomBox, on the default port (30000). To connect to the server, a Minetest client is needed.
Port ForwardingIf your FreedomBox is behind a router, you will need to set up port forwarding on your router. You should forward the following ports for Minetest: UDP 30000 Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/Monkeysphere.raw.xml b/doc/Monkeysphere.raw.xml index 6bfe5d3eb..2c4bc8515 100644 --- a/doc/Monkeysphere.raw.xml +++ b/doc/Monkeysphere.raw.xml @@ -1,194 +1,5 @@ - -
- - FreedomBox/Manual/Monkeysphere - - - 1 - 2016-09-04 10:12:10 - Drahtseil - stub created - - - -
- Monkeysphere - With Monkeysphere, an OpenPGP key can be generated for each configured domain serving SSH. The OpenPGP public key can then be uploaded to the OpenPGP keyservers. Users connecting to this machine through SSH can verify that they are connecting to the correct host. For users to trust the key, at least one person (usually the machine owner) must sign the key using the regular OpenPGP key signing process. See the Monkeysphere SSH documentation for more details. - Monkeysphere can also generate an OpenPGP key for each Secure Web Server (HTTPS) certificate installed on this machine. The OpenPGP public key can then be uploaded to the OpenPGP keyservers. Users accessing the web server through HTTPS can verify that they are connecting to the correct host. To validate the certificate, the user will need to install some software that is available on the Monkeysphere website. - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
+ +
FreedomBox/Manual/Monkeysphere12016-09-04 10:12:10Drahtseilstub created
MonkeysphereWith Monkeysphere, an OpenPGP key can be generated for each configured domain serving SSH. The OpenPGP public key can then be uploaded to the OpenPGP keyservers. Users connecting to this machine through SSH can verify that they are connecting to the correct host. For users to trust the key, at least one person (usually the machine owner) must sign the key using the regular OpenPGP key signing process. See the Monkeysphere SSH documentation for more details. Monkeysphere can also generate an OpenPGP key for each Secure Web Server (HTTPS) certificate installed on this machine. The OpenPGP public key can then be uploaded to the OpenPGP keyservers. Users accessing the web server through HTTPS can verify that they are connecting to the correct host. To validate the certificate, the user will need to install some software that is available on the Monkeysphere website. Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/Mumble.raw.xml b/doc/Mumble.raw.xml index ad715b969..f9bbe5f30 100644 --- a/doc/Mumble.raw.xml +++ b/doc/Mumble.raw.xml @@ -1,241 +1,5 @@ - -
- - FreedomBox/Manual/Mumble - - - 6 - 2017-01-02 13:28:53 - JamesValleroy - add port forwarding info - - - 5 - 2016-12-31 04:04:56 - JamesValleroy - add basic usage info - - - 4 - 2016-09-01 19:14:55 - Drahtseil - adapted title to Plinth wording - - - 3 - 2016-04-10 07:20:42 - PhilippeBaret - Added bottom navigation link - - - 2 - 2015-12-15 20:51:58 - PhilippeBaret - - - 1 - 2015-12-15 20:06:18 - PhilippeBaret - Added Mumble page and definition. - - - -
- Voice Chat (Mumble) -
- What is Mumble? - Mumble is a voice chat software. Primarily intended for use while gaming, it is suitable for simple talking with high audio quality, noise suppression, encrypted communication, public/private-key authentication by default, and "wizards" to configure your microphone for instance. A user can be marked as a "priority speaker" within a channel. -
-
- Using Mumble - FreedomBox includes the Mumble server. Clients are available for desktop and mobile platforms. Users can download one of these clients and connect to the server. -
-
- Port Forwarding - If your FreedomBox is behind a router, you will need to set up port forwarding on your router. You should forward the following ports for Mumble: - - - TCP 64738 - - - UDP 64738 - - - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
+ +
FreedomBox/Manual/Mumble62017-01-02 13:28:53JamesValleroyadd port forwarding info52016-12-31 04:04:56JamesValleroyadd basic usage info42016-09-01 19:14:55Drahtseiladapted title to Plinth wording32016-04-10 07:20:42PhilippeBaretAdded bottom navigation link22015-12-15 20:51:58PhilippeBaret12015-12-15 20:06:18PhilippeBaretAdded Mumble page and definition.
Voice Chat (Mumble)
What is Mumble?Mumble is a voice chat software. Primarily intended for use while gaming, it is suitable for simple talking with high audio quality, noise suppression, encrypted communication, public/private-key authentication by default, and "wizards" to configure your microphone for instance. A user can be marked as a "priority speaker" within a channel.
Using MumbleFreedomBox includes the Mumble server. Clients are available for desktop and mobile platforms. Users can download one of these clients and connect to the server.
Port ForwardingIf your FreedomBox is behind a router, you will need to set up port forwarding on your router. You should forward the following ports for Mumble: TCP 64738 UDP 64738 Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/NameServices.raw.xml b/doc/NameServices.raw.xml index 4420e560c..6238adc0c 100644 --- a/doc/NameServices.raw.xml +++ b/doc/NameServices.raw.xml @@ -1,204 +1,5 @@ - -
- - FreedomBox/Manual/NameServices - - - 3 - 2016-12-31 04:18:51 - JamesValleroy - reword - - - 2 - 2016-08-21 17:16:56 - Drahtseil - - - 1 - 2016-08-21 17:16:41 - Drahtseil - Created NameServices - - - -
- Name Services - Name Services provides an overview of ways the box can be reached from the public Internet: domain name, Tor hidden service, and Pagekite. For each type of name, it is shown whether the HTTP, HTTPS, and SSH services are enabled or disabled for incoming connections through the given name. - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
+ +
FreedomBox/Manual/NameServices32016-12-31 04:18:51JamesValleroyreword22016-08-21 17:16:56Drahtseil12016-08-21 17:16:41DrahtseilCreated NameServices
Name ServicesName Services provides an overview of ways the box can be reached from the public Internet: domain name, Tor hidden service, and Pagekite. For each type of name, it is shown whether the HTTP, HTTPS, and SSH services are enabled or disabled for incoming connections through the given name. Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/Networks.raw.xml b/doc/Networks.raw.xml index da0ce8533..345fa6062 100644 --- a/doc/Networks.raw.xml +++ b/doc/Networks.raw.xml @@ -1,611 +1,8 @@ - -
- - FreedomBox/Manual/Networks - - - 8 - 2017-03-31 20:04:48 - Drahtseil - Screenshot Network Single - - - 7 - 2017-03-02 16:26:27 - AaronFerrucci - Corrected a few typos - - - 6 - 2016-09-02 05:31:28 - SunilMohanAdapa - Add information about configuring BATMAN-Adv Mesh network - - - 5 - 2016-03-06 20:43:34 - PhilippeBaret - Text correction - - - 4 - 2015-09-13 15:04:43 - SunilMohanAdapa - Demote headings one level for inclusion into manual - - - 3 - 2015-09-12 11:23:58 - SunilMohanAdapa - Update link to renamed Firewall page - - - 2 - 2015-09-12 10:04:19 - SunilMohanAdapa - Add information about Internet connection sharing - - - 1 - 2015-09-12 09:24:59 - SunilMohanAdapa - New page for FreedomBox manual on networking - - - -
- Networks - This section describes how networking is setup by default in FreedomBox and how you can customize it. See also the Firewall section for more information on how firewall works. -
- Default setup - In a fresh image of FreedomBox, network is not configured at all. When the image is written to an SD card and the device boots, configuration is done. During first boot, FreedomBox setup package detects the networks interfaces and tries to automatically configure them so that FreedomBox is available for further configuration via the web interface from another machine without the need to connect a monitor. Automatic configuration also tries to make FreedomBox useful, out of the box, for the most important scenarios FreedomBox is used for. - There are two scenarios it handles: when is a single ethernet interface and when there are multiple ethernet interfaces. -
- Single ethernet interface - When there is only single ethernet interface available on the hardware device, there is not much scope for it to play the role of a router. In this case, the device is assumed to be just another machine in the network. Accordingly, the only available interface is configured to be an internal interface in automatic configuration mode. This means that it connects to the Internet using the configuration provided by a router in the network and also makes all (internal and external) of its services available to all the clients on this network. - - - - - - - network_single.png - - - -
-
- Multiple ethernet interface - When there are multiple ethernet interfaces available on the hardware device, the device can act as a router. The interfaces are then configured to perform this function. - The first network interface is configured to be an WAN or external interface in automatic configuration mode. This means that it connects to the Internet using network configuration provided by the Internet Service Provider (ISP). Only services that are meant to be provided across the entire Internet (external services) will be exposed on this interface. You must plug your Internet connection into the port of this ethernet interface. If you wish to continue to have your existing router manage the Internet connection for you, then plug a connection from your router to the port on this interface. - The remaining network interfaces are configured for the clients of a router. They are configured as LAN or internal interfaces in shared configuration mode. This means that all the services (both external and internal) services are provided to who ever connects on this interface. Further, the shared mode means that clients will be able to receive details of automatic network connection on this interface. Specifically, DHCP configuration and DNS servers are provided on this interface. The Internet connection available to the device using the first network interface will be shared with clients using this interface. This all means that you can connect your computers to this network interface and they will get automatically configured and will be able to access the Internet via the FreedomBox. - Currently, it is not very clear which interface will be come the WAN interface (and the remaining being LAN interfaces) although the assignment process is deterministic. So, it take a bit of trail and error to figure out which one is which. In future, for each device, this will be well documented. -
-
- Wi-Fi configuration - All Wi-Fi interfaces are configured to be LAN or internal interfaces in shared configuration mode. They are also configured to become Wi-Fi access points with following details. - - - Name of the access point will be FreedomBox plus the name of the interface (to handle the case where there are multiple of them). - - - Password for connecting to the interface will be freedombox123. - - -
-
-
- Internet Connection Sharing - Although the primary duty of FreedomBox is to provide decentralized services, it can also act like a home router. Hence, in most cases, FreedomBox connects to the Internet and provides other machines in the network the ability to use that Internet connection. FreedomBox can do this in two ways: using a shared mode connection or using an internal connection. - When an interface is set in shared mode, you may connect your machine directly to it. This is either by plugging in an ethernet cable from this interface to your machine or by connecting to a Wi-Fi access point. This case is the simplest to use, as FreedomBox automatically provides your machine with the necessary network configuration. Your machine will automatically connect to FreedomBox provided network and will be able to connect to the Internet given that FreedomBox can itself connect to the Internet. - Sometimes the above setup may not be possible because the hardware device may have only one network interface or for other reasons. Even in this case, your machine can still connect to the Internet via FreedomBox. For this to work, make sure that the network interface that your machine is connecting to is in internal mode. Then, connect your machine to network in which FreedomBox is present. After this, in your machine's network configuration, set FreedomBox's IP address as the gateway. FreedomBox will then accept your network traffic from your machine and send it over to the Internet. This works because network interfaces in internal mode are configured to masquerade packets from local machines to the Internet and receive packets from Internet and forward them back to local machines. -
-
- Customization - The above default configuration may not be fit for your setup. You can customize the configuration to suit your needs from the Networks area in the 'setup' section of the FreedomBox web interface. -
- PPPoE connections - If your ISP does not provide automatic network configuration via DHCP and requires you to connection via PPPoE. To configure PPPoE, remove any network connection existing on an interface and add a PPPoE connection. Here, optionally, provide the account username and password given by your ISP and activate the connection. -
-
- Connect to Internet via Wi-Fi - By default Wi-Fi devices attached during first boot will be configured as access points. They can be configured as regular Wi-Fi devices instead to connection to a local network or an existing Wi-Fi router. To do this, click on the Wi-Fi connection to edit it. Change the mode to Infrastructure instead of Access Point mode and IPv4 Addressing Method to Automatic (DHCP) instead of Shared mode. Then the SSID provided will mean the Wi-Fi network name you wish to connect to and passphrase will be the used to while making the connection. -
-
- Adding a new network device - When a new network device is added, network manager will automatically configure it. In most cases this will not work to your liking. Delete the automatic configuration created on the interface and create a new network connection. Select your newly added network interface in the add connection page. - - - Then set firewall zone to internal and external appropriately. - - - You can configure the interface to connect to a network or provide network configuration to whatever machine connects to it. - - - Similarly, if it is a Wi-Fi interface, you can configure it to become a Wi-FI access point or to connect to an existing access points in the network. - - -
-
- Configuring a mesh network - FreedomBox has rudimentary support for participating in BATMAN-Adv based mesh networks. It is possible to either join an existing network in your area or create a new mesh network and share your Internet connection with the rest of the nodes that join the network. Currently, two connections have to be created and activated manually to join or create a mesh network. -
- Joining a mesh network - To join an existing mesh network in your area, first consult the organizers and get information about the mesh network. - - - Create a new connection, then select the connection type as Wi-Fi. In the following dialog, provide the following values: - - - - - - - - - - Field Name - - - - - Example Value - - - - - Explanation - - - - - - - Connection Name - - - - Mesh Join - BATMAN - - - The name must end with 'BATMAN' (uppercase) - - - - - - Physical Interface - - - - wlan0 - - - The Wi-Fi device you wish to use for joining the mesh network - - - - - - Firewall Zone - - - - External - - - Since you don't wish that participants in mesh network to use internal services of FreedomBox - - - - - - SSID - - - - ch1.freifunk.net - - - As provided to you by the operators of the mesh network. You should see this as a network in Nearby Wi-Fi Networks - - - - - - Mode - - - - Ad-hoc - - - Because this is a peer-to-peer network - - - - - - Frequency Band - - - - 2.4Ghz - - - As provided to you by the operators of the mesh network - - - - - - Channel - - - - 1 - - - As provided to you by the operators of the mesh network - - - - - - BSSID - - - - 12:CA:FF:EE:BA:BE - - - As provided to you by the operators of the mesh network - - - - - - Authentication - - - - Open - - - Leave this as open, unless you know your mesh network needs it be otherwise - - - - - - Passphrase - - - - - Leave empty unless you know your mesh network requires one - - - - - - IPv4 Addressing Method - - - - Disabled - - - We don't want to request IP configuration information yet - - - - - - Save the connection. Join the mesh network by activating this newly created connection. - - - Create a second new connection, then select the connection type as Generic. In the following dialog, provide this following values: - - - - - - - - - - Field Name - - - - - Example Value - - - - - Explanation - - - - - - - Connection Name - - - - Mesh Connect - - - Any name to identify this connection - - - - - - Physical Interface - - - - bat0 - - - This interface will only show up after you successfully activate the connection in first step - - - - - - Firewall Zone - - - - External - - - Since you don't wish that participants in mesh network to use internal services of FreedomBox - - - - - - IPv4 Addressing Method - - - - Auto - - - Mesh networks usually have a DHCP server somewhere that provide your machine with IP configuration. If not, consult the operator and configure IP address setting accordingly with Manual method - - - - - - Save the connection. Configure your machine for participation in the network by activating this connection. Currently, this connection has to be manually activated every time you need to join the network. In future, FreedomBox will do this automatically. You will now be able reach other nodes in the network. You will also be able to connect to the Internet via the mesh network if there is an Internet connection point somewhere in mesh as setup by the operators. - - -
-
- Creating a mesh network - To create your own mesh network and share your Internet connection with the rest of the nodes in the network: - - - Follow the instructions as provided above in step 1 of Joining a mesh network but choose and fix upon your own valid values for SSID (a name for you mesh network), Frequency Band (usually 2.4Ghz), Channel (1 to 11 in 2.4Ghz band) and BSSID (a hex value like 12:CA:DE:AD:BE:EF). Create this connection and activate it. - - - Follow the instructions as provided above in step 2 of Joining a mesh network but select IPv4 Addressing Method as Shared. This will provide automatic IP configuration to other nodes in the network as well as share the Internet connection on your machine (achieved using a second Wi-Fi interface, using Ethernet, etc.) with other nodes in the mesh network. - - - Spread the word about your mesh network to your neighbors and let them know the parameters you have provided when creating the network. When other nodes connect to this mesh network, they have to follow steps in Joining a mesh network but use the values for SSID, Frequency Band and Channel that you have chosen when you created the mesh network. -
-
-
-
- Manual Network Operation - FreedomBox automatically configures networks by default and provides a simplified interface to customize the configuration to specific needs. In most cases, manual operation is not necessary. The following steps describe how to manually operate network configuration in the event that a user finds FreedomBox interface to insufficient for task at hand or to diagnose a problem that FreedomBox does not identify. - On the command line interface: - For text based user interface for configuring network connections: - - To see the list of available network devices: - - To see the list of configured connections: - - To see the current status of a connection: - ']]> - To see the current firewall zone assigned to a network interface: - ' | grep zone]]> - or - - To create a new network connection: - " ifname "" type ethernet + +
FreedomBox/Manual/Networks82017-03-31 20:04:48DrahtseilScreenshot Network Single72017-03-02 16:26:27AaronFerrucciCorrected a few typos62016-09-02 05:31:28SunilMohanAdapaAdd information about configuring BATMAN-Adv Mesh network52016-03-06 20:43:34PhilippeBaretText correction42015-09-13 15:04:43SunilMohanAdapaDemote headings one level for inclusion into manual32015-09-12 11:23:58SunilMohanAdapaUpdate link to renamed Firewall page22015-09-12 10:04:19SunilMohanAdapaAdd information about Internet connection sharing12015-09-12 09:24:59SunilMohanAdapaNew page for FreedomBox manual on networking
NetworksThis section describes how networking is setup by default in FreedomBox and how you can customize it. See also the Firewall section for more information on how firewall works.
Default setupIn a fresh image of FreedomBox, network is not configured at all. When the image is written to an SD card and the device boots, configuration is done. During first boot, FreedomBox setup package detects the networks interfaces and tries to automatically configure them so that FreedomBox is available for further configuration via the web interface from another machine without the need to connect a monitor. Automatic configuration also tries to make FreedomBox useful, out of the box, for the most important scenarios FreedomBox is used for. There are two scenarios it handles: when is a single ethernet interface and when there are multiple ethernet interfaces.
Single ethernet interfaceWhen there is only single ethernet interface available on the hardware device, there is not much scope for it to play the role of a router. In this case, the device is assumed to be just another machine in the network. Accordingly, the only available interface is configured to be an internal interface in automatic configuration mode. This means that it connects to the Internet using the configuration provided by a router in the network and also makes all (internal and external) of its services available to all the clients on this network. network_single.png
Multiple ethernet interfaceWhen there are multiple ethernet interfaces available on the hardware device, the device can act as a router. The interfaces are then configured to perform this function. The first network interface is configured to be an WAN or external interface in automatic configuration mode. This means that it connects to the Internet using network configuration provided by the Internet Service Provider (ISP). Only services that are meant to be provided across the entire Internet (external services) will be exposed on this interface. You must plug your Internet connection into the port of this ethernet interface. If you wish to continue to have your existing router manage the Internet connection for you, then plug a connection from your router to the port on this interface. The remaining network interfaces are configured for the clients of a router. They are configured as LAN or internal interfaces in shared configuration mode. This means that all the services (both external and internal) services are provided to who ever connects on this interface. Further, the shared mode means that clients will be able to receive details of automatic network connection on this interface. Specifically, DHCP configuration and DNS servers are provided on this interface. The Internet connection available to the device using the first network interface will be shared with clients using this interface. This all means that you can connect your computers to this network interface and they will get automatically configured and will be able to access the Internet via the FreedomBox. Currently, it is not very clear which interface will be come the WAN interface (and the remaining being LAN interfaces) although the assignment process is deterministic. So, it take a bit of trail and error to figure out which one is which. In future, for each device, this will be well documented.
Wi-Fi configurationAll Wi-Fi interfaces are configured to be LAN or internal interfaces in shared configuration mode. They are also configured to become Wi-Fi access points with following details. Name of the access point will be FreedomBox plus the name of the interface (to handle the case where there are multiple of them). Password for connecting to the interface will be freedombox123.
Internet Connection SharingAlthough the primary duty of FreedomBox is to provide decentralized services, it can also act like a home router. Hence, in most cases, FreedomBox connects to the Internet and provides other machines in the network the ability to use that Internet connection. FreedomBox can do this in two ways: using a shared mode connection or using an internal connection. When an interface is set in shared mode, you may connect your machine directly to it. This is either by plugging in an ethernet cable from this interface to your machine or by connecting to a Wi-Fi access point. This case is the simplest to use, as FreedomBox automatically provides your machine with the necessary network configuration. Your machine will automatically connect to FreedomBox provided network and will be able to connect to the Internet given that FreedomBox can itself connect to the Internet. Sometimes the above setup may not be possible because the hardware device may have only one network interface or for other reasons. Even in this case, your machine can still connect to the Internet via FreedomBox. For this to work, make sure that the network interface that your machine is connecting to is in internal mode. Then, connect your machine to network in which FreedomBox is present. After this, in your machine's network configuration, set FreedomBox's IP address as the gateway. FreedomBox will then accept your network traffic from your machine and send it over to the Internet. This works because network interfaces in internal mode are configured to masquerade packets from local machines to the Internet and receive packets from Internet and forward them back to local machines.
CustomizationThe above default configuration may not be fit for your setup. You can customize the configuration to suit your needs from the Networks area in the 'setup' section of the FreedomBox web interface.
PPPoE connectionsIf your ISP does not provide automatic network configuration via DHCP and requires you to connection via PPPoE. To configure PPPoE, remove any network connection existing on an interface and add a PPPoE connection. Here, optionally, provide the account username and password given by your ISP and activate the connection.
Connect to Internet via Wi-FiBy default Wi-Fi devices attached during first boot will be configured as access points. They can be configured as regular Wi-Fi devices instead to connection to a local network or an existing Wi-Fi router. To do this, click on the Wi-Fi connection to edit it. Change the mode to Infrastructure instead of Access Point mode and IPv4 Addressing Method to Automatic (DHCP) instead of Shared mode. Then the SSID provided will mean the Wi-Fi network name you wish to connect to and passphrase will be the used to while making the connection.
Adding a new network deviceWhen a new network device is added, network manager will automatically configure it. In most cases this will not work to your liking. Delete the automatic configuration created on the interface and create a new network connection. Select your newly added network interface in the add connection page. Then set firewall zone to internal and external appropriately. You can configure the interface to connect to a network or provide network configuration to whatever machine connects to it. Similarly, if it is a Wi-Fi interface, you can configure it to become a Wi-FI access point or to connect to an existing access points in the network.
Configuring a mesh networkFreedomBox has rudimentary support for participating in BATMAN-Adv based mesh networks. It is possible to either join an existing network in your area or create a new mesh network and share your Internet connection with the rest of the nodes that join the network. Currently, two connections have to be created and activated manually to join or create a mesh network.
Joining a mesh networkTo join an existing mesh network in your area, first consult the organizers and get information about the mesh network. Create a new connection, then select the connection type as Wi-Fi. In the following dialog, provide the following values: Field NameExample ValueExplanation Connection Name Mesh Join - BATMAN The name must end with 'BATMAN' (uppercase) Physical Interface wlan0 The Wi-Fi device you wish to use for joining the mesh network Firewall Zone External Since you don't wish that participants in mesh network to use internal services of FreedomBox SSID ch1.freifunk.net As provided to you by the operators of the mesh network. You should see this as a network in Nearby Wi-Fi Networks Mode Ad-hoc Because this is a peer-to-peer network Frequency Band 2.4Ghz As provided to you by the operators of the mesh network Channel 1 As provided to you by the operators of the mesh network BSSID 12:CA:FF:EE:BA:BE As provided to you by the operators of the mesh network Authentication Open Leave this as open, unless you know your mesh network needs it be otherwise Passphrase Leave empty unless you know your mesh network requires one IPv4 Addressing Method Disabled We don't want to request IP configuration information yet Save the connection. Join the mesh network by activating this newly created connection. Create a second new connection, then select the connection type as Generic. In the following dialog, provide this following values: Field NameExample ValueExplanation Connection Name Mesh Connect Any name to identify this connection Physical Interface bat0 This interface will only show up after you successfully activate the connection in first step Firewall Zone External Since you don't wish that participants in mesh network to use internal services of FreedomBox IPv4 Addressing Method Auto Mesh networks usually have a DHCP server somewhere that provide your machine with IP configuration. If not, consult the operator and configure IP address setting accordingly with Manual method Save the connection. Configure your machine for participation in the network by activating this connection. Currently, this connection has to be manually activated every time you need to join the network. In future, FreedomBox will do this automatically. You will now be able reach other nodes in the network. You will also be able to connect to the Internet via the mesh network if there is an Internet connection point somewhere in mesh as setup by the operators.
Creating a mesh networkTo create your own mesh network and share your Internet connection with the rest of the nodes in the network: Follow the instructions as provided above in step 1 of Joining a mesh network but choose and fix upon your own valid values for SSID (a name for you mesh network), Frequency Band (usually 2.4Ghz), Channel (1 to 11 in 2.4Ghz band) and BSSID (a hex value like 12:CA:DE:AD:BE:EF). Create this connection and activate it. Follow the instructions as provided above in step 2 of Joining a mesh network but select IPv4 Addressing Method as Shared. This will provide automatic IP configuration to other nodes in the network as well as share the Internet connection on your machine (achieved using a second Wi-Fi interface, using Ethernet, etc.) with other nodes in the mesh network. Spread the word about your mesh network to your neighbors and let them know the parameters you have provided when creating the network. When other nodes connect to this mesh network, they have to follow steps in Joining a mesh network but use the values for SSID, Frequency Band and Channel that you have chosen when you created the mesh network.
Manual Network OperationFreedomBox automatically configures networks by default and provides a simplified interface to customize the configuration to specific needs. In most cases, manual operation is not necessary. The following steps describe how to manually operate network configuration in the event that a user finds FreedomBox interface to insufficient for task at hand or to diagnose a problem that FreedomBox does not identify. On the command line interface: For text based user interface for configuring network connections: To see the list of available network devices: To see the list of configured connections: To see the current status of a connection: ']]>To see the current firewall zone assigned to a network interface: ' | grep zone]]>or To create a new network connection: " ifname "" type ethernet nmcli con modify "" connection.autoconnect TRUE -nmcli con modify "" connection.zone internal]]> - To change the firewall zone for a connection: - " connection.zone ""]]> - For more information on how to use nmcli command, see its man page. Also for a full list of configuration settings and type of connections accepted by Network Manager see: - - - - To see the current status of the firewall and manually operate it, see the Firewall section. - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
+nmcli con modify "" connection.zone internal]]>To change the firewall zone for a connection: " connection.zone ""]]>For more information on how to use nmcli command, see its man page. Also for a full list of configuration settings and type of connections accepted by Network Manager see: To see the current status of the firewall and manually operate it, see the Firewall section. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/OpenVPN.raw.xml b/doc/OpenVPN.raw.xml index a1c94c168..7b67b979d 100644 --- a/doc/OpenVPN.raw.xml +++ b/doc/OpenVPN.raw.xml @@ -1,291 +1,7 @@ - -
- - FreedomBox/Manual/OpenVPN - - - 8 - 2016-12-31 04:01:13 - JamesValleroy - clarify install vs setup - - - 7 - 2016-09-09 15:37:55 - SunilMohanAdapa - Minor indentation fix with screenshot - - - 6 - 2016-09-01 19:14:03 - Drahtseil - adapted title to Plinth wording - - - 5 - 2016-08-14 19:39:09 - JanCostermans - added screenshot and setting up sections - - - 4 - 2016-04-10 07:16:50 - PhilippeBaret - Added bottom navigation link - - - 3 - 2015-12-16 00:32:58 - PhilippeBaret - Text finishing - - - 2 - 2015-12-16 00:28:34 - PhilippeBaret - Added definition for OpenVPN - - - 1 - 2015-12-15 23:58:42 - PhilippeBaret - Added first content [OpenVPN page to Apps manual] - - - -
- Virtual Private Network (OpenVPN) -
- What is OpenVPN? - OpenVPN provides to your FreedomBox a virtual private network service. You can use this software for remote access, site-to-site VPNs and Wi-Fi security. OpenVPN includes support for dynamic IP addresses and NAT. -
-
- Setting up - - - In Plinth apps menu, select Virtual Private Network (OpenVPN) and click Install. - - - After the module is installed, there is an additional setup step that may take a long time to complete. Click "Start setup" to begin. - - - - - - - plinth_openvpn.png - - - - - - Wait for the setup to finish. This could take a while. - - - Once the setup of the OpenVPN server is complete, you can download your profile. This will download a file called <USER>.ovpn, where <USER> is the name of a FreedomBox user. Each FreedomBox user will be able to download a different profile. - - - The ovpn file contains all the information a vpn client needs to connect to the server. - - - If you are behind a modem, you may have to change the ip address (if not, you can skip this step). Open the ovpn file in any text editor. The second line shows the IP address or hostname the client will try to connect to. This should be your WAN IP address or your hostname. This line also contains the port number, 1194 being the default. You may have to open this port on your modem and enable port forwarding. - - - +
FreedomBox/Manual/OpenVPN82016-12-31 04:01:13JamesValleroyclarify install vs setup72016-09-09 15:37:55SunilMohanAdapaMinor indentation fix with screenshot62016-09-01 19:14:03Drahtseiladapted title to Plinth wording52016-08-14 19:39:09JanCostermansadded screenshot and setting up sections42016-04-10 07:16:50PhilippeBaretAdded bottom navigation link32015-12-16 00:32:58PhilippeBaretText finishing22015-12-16 00:28:34PhilippeBaretAdded definition for OpenVPN12015-12-15 23:58:42PhilippeBaretAdded first content [OpenVPN page to Apps manual]
Virtual Private Network (OpenVPN)
What is OpenVPN?OpenVPN provides to your FreedomBox a virtual private network service. You can use this software for remote access, site-to-site VPNs and Wi-Fi security. OpenVPN includes support for dynamic IP addresses and NAT.
Setting upIn Plinth apps menu, select Virtual Private Network (OpenVPN) and click Install. After the module is installed, there is an additional setup step that may take a long time to complete. Click "Start setup" to begin. plinth_openvpn.png Wait for the setup to finish. This could take a while. Once the setup of the OpenVPN server is complete, you can download your profile. This will download a file called <USER>.ovpn, where <USER> is the name of a FreedomBox user. Each FreedomBox user will be able to download a different profile. The ovpn file contains all the information a vpn client needs to connect to the server. If you are behind a modem, you may have to change the ip address (if not, you can skip this step). Open the ovpn file in any text editor. The second line shows the IP address or hostname the client will try to connect to. This should be your WAN IP address or your hostname. This line also contains the port number, 1194 being the default. You may have to open this port on your modem and enable port forwarding. - - - Install an OpenVPN client for your system - - - Open the ovpn file with the OpenVPN client. - - - Try to ping the FreedomBox or other devices on the local network. - - -
-
- External Links - - - - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
+proto udp]]>Install an OpenVPN client for your system Open the ovpn file with the OpenVPN client. Try to ping the FreedomBox or other devices on the local network.
External Links Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/PageKite.raw.xml b/doc/PageKite.raw.xml index 18b126521..cb6a22ef1 100644 --- a/doc/PageKite.raw.xml +++ b/doc/PageKite.raw.xml @@ -1,290 +1,5 @@ - -
- - FreedomBox/Manual/PageKite - - - 12 - 2017-01-07 20:37:22 - JamesValleroy - add info on getting certificate - - - 11 - 2017-01-07 20:21:47 - JamesValleroy - add instructions - - - 10 - 2017-01-07 20:14:44 - JamesValleroy - clarify how pagekite works - - - 9 - 2016-09-01 19:19:45 - Drahtseil - adapted title to Plinth wording - - - 8 - 2016-04-10 07:13:20 - PhilippeBaret - Added navigation link - - - 7 - 2015-12-15 20:50:09 - PhilippeBaret - Correction - - - 6 - 2015-12-15 19:28:57 - PhilippeBaret - Added more definition - - - 5 - 2015-12-15 19:19:27 - PhilippeBaret - Added pagekite extended definition - - - 4 - 2015-09-13 14:58:24 - SunilMohanAdapa - Add headings for inclusion into manual - - - 3 - 2015-09-13 13:18:15 - SunilMohanAdapa - Move PageKite page to manual - - - 2 - 2015-02-13 05:01:10 - SunilMohanAdapa - Include FreedomBox portal in footer - - - 1 - 2012-09-14 07:37:02 - planetlarg - - - -
- Public Visibility (PageKite) -
- What is PageKite? - PageKite makes local websites and services publicly accessible immediately without creating yourself a public IP address. It does this by tunneling protocols such as HTTPS or SSH through firewalls and NAT. Using PageKite requires an account on a PageKite relay service. One such service is . - A PageKite relay service will allow you to create kites. Kites are similar to domain names, but with different advantages and drawbacks. A kite can have a number of configured services. PageKite is known to work with HTTP, HTTPS, and SSH, and may work with some other services, but not all. -
-
- Using PageKite - - - Create an account on a PageKite relay service. - - - Add a kite to your account. Note your kite name and kite secret. - - - In Plinth, go to the "Configure PageKite" tab on the Public Visibility (PageKite) page. - - - Check the "Enable PageKite" box, then enter your kite name and kite secret. Click "Save settings". - - - On the "Standard Services" tab, you can enable HTTP and HTTPS (recommended) and SSH (optional). - - - HTTP is needed to obtain the Let's Encrypt certificate. You can disable it later. - - - - - On the Certificates (Let's Encrypt) page, you can obtain a Let's Encrypt certificate for your kite name. - - - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
+ +
FreedomBox/Manual/PageKite122017-01-07 20:37:22JamesValleroyadd info on getting certificate112017-01-07 20:21:47JamesValleroyadd instructions102017-01-07 20:14:44JamesValleroyclarify how pagekite works92016-09-01 19:19:45Drahtseiladapted title to Plinth wording82016-04-10 07:13:20PhilippeBaretAdded navigation link72015-12-15 20:50:09PhilippeBaretCorrection62015-12-15 19:28:57PhilippeBaretAdded more definition52015-12-15 19:19:27PhilippeBaretAdded pagekite extended definition42015-09-13 14:58:24SunilMohanAdapaAdd headings for inclusion into manual32015-09-13 13:18:15SunilMohanAdapaMove PageKite page to manual22015-02-13 05:01:10SunilMohanAdapaInclude FreedomBox portal in footer12012-09-14 07:37:02planetlarg
Public Visibility (PageKite)
What is PageKite?PageKite makes local websites and services publicly accessible immediately without creating yourself a public IP address. It does this by tunneling protocols such as HTTPS or SSH through firewalls and NAT. Using PageKite requires an account on a PageKite relay service. One such service is . A PageKite relay service will allow you to create kites. Kites are similar to domain names, but with different advantages and drawbacks. A kite can have a number of configured services. PageKite is known to work with HTTP, HTTPS, and SSH, and may work with some other services, but not all.
Using PageKiteCreate an account on a PageKite relay service. Add a kite to your account. Note your kite name and kite secret. In Plinth, go to the "Configure PageKite" tab on the Public Visibility (PageKite) page. Check the "Enable PageKite" box, then enter your kite name and kite secret. Click "Save settings". On the "Standard Services" tab, you can enable HTTP and HTTPS (recommended) and SSH (optional). HTTP is needed to obtain the Let's Encrypt certificate. You can disable it later. On the Certificates (Let's Encrypt) page, you can obtain a Let's Encrypt certificate for your kite name. Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/Power.raw.xml b/doc/Power.raw.xml index d3a654764..d608eea63 100644 --- a/doc/Power.raw.xml +++ b/doc/Power.raw.xml @@ -1,199 +1,5 @@ - -
- - FreedomBox/Manual/Power - - - 2 - 2017-01-07 20:38:36 - JamesValleroy - note confirmation - - - 1 - 2016-08-21 09:29:59 - Drahtseil - Created Power - - - -
- Power - Power provides an easy way to restart or shut down FreedomBox. After you select "Restart" or "Shut Down", you will be asked to confirm. - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
+ +
FreedomBox/Manual/Power22017-01-07 20:38:36JamesValleroynote confirmation12016-08-21 09:29:59DrahtseilCreated Power
PowerPower provides an easy way to restart or shut down FreedomBox. After you select "Restart" or "Shut Down", you will be asked to confirm. Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/Privoxy.raw.xml b/doc/Privoxy.raw.xml index 64068d25d..efa30b0ed 100644 --- a/doc/Privoxy.raw.xml +++ b/doc/Privoxy.raw.xml @@ -1,317 +1,5 @@ - -
- - FreedomBox/Manual/Privoxy - - - 10 - 2018-03-11 03:09:16 - JosephNuthalapati - Fix oversized images - - - 9 - 2016-09-09 15:39:20 - SunilMohanAdapa - Minor indentation fix with screenshots - - - 8 - 2016-09-09 15:31:16 - SunilMohanAdapa - Promote the visibility of the screencast - - - 7 - 2016-08-09 19:09:55 - Drahtseil - configuration for advanced users - - - 6 - 2016-08-06 20:02:42 - Drahtseil - Screencast of the setting up - - - 5 - 2016-08-06 17:57:33 - Drahtseil - screenshots - - - 4 - 2016-08-01 19:38:35 - Drahtseil - Very basic restructuring as preparation for more work to be done. - - - 3 - 2016-04-10 07:24:20 - PhilippeBaret - Added bottom navigation link - - - 2 - 2015-12-15 20:54:14 - PhilippeBaret - Added link to Privoxy FAQ - - - 1 - 2015-12-15 20:22:00 - PhilippeBaret - Added Privoxy page and definition - - - -
- Web Proxy (Privoxy) - A web proxy acts as a filter for incoming and outgoing internet traffic. Thus, you can instruct any computer in your network to pass internet traffic through the proxy to remove unwanted ads and tracking mechanisms. - Privoxy is a software for security, privacy, and accurate control over the web. It provides a much more powerful web proxy (and anonymity on the web) than what your browser can offer. Privoxy "is a proxy that is primarily focused on privacy enhancement, ad and junk elimination and freeing the user from restrictions placed on his activities" (source: Privoxy FAQ). -
- Screencast - Watch the screencast on how to setup and use Privoxy in FreedomBox. -
-
- Setting up - - - In Plinth install Web Proxy (Privoxy) - - - - - - - Privoxy Installation - - - - - - Adapt your browser proxy settings to your FreedomBox hostname (or IP address) with port 8118. Please note that Privoxy can only proxy HTTP and HTTPS traffic. It will not work with FTP or other protocols. - - - - - - - Privoxy Browser Settings - - - - - - Go to page or . If Privoxy is installed properly, you will be able to configure it in detail; if not you will see an error message. - - - If you are using a laptop that occasionally has to connect through other routers than yours with the FreedomBox and Privoxy, you may want to install a proxy switch add-on that allows you to easily turn the proxy on or off. - - -
-
- Advanced Users - - - The default installation should provide a reasonable starting point for most. There will undoubtedly be occasions where you will want to adjust the configuration, that can be dealt with as the need arises. - - - While using Privoxy, you can see its configuration details and documentation at or . - - - To enable changing these configurations, you first have to change the value of enable-edit-actions in /etc/privoxy/config to 1. Before doing so, read carefully the manual, especially: - - - - Access to the editor can not be controlled separately by "ACLs" or HTTP authentication, so that everybody who can access Privoxy can modify its configuration for all users. This option is not recommended for environments with untrusted users. Note that malicious client side code (e.g Java) is also capable of using the actions editor and you shouldn't enable this options unless you understand the consequences and are sure your browser is configured correctly. - - - - - - Now you find an EDIT button on the configuration screen in http://config.privoxy.org/. - - - The Quickstart is a good starting point to read on how to define own blocking and filtering rules. - - - - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
+ +
FreedomBox/Manual/Privoxy102018-03-11 03:09:16JosephNuthalapatiFix oversized images92016-09-09 15:39:20SunilMohanAdapaMinor indentation fix with screenshots82016-09-09 15:31:16SunilMohanAdapaPromote the visibility of the screencast72016-08-09 19:09:55Drahtseilconfiguration for advanced users62016-08-06 20:02:42DrahtseilScreencast of the setting up52016-08-06 17:57:33Drahtseilscreenshots42016-08-01 19:38:35DrahtseilVery basic restructuring as preparation for more work to be done.32016-04-10 07:24:20PhilippeBaretAdded bottom navigation link22015-12-15 20:54:14PhilippeBaretAdded link to Privoxy FAQ12015-12-15 20:22:00PhilippeBaretAdded Privoxy page and definition
Web Proxy (Privoxy)A web proxy acts as a filter for incoming and outgoing internet traffic. Thus, you can instruct any computer in your network to pass internet traffic through the proxy to remove unwanted ads and tracking mechanisms. Privoxy is a software for security, privacy, and accurate control over the web. It provides a much more powerful web proxy (and anonymity on the web) than what your browser can offer. Privoxy "is a proxy that is primarily focused on privacy enhancement, ad and junk elimination and freeing the user from restrictions placed on his activities" (source: Privoxy FAQ).
ScreencastWatch the screencast on how to setup and use Privoxy in FreedomBox.
Setting upIn Plinth install Web Proxy (Privoxy) Privoxy Installation Adapt your browser proxy settings to your FreedomBox hostname (or IP address) with port 8118. Please note that Privoxy can only proxy HTTP and HTTPS traffic. It will not work with FTP or other protocols. Privoxy Browser Settings Go to page or . If Privoxy is installed properly, you will be able to configure it in detail; if not you will see an error message. If you are using a laptop that occasionally has to connect through other routers than yours with the FreedomBox and Privoxy, you may want to install a proxy switch add-on that allows you to easily turn the proxy on or off.
Advanced UsersThe default installation should provide a reasonable starting point for most. There will undoubtedly be occasions where you will want to adjust the configuration, that can be dealt with as the need arises. While using Privoxy, you can see its configuration details and documentation at or . To enable changing these configurations, you first have to change the value of enable-edit-actions in /etc/privoxy/config to 1. Before doing so, read carefully the manual, especially: Access to the editor can not be controlled separately by "ACLs" or HTTP authentication, so that everybody who can access Privoxy can modify its configuration for all users. This option is not recommended for environments with untrusted users. Note that malicious client side code (e.g Java) is also capable of using the actions editor and you shouldn't enable this options unless you understand the consequences and are sure your browser is configured correctly. Now you find an EDIT button on the configuration screen in http://config.privoxy.org/. The Quickstart is a good starting point to read on how to define own blocking and filtering rules. Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/Quassel.raw.xml b/doc/Quassel.raw.xml index 4e85957b8..729494481 100644 --- a/doc/Quassel.raw.xml +++ b/doc/Quassel.raw.xml @@ -1,313 +1,5 @@ - -
- - FreedomBox/Manual/Quassel - - - 3 - 2018-03-11 03:00:04 - JosephNuthalapati - Fix oversized image - - - 2 - 2016-08-18 17:30:28 - Drahtseil - wording, screen-shots - - - 1 - 2016-08-17 20:09:38 - Drahtseil - page creation; not sure about the configuration of quassel-client (too long ago); screenshots to follow - - - -
- IRC Client (Quassel) - Quassel is an IRC application that is split into two parts, a "core" and a "client". This allows the core to remain connected to IRC servers, and to continue receiving messages, even when the client is disconnected. FreedomBox can run the Quassel core service keeping you always online and one or more Quassel clients from a desktop or a mobile device can be used to connect and disconnect from it. -
- Why running Quassel? - Many discussions about FreedomBox are being done on the IRC-Channel irc://irc.debian.org/freedombox. If your FreedomBox is running Quassel, it will collect all discussions while you are away, such as responses to your questions. Remember, the FreedomBox project is a worldwide project with people from nearly every time zone. You use your client to connect to the Quassel core to read and respond whenever you have time and are available. -
-
- How to setup Quassel? - - - Within Plinth - - - select Applications - - - go to IRC Client (Quassel) and - - - install the application and make sure it is enabled - - - - - - - Quassel Installation - - - - - - now your Quassel core is running - - - - - Configure in your router port forwarding for port 4242 - - - on my device, this setting can be found in the section Network > NAT & Port rules > Port Forwarding - - - - - - - Quassel_PortForwarding.png - - - - - - - -
-
- Clients - Clients to connect to Quassel from your desktop and mobile devices are available. - In a Debian system, you can e.g. use quassel-client - - - With the first start you create a user-ID you want to use in your IRC channel - - - Configure the network connection, e.g. server irc.debian.org/freedombox - - - Communication takes place in a channel, e.g. freedombox - - - Add a core - - - Chose an account name - - - Computer name is the DNS name to access your FreedomBox - - - Port: 4242 - - - User and password - - - - - For Android devices you may use e.g. Quasseldroid from F-Droid - - - enter core, username etc. as above - - - - - - - - - Quasseldroid.png - - - - - - - - By the way, the German verb quasseln means talking a lot, to jabber. - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
+ +
FreedomBox/Manual/Quassel32018-03-11 03:00:04JosephNuthalapatiFix oversized image22016-08-18 17:30:28Drahtseilwording, screen-shots12016-08-17 20:09:38Drahtseilpage creation; not sure about the configuration of quassel-client (too long ago); screenshots to follow
IRC Client (Quassel)Quassel is an IRC application that is split into two parts, a "core" and a "client". This allows the core to remain connected to IRC servers, and to continue receiving messages, even when the client is disconnected. FreedomBox can run the Quassel core service keeping you always online and one or more Quassel clients from a desktop or a mobile device can be used to connect and disconnect from it.
Why running Quassel?Many discussions about FreedomBox are being done on the IRC-Channel irc://irc.debian.org/freedombox. If your FreedomBox is running Quassel, it will collect all discussions while you are away, such as responses to your questions. Remember, the FreedomBox project is a worldwide project with people from nearly every time zone. You use your client to connect to the Quassel core to read and respond whenever you have time and are available.
How to setup Quassel?Within Plinth select Applications go to IRC Client (Quassel) and install the application and make sure it is enabled Quassel Installation now your Quassel core is running Configure in your router port forwarding for port 4242 on my device, this setting can be found in the section Network > NAT & Port rules > Port Forwarding Quassel_PortForwarding.png
ClientsClients to connect to Quassel from your desktop and mobile devices are available. In a Debian system, you can e.g. use quassel-client With the first start you create a user-ID you want to use in your IRC channel Configure the network connection, e.g. server irc.debian.org/freedombox Communication takes place in a channel, e.g. freedombox Add a core Chose an account name Computer name is the DNS name to access your FreedomBox Port: 4242 User and password For Android devices you may use e.g. Quasseldroid from F-Droid enter core, username etc. as above Quasseldroid.png By the way, the German verb quasseln means talking a lot, to jabber. Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/Radicale.raw.xml b/doc/Radicale.raw.xml index 09fb8d216..e2d422610 100644 --- a/doc/Radicale.raw.xml +++ b/doc/Radicale.raw.xml @@ -1,638 +1,25 @@ - -
- - FreedomBox/Manual/Radicale - - - 34 - 2018-07-10 18:04:49 - BartNotelaers - - - 33 - 2018-06-17 16:36:11 - JosephNuthalapati - Add a missing instruction on how to synchronize using DAVdroid - - - 32 - 2018-06-01 10:48:04 - JosephNuthalapati - Update DAVdroid account setup with screenshots - - - 31 - 2018-01-03 08:54:14 - JosephNuthalapati - Update broken link - radicale clients - - - 30 - 2017-08-06 23:06:11 - JohannesKeyser - updated dead link to radicale client page, and added warning about misleading URL info - - - 29 - 2016-12-31 02:28:01 - JamesValleroy - style changes - - - 28 - 2016-09-09 15:36:28 - SunilMohanAdapa - Minor indentation fix with screenshot - - - 27 - 2016-09-09 14:43:07 - SunilMohanAdapa - Minor fix to adjust screenshot - - - 26 - 2016-09-01 19:11:38 - Drahtseil - adapted title to Plinth wording - - - 25 - 2016-08-31 17:26:23 - Drahtseil - updated screenshot - - - 24 - 2016-08-31 17:24:42 - Drahtseil - Access rights - - - 23 - 2016-08-01 16:32:28 - Drahtseil - - - 22 - 2016-08-01 16:28:29 - Drahtseil - screenshots - - - 21 - 2016-08-01 16:18:30 - Drahtseil - Evolution tutorial to use Calendar instead of Contacts (just happen to have that screenshot) - - - 20 - 2016-07-31 18:21:39 - Drahtseil - Android, advanced user, screenshots still to follow - - - 19 - 2016-07-31 16:54:46 - Drahtseil - - - 18 - 2016-05-18 12:40:51 - SunilMohanAdapa - Reduce item nesting to < 4 due to problems in generating FreedomBox Manual - - - 17 - 2016-04-27 03:35:17 - StacyCockrum - formatting - - - 16 - 2016-04-27 03:24:18 - StacyCockrum - Editing and added instructions for Evolution Calendar. - - - 15 - 2016-04-26 06:11:34 - PhilippeBaret - Editing - - - 14 - 2016-04-25 11:43:17 - StacyCockrum - - - 13 - 2016-04-25 11:36:30 - StacyCockrum - I'm not sure if this is the right place to put this kind of information. I thought it would be helpful for a person to know some specifics around the settings. Pls advise if it should go somewhere e - - - 12 - 2016-04-16 01:38:12 - PhilippeBaret - Added Why Radical app content - - - 11 - 2016-04-16 01:36:07 - PhilippeBaret - Correction - - - 10 - 2016-04-15 14:58:18 - StacyCockrum - 2nd bullet under "How to setup...?" Is it true that a new calendar/address book is created for each client or perhaps the clients need to be configured to access the calendar/address books? - - - 9 - 2016-04-15 14:53:50 - StacyCockrum - Struggled with the last sentence of the first bullet under "How to setup Radicale?". When the Radicale server is launched does CalDAV become a function of the server or is a CalDAV server? - - - 8 - 2016-04-11 09:04:25 - PhilippeBaret - Correction - - - 7 - 2016-04-11 09:02:38 - PhilippeBaret - Correction proper terms: CalDAV and CardDAV - - - 6 - 2016-04-11 09:01:11 - PhilippeBaret - Added Why running Radicale section - - - 5 - 2016-04-11 08:53:27 - PhilippeBaret - Correction - - - 4 - 2016-04-11 08:48:16 - PhilippeBaret - Added how to setup Radical server and clients in FreedomBox Manual - - - 3 - 2016-04-10 07:12:39 - PhilippeBaret - Added manual link - - - 2 - 2016-04-10 07:09:27 - PhilippeBaret - Added Radicale definition on FreedomBox manual - - - 1 - 2016-04-10 06:40:28 - PhilippeBaret - Added first content to Radicale manual page - - - -
- Calendar and Addressbook (Radicale) - With Radicale, you can synchronize your personal calendars, ToDo lists, and addressbooks with your various computers, tablets, and smartphones, and share them with friends, without letting third parties know your personal schedule or contacts. -
- Why should I run Radicale? - Using Radicale, you can get rid of centralized services like Google Calendar or Apple Calendar (iCloud) data mining your events and social connections. -
-
- How to setup Radicale? - First, the Radicale server needs to be activated on your box. - - - Within Plinth - - - select Applications - - - go to Calendar and Addressbook (Radicale) and - - - install the application. After the installation is complete, make sure the application is marked "enabled" in the FreedomBox interface. Enabling the application launches the Radicale CalDAV/CardDAV server. - - - define the access rights: - - - Only the owner of a calendar/addressbook can view or make changes - - - Any user can view any calendar/addressbook, but only the owner can make changes - - - Any user can view or make changes to any calendar/addressbook - - - - - - - Note, that only users with a FreedomBox login can access Radicale. - - - - - - - Radicale-Plinth.png - - - - If you want to share a calendar with only some users, the simplest approach is to create an additional user-name for these users and to share that user-name and password with them. - Radicale does not have a user interface. An external supported client application is needed. - Now open your client application to create new calendar and address books that will use your FreedomBox and Radicale server. The Radicale website provides an overview of supported clients, but do not use the URLs described there; FreedomBox uses another setup, follow this manual. Below are the steps for two examples: - - - Example of setup with Evolution client: - - - Calendar - - - Create a new calendar - - - For "Type," select "CalDAV" - - - When "CalDAV" is selected, additional options will appear in the dialogue window. - - - URL: https://IP-address-or-domain-for-your-server/radicale/user/contact-file-name.ics/. Items in italics need to be changed to match your settings. - - - note the trailing / in the path, it is important. - - - - - Enable "Use a secure connection." - - - Name the calendar - - - - - - - Radicale-Evolution-Docu.png - - - - - - - - TODO/Tasks list: Adding a TODO/Tasks list is basically the same as a calendar. - - - Contacts - - - Follow the same steps described above and replace CalDAV with WebDAV. The extension of the address book will be .vcf. - - - - - - -
-
- Synchronizing with your Android phone - There are various Apps that allow integration with the Radicale server. This example uses DAVdroid, which is available e.g. on F-Droid. If you intend to use ToDo-Lists as well, the compatible app OpenTasks has to be installed first. - Follow these steps for setting up your account with the Radicale server running on your FreedomBox. - - - Install DAVdroid - - - Create a new account on DAVdroid by clicking on the floating + button. - - - Select the second option as shown in the first figure below and enter the base url as (see the first screenshot below). DAVdroid will be able to discover both CalDAV and WebDAV accounts for the user. - - - Follow this video from DAVdroid FAQ to learn how to migrate your existing contacts to Radicale. - - - - Synchronizing contacts - - - - Click on the hamburger menus of CalDAV and CardDAV and select either "Refresh ..." in case of existing accounts or "Create ..." in case of new accounts (see the second screenshot below). - - - Check the checkboxes for the address books and calendars you want to synchronize and click on the sync button in the header. (see the third screenshot below) - - - - - - - - - DAVdroid account setup - - - - - - - - DAVdroid refresh - - - - - - - - DAVdroid account sync - - - -
-
- Advanced Users -
- Sharing resources - Above was shown an easy way to create a resource for a group of people by creating a dedicated account for all. Here will be described an alternative method where two users User1 and User2 are granted access to a calendar. This requires SSH-access to the FreedomBox. - - - create a file /etc/radicale/rights - - - +
FreedomBox/Manual/Radicale342018-07-10 18:04:49BartNotelaers332018-06-17 16:36:11JosephNuthalapatiAdd a missing instruction on how to synchronize using DAVdroid322018-06-01 10:48:04JosephNuthalapatiUpdate DAVdroid account setup with screenshots312018-01-03 08:54:14JosephNuthalapatiUpdate broken link - radicale clients302017-08-06 23:06:11JohannesKeyserupdated dead link to radicale client page, and added warning about misleading URL info292016-12-31 02:28:01JamesValleroystyle changes282016-09-09 15:36:28SunilMohanAdapaMinor indentation fix with screenshot272016-09-09 14:43:07SunilMohanAdapaMinor fix to adjust screenshot262016-09-01 19:11:38Drahtseiladapted title to Plinth wording252016-08-31 17:26:23Drahtseilupdated screenshot242016-08-31 17:24:42DrahtseilAccess rights232016-08-01 16:32:28Drahtseil222016-08-01 16:28:29Drahtseilscreenshots212016-08-01 16:18:30DrahtseilEvolution tutorial to use Calendar instead of Contacts (just happen to have that screenshot)202016-07-31 18:21:39DrahtseilAndroid, advanced user, screenshots still to follow192016-07-31 16:54:46Drahtseil182016-05-18 12:40:51SunilMohanAdapaReduce item nesting to < 4 due to problems in generating FreedomBox Manual172016-04-27 03:35:17StacyCockrumformatting162016-04-27 03:24:18StacyCockrumEditing and added instructions for Evolution Calendar.152016-04-26 06:11:34PhilippeBaretEditing142016-04-25 11:43:17StacyCockrum132016-04-25 11:36:30StacyCockrumI'm not sure if this is the right place to put this kind of information. I thought it would be helpful for a person to know some specifics around the settings. Pls advise if it should go somewhere e122016-04-16 01:38:12PhilippeBaretAdded Why Radical app content112016-04-16 01:36:07PhilippeBaretCorrection102016-04-15 14:58:18StacyCockrum2nd bullet under "How to setup...?" Is it true that a new calendar/address book is created for each client or perhaps the clients need to be configured to access the calendar/address books?92016-04-15 14:53:50StacyCockrumStruggled with the last sentence of the first bullet under "How to setup Radicale?". When the Radicale server is launched does CalDAV become a function of the server or is a CalDAV server?82016-04-11 09:04:25PhilippeBaretCorrection72016-04-11 09:02:38PhilippeBaretCorrection proper terms: CalDAV and CardDAV62016-04-11 09:01:11PhilippeBaretAdded Why running Radicale section52016-04-11 08:53:27PhilippeBaretCorrection42016-04-11 08:48:16PhilippeBaretAdded how to setup Radical server and clients in FreedomBox Manual32016-04-10 07:12:39PhilippeBaretAdded manual link22016-04-10 07:09:27PhilippeBaretAdded Radicale definition on FreedomBox manual12016-04-10 06:40:28PhilippeBaretAdded first content to Radicale manual page
Calendar and Addressbook (Radicale)With Radicale, you can synchronize your personal calendars, ToDo lists, and addressbooks with your various computers, tablets, and smartphones, and share them with friends, without letting third parties know your personal schedule or contacts.
Why should I run Radicale?Using Radicale, you can get rid of centralized services like Google Calendar or Apple Calendar (iCloud) data mining your events and social connections.
How to setup Radicale?First, the Radicale server needs to be activated on your box. Within Plinth select Applications go to Calendar and Addressbook (Radicale) and install the application. After the installation is complete, make sure the application is marked "enabled" in the FreedomBox interface. Enabling the application launches the Radicale CalDAV/CardDAV server. define the access rights: Only the owner of a calendar/addressbook can view or make changes Any user can view any calendar/addressbook, but only the owner can make changes Any user can view or make changes to any calendar/addressbook Note, that only users with a FreedomBox login can access Radicale. Radicale-Plinth.png If you want to share a calendar with only some users, the simplest approach is to create an additional user-name for these users and to share that user-name and password with them. Radicale does not have a user interface. An external supported client application is needed. Now open your client application to create new calendar and address books that will use your FreedomBox and Radicale server. The Radicale website provides an overview of supported clients, but do not use the URLs described there; FreedomBox uses another setup, follow this manual. Below are the steps for two examples: Example of setup with Evolution client: Calendar Create a new calendar For "Type," select "CalDAV" When "CalDAV" is selected, additional options will appear in the dialogue window. URL: https://IP-address-or-domain-for-your-server/radicale/user/contact-file-name.ics/. Items in italics need to be changed to match your settings. note the trailing / in the path, it is important. Enable "Use a secure connection." Name the calendar Radicale-Evolution-Docu.png TODO/Tasks list: Adding a TODO/Tasks list is basically the same as a calendar. Contacts Follow the same steps described above and replace CalDAV with WebDAV. The extension of the address book will be .vcf.
Synchronizing with your Android phoneThere are various Apps that allow integration with the Radicale server. This example uses DAVdroid, which is available e.g. on F-Droid. If you intend to use ToDo-Lists as well, the compatible app OpenTasks has to be installed first. Follow these steps for setting up your account with the Radicale server running on your FreedomBox. Install DAVdroid Create a new account on DAVdroid by clicking on the floating + button. Select the second option as shown in the first figure below and enter the base url as (see the first screenshot below). DAVdroid will be able to discover both CalDAV and WebDAV accounts for the user. Follow this video from DAVdroid FAQ to learn how to migrate your existing contacts to Radicale. Synchronizing contacts Click on the hamburger menus of CalDAV and CardDAV and select either "Refresh ..." in case of existing accounts or "Create ..." in case of new accounts (see the second screenshot below). Check the checkboxes for the address books and calendars you want to synchronize and click on the sync button in the header. (see the third screenshot below) DAVdroid account setup DAVdroid refresh DAVdroid account sync
Advanced Users
Sharing resourcesAbove was shown an easy way to create a resource for a group of people by creating a dedicated account for all. Here will be described an alternative method where two users User1 and User2 are granted access to a calendar. This requires SSH-access to the FreedomBox. create a file /etc/radicale/rights - - - [friends_calendar] is just an identifier, can be any name. - - - The [owner-write] section makes sure that owners have access to their own files - - - - - edit file /etc/radicale/config and make the following changes in section [rights) - - - [friends_calendar] is just an identifier, can be any name. The [owner-write] section makes sure that owners have access to their own files edit file /etc/radicale/config and make the following changes in section [rights) - - - - - Restart the radicale server or the FreedomBox - - -
-
- Importing files - If you are using a contacts file exported from another service or application, it should be copied to: /var/lib/radicale/collections/user/contact file name.vcf. -
-
- Installing Radicale on ''testing'' version of Freedombox - Radicale is currently not included in the testing version of Freedombox, but can be installed by temporarily using files from the unstable version. Use SSH to connect to your Freedombox: - - - - - - Then edit the sources for the Freedombox software repositories: - - - - - - This will open a command line text editor. Edit the list as seen below. Add one line with the unstable sources and disable the other sources by turning them into comments by adding # in front: - - - Restart the radicale server or the FreedomBox
Importing filesIf you are using a contacts file exported from another service or application, it should be copied to: /var/lib/radicale/collections/user/contact file name.vcf.
Installing Radicale on ''testing'' version of FreedomboxRadicale is currently not included in the testing version of Freedombox, but can be installed by temporarily using files from the unstable version. Use SSH to connect to your Freedombox: Then edit the sources for the Freedombox software repositories: This will open a command line text editor. Edit the list as seen below. Add one line with the unstable sources and disable the other sources by turning them into comments by adding # in front: - - - After saving this file, refresh the sources: - - - - - - Then you may install Radicale from Plinth. - Afterwards, reverse the changes to the software sources list so automatic updates may be processed properly - important for the security of your Freedombox. - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
-
+ #deb-src http://security.debian.org/debian-security/ testing/updates main ]]>After saving this file, refresh the sources: Then you may install Radicale from Plinth. Afterwards, reverse the changes to the software sources list so automatic updates may be processed properly - important for the security of your Freedombox. Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/Repro.raw.xml b/doc/Repro.raw.xml index 4600afb62..70faa6805 100644 --- a/doc/Repro.raw.xml +++ b/doc/Repro.raw.xml @@ -1,283 +1,5 @@ - -
- - FreedomBox/Manual/Repro - - - 6 - 2017-01-02 13:43:51 - JamesValleroy - add port forwarding info - - - 5 - 2016-12-31 03:57:09 - JamesValleroy - add basic info - - - 4 - 2016-12-26 18:56:31 - JamesValleroy - add screenshots - - - 3 - 2016-05-27 17:24:23 - JamesValleroy - add footer - - - 2 - 2016-05-27 17:21:48 - JamesValleroy - Renamed from 'FreedomBox/Manual/repro'. - - - 1 - 2016-05-15 19:03:02 - JamesValleroy - start page - - - -
- SIP Server (repro) - repro is a server for SIP, a standard that enables Voice-over-IP calls. A desktop or mobile SIP client is required to use repro. -
- How to set up the SIP server - - - Configure the domain at /repro/domains.html on the FreedomBox. - - - - - - - - - Repro Domains - - - - - - - - Add users at /repro/addUser.html. - - - - - - - - - Repro Users - - - - - - - - Disable and re-enable the repro application in Plinth. - - -
-
- Port Forwarding - If your FreedomBox is behind a router, you will need to set up port forwarding on your router. You should forward the following ports for repro: - - - TCP 5060 - - - TCP 5061 - - - UDP 5060 - - - UDP 5061 - - - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
+ +
FreedomBox/Manual/Repro62017-01-02 13:43:51JamesValleroyadd port forwarding info52016-12-31 03:57:09JamesValleroyadd basic info42016-12-26 18:56:31JamesValleroyadd screenshots32016-05-27 17:24:23JamesValleroyadd footer22016-05-27 17:21:48JamesValleroyRenamed from 'FreedomBox/Manual/repro'.12016-05-15 19:03:02JamesValleroystart page
SIP Server (repro)repro is a server for SIP, a standard that enables Voice-over-IP calls. A desktop or mobile SIP client is required to use repro.
How to set up the SIP serverConfigure the domain at /repro/domains.html on the FreedomBox. Repro Domains Add users at /repro/addUser.html. Repro Users Disable and re-enable the repro application in Plinth.
Port ForwardingIf your FreedomBox is behind a router, you will need to set up port forwarding on your router. You should forward the following ports for repro: TCP 5060 TCP 5061 UDP 5060 UDP 5061 Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/Roundcube.raw.xml b/doc/Roundcube.raw.xml index 80562cc96..7a9c5dafd 100644 --- a/doc/Roundcube.raw.xml +++ b/doc/Roundcube.raw.xml @@ -1,230 +1,5 @@ - -
- - FreedomBox/Manual/Roundcube - - - 6 - 2016-12-31 03:41:20 - JamesValleroy - add link - - - 5 - 2016-09-01 19:12:35 - Drahtseil - adapted title to Plinth wording - - - 4 - 2016-04-10 07:25:23 - PhilippeBaret - Added bottom navigation link - - - 3 - 2015-12-15 19:04:22 - PhilippeBaret - Text finishing - - - 2 - 2015-12-15 19:03:29 - PhilippeBaret - Added ## END_INCLUDE - - - 1 - 2015-12-15 19:02:17 - PhilippeBaret - Added Rouncube page with definition - - - -
- Email Client (Roundcube) -
- What is Roundcube? - Roundcube is a browser-based multilingual email client with an application-like user interface. Roundcube is using the Internet Message Access Protocol (IMAP) to access e-mail on a remote mail server. It supports MIME to send files, and provides particularly address book, folder management, message searching and spell checking. -
-
- Using Roundcube - After Roundcube is installed, it can be accessed at https://<your freedombox>/roundcube. - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
+ +
FreedomBox/Manual/Roundcube62016-12-31 03:41:20JamesValleroyadd link52016-09-01 19:12:35Drahtseiladapted title to Plinth wording42016-04-10 07:25:23PhilippeBaretAdded bottom navigation link32015-12-15 19:04:22PhilippeBaretText finishing22015-12-15 19:03:29PhilippeBaretAdded ## END_INCLUDE12015-12-15 19:02:17PhilippeBaretAdded Rouncube page with definition
Email Client (Roundcube)
What is Roundcube?Roundcube is a browser-based multilingual email client with an application-like user interface. Roundcube is using the Internet Message Access Protocol (IMAP) to access e-mail on a remote mail server. It supports MIME to send files, and provides particularly address book, folder management, message searching and spell checking.
Using RoundcubeAfter Roundcube is installed, it can be accessed at https://<your freedombox>/roundcube. Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/Searx.raw.xml b/doc/Searx.raw.xml index 41938f18c..e71daf7b3 100644 --- a/doc/Searx.raw.xml +++ b/doc/Searx.raw.xml @@ -1,276 +1,5 @@ - -
- - FreedomBox/Manual/Searx - - - 6 - 2018-03-08 15:08:44 - JosephNuthalapati - Add screenshot. Remove last 20 seconds from screencast to reduce size. - - - 5 - 2018-03-08 14:23:24 - JosephNuthalapati - Add query param to make the video play within the browser - - - 4 - 2018-03-07 20:43:27 - Drahtseil - - - 3 - 2018-03-07 20:37:05 - Drahtseil - Screencast of the installation and first steps - - - 2 - 2018-02-26 17:15:26 - JamesValleroy - included in 0.24 - - - 1 - 2018-02-22 12:12:50 - JosephNuthalapati - searx: Initial draft - - - -
- Web Search (Searx) -
- About Searx - Searx is a metasearch engine. A metasearch engine aggregates the results from various search engines and presents them in a unified interface. - Read more about Searx on their official website. - Available since: version 0.24.0 -
-
- Screenshot - - - - - - - Searx Screenshot - - - -
-
- Screencast - Searx installation and first steps (14 MB) -
-
- Why use Searx? -
- Personalization and Filter Bubbles - Search engines have the ability to profile users and serve results most relevant to them, putting people into filter bubbles, thus distorting people's view of the world. Search engines have a financial incentive to serve interesting advertisements to their users, increasing their chances of clicking on the advertisements. - A metasearch engine is a possible solution to this problem, as it aggregates results from multiple search engines thus bypassing personalization attempts by search engines. - Searx avoids storing cookies from search engines as a means of preventing tracking and profiling by search engines. -
-
- Advertisement filtering - Searx filters out advertisements from the search results before serving the results, thus increasing relevance the of your search results and saving you from distractions. -
-
- Privacy - Searx uses HTTP POST instead of GET by default to send your search queries to the search engines, so that anyone snooping your traffic wouldn't be able to read your queries. The search queries wouldn't stored in browser history either. - Note: Searx used from Chrome browser's omnibar would make GET requests instead of POST. -
-
-
- Searx on FreedomBox - - - Searx on FreedomBox uses Single Sign On. This means that you should be logged in into your FreedomBox in the browser that you're using Searx. - - - Searx can be added as a search engine to the Firefox browser's search bar. See Firefox Help on this topic. Once Searx is added, you can also set it as your default search engine. - - - Searx also offers search results in csv, json and rss formats, which can be used with scripts to automate some tasks. - - - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
+ +
FreedomBox/Manual/Searx62018-03-08 15:08:44JosephNuthalapatiAdd screenshot. Remove last 20 seconds from screencast to reduce size.52018-03-08 14:23:24JosephNuthalapatiAdd query param to make the video play within the browser42018-03-07 20:43:27Drahtseil32018-03-07 20:37:05DrahtseilScreencast of the installation and first steps22018-02-26 17:15:26JamesValleroyincluded in 0.2412018-02-22 12:12:50JosephNuthalapatisearx: Initial draft
Web Search (Searx)
About SearxSearx is a metasearch engine. A metasearch engine aggregates the results from various search engines and presents them in a unified interface. Read more about Searx on their official website. Available since: version 0.24.0
ScreenshotSearx Screenshot
ScreencastSearx installation and first steps (14 MB)
Why use Searx?
Personalization and Filter BubblesSearch engines have the ability to profile users and serve results most relevant to them, putting people into filter bubbles, thus distorting people's view of the world. Search engines have a financial incentive to serve interesting advertisements to their users, increasing their chances of clicking on the advertisements. A metasearch engine is a possible solution to this problem, as it aggregates results from multiple search engines thus bypassing personalization attempts by search engines. Searx avoids storing cookies from search engines as a means of preventing tracking and profiling by search engines.
Advertisement filteringSearx filters out advertisements from the search results before serving the results, thus increasing relevance the of your search results and saving you from distractions.
PrivacySearx uses HTTP POST instead of GET by default to send your search queries to the search engines, so that anyone snooping your traffic wouldn't be able to read your queries. The search queries wouldn't stored in browser history either. Note: Searx used from Chrome browser's omnibar would make GET requests instead of POST.
Searx on FreedomBoxSearx on FreedomBox uses Single Sign On. This means that you should be logged in into your FreedomBox in the browser that you're using Searx. Searx can be added as a search engine to the Firefox browser's search bar. See Firefox Help on this topic. Once Searx is added, you can also set it as your default search engine. Searx also offers search results in csv, json and rss formats, which can be used with scripts to automate some tasks. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/SecureShell.raw.xml b/doc/SecureShell.raw.xml index 6e5f79edd..8a807c746 100644 --- a/doc/SecureShell.raw.xml +++ b/doc/SecureShell.raw.xml @@ -1,322 +1,8 @@ - -
- - FreedomBox/Manual/SecureShell - - - 11 - 2018-01-30 07:55:33 - SunilMohanAdapa - Update GitHub links with Salsa - - - 10 - 2017-03-06 23:17:08 - JamesValleroy - add note - - - 9 - 2016-10-13 21:49:06 - David Jones - Added infromation about connecting to the FBX using ssh over Tor - - - 8 - 2016-10-13 21:09:31 - David Jones - Added information about admin account for first log in to Plinth - - - 7 - 2016-09-05 09:42:36 - ElVirolo - Removing my previous contribution, as info already present in original version. - - - 6 - 2016-09-05 09:39:05 - ElVirolo - - - 5 - 2016-09-05 09:26:15 - ElVirolo - Added "Users created via Plinth" paragraph - - - 4 - 2015-12-21 19:42:10 - JamesValleroy - update default account - - - 3 - 2015-12-21 19:33:56 - JamesValleroy - fix outline level - - - 2 - 2015-12-15 19:31:18 - PhilippeBaret - Added definition title - - - 1 - 2015-09-16 16:22:37 - SunilMohanAdapa - New manual page for secure shell access - - - -
- Secure Shell -
- What is Secure Shell? - FreedomBox runs openssh-server server by default allowing remote logins from all interfaces. If your hardware device is connected to a monitor and a keyboard, you may login directly as well. Regular operation of FreedomBox does not require you to use the shell. However, some tasks or identifying a problem may require you to login to a shell. -
-
- Setting Up A User Account -
- Plinth First Log In: Admin Account - When creating an account in Plinth for the first time, this user will automatically have administrator capabilities. Admin users are able to log in using ssh (see Logging In below) and have superuser privileges via sudo. -
-
- Default User Account - - - Note: If you can access Plinth, then you don't need to do this. You can use the user account created in Plinth to connect to SSH. - - - The pre-built FreedomBox images have a default user account called "fbx". However the password is not set for this account, so it will not be possible to log in with this account by default. - There is a script included in the freedom-maker program, that will allow you to set the password for this account, if it is needed. To set a password for the "fbx" user: - 1. Decompress the image file. - 2. Get a copy of freedom-maker from . - 3. Run sudo ./bin/passwd-in-image <image-file> fbx. - 4. Copy the image file to SD card and boot device as normal. - The "fbx" user also has superuser privileges via sudo. -
-
-
- Logging In -
- Local - To login via SSH, to your FreedomBox: - - Replace fbx with the name of the user you wish to login as. freedombox should be replaced with the hostname or IP address of you FreedomBox device as found in the Quick Start process. - fbx is the default user present on FreedomBox with superuser privileges. Any other user created using Plinth and belonging to the group admin will be able to login. The root account has no password set and will not be able to login. Access will be denied to all other users. - fbx and users in admin group will also be able to login on the terminal directly. Other users will be denied access. - If you repeatedly try to login as a user and fail, you will be blocked from logging in for some time. This is due to libpam-abl package that FreedomBox installs by default. To control this behavior consult libpam-abl documentation. -
-
- SSH over Tor - If in Plinth you have enabled hidden services via Tor, you can access your FreedomBox using ssh over Tor. On a GNU/Linux computer, install netcat-openbsd. - - Edit ~/.ssh/config to enable connections over Tor. - - Add the following: - +
FreedomBox/Manual/SecureShell112018-01-30 07:55:33SunilMohanAdapaUpdate GitHub links with Salsa102017-03-06 23:17:08JamesValleroyadd note92016-10-13 21:49:06David JonesAdded infromation about connecting to the FBX using ssh over Tor82016-10-13 21:09:31David JonesAdded information about admin account for first log in to Plinth72016-09-05 09:42:36ElViroloRemoving my previous contribution, as info already present in original version.62016-09-05 09:39:05ElVirolo52016-09-05 09:26:15ElViroloAdded "Users created via Plinth" paragraph42015-12-21 19:42:10JamesValleroyupdate default account32015-12-21 19:33:56JamesValleroyfix outline level22015-12-15 19:31:18PhilippeBaretAdded definition title12015-09-16 16:22:37SunilMohanAdapaNew manual page for secure shell access
Secure Shell
What is Secure Shell?FreedomBox runs openssh-server server by default allowing remote logins from all interfaces. If your hardware device is connected to a monitor and a keyboard, you may login directly as well. Regular operation of FreedomBox does not require you to use the shell. However, some tasks or identifying a problem may require you to login to a shell.
Setting Up A User Account
Plinth First Log In: Admin AccountWhen creating an account in Plinth for the first time, this user will automatically have administrator capabilities. Admin users are able to log in using ssh (see Logging In below) and have superuser privileges via sudo.
Default User AccountNote: If you can access Plinth, then you don't need to do this. You can use the user account created in Plinth to connect to SSH. The pre-built FreedomBox images have a default user account called "fbx". However the password is not set for this account, so it will not be possible to log in with this account by default. There is a script included in the freedom-maker program, that will allow you to set the password for this account, if it is needed. To set a password for the "fbx" user: 1. Decompress the image file. 2. Get a copy of freedom-maker from . 3. Run sudo ./bin/passwd-in-image <image-file> fbx. 4. Copy the image file to SD card and boot device as normal. The "fbx" user also has superuser privileges via sudo.
Logging In
LocalTo login via SSH, to your FreedomBox: Replace fbx with the name of the user you wish to login as. freedombox should be replaced with the hostname or IP address of you FreedomBox device as found in the Quick Start process. fbx is the default user present on FreedomBox with superuser privileges. Any other user created using Plinth and belonging to the group admin will be able to login. The root account has no password set and will not be able to login. Access will be denied to all other users. fbx and users in admin group will also be able to login on the terminal directly. Other users will be denied access. If you repeatedly try to login as a user and fail, you will be blocked from logging in for some time. This is due to libpam-abl package that FreedomBox installs by default. To control this behavior consult libpam-abl documentation.
SSH over TorIf in Plinth you have enabled hidden services via Tor, you can access your FreedomBox using ssh over Tor. On a GNU/Linux computer, install netcat-openbsd. Edit ~/.ssh/config to enable connections over Tor. Add the following: - Replace USERNAME with, e.g., an admin username (see above). - Note that in some cases you may need to replace 9050 with 9150. - Now to connect to the FreedomBox, open a terminal and type: - - Replace USERNAME with, e.g., an admin username, and ADDRESS with the hidden service address for your FreedomBox. -
-
-
- Becoming Superuser - After logging in, if you want to become the superuser for performing administrative activities: - - Make a habit of logging in as root only when you need to. If you aren't logged in as root, you can't accidentally break everything. - - - -
-
- Changing Password - To change the password of a user managed by Plinth, use the change password page. However, the fbx default user is not managed by Plinth and its password cannot be changed in the web interface. - To change password on the terminal, log in to your FreedomBox as the user whose password you want to change. Then, run the following command: - - This will ask you for your current password before giving you the opportunity to set a new one. - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
+ ProxyCommand nc -X 5 -x 127.0.0.1:9050 %h %p]]>Replace USERNAME with, e.g., an admin username (see above). Note that in some cases you may need to replace 9050 with 9150. Now to connect to the FreedomBox, open a terminal and type: Replace USERNAME with, e.g., an admin username, and ADDRESS with the hidden service address for your FreedomBox.
Becoming SuperuserAfter logging in, if you want to become the superuser for performing administrative activities: Make a habit of logging in as root only when you need to. If you aren't logged in as root, you can't accidentally break everything.
Changing PasswordTo change the password of a user managed by Plinth, use the change password page. However, the fbx default user is not managed by Plinth and its password cannot be changed in the web interface. To change password on the terminal, log in to your FreedomBox as the user whose password you want to change. Then, run the following command: This will ask you for your current password before giving you the opportunity to set a new one. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/Security.raw.xml b/doc/Security.raw.xml index f23d800e7..7851efbc0 100644 --- a/doc/Security.raw.xml +++ b/doc/Security.raw.xml @@ -1,210 +1,5 @@ - -
- - FreedomBox/Manual/Security - - - 2 - 2016-08-31 17:40:56 - Drahtseil - Screenshot - - - 1 - 2016-08-31 17:37:33 - Drahtseil - creation - - - -
- Security - When this option is enabled, only users in the "admin" group will be able to log in to console or via SSH. Console users may be able to access some services without further authorization. - You can define the group of the users in the Users section. - - - - - - - Security.png - - - - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
+ +
FreedomBox/Manual/Security22016-08-31 17:40:56DrahtseilScreenshot12016-08-31 17:37:33Drahtseilcreation
SecurityWhen this option is enabled, only users in the "admin" group will be able to log in to console or via SSH. Console users may be able to access some services without further authorization. You can define the group of the users in the Users section. Security.png Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/ServiceDiscovery.raw.xml b/doc/ServiceDiscovery.raw.xml index ad249fcd4..6a0e2a564 100644 --- a/doc/ServiceDiscovery.raw.xml +++ b/doc/ServiceDiscovery.raw.xml @@ -1,201 +1,5 @@ - -
- - FreedomBox/Manual/ServiceDiscovery - - - 2 - 2017-01-02 13:17:40 - JamesValleroy - mention .local address - - - 1 - 2016-08-21 09:48:13 - Drahtseil - Created Service Discovery - - - -
- Service Discovery - Service discovery allows other devices on the network to discover your FreedomBox and services running on it. If a client on the local network supports mDNS, it can find your FreedomBox at <hostname>.local (for example: freedombox.local). - It also allows FreedomBox to discover other devices and services running on your local network. - Service discovery is not essential and works only on internal networks. It may be disabled to improve security especially when connecting to a hostile local network. - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
+ +
FreedomBox/Manual/ServiceDiscovery22017-01-02 13:17:40JamesValleroymention .local address12016-08-21 09:48:13DrahtseilCreated Service Discovery
Service DiscoveryService discovery allows other devices on the network to discover your FreedomBox and services running on it. If a client on the local network supports mDNS, it can find your FreedomBox at <hostname>.local (for example: freedombox.local). It also allows FreedomBox to discover other devices and services running on your local network. Service discovery is not essential and works only on internal networks. It may be disabled to improve security especially when connecting to a hostile local network. Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/Shadowsocks.raw.xml b/doc/Shadowsocks.raw.xml index e250c676f..e2140b971 100644 --- a/doc/Shadowsocks.raw.xml +++ b/doc/Shadowsocks.raw.xml @@ -1,218 +1,5 @@ - -
- - FreedomBox/Manual/Shadowsocks - - - 1 - 2018-01-04 19:59:57 - David Jones - - - -
- SOCKS5 proxy (Shadowsocks) -
- What is Shadowsocks? - Shadowsocks is a lightweight and secure SOCKS5 proxy, designed to protect your Internet traffic. It can be used to bypass Internet filtering and censorship. Your FreedomBox can run a Shadowsocks client which can connect to a Shadowsocks server. It will also run a SOCKS5 proxy. Local devices can connect to this proxy, and their data will be encrypted and proxied through the Shadowsocks server. - Note: Shadowsocks is available in FreedomBox starting with Plinth version 0.18. -
-
- Using the Shadowsocks client? - The current implementation of Shadowsocks in FreedomBox only supports configuring FreedomBox as a Shadowsocks client. The current use case for Shadowsocks is as follows: - - - Shadowsocks client (FreedomBox) is in a region where some parts of the Internet are blocked or censored. - - - Shadowsocks server is in a different region, which doesn't have these blocks. - - - The FreedomBox provides SOCKS proxy service on the local network for other devices to make use of its Shadowsocks connection. - - - At a future date it will be possible to configure FreedomBox as Shadowsocks server. -
-
- Configuring your FreedomBox for the Shadowsocks client - To enable Shadowsocks, first navigate to the Socks5 Proxy (Shadowsocks) page and install it. - Server: the Shadowsocks server is not the FreedomBox IP or URL; rather, it will be another server or VPS that has been configured as a Shadowsocks server. There are also some public Shadowsocks servers listed on the web, but be aware that whoever operates the server can see where requests are going, and any non-encrypted data will be visible to them. - To use Shadowsocks after setup, set the SOCKS5 proxy URL in your device, browser or application to - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
+ +
FreedomBox/Manual/Shadowsocks12018-01-04 19:59:57David Jones
SOCKS5 proxy (Shadowsocks)
What is Shadowsocks?Shadowsocks is a lightweight and secure SOCKS5 proxy, designed to protect your Internet traffic. It can be used to bypass Internet filtering and censorship. Your FreedomBox can run a Shadowsocks client which can connect to a Shadowsocks server. It will also run a SOCKS5 proxy. Local devices can connect to this proxy, and their data will be encrypted and proxied through the Shadowsocks server. Note: Shadowsocks is available in FreedomBox starting with Plinth version 0.18.
Using the Shadowsocks client?The current implementation of Shadowsocks in FreedomBox only supports configuring FreedomBox as a Shadowsocks client. The current use case for Shadowsocks is as follows: Shadowsocks client (FreedomBox) is in a region where some parts of the Internet are blocked or censored. Shadowsocks server is in a different region, which doesn't have these blocks. The FreedomBox provides SOCKS proxy service on the local network for other devices to make use of its Shadowsocks connection. At a future date it will be possible to configure FreedomBox as Shadowsocks server.
Configuring your FreedomBox for the Shadowsocks clientTo enable Shadowsocks, first navigate to the Socks5 Proxy (Shadowsocks) page and install it. Server: the Shadowsocks server is not the FreedomBox IP or URL; rather, it will be another server or VPS that has been configured as a Shadowsocks server. There are also some public Shadowsocks servers listed on the web, but be aware that whoever operates the server can see where requests are going, and any non-encrypted data will be visible to them. To use Shadowsocks after setup, set the SOCKS5 proxy URL in your device, browser or application to Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/Snapshots.raw.xml b/doc/Snapshots.raw.xml index 2cfbe73a3..a3f976442 100644 --- a/doc/Snapshots.raw.xml +++ b/doc/Snapshots.raw.xml @@ -1,214 +1,5 @@ - -
- - FreedomBox/Manual/Snapshots - - - 2 - 2018-03-10 15:11:41 - JosephNuthalapati - Fix oversized image - - - 1 - 2017-11-14 02:24:01 - JamesValleroy - new page for snapshots module - - - -
- Snapshots - Snapshots allows you to create filesystem snapshots, and rollback the system to a previous snapshot. - - - Note: This feature requires a Btrfs filesystem. All of the FreedomBox stable disk images use Btrfs. - - - - - - - - - Snapshots - - - - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
+ +
FreedomBox/Manual/Snapshots22018-03-10 15:11:41JosephNuthalapatiFix oversized image12017-11-14 02:24:01JamesValleroynew page for snapshots module
SnapshotsSnapshots allows you to create filesystem snapshots, and rollback the system to a previous snapshot. Note: This feature requires a Btrfs filesystem. All of the FreedomBox stable disk images use Btrfs. Snapshots Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/Storage.raw.xml b/doc/Storage.raw.xml index c734b4bbf..cb40909d6 100644 --- a/doc/Storage.raw.xml +++ b/doc/Storage.raw.xml @@ -1,240 +1,5 @@ - -
- - FreedomBox/Manual/Storage - - - 7 - 2018-03-05 12:17:19 - JosephNuthalapati - Renamed from 'FreedomBox/Manual/Disks'. - - - 6 - 2018-03-05 12:16:41 - JosephNuthalapati - Renaming Disks to Storage - - - 5 - 2017-04-09 13:45:57 - JamesValleroy - update note about issue - - - 4 - 2017-03-31 20:16:25 - Drahtseil - update screenshot with "expand partition" - - - 3 - 2017-02-10 22:33:01 - JamesValleroy - add warning about non-functional feature - - - 2 - 2016-08-31 17:10:11 - Drahtseil - screenshot - - - 1 - 2016-08-31 17:09:10 - Drahtseil - Disks creation - - - -
- Storage - Storage shows free space of mounted partitions. - If there is some free space left after the root partition, the option to expand the root partition is also available. - - - - - - - Disks.png - - - - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
+ +
FreedomBox/Manual/Storage72018-03-05 12:17:19JosephNuthalapatiRenamed from 'FreedomBox/Manual/Disks'.62018-03-05 12:16:41JosephNuthalapatiRenaming Disks to Storage52017-04-09 13:45:57JamesValleroyupdate note about issue42017-03-31 20:16:25Drahtseilupdate screenshot with "expand partition"32017-02-10 22:33:01JamesValleroyadd warning about non-functional feature22016-08-31 17:10:11Drahtseilscreenshot12016-08-31 17:09:10DrahtseilDisks creation
StorageStorage shows free space of mounted partitions. If there is some free space left after the root partition, the option to expand the root partition is also available. Disks.png Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/Syncthing.raw.xml b/doc/Syncthing.raw.xml index 45352fcf4..eb311b126 100644 --- a/doc/Syncthing.raw.xml +++ b/doc/Syncthing.raw.xml @@ -1,261 +1,5 @@ - -
- - FreedomBox/Manual/Syncthing - - - 10 - 2018-03-10 04:32:57 - JosephNuthalapati - Fix oversized image - - - 9 - 2017-10-22 14:57:58 - Drahtseil - - - 8 - 2017-10-22 14:57:09 - Drahtseil - Syncthing GUI image - - - 7 - 2017-10-22 14:54:54 - Drahtseil - Some rewording etc. - - - 6 - 2017-10-21 14:59:53 - Drahtseil - Titel same as in Plinth GUI; standard footer; some basic restructuring before I will update the docu more in detail - - - 5 - 2017-04-04 10:39:36 - JosephNuthalapati - - - 4 - 2017-03-23 10:54:49 - JosephNuthalapati - Rewrote the section on Syncthing's role in FreedomBox - - - 3 - 2017-03-23 05:12:13 - SunilMohanAdapa - Minor formatting - - - 2 - 2017-03-23 05:11:43 - SunilMohanAdapa - Add note about availability of Syncthing - - - 1 - 2017-03-23 02:11:00 - JosephNuthalapati - Created wiki page for Syncthing - - - -
- File Synchronization (Syncthing) - With Syncthing installed on your FreedomBox, you can synchronize content from other devices to your FreedomBox and vice-versa. For example, you can keep the photos taken on your mobile phone synchronized to your FreedomBox. - Note: Syncthing is available in FreedomBox starting with Plinth version 0.14. - Users should keep in mind that Syncthing is a peer-to-peer synchronization solution, not a client-server one. This means that the FreedomBox isn't really the server and your other devices clients. They're all devices from Syncthing's perspective. You can use Syncthing to synchronize your files between any of your devices. The advantage that FreedomBox provides is that it is a server that's always running. Suppose you want your photos on your phone to be synchronized to your laptop, if you simply sync the photos to the FreedomBox, the laptop can get them from the FreedomBox whenever it comes online the next time. You don't have to be worried about your other devices being online for synchronization. If your FreedomBox is one of the devices set up with your Syncthing shared folder, you can rest assured that your other devices will eventually get the latest files once they come online. - After installation follow the instructions in the getting started of the Syncthing project. Syncthing allows individual folders to be selectively shared with other devices. Devices must be paired up before sharing by scanning QR codes or entering the device ids manually. Syncthing has a discovery service for easily identifying the other devices on the same network having Syncthing installed. - In order to access to the web client of the Syncthing instance running on your FreedomBox, use the path /syncthing. This web client is currently only accessible to the users of the FreedomBox that have administrator privileges, though it might be accessible to all FreedomBox users in a future release. - - - - - - - Syncthing web interface - - - - Syncthing has android apps available on the F-Droid and Google Play app stores. Cross-platform desktop apps are also available. - To learn more about Syncthing, please visit their official website and documentation. - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
+ +
FreedomBox/Manual/Syncthing102018-03-10 04:32:57JosephNuthalapatiFix oversized image92017-10-22 14:57:58Drahtseil82017-10-22 14:57:09DrahtseilSyncthing GUI image72017-10-22 14:54:54DrahtseilSome rewording etc.62017-10-21 14:59:53DrahtseilTitel same as in Plinth GUI; standard footer; some basic restructuring before I will update the docu more in detail52017-04-04 10:39:36JosephNuthalapati42017-03-23 10:54:49JosephNuthalapatiRewrote the section on Syncthing's role in FreedomBox32017-03-23 05:12:13SunilMohanAdapaMinor formatting22017-03-23 05:11:43SunilMohanAdapaAdd note about availability of Syncthing12017-03-23 02:11:00JosephNuthalapatiCreated wiki page for Syncthing
File Synchronization (Syncthing)With Syncthing installed on your FreedomBox, you can synchronize content from other devices to your FreedomBox and vice-versa. For example, you can keep the photos taken on your mobile phone synchronized to your FreedomBox. Note: Syncthing is available in FreedomBox starting with Plinth version 0.14. Users should keep in mind that Syncthing is a peer-to-peer synchronization solution, not a client-server one. This means that the FreedomBox isn't really the server and your other devices clients. They're all devices from Syncthing's perspective. You can use Syncthing to synchronize your files between any of your devices. The advantage that FreedomBox provides is that it is a server that's always running. Suppose you want your photos on your phone to be synchronized to your laptop, if you simply sync the photos to the FreedomBox, the laptop can get them from the FreedomBox whenever it comes online the next time. You don't have to be worried about your other devices being online for synchronization. If your FreedomBox is one of the devices set up with your Syncthing shared folder, you can rest assured that your other devices will eventually get the latest files once they come online. After installation follow the instructions in the getting started of the Syncthing project. Syncthing allows individual folders to be selectively shared with other devices. Devices must be paired up before sharing by scanning QR codes or entering the device ids manually. Syncthing has a discovery service for easily identifying the other devices on the same network having Syncthing installed. In order to access to the web client of the Syncthing instance running on your FreedomBox, use the path /syncthing. This web client is currently only accessible to the users of the FreedomBox that have administrator privileges, though it might be accessible to all FreedomBox users in a future release. Syncthing web interface Syncthing has android apps available on the F-Droid and Google Play app stores. Cross-platform desktop apps are also available. To learn more about Syncthing, please visit their official website and documentation. Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/TinyTinyRSS.raw.xml b/doc/TinyTinyRSS.raw.xml index b56c7579f..a8bf8ddcc 100644 --- a/doc/TinyTinyRSS.raw.xml +++ b/doc/TinyTinyRSS.raw.xml @@ -1,398 +1,5 @@ - -
- - FreedomBox/Manual/TinyTinyRSS - - - 10 - 2018-03-11 03:05:29 - JosephNuthalapati - Fix oversized images - - - 9 - 2017-10-18 13:51:27 - JosephNuthalapati - Remove link to source code as this wiki seems to have banned anything that starts with git.tt - - - 8 - 2017-10-18 13:47:46 - JosephNuthalapati - Add importing OPML feeds and link to source code of TT-RSS Android App - - - 7 - 2017-10-18 12:58:46 - JosephNuthalapati - Add documentation for automatic detection of RSS feeds and the Unsubscribe option - - - 6 - 2017-10-18 12:37:03 - JosephNuthalapati - Add screenshots for subscribing to a new RSS feed - - - 5 - 2017-10-16 12:11:52 - SunilMohanAdapa - Minor styling - - - 4 - 2017-10-16 12:08:36 - SunilMohanAdapa - Add information about mobile application - - - 3 - 2016-12-31 03:49:54 - JamesValleroy - add screenshot - - - 2 - 2016-12-31 03:44:56 - JamesValleroy - add user info - - - 1 - 2016-09-04 10:18:59 - Drahtseil - stub created - - - -
- News Feed Reader (Tiny Tiny RSS) - Tiny Tiny RSS is a news feed (RSS/Atom) reader and aggregator, designed to allow reading news from any location, while feeling as close to a real desktop application as possible. - Any user created through FreedomBox web interface will be able to login and use this app. Each user has their own feeds, state and preferences. -
- Using the Web Interface - When enabled, Tiny Tiny RSS will be available from /tt-rss path on the web server. Any user created through Plinth will be able to login and use this app. - - - - - - - Tiny Tiny RSS - - - -
- Adding a new feed - 1. Go to the website you want the RSS feed for and copy the RSS/Atom feed link from it. - - - - - - - Selecting feeds - - - - 2. Select "Subscribe to feed.." from the Actions dropdown. - - - - - - - Subscribe to feed - - - - 3. In the dialog box that appears, paste the URL for copied in step 1 and click the Subscribe button. - - - - - - - Subscription dialog box - - - - Give the application a minute to fetch the feeds after clicking Subscribe. - In some websites, the RSS feeds button isn't clearly visible. In that case, you can simply paste the website URL into the Subscribe dialog (step 3) and let TT-RSS automatically detect the RSS feeds on the page. - You can try this now with the homepage of WikiNews - As you can see in the image below, TT-RSS detected and added the Atom feed of WikiNews to our list of feeds. - - - - - - - WikiNews feed added - - - - If you don't want to keep this feed, right click on the feed shown in the above image, select Edit feed and click Unsubscribe in the dialog box that appears. - - - - - - - Unsubscribe from a feed - - - -
-
- Importing your feeds from another feed reader - In your existing feed reader, find an option to Export your feeds to a file. Prefer the OPML file format if you have to choose between multiple formats. Let's say your exported feeds file is called Subscriptions.opml - Click on the Actions menu at the top left corner and select Preferences. You will be taken to another page. - Select the second tab called Feeds in the top header. Feeds has several sections. The second one is called OPML. Select it. - - - - - - - OPML feeds page - - - - To import your Subscriptions.opml file into TT-RSS, - - - Click Browse and select the file from your file system - - - Click Import my OPML - - - After importing, you'll be taken to the Feeds section that's above the OPML section in the page. You can see that the feeds from your earlier feed reader are now imported into Tiny Tiny RSS. You can now start using Tiny Tiny RSS as your primary feed reader. - In the next section, we will discuss setting up the mobile app, which can let you read your feeds on the go. -
-
-
- Using the Mobile App - The official Android app from the Tiny Tiny RSS project works with FreedomBox's Tiny Tiny RSS Server. The older TTRSS-Reader application is known not to work. - The official Android app is unfortunately only available on the Google Play Store and not on F-Droid. You can still obtain the source code and build the apk file yourself. - To configure, first install the application, then in the setting page, set URL as . Set your user name and password in the Login details as well as HTTP Authentication details. If your FreedomBox does not have a valid HTTPS certificate, then in settings request allowing any SSL certificate and any host. - - - - - - - Tiny Tiny RSS - - - - - - - - Tiny Tiny RSS - - - - - - - - Tiny Tiny RSS - - - - - - - - Tiny Tiny RSS - - - - - - - - Tiny Tiny RSS - - - - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
+ +
FreedomBox/Manual/TinyTinyRSS102018-03-11 03:05:29JosephNuthalapatiFix oversized images92017-10-18 13:51:27JosephNuthalapatiRemove link to source code as this wiki seems to have banned anything that starts with git.tt82017-10-18 13:47:46JosephNuthalapatiAdd importing OPML feeds and link to source code of TT-RSS Android App72017-10-18 12:58:46JosephNuthalapatiAdd documentation for automatic detection of RSS feeds and the Unsubscribe option62017-10-18 12:37:03JosephNuthalapatiAdd screenshots for subscribing to a new RSS feed52017-10-16 12:11:52SunilMohanAdapaMinor styling42017-10-16 12:08:36SunilMohanAdapaAdd information about mobile application32016-12-31 03:49:54JamesValleroyadd screenshot22016-12-31 03:44:56JamesValleroyadd user info12016-09-04 10:18:59Drahtseilstub created
News Feed Reader (Tiny Tiny RSS)Tiny Tiny RSS is a news feed (RSS/Atom) reader and aggregator, designed to allow reading news from any location, while feeling as close to a real desktop application as possible. Any user created through FreedomBox web interface will be able to login and use this app. Each user has their own feeds, state and preferences.
Using the Web InterfaceWhen enabled, Tiny Tiny RSS will be available from /tt-rss path on the web server. Any user created through Plinth will be able to login and use this app. Tiny Tiny RSS
Adding a new feed1. Go to the website you want the RSS feed for and copy the RSS/Atom feed link from it. Selecting feeds 2. Select "Subscribe to feed.." from the Actions dropdown. Subscribe to feed 3. In the dialog box that appears, paste the URL for copied in step 1 and click the Subscribe button. Subscription dialog box Give the application a minute to fetch the feeds after clicking Subscribe. In some websites, the RSS feeds button isn't clearly visible. In that case, you can simply paste the website URL into the Subscribe dialog (step 3) and let TT-RSS automatically detect the RSS feeds on the page. You can try this now with the homepage of WikiNews As you can see in the image below, TT-RSS detected and added the Atom feed of WikiNews to our list of feeds. WikiNews feed added If you don't want to keep this feed, right click on the feed shown in the above image, select Edit feed and click Unsubscribe in the dialog box that appears. Unsubscribe from a feed
Importing your feeds from another feed readerIn your existing feed reader, find an option to Export your feeds to a file. Prefer the OPML file format if you have to choose between multiple formats. Let's say your exported feeds file is called Subscriptions.opml Click on the Actions menu at the top left corner and select Preferences. You will be taken to another page. Select the second tab called Feeds in the top header. Feeds has several sections. The second one is called OPML. Select it. OPML feeds page To import your Subscriptions.opml file into TT-RSS, Click Browse and select the file from your file system Click Import my OPML After importing, you'll be taken to the Feeds section that's above the OPML section in the page. You can see that the feeds from your earlier feed reader are now imported into Tiny Tiny RSS. You can now start using Tiny Tiny RSS as your primary feed reader. In the next section, we will discuss setting up the mobile app, which can let you read your feeds on the go.
Using the Mobile AppThe official Android app from the Tiny Tiny RSS project works with FreedomBox's Tiny Tiny RSS Server. The older TTRSS-Reader application is known not to work. The official Android app is unfortunately only available on the Google Play Store and not on F-Droid. You can still obtain the source code and build the apk file yourself. To configure, first install the application, then in the setting page, set URL as . Set your user name and password in the Login details as well as HTTP Authentication details. If your FreedomBox does not have a valid HTTPS certificate, then in settings request allowing any SSL certificate and any host. Tiny Tiny RSS Tiny Tiny RSS Tiny Tiny RSS Tiny Tiny RSS Tiny Tiny RSS Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/Tor.raw.xml b/doc/Tor.raw.xml index 8f125b308..f1a2062db 100644 --- a/doc/Tor.raw.xml +++ b/doc/Tor.raw.xml @@ -1,335 +1,5 @@ - -
- - FreedomBox/Manual/Tor - - - 15 - 2018-03-19 06:27:56 - JosephNuthalapati - Add section on circumventing tor censorship - - - 14 - 2018-03-19 06:25:43 - JosephNuthalapati - Add section on circumventing tor censorship - - - 13 - 2017-01-07 16:00:24 - JamesValleroy - add image - - - 12 - 2017-01-07 15:21:27 - JamesValleroy - plural - - - 11 - 2016-12-31 02:19:46 - JamesValleroy - mention ssh - - - 10 - 2016-12-31 02:19:03 - JamesValleroy - add relay info - - - 9 - 2016-12-23 18:31:29 - JamesValleroy - undo outline level change - - - 8 - 2016-12-23 18:30:06 - JamesValleroy - move down outline level - - - 7 - 2016-04-10 07:14:17 - PhilippeBaret - Added bottom navigation link - - - 6 - 2015-12-15 16:54:58 - PhilippeBaret - Text finishing - - - 5 - 2015-12-15 16:40:11 - PhilippeBaret - - - 4 - 2015-12-15 16:34:38 - PhilippeBaret - Added Tor definition - - - 3 - 2015-09-13 14:54:59 - SunilMohanAdapa - Demote headings one level for inclusion into manual - - - 2 - 2015-09-13 14:53:54 - SunilMohanAdapa - Add FreedomBox category and portal - - - 1 - 2015-09-12 15:55:05 - JamesValleroy - create tor page - - - -
- Anonymity Network (Tor) -
- What is Tor? - Tor is a network of servers operated by volunteers. It allows users of these servers to improve their privacy and security while surfing on the Internet. You and your friends are able to access to your FreedomBox via Tor network without revealing its IP address. Activating Tor application on your FreedomBox, you will be able to offer remote services (chat, wiki, file sharing, etc...) without showing your location. This application will give you a better protection than a public web server because you will be less exposed to intrusive people on the web. -
-
- Using Tor to browse anonymously - Tor Browser is the recommended way to browse the web using Tor. You can download the Tor Browser from and follow the instructions on that site to install and run it. -
-
- Using Tor Hidden Service to access your FreedomBox - Tor Hidden Service provides a way to access your FreedomBox, even if it's behind a router or firewall. - To enable Tor Hidden Service, first navigate to the Anonymity Network (Tor) page. (If you don't see it, click on the FreedomBox logo at the top-left of the page, to go to the main Apps page.) On the Anonymity Network (Tor) page, under Configuration, check "Enable Tor Hidden Service", then press the Update setup button. Tor will be reconfigured and restarted. - After a while, the page will refresh and under Status, you will see a table listing the Hidden Service .onion address. Copy the entire address (ending in .onion) and paste it into the Tor Browser's address field, and you should be able to access your FreedomBox. (You may see a certificate warning because FreedomBox has a self-signed certificate.) - - - - - - - Tor Browser - Plinth - - - - Currently only HTTP (port 80), HTTPS (port 443), and SSH (port 22) are accessible through the Tor Hidden Service configured on the FreedomBox. -
-
- Running a Tor relay - When Tor is installed, it is configured by default to run as a bridge relay. The relay or bridge option can be disabled through the Tor configuration page in Plinth. - At the bottom of the Tor page in Plinth, there is a list of ports used by the Tor relay. If your FreedomBox is behind a router, you will need to configure port forwarding on your router so that these ports can be reached from the public Internet. -
-
- Using Tor SOCKS port (advanced) - FreedomBox provides a Tor SOCKS port that other applications can connect to, in order to route their traffic over the Tor network. This port is accessible on any interfaces configured in the internal firewall zone. To configure the application, set SOCKS Host to the internal network connection's IP address, and set the SOCKS Port to 9050. -
-
- Circumventing Tor censorship - If your ISP is trying to block Tor traffic, you can use tor bridge relays to connect to the tor network. - 1. Get the bridge configuration from the Tor BridgeDB - - - - - - - Tor BridgeDB - - - - 2. Add the lines to your FreedomBox Tor configuration as show below. - - - - - - - Tor Configuration Page - - - - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
+ +
FreedomBox/Manual/Tor152018-03-19 06:27:56JosephNuthalapatiAdd section on circumventing tor censorship142018-03-19 06:25:43JosephNuthalapatiAdd section on circumventing tor censorship132017-01-07 16:00:24JamesValleroyadd image122017-01-07 15:21:27JamesValleroyplural112016-12-31 02:19:46JamesValleroymention ssh102016-12-31 02:19:03JamesValleroyadd relay info92016-12-23 18:31:29JamesValleroyundo outline level change82016-12-23 18:30:06JamesValleroymove down outline level72016-04-10 07:14:17PhilippeBaretAdded bottom navigation link62015-12-15 16:54:58PhilippeBaretText finishing52015-12-15 16:40:11PhilippeBaret42015-12-15 16:34:38PhilippeBaretAdded Tor definition32015-09-13 14:54:59SunilMohanAdapaDemote headings one level for inclusion into manual22015-09-13 14:53:54SunilMohanAdapaAdd FreedomBox category and portal12015-09-12 15:55:05JamesValleroycreate tor page
Anonymity Network (Tor)
What is Tor?Tor is a network of servers operated by volunteers. It allows users of these servers to improve their privacy and security while surfing on the Internet. You and your friends are able to access to your FreedomBox via Tor network without revealing its IP address. Activating Tor application on your FreedomBox, you will be able to offer remote services (chat, wiki, file sharing, etc...) without showing your location. This application will give you a better protection than a public web server because you will be less exposed to intrusive people on the web.
Using Tor to browse anonymouslyTor Browser is the recommended way to browse the web using Tor. You can download the Tor Browser from and follow the instructions on that site to install and run it.
Using Tor Hidden Service to access your FreedomBoxTor Hidden Service provides a way to access your FreedomBox, even if it's behind a router or firewall. To enable Tor Hidden Service, first navigate to the Anonymity Network (Tor) page. (If you don't see it, click on the FreedomBox logo at the top-left of the page, to go to the main Apps page.) On the Anonymity Network (Tor) page, under Configuration, check "Enable Tor Hidden Service", then press the Update setup button. Tor will be reconfigured and restarted. After a while, the page will refresh and under Status, you will see a table listing the Hidden Service .onion address. Copy the entire address (ending in .onion) and paste it into the Tor Browser's address field, and you should be able to access your FreedomBox. (You may see a certificate warning because FreedomBox has a self-signed certificate.) Tor Browser - Plinth Currently only HTTP (port 80), HTTPS (port 443), and SSH (port 22) are accessible through the Tor Hidden Service configured on the FreedomBox.
Running a Tor relayWhen Tor is installed, it is configured by default to run as a bridge relay. The relay or bridge option can be disabled through the Tor configuration page in Plinth. At the bottom of the Tor page in Plinth, there is a list of ports used by the Tor relay. If your FreedomBox is behind a router, you will need to configure port forwarding on your router so that these ports can be reached from the public Internet.
Using Tor SOCKS port (advanced)FreedomBox provides a Tor SOCKS port that other applications can connect to, in order to route their traffic over the Tor network. This port is accessible on any interfaces configured in the internal firewall zone. To configure the application, set SOCKS Host to the internal network connection's IP address, and set the SOCKS Port to 9050.
Circumventing Tor censorshipIf your ISP is trying to block Tor traffic, you can use tor bridge relays to connect to the tor network. 1. Get the bridge configuration from the Tor BridgeDB Tor BridgeDB 2. Add the lines to your FreedomBox Tor configuration as show below. Tor Configuration Page Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/Transmission.raw.xml b/doc/Transmission.raw.xml index 90ceb4a9a..b655b424d 100644 --- a/doc/Transmission.raw.xml +++ b/doc/Transmission.raw.xml @@ -1,269 +1,5 @@ - -
- - FreedomBox/Manual/Transmission - - - 9 - 2016-12-31 02:07:57 - JamesValleroy - add login info - - - 8 - 2016-12-30 19:20:51 - JamesValleroy - reword - - - 7 - 2016-12-30 19:13:09 - JamesValleroy - add intro paragraph - - - 6 - 2016-12-30 18:59:46 - JamesValleroy - no space in "BitTorrent" - - - 5 - 2016-12-26 18:00:44 - JamesValleroy - add screenshot - - - 4 - 2016-09-01 19:04:35 - Drahtseil - adapted title to Plinth wording - - - 3 - 2016-04-10 07:27:22 - PhilippeBaret - Added bottom navigation link - - - 2 - 2015-12-15 20:42:02 - PhilippeBaret - - - 1 - 2015-12-15 18:23:33 - PhilippeBaret - Added Transmission page and definition - - - -
- BitTorrent (Transmission) -
- What is Transmission ? - BitTorrent is a communications protocol using peer-to-peer (P2P) file sharing. It is not anonymous; you should assume that others can see what files you are sharing. There are two BitTorrent web clients available in FreedomBox: Transmission and Deluge. They have similar features, but you may prefer one over the other. - Transmission is a lightweight BitTorrent client that is well known for its simplicity and a default configuration that "Just Works". -
-
- Screenshot - - - - - - - Transmission Web Interface - - - -
-
- Using Transmission - After installing Transmission, it can be accessed at https://<your freedombox>/transmission. When you try to access this page, you will be required to login with a username and password. The default for both is "transmission". You can change the username and password using the configuration form in Plinth. -
-
- Known Issues - - - The initial password is shown in the Plinth configuration form in a hashed format. This prevents it from being read or copied. However, after the password is changed, it is shown directly, without hashing. - - - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
+ +
FreedomBox/Manual/Transmission92016-12-31 02:07:57JamesValleroyadd login info82016-12-30 19:20:51JamesValleroyreword72016-12-30 19:13:09JamesValleroyadd intro paragraph62016-12-30 18:59:46JamesValleroyno space in "BitTorrent"52016-12-26 18:00:44JamesValleroyadd screenshot42016-09-01 19:04:35Drahtseiladapted title to Plinth wording32016-04-10 07:27:22PhilippeBaretAdded bottom navigation link22015-12-15 20:42:02PhilippeBaret12015-12-15 18:23:33PhilippeBaretAdded Transmission page and definition
BitTorrent (Transmission)
What is Transmission ?BitTorrent is a communications protocol using peer-to-peer (P2P) file sharing. It is not anonymous; you should assume that others can see what files you are sharing. There are two BitTorrent web clients available in FreedomBox: Transmission and Deluge. They have similar features, but you may prefer one over the other. Transmission is a lightweight BitTorrent client that is well known for its simplicity and a default configuration that "Just Works".
ScreenshotTransmission Web Interface
Using TransmissionAfter installing Transmission, it can be accessed at https://<your freedombox>/transmission. When you try to access this page, you will be required to login with a username and password. The default for both is "transmission". You can change the username and password using the configuration form in Plinth.
Known IssuesThe initial password is shown in the Plinth configuration form in a hashed format. This prevents it from being read or copied. However, after the password is changed, it is shown directly, without hashing. Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/Upgrades.raw.xml b/doc/Upgrades.raw.xml index aecf5d4be..d8094f87b 100644 --- a/doc/Upgrades.raw.xml +++ b/doc/Upgrades.raw.xml @@ -1,238 +1,8 @@ - -
- - FreedomBox/Manual/Upgrades - - - 5 - 2017-03-31 20:11:01 - Drahtseil - Screenshot automatic upgrades - - - 4 - 2016-09-01 19:20:27 - Drahtseil - adapted title to Plinth wording - - - 3 - 2016-01-16 07:41:43 - StacyCockrum - - - 2 - 2016-01-16 07:35:56 - StacyCockrum - - - 1 - 2015-09-16 15:01:05 - SunilMohanAdapa - Add upgrades manual page - - - -
- Software Upgrades - FreedomBox can automatically install security upgrades. On the Upgrades page of the Settings section in Plinth you can turn on automatic upgrades. For FreedomBox versions above 0.5, this feature is enabled by default and there is no manual action necessary. It is strongly recommended that you have this option enabled to keep your FreedomBox secure. - Upgrades are performed every day at night. If you wish to shutdown FreedomBox every day after use, keep it running at night once a week or so to let the automatic upgrades happen. Alternatively, you can perform manual upgrades as described below. - - - - - - - upgrades.png - - - -
- Manual Upgrades - In the Plinth web interface, you can initiate a manual upgrade process from Upgrades page of the Settings section. Note that once the upgrades start, it may take a long time to complete and Plinth may seem to wait for the page to load. - Under some circumstances, automatic upgrades may fail and require you perform a manual upgrade action. Even upgrades initiated from Plinth may not finish properly. This may be because the upgrade process requires you to make a decision. In these cases, manual upgrade on the terminal may be the only option. - In addition, while the upgrade task is running any application installations will wait until the upgrade task is finished. Depending on the hardware, the upgrade task may take a little time, therefore, giving the impression that the application installation stalled. - To perform manual upgrades on the terminal, login into FreedomBox on a terminal or using a remote secure shell (see Secure Shell section). Then run the following commands: - +
FreedomBox/Manual/Upgrades52017-03-31 20:11:01DrahtseilScreenshot automatic upgrades42016-09-01 19:20:27Drahtseiladapted title to Plinth wording32016-01-16 07:41:43StacyCockrum22016-01-16 07:35:56StacyCockrum12015-09-16 15:01:05SunilMohanAdapaAdd upgrades manual page
Software UpgradesFreedomBox can automatically install security upgrades. On the Upgrades page of the Settings section in Plinth you can turn on automatic upgrades. For FreedomBox versions above 0.5, this feature is enabled by default and there is no manual action necessary. It is strongly recommended that you have this option enabled to keep your FreedomBox secure. Upgrades are performed every day at night. If you wish to shutdown FreedomBox every day after use, keep it running at night once a week or so to let the automatic upgrades happen. Alternatively, you can perform manual upgrades as described below. upgrades.png
Manual UpgradesIn the Plinth web interface, you can initiate a manual upgrade process from Upgrades page of the Settings section. Note that once the upgrades start, it may take a long time to complete and Plinth may seem to wait for the page to load. Under some circumstances, automatic upgrades may fail and require you perform a manual upgrade action. Even upgrades initiated from Plinth may not finish properly. This may be because the upgrade process requires you to make a decision. In these cases, manual upgrade on the terminal may be the only option. In addition, while the upgrade task is running any application installations will wait until the upgrade task is finished. Depending on the hardware, the upgrade task may take a little time, therefore, giving the impression that the application installation stalled. To perform manual upgrades on the terminal, login into FreedomBox on a terminal or using a remote secure shell (see Secure Shell section). Then run the following commands: - This will ask you if it is alright to install/upgrade (or remove) some packages and use (or release) some disk space. Say yes after review. In some cases, during the upgrades process you will be asked questions about modified configuration files, answering with a default Keep current configuration is usually safe. - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
+# apt-get dist-upgrade]]>This will ask you if it is alright to install/upgrade (or remove) some packages and use (or release) some disk space. Say yes after review. In some cases, during the upgrades process you will be asked questions about modified configuration files, answering with a default Keep current configuration is usually safe. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/Users.raw.xml b/doc/Users.raw.xml index 19a904e3c..fec1d52f1 100644 --- a/doc/Users.raw.xml +++ b/doc/Users.raw.xml @@ -1,233 +1,5 @@ - -
- - FreedomBox/Manual/Users - - - 4 - 2017-01-14 20:13:01 - JamesValleroy - add known issue - - - 3 - 2016-12-31 04:15:09 - JamesValleroy - reword - - - 2 - 2016-09-01 19:21:25 - Drahtseil - adapted title to Plinth wording - - - 1 - 2016-08-21 16:48:45 - Drahtseil - Created Users - - - -
- Users and Groups - You can grant access to your FreedomBox for other users. Provide the Username with a password and assign a group to it. Currently the groups - - - admin - - - wiki - - - are supported. - The user will be able to log in to services that support single sign-on through LDAP, if they are in the appropriate group. - Users in the admin group will be able to log in to all services. They can also log in to the system through SSH and have administrative privileges (sudo). - These characteristics can also be changed later-on. - It is also possible to set an SSH public key which will allow this user to securely log in to the system without using a password. You may enter multiple keys, one on each line. Blank lines and lines starting with # will be ignored. - A user's account can be deactivated, which will temporarily disable the account. -
- Known Issues - - - Currently, Plinth does not distinguish between users and administrators. Every user added through Plinth will have full access to the Plinth interface. - - - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
+ +
FreedomBox/Manual/Users42017-01-14 20:13:01JamesValleroyadd known issue32016-12-31 04:15:09JamesValleroyreword22016-09-01 19:21:25Drahtseiladapted title to Plinth wording12016-08-21 16:48:45DrahtseilCreated Users
Users and GroupsYou can grant access to your FreedomBox for other users. Provide the Username with a password and assign a group to it. Currently the groups admin wiki are supported. The user will be able to log in to services that support single sign-on through LDAP, if they are in the appropriate group. Users in the admin group will be able to log in to all services. They can also log in to the system through SSH and have administrative privileges (sudo). These characteristics can also be changed later-on. It is also possible to set an SSH public key which will allow this user to securely log in to the system without using a password. You may enter multiple keys, one on each line. Blank lines and lines starting with # will be ignored. A user's account can be deactivated, which will temporarily disable the account.
Known IssuesCurrently, Plinth does not distinguish between users and administrators. Every user added through Plinth will have full access to the Plinth interface. Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/ejabberd.raw.xml b/doc/ejabberd.raw.xml index 7b0dabd03..a363ffd9d 100644 --- a/doc/ejabberd.raw.xml +++ b/doc/ejabberd.raw.xml @@ -1,294 +1,5 @@ - -
- - FreedomBox/Manual/ejabberd - - - 10 - 2018-03-02 13:01:38 - JosephNuthalapati - Consistent naming conventions - - - 9 - 2017-01-07 17:42:27 - JamesValleroy - add note about service restart - - - 8 - 2017-01-02 13:48:30 - JamesValleroy - add port forwarding info - - - 7 - 2016-12-31 03:11:19 - JamesValleroy - clarify - - - 6 - 2016-12-31 03:10:19 - JamesValleroy - mention web client - - - 5 - 2016-12-31 02:35:52 - JamesValleroy - add security info - - - 4 - 2016-09-04 10:31:37 - Drahtseil - added links - - - 3 - 2016-04-10 07:18:35 - PhilippeBaret - Added bottom navigation link - - - 2 - 2015-12-15 18:37:29 - PhilippeBaret - Added definition to Chat server page - - - 1 - 2015-09-20 23:52:11 - JamesValleroy - add xmpp page - - - -
- Chat Server (XMPP) -
- What is XMPP? - XMPP is a federated protocol for Instant Messaging. This means that users who have accounts on one server, can talk to users that are on another server. XMPP can also be used for voice and video calls, if supported by the clients. - With XMPP, there are two ways that conversations can be secured: - - - TLS: This secures the connection between the client and server, or between two servers. This should be supported by all clients and is highly recommended. - - - End-to-end: This secures the messages sent from one client to another, so that even the server cannot see the contents. The latest and most convenient protocol is called OMEMO, but it is only supported by a few clients. There is another protocol called OTR that may be supported by some clients that lack OMEMO support. Both clients must support the same protocol for it to work. - - -
-
- Setting the Domain Name - For XMPP to work, your FreedomBox needs to have a Domain Name that can be accessed over the public Internet. You can read more about obtaining a Domain Name in the Dynamic DNS section of this manual. - Once you have a Domain Name, you can tell your FreedomBox to use it by setting the Domain Name in the System Configuration. - - - Note: After changing your Domain Name, the Chat Server (XMPP) page may show that the service is not running. After a minute or so, it should be up and running again. - - - Please note that Pagekite does not support the XMPP protocol at this time. -
-
- Registering XMPP users through SSO - Currently, all users created through Plinth will be able to login to the XMPP server. You can add new users through the System Users and Groups module. It does not matter which Groups are selected for the new user. -
-
- Using the web client - After the XMPP module install completes, the JSXC web client for XMPP can be accessed at https://<your freedombox>/plinth/apps/xmpp/jsxc/. It will automatically check the BOSH server connection to the configured domain name. -
-
- Using a desktop or mobile client - XMPP clients are available for various desktop and mobile platforms. -
-
- Port Forwarding - If your FreedomBox is behind a router, you will need to set up port forwarding on your router. You should forward the following ports for XMPP: - - - TCP 5222 (client-to-server) - - - TCP 5269 (server-to-server) - - - - - - - - - - - - - - - - - - Information - - - - - - - Support - - - - - Work Space - - - - - - Reports - - - - - Promote - - - - - - - Overview - - - - - Hardware - - - - - - - - - - Live Help - - - - - Where To Start - - - - - Translate - - - - - Calls - - - - - Talks - - - - - - - Features - - - - - Vision - - - - - - - - - - Q&A - - - - - Design - - - - - To Do - - - - - Metrics - - - - - Press - - - - - - - Download - - - - - Manual - - - - - - - - - - Use cases - - - - - Code - - - - - Contributors - - - - - Releases - - - - - Blog - - - - - - - - - -
-
-
+ +
FreedomBox/Manual/ejabberd102018-03-02 13:01:38JosephNuthalapatiConsistent naming conventions92017-01-07 17:42:27JamesValleroyadd note about service restart82017-01-02 13:48:30JamesValleroyadd port forwarding info72016-12-31 03:11:19JamesValleroyclarify62016-12-31 03:10:19JamesValleroymention web client52016-12-31 02:35:52JamesValleroyadd security info42016-09-04 10:31:37Drahtseiladded links32016-04-10 07:18:35PhilippeBaretAdded bottom navigation link22015-12-15 18:37:29PhilippeBaretAdded definition to Chat server page12015-09-20 23:52:11JamesValleroyadd xmpp page
Chat Server (XMPP)
What is XMPP?XMPP is a federated protocol for Instant Messaging. This means that users who have accounts on one server, can talk to users that are on another server. XMPP can also be used for voice and video calls, if supported by the clients. With XMPP, there are two ways that conversations can be secured: TLS: This secures the connection between the client and server, or between two servers. This should be supported by all clients and is highly recommended. End-to-end: This secures the messages sent from one client to another, so that even the server cannot see the contents. The latest and most convenient protocol is called OMEMO, but it is only supported by a few clients. There is another protocol called OTR that may be supported by some clients that lack OMEMO support. Both clients must support the same protocol for it to work.
Setting the Domain NameFor XMPP to work, your FreedomBox needs to have a Domain Name that can be accessed over the public Internet. You can read more about obtaining a Domain Name in the Dynamic DNS section of this manual. Once you have a Domain Name, you can tell your FreedomBox to use it by setting the Domain Name in the System Configuration. Note: After changing your Domain Name, the Chat Server (XMPP) page may show that the service is not running. After a minute or so, it should be up and running again. Please note that Pagekite does not support the XMPP protocol at this time.
Registering XMPP users through SSOCurrently, all users created through Plinth will be able to login to the XMPP server. You can add new users through the System Users and Groups module. It does not matter which Groups are selected for the new user.
Using the web clientAfter the XMPP module install completes, the JSXC web client for XMPP can be accessed at https://<your freedombox>/plinth/apps/xmpp/jsxc/. It will automatically check the BOSH server connection to the configured domain name.
Using a desktop or mobile clientXMPP clients are available for various desktop and mobile platforms.
Port ForwardingIf your FreedomBox is behind a router, you will need to set up port forwarding on your router. You should forward the following ports for XMPP: TCP 5222 (client-to-server) TCP 5269 (server-to-server) Back to Features introduction or manual pages. InformationSupportWork SpaceReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Metrics Press Download Manual Use cases Code Contributors Releases Blog HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Saturday, September 8th at 14:00 UTC Latest news: Stable FreedomBox images - 2017-08-05 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. CategoryFreedomBox
\ No newline at end of file diff --git a/doc/freedombox-manual.raw.xml b/doc/freedombox-manual.raw.xml index 623a049e2..3f041bdd8 100644 --- a/doc/freedombox-manual.raw.xml +++ b/doc/freedombox-manual.raw.xml @@ -2019,11 +2019,11 @@ proto udp]]> MediaWiki on FreedomBox is configured to be publicly readable and privately editable. Only logged in users can make edits to the wiki. This configuration prevents spam and vandalism on the wiki.
User management - Users can be created by the MediaWiki administrator (user "admin") only. The "admin" user can also be used to reset passwords of MediaWiki users. The administrator password, if forgotten can be reset anytime from the MediaWiki page in the Plinth UI. + Users can be created by the MediaWiki administrator (user "admin") only. The "admin" user can also be used to reset passwords of MediaWiki users. The administrator password, if forgotten can be reset anytime from the MediaWiki page in the Plinth UI.
Use cases - MediaWiki is quite versatile and can be put to many creative uses. It also comes with a lot of plugins and themes and is highly customizable. + MediaWiki is quite versatile and can be put to many creative uses. It also comes with a lot of plugins and themes and is highly customizable.
Personal Knowledge Repository