From 53891a900f675b402cc8079bda71a1b44a4ea0f2 Mon Sep 17 00:00:00 2001 From: James Valleroy Date: Wed, 19 Aug 2020 19:52:25 -0400 Subject: [PATCH] manual: Remove checked-in xml files Signed-off-by: James Valleroy Reviewed-by: Sunil Mohan Adapa --- doc/manual/en/Apache_userdir.raw.xml | 1 - doc/manual/en/Backups.raw.xml | 1 - doc/manual/en/Bind.raw.xml | 1 - doc/manual/en/Cockpit.raw.xml | 3 - doc/manual/en/Configure.raw.xml | 1 - doc/manual/en/Coturn.raw.xml | 4 - doc/manual/en/DateTime.raw.xml | 1 - doc/manual/en/Deluge.raw.xml | 1 - doc/manual/en/Diagnostics.raw.xml | 1 - doc/manual/en/DynamicDNS.raw.xml | 1 - doc/manual/en/Firewall.raw.xml | 13 - doc/manual/en/GitWeb.raw.xml | 1 - doc/manual/en/I2P.raw.xml | 1 - doc/manual/en/Ikiwiki.raw.xml | 1 - doc/manual/en/Infinoted.raw.xml | 1 - doc/manual/en/JSXC.raw.xml | 1 - doc/manual/en/LetsEncrypt.raw.xml | 1 - doc/manual/en/MLDonkey.raw.xml | 1 - doc/manual/en/MatrixSynapse.raw.xml | 7 - doc/manual/en/MediaWiki.raw.xml | 1 - doc/manual/en/Minetest.raw.xml | 1 - doc/manual/en/MiniDLNA.raw.xml | 1 - doc/manual/en/Monkeysphere.raw.xml | 1 - doc/manual/en/Mumble.raw.xml | 2 - doc/manual/en/NameServices.raw.xml | 1 - doc/manual/en/Networks.raw.xml | 5 - doc/manual/en/OpenVPN.raw.xml | 4 - doc/manual/en/PageKite.raw.xml | 1 - doc/manual/en/Performance.raw.xml | 1 - doc/manual/en/Power.raw.xml | 1 - doc/manual/en/Privoxy.raw.xml | 1 - doc/manual/en/Quassel.raw.xml | 1 - doc/manual/en/Radicale.raw.xml | 25 - doc/manual/en/Repro.raw.xml | 1 - doc/manual/en/Roundcube.raw.xml | 1 - doc/manual/en/Samba.raw.xml | 1 - doc/manual/en/Searx.raw.xml | 1 - doc/manual/en/SecureShell.raw.xml | 6 - doc/manual/en/Security.raw.xml | 1 - doc/manual/en/ServiceDiscovery.raw.xml | 1 - doc/manual/en/Shadowsocks.raw.xml | 1 - doc/manual/en/Sharing.raw.xml | 1 - doc/manual/en/Snapshots.raw.xml | 1 - doc/manual/en/Storage.raw.xml | 1 - doc/manual/en/Syncthing.raw.xml | 1 - doc/manual/en/TinyTinyRSS.raw.xml | 1 - doc/manual/en/Tor.raw.xml | 1 - doc/manual/en/Transmission.raw.xml | 1 - doc/manual/en/Upgrades.raw.xml | 8 - doc/manual/en/Users.raw.xml | 1 - doc/manual/en/bepasty.raw.xml | 1 - doc/manual/en/ejabberd.raw.xml | 1 - doc/manual/en/freedombox-manual.raw.xml | 15362 ---------------------- doc/manual/es/Apache_userdir.raw.xml | 1 - doc/manual/es/Backups.raw.xml | 1 - doc/manual/es/Bind.raw.xml | 1 - doc/manual/es/Cockpit.raw.xml | 3 - doc/manual/es/Configure.raw.xml | 1 - doc/manual/es/Coturn.raw.xml | 4 - doc/manual/es/DateTime.raw.xml | 1 - doc/manual/es/Deluge.raw.xml | 1 - doc/manual/es/Diagnostics.raw.xml | 1 - doc/manual/es/DynamicDNS.raw.xml | 1 - doc/manual/es/Firewall.raw.xml | 13 - doc/manual/es/GitWeb.raw.xml | 1 - doc/manual/es/I2P.raw.xml | 1 - doc/manual/es/Ikiwiki.raw.xml | 1 - doc/manual/es/Infinoted.raw.xml | 1 - doc/manual/es/JSXC.raw.xml | 1 - doc/manual/es/LetsEncrypt.raw.xml | 1 - doc/manual/es/MLDonkey.raw.xml | 1 - doc/manual/es/MatrixSynapse.raw.xml | 7 - doc/manual/es/MediaWiki.raw.xml | 1 - doc/manual/es/Minetest.raw.xml | 1 - doc/manual/es/MiniDLNA.raw.xml | 1 - doc/manual/es/Monkeysphere.raw.xml | 1 - doc/manual/es/Mumble.raw.xml | 2 - doc/manual/es/NameServices.raw.xml | 1 - doc/manual/es/Networks.raw.xml | 5 - doc/manual/es/OpenVPN.raw.xml | 4 - doc/manual/es/PageKite.raw.xml | 1 - doc/manual/es/Performance.raw.xml | 1 - doc/manual/es/Power.raw.xml | 1 - doc/manual/es/Privoxy.raw.xml | 1 - doc/manual/es/Quassel.raw.xml | 1 - doc/manual/es/Radicale.raw.xml | 25 - doc/manual/es/Repro.raw.xml | 1 - doc/manual/es/Roundcube.raw.xml | 1 - doc/manual/es/Samba.raw.xml | 1 - doc/manual/es/Searx.raw.xml | 1 - doc/manual/es/SecureShell.raw.xml | 4 - doc/manual/es/Security.raw.xml | 1 - doc/manual/es/ServiceDiscovery.raw.xml | 1 - doc/manual/es/Shadowsocks.raw.xml | 1 - doc/manual/es/Sharing.raw.xml | 1 - doc/manual/es/Snapshots.raw.xml | 1 - doc/manual/es/Storage.raw.xml | 1 - doc/manual/es/Syncthing.raw.xml | 1 - doc/manual/es/TinyTinyRSS.raw.xml | 1 - doc/manual/es/Tor.raw.xml | 1 - doc/manual/es/Transmission.raw.xml | 1 - doc/manual/es/Upgrades.raw.xml | 8 - doc/manual/es/Users.raw.xml | 1 - doc/manual/es/bepasty.raw.xml | 1 - doc/manual/es/ejabberd.raw.xml | 1 - doc/manual/es/freedombox-manual.raw.xml | 14871 --------------------- 106 files changed, 30469 deletions(-) delete mode 100644 doc/manual/en/Apache_userdir.raw.xml delete mode 100644 doc/manual/en/Backups.raw.xml delete mode 100644 doc/manual/en/Bind.raw.xml delete mode 100644 doc/manual/en/Cockpit.raw.xml delete mode 100644 doc/manual/en/Configure.raw.xml delete mode 100644 doc/manual/en/Coturn.raw.xml delete mode 100644 doc/manual/en/DateTime.raw.xml delete mode 100644 doc/manual/en/Deluge.raw.xml delete mode 100644 doc/manual/en/Diagnostics.raw.xml delete mode 100644 doc/manual/en/DynamicDNS.raw.xml delete mode 100644 doc/manual/en/Firewall.raw.xml delete mode 100644 doc/manual/en/GitWeb.raw.xml delete mode 100644 doc/manual/en/I2P.raw.xml delete mode 100644 doc/manual/en/Ikiwiki.raw.xml delete mode 100644 doc/manual/en/Infinoted.raw.xml delete mode 100644 doc/manual/en/JSXC.raw.xml delete mode 100644 doc/manual/en/LetsEncrypt.raw.xml delete mode 100644 doc/manual/en/MLDonkey.raw.xml delete mode 100644 doc/manual/en/MatrixSynapse.raw.xml delete mode 100644 doc/manual/en/MediaWiki.raw.xml delete mode 100644 doc/manual/en/Minetest.raw.xml delete mode 100644 doc/manual/en/MiniDLNA.raw.xml delete mode 100644 doc/manual/en/Monkeysphere.raw.xml delete mode 100644 doc/manual/en/Mumble.raw.xml delete mode 100644 doc/manual/en/NameServices.raw.xml delete mode 100644 doc/manual/en/Networks.raw.xml delete mode 100644 doc/manual/en/OpenVPN.raw.xml delete mode 100644 doc/manual/en/PageKite.raw.xml delete mode 100644 doc/manual/en/Performance.raw.xml delete mode 100644 doc/manual/en/Power.raw.xml delete mode 100644 doc/manual/en/Privoxy.raw.xml delete mode 100644 doc/manual/en/Quassel.raw.xml delete mode 100644 doc/manual/en/Radicale.raw.xml delete mode 100644 doc/manual/en/Repro.raw.xml delete mode 100644 doc/manual/en/Roundcube.raw.xml delete mode 100644 doc/manual/en/Samba.raw.xml delete mode 100644 doc/manual/en/Searx.raw.xml delete mode 100644 doc/manual/en/SecureShell.raw.xml delete mode 100644 doc/manual/en/Security.raw.xml delete mode 100644 doc/manual/en/ServiceDiscovery.raw.xml delete mode 100644 doc/manual/en/Shadowsocks.raw.xml delete mode 100644 doc/manual/en/Sharing.raw.xml delete mode 100644 doc/manual/en/Snapshots.raw.xml delete mode 100644 doc/manual/en/Storage.raw.xml delete mode 100644 doc/manual/en/Syncthing.raw.xml delete mode 100644 doc/manual/en/TinyTinyRSS.raw.xml delete mode 100644 doc/manual/en/Tor.raw.xml delete mode 100644 doc/manual/en/Transmission.raw.xml delete mode 100644 doc/manual/en/Upgrades.raw.xml delete mode 100644 doc/manual/en/Users.raw.xml delete mode 100644 doc/manual/en/bepasty.raw.xml delete mode 100644 doc/manual/en/ejabberd.raw.xml delete mode 100644 doc/manual/en/freedombox-manual.raw.xml delete mode 100644 doc/manual/es/Apache_userdir.raw.xml delete mode 100644 doc/manual/es/Backups.raw.xml delete mode 100644 doc/manual/es/Bind.raw.xml delete mode 100644 doc/manual/es/Cockpit.raw.xml delete mode 100644 doc/manual/es/Configure.raw.xml delete mode 100644 doc/manual/es/Coturn.raw.xml delete mode 100644 doc/manual/es/DateTime.raw.xml delete mode 100644 doc/manual/es/Deluge.raw.xml delete mode 100644 doc/manual/es/Diagnostics.raw.xml delete mode 100644 doc/manual/es/DynamicDNS.raw.xml delete mode 100644 doc/manual/es/Firewall.raw.xml delete mode 100644 doc/manual/es/GitWeb.raw.xml delete mode 100644 doc/manual/es/I2P.raw.xml delete mode 100644 doc/manual/es/Ikiwiki.raw.xml delete mode 100644 doc/manual/es/Infinoted.raw.xml delete mode 100644 doc/manual/es/JSXC.raw.xml delete mode 100644 doc/manual/es/LetsEncrypt.raw.xml delete mode 100644 doc/manual/es/MLDonkey.raw.xml delete mode 100644 doc/manual/es/MatrixSynapse.raw.xml delete mode 100644 doc/manual/es/MediaWiki.raw.xml delete mode 100644 doc/manual/es/Minetest.raw.xml delete mode 100644 doc/manual/es/MiniDLNA.raw.xml delete mode 100644 doc/manual/es/Monkeysphere.raw.xml delete mode 100644 doc/manual/es/Mumble.raw.xml delete mode 100644 doc/manual/es/NameServices.raw.xml delete mode 100644 doc/manual/es/Networks.raw.xml delete mode 100644 doc/manual/es/OpenVPN.raw.xml delete mode 100644 doc/manual/es/PageKite.raw.xml delete mode 100644 doc/manual/es/Performance.raw.xml delete mode 100644 doc/manual/es/Power.raw.xml delete mode 100644 doc/manual/es/Privoxy.raw.xml delete mode 100644 doc/manual/es/Quassel.raw.xml delete mode 100644 doc/manual/es/Radicale.raw.xml delete mode 100644 doc/manual/es/Repro.raw.xml delete mode 100644 doc/manual/es/Roundcube.raw.xml delete mode 100644 doc/manual/es/Samba.raw.xml delete mode 100644 doc/manual/es/Searx.raw.xml delete mode 100644 doc/manual/es/SecureShell.raw.xml delete mode 100644 doc/manual/es/Security.raw.xml delete mode 100644 doc/manual/es/ServiceDiscovery.raw.xml delete mode 100644 doc/manual/es/Shadowsocks.raw.xml delete mode 100644 doc/manual/es/Sharing.raw.xml delete mode 100644 doc/manual/es/Snapshots.raw.xml delete mode 100644 doc/manual/es/Storage.raw.xml delete mode 100644 doc/manual/es/Syncthing.raw.xml delete mode 100644 doc/manual/es/TinyTinyRSS.raw.xml delete mode 100644 doc/manual/es/Tor.raw.xml delete mode 100644 doc/manual/es/Transmission.raw.xml delete mode 100644 doc/manual/es/Upgrades.raw.xml delete mode 100644 doc/manual/es/Users.raw.xml delete mode 100644 doc/manual/es/bepasty.raw.xml delete mode 100644 doc/manual/es/ejabberd.raw.xml delete mode 100644 doc/manual/es/freedombox-manual.raw.xml diff --git a/doc/manual/en/Apache_userdir.raw.xml b/doc/manual/en/Apache_userdir.raw.xml deleted file mode 100644 index 93ef0575c..000000000 --- a/doc/manual/en/Apache_userdir.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Apache_userdir92020-07-19 22:42:24fioddorTranslations header added outside include block82020-05-30 17:51:15SunilMohanAdapaUpdate the title to emphasize app name over its generic name72020-05-23 19:43:05JamesValleroyadd TableOfContents62020-02-26 22:51:55JamesValleroyrephrase52020-02-26 22:50:33JamesValleroyPlinth -> FreedomBox42020-02-26 22:49:27JamesValleroysimply wording32019-02-27 00:08:57JamesValleroyremove wiki links22019-02-17 21:44:22MikkelKirkgaardNielsenrefer to ourselves as User websites, add basics table from new template12019-02-13 23:15:52MikkelKirkgaardNielsenadd draft pageTranslation(s): English - Español
User Websites
What is User websites?User websites is a module of the Apache webserver enabled to allow users defined in the FreedomBox system to expose a set of static files on the FreedomBox filesystem as a website to the local network and/or the internet according to the network and firewall setup. Application basicsCategory File sharing Available since version 0.9.4Upstream project website Upstream end user documentation
ScreenshotAdd when/if an interface is made for FreedomBox
Using User websitesThe module is always enabled and offers no configuration from the FreedomBox web interface. There is no configuration or status page shown for this module in the FreedomBox web interface. To serve documents, place the files in the designated directory in a FreedomBox user's home directory in the filesystem. This directory is: public_html Thus the absolute path for the directory of a user named fbx with home directory in /home/fbx will be /home/fbx/public_html. User websites will serve documents placed in this directory when requests for documents with the URI path "~fbx" are received. For the the example.org domain thus a request for the document example.org/~fbx/index.html will transfer the file in /home/fbx/public_html/index.html.
Using SFTP to create public_html and upload documentsTo be written Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Backups.raw.xml b/doc/manual/en/Backups.raw.xml deleted file mode 100644 index b09fefa95..000000000 --- a/doc/manual/en/Backups.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Backups332020-08-19 09:16:56fioddorTranslations header added outside include block322020-05-23 20:39:02JamesValleroyadd TableOfContents312019-11-11 17:07:05JosephNuthalapatiRename Tor Hidden Service to Tor Onion Service302019-02-26 23:33:42SunilMohanAdapaUpdate information about tt-rss292019-02-23 00:11:05JamesValleroyadd mldonkey282019-02-04 01:16:41SunilMohanAdapaAdd FreedomBox footer272019-01-31 01:30:48SunilMohanAdapaMinor formatting262019-01-31 01:29:18SunilMohanAdapaMake manual friendly, consolidate feature data, update description252019-01-30 17:45:57SunilMohanAdapaMinor release update242019-01-23 00:43:21SunilMohanAdapaUpdate information about syncthing232019-01-18 22:26:06SunilMohanAdapaUpdate OpenVPN information222018-10-30 05:04:32SunilMohanAdapaUpdate information about Tahoe-LAFS212018-10-29 23:50:51SunilMohanAdapaUpdate information about users and letsencrypt202018-10-26 05:36:32SunilMohanAdapaUpdate information about Monkeysphere192018-10-23 23:30:58SunilMohanAdapaUpdate information about upgrades182018-10-23 22:21:23SunilMohanAdapaAdd information about Tor172018-10-22 17:17:31SunilMohanAdapaUpdate information about newly merged changes162018-10-19 17:12:53SunilMohanAdapaAdd information about SSH152018-10-19 15:38:54SunilMohanAdapaUpdate information on recent progress142018-10-15 23:09:09SunilMohanAdapaUpdate status of datetime and deluge132018-10-09 03:22:17SunilMohanAdapaUpdate information about release of version 0.40122018-10-04 11:34:24JamesValleroyremove links to "FreedomBox" page112018-10-04 04:47:13SunilMohanAdapaMinor formatting102018-10-04 04:46:50SunilMohanAdapaUpdate list of supported applications92018-10-02 15:43:29DannyHaidar82018-10-02 15:41:49DannyHaidar72018-10-02 15:38:00DannyHaidar62018-10-01 17:38:55DannyHaidar52018-10-01 16:50:33DannyHaidar42018-10-01 16:49:00DannyHaidar32018-10-01 16:39:47DannyHaidar22018-10-01 16:37:48DannyHaidar12018-10-01 16:36:42DannyHaidarTranslation(s): English - Español
BackupsFreedomBox includes the ability to backup and restore data, preferences, configuration and secrets from most of the applications. The Backups feature is built using Borg backup software. Borg is a deduplicating and compressing backup program. It is designed for efficient and secure backups. This backups feature can be used to selectively backup and restore data on an app-by-app basis. Backed up data can be stored on the FreedomBox machine itself or on a remote server. Any remote server providing SSH access can be used as a backup storage repository for FreedomBox backups. Data stored remotely may be encrypted and in such cases remote server cannot access your decrypted data.
Status of Backups Feature App/Feature Support in Version Notes Avahi - no backup needed Backups - no backup needed Bind 0.41 Cockpit - no backup needed Coquelicot 0.40 includes uploaded files Datetime 0.41 Deluge 0.41 does not include downloaded/seeding files Diagnostics - no backup needed Dynamic DNS 0.39 ejabberd 0.39 includes all data and configuration Firewall - no backup needed ikiwiki 0.39 includes all wikis/blogs and their content infinoted 0.39 includes all data and keys JSXC - no backup needed Let's Encrypt 0.42 Matrix Synapse 0.39 includes media and uploads MediaWiki 0.39 includes wiki pages and uploaded files Minetest 0.39 MLDonkey 19.0 Monkeysphere 0.42 Mumble 0.40 Names - no backup needed Networks No No plans currently to implement backup OpenVPN 0.48 includes all user and server keys Pagekite 0.40 Power - no backup needed Privoxy - no backup needed Quassel 0.40 includes users and logs Radicale 0.39 includes calendar and cards data for all users repro 0.39 includes all users, data and keys Roundcube - no backup needed SearX - no backup needed Secure Shell (SSH) Server 0.41 includes host keys Security 0.41 Shadowsocks 0.40 only secrets Sharing 0.40 does not include the data in the shared folders Snapshot 0.41 only configuration, does not include snapshot data Storage - no backup needed Syncthing 0.48 does not include data in the shared folders Tahoe-LAFS 0.42 includes all data and configuration Tiny Tiny RSS 19.2 includes database containing feeds, stories, etc. Tor 0.42 includes configuration and secrets such as onion service keys Transmission 0.40 does not include downloaded/seeding files Upgrades 0.42 Users No No plans currently to implement backup
How to install and use BackupsStep 1 Backups: Step 1 Step 2 Backups: Step 2 Step 3 Backups: Step 3 Step 4 Backups: Step 4 Step 5 Backups: Step 5 Step 6 Backups: Step 6 Step 7 Backups: Step 7 Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Bind.raw.xml b/doc/manual/en/Bind.raw.xml deleted file mode 100644 index 53a0ee09c..000000000 --- a/doc/manual/en/Bind.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Bind72020-05-30 18:19:00SunilMohanAdapaUpdate the title to emphasize app name over its generic name62020-05-26 14:03:37fioddorCorrección.52020-05-26 14:03:05fioddorLinks to translations42020-05-26 13:36:27fioddorTOC and BEGIN_INCLUDE32020-05-26 04:53:53SunilMohanAdapaMinor formatting22020-05-26 04:53:30SunilMohanAdapaAdd note about not being available on OpenVPN12017-01-21 17:35:14JamesValleroycreate page for bindTranslation(s): - English - Español
BIND (Domain Name Server)BIND enables you to publish your Domain Name System (DNS) information on the Internet, and to resolve DNS queries for your user devices on your network. Currently, on FreedomBox, BIND is only used to resolve DNS queries for other machines on local network. It is also incompatible with sharing Internet connection from FreedomBox. Note: This service is available only on networks configured as "internal" zone. It is not available when connected via OpenVPN. Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Cockpit.raw.xml b/doc/manual/en/Cockpit.raw.xml deleted file mode 100644 index de47f95c3..000000000 --- a/doc/manual/en/Cockpit.raw.xml +++ /dev/null @@ -1,3 +0,0 @@ -
FreedomBox/Manual/Cockpit82020-08-18 20:59:34fioddorTranslations header added outside include block72020-05-23 20:39:42JamesValleroyadd TableOfContents62019-11-14 18:04:05fioddorwiki link to wiki page52019-11-11 16:57:11JosephNuthalapatiRename Tor Hidden Service to Tor Onion Service42019-08-20 18:22:51SunilMohanAdapaUpdate information about .local domain and fix URLs32019-07-19 00:08:47SunilMohanAdapaAdd informatio about Cockpit needing a proper domain name22019-01-10 21:41:56SunilMohanAdapaWrite manual page for Cockpit12018-03-02 12:57:48JosephNuthalapatiCreate stub for CockpitTranslation(s): English - Español
Cockpit (Server Administration)Cockpit is a server manager that makes it easy to administer GNU/Linux servers via a web browser. On a FreedomBox, controls are available for many advanced functions that are not usually required. A web based terminal for console operations is also available. It can be accessed by any user on your FreedomBox belonging to the admin group. Cockpit is only usable when you have proper domain name setup for your FreedomBox and you use that domain name to access Cockpit. See the Troubleshooting section for more information. Use cockpit only if you are an administrator of GNU/Linux systems with advanced skills. FreedomBox tries to coexist with changes to system by system administrators and system administration tools like Cockpit. However, improper changes to the system might causes failures in FreedomBox functions.
Using CockpitInstall Cockpit like any other application on FreedomBox. Make sure that Cockpit is enabled after that. cockpit-enable.png Ensure that the user account on FreedomBox that will used for Cockpit is part of the administrators group. cockpit-admin-user.png Launch the Cockpit web interface. Login using the configured user account. cockpit-login.png Start using cockpit. cockpit-system.png Cockpit is usable on mobile interfaces too. cockpit-mobile.png
FeaturesThe following features of Cockpit may be useful for advanced FreedomBox users.
System DashboardCockpit has a system dashboard that Shows detailed hardware information Shows basic performance metrics of a system Allows changing system time and timezone Allows changing hostname. Please use FreedomBox UI to do this Shows SSH server fingerprints cockpit-system.png
Viewing System LogsCockpit allows querying system logs and examining them in full detail. cockpit-logs.png
Managing StorageCockpit allows following advanced storage functions: View full disk information Editing disk partitions RAID management cockpit-storage1.png cockpit-storage2.png
NetworkingCockpit and FreedomBox both rely on NetworkManager to configure the network. However, Cockpit offers some advanced configuration not available on FreedomBox: Route configuration Configure Bonds, Bridges, VLANs cockpit-network1.png cockpit-network2.png cockpit-network3.png
ServicesCockpit allows management of services and periodic jobs (similar to cron). cockpit-services1.png cockpit-services2.png
Web TerminalCockpit offers a web based terminal that can be used perform manual system administration tasks. cockpit-terminal.png
TroubleshootingCockpit requires a domain name to be properly setup on your FreedomBox and will only work when you access it using a URL with that domain name. Cockpit will not work when using IP address in the URL. Using freedombox.local as the domain name also does not work. For example, the following URLs will not work: Starting with FreedomBox version 19.15, using .local domain works. You can access Cockpit using the URL . The .local domain is based on your hostname. If your hostname is mybox, your .local domain name will be mybox.local and the Cockpit URL will be . To properly access Cockpit, use the domain name configured for your FreedomBox.Cockpit will also work well when using a Tor Onion Service. The following URLs will work: The reason for this behaviour is that Cockpit uses WebSockets to connect to the backend server. Cross site requests for WebSockets must be prevented for security reasons. To implement this, Cockpit maintains a list of all domains from which requests are allowed. FreedomBox automatically configures this list whenever you add or remove a domain. However, since we can't rely on IP addresses, they are not added by FreedomBox to this domain list. You can see the current list of allowed domains, as managed by FreedomBox, in /etc/cockpit/cockpit.conf. You may edit this, but do so only if you understand web security consequences of this. Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Configure.raw.xml b/doc/manual/en/Configure.raw.xml deleted file mode 100644 index 5029c673c..000000000 --- a/doc/manual/en/Configure.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Configure132020-08-19 09:20:46fioddorLink corrected122020-08-19 09:10:44fioddorTranslations header added outside include block112020-05-23 19:47:01JamesValleroymove TableOfContents above BEGIN_INCLUDE102020-05-23 17:08:24JamesValleroyremove references to (Plinth)92019-02-28 10:25:01JosephNuthalapatiRename default app to webserver home page82018-10-09 09:54:01JosephNuthalapatiImprove formatting72018-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 ConfigureTranslation(s): English - Español
ConfigureConfigure has some general configuration options:
HostnameHostname is the local name by which other devices on the local network can reach your FreedomBox. The default hostname is freedombox.
Domain NameDomain 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), Matrix Synapse, Certificates (Let's Encrypt), and Monkeysphere.
Webserver Home PageThis is an advanced option that allows you to set something other than FreedomBox Service as the home page 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 home page, visiting will take you to instead of the usual . You can set any web application, Ikiwiki wikis and blogs or Apache's default index.html page as the web server home page. Once some other app is set as the home page, you can only navigate to the FreedomBox Service by typing into the browser. /freedombox can also be used as an alias to /plinth Tip: Bookmark the URL of FreedomBox Service before setting the home page to some other app. Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Coturn.raw.xml b/doc/manual/en/Coturn.raw.xml deleted file mode 100644 index 971c048fa..000000000 --- a/doc/manual/en/Coturn.raw.xml +++ /dev/null @@ -1,4 +0,0 @@ -
FreedomBox/Manual/Coturn132020-07-19 22:15:01fioddorTranslations header added outside include block122020-07-18 15:36:19fioddorAvailability standardized.112020-07-18 15:03:33fioddorIcon added for fast identification. Availability standardized.102020-05-30 18:10:51SunilMohanAdapaUpdate the title to emphasize app name over its generic name92020-05-23 19:57:40JamesValleroyadd TableOfContents82020-05-18 23:24:50JamesValleroyremove duplicate word "server"72020-05-18 23:23:07JamesValleroyspelling "known"62020-05-18 23:22:26JamesValleroyadd common acronym (NAT)52020-05-18 23:21:45JamesValleroyspelling42020-05-10 10:33:22fioddorStress the benefits of direct streaming.32020-05-08 19:15:06Drahtseiltiny typo in synapes corrected22020-05-06 06:04:11SunilMohanAdapaUpdate title, include footer12020-05-06 05:59:44SunilMohanAdapaAdd manual page for new app CoturnTranslation(s): English - Español
Coturn (VoIP Helper) Coturn icon Available since: version 20.8 Coturn is a server to facilitate audio/video calls and conferences by providing an implementation of TURN and STUN protocols. WebRTC, SIP and other communication servers can use it to establish a call between parties who are otherwise unable connect to each other. It is not meant to be used directly by users. Servers such as Matrix Synapse need to be configured with the details provided on the Coturn app page. Apart from Matrix Synapse, Jitsi, Ejabberd, Nextcloud Talk, etc. can use Coturn server for audio/video calls and conferences. There is no need for the servers to be running on the same machine as FreedomBox and external servers can use Coturn running on FreedomBox. Coturn is configured in FreedomBox as an advanced app. This means that you need to check "Show advanced apps and features" in "General Configuration" to see Coturn icon in the "Apps" section.
How it worksWhen making an audio/video call, it is best to route the media streams between two peers directly. This will give the best possible latency (better signal quality) and avoid depending on a centralized server (privacy). It scales well because a simple chat server can host thousands of calls without involving the server in any way other than to setup the call. However, this approach does not work most of the time to due to how networks are configured. Most peers on the network do not have a unique IP address allocated to them. They work hidden behind a network device that performs "Network Address Translation" (NAT) for them. This means that the two peers have no way of reaching each other. To address this problem, a simple technique known as STUN was introduced. With the help of a third party STUN server, the peers can trick the NAT devices, to carry the traffic between the two peers. Unfortunately, this trick only works about 80% of the time. So, if STUN fails, peers have no choice but to route their traffic through an intermediary server called TURN server. All the mechanism of trying out STUN first and then falling back to TURN is described in a protocol known as ICE. On FreedomBox, Coturn provides both STUN and TURN servers. Both services are provided over TCP as well as UDP. They are provided on unencrypted as well as encrypted channels (with have a higher chance of success). Since STUN servers are very inexpensive and don't consume a lot of server resources, there is no authentication needed to use them. TURN servers on the other hand need authentication. This authentication is highly simplified and does not require maintaining a database of users. A server such as matrix-synapse which is about to setup an audio/video call between two peers will generate a username and password using a shared secret. When the peers use the TURN server, they will be validated using these credentials because the TURN server also knows the same secret. In summary, a communication server needs to know the URLs of the STUN/TURN servers along with a shared authentication secret for TURN. After that, during audio/video call setup, they will correctly guide the peers to use STUN/TURN servers. Coturn app in FreedomBox provides exactly this information. This information can be used to configure a communication server irrespective of whether it is running on the same FreedomBox or on another server.
Configuring Matrix SynapseMatrix Synapse server in FreedomBox can be configured to use Coturn TURN/STUN server. In future, when you install Matrix Synapse, FreedomBox will automatically install Coturn and configure its parameters into Matrix Synapse. To configure Matrix Synapse, edit the file /etc/matrix-synapse/homeserver.yaml with the following lines: And then restart matrix-synapse server by disabling and re-enabling the matrix-synapse app. Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/DateTime.raw.xml b/doc/manual/en/DateTime.raw.xml deleted file mode 100644 index 2107c3f5e..000000000 --- a/doc/manual/en/DateTime.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/DateTime62020-08-19 10:01:36fioddorTranslations header added outside include block. Begin mark added.52020-05-23 20:41:22JamesValleroyRevert to revision 3.42020-05-23 20:40:09JamesValleroyadd TableOfContents32020-03-30 00:08:09JamesValleroytoo many #s in front of END_INCLUDE22017-03-31 20:20:57DrahtseilScreenshot DateTime12016-08-21 09:26:45DrahtseilCreated Date & TimeTranslation(s): English - Español
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. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Deluge.raw.xml b/doc/manual/en/Deluge.raw.xml deleted file mode 100644 index e4a531a75..000000000 --- a/doc/manual/en/Deluge.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Deluge182020-07-19 22:17:43fioddor172020-07-19 22:16:45fioddorTranslations header added outside include block162020-07-18 14:37:24fioddor152020-07-18 14:32:54fioddorAvailability version142020-07-18 11:22:29fioddorIcon added for fast identification132020-05-30 17:53:48SunilMohanAdapaUpdate the title to emphasize app name over its generic name122020-05-23 19:48:36JamesValleroyadd TableOfContents112016-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 manualTranslation(s): English - Español
Deluge (BitTorrent Web Client) Deluge icon Available since: version 0.5
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. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Diagnostics.raw.xml b/doc/manual/en/Diagnostics.raw.xml deleted file mode 100644 index 659c16b96..000000000 --- a/doc/manual/en/Diagnostics.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Diagnostics22020-08-19 10:11:39fioddorTranslations header added outside include block. BEGIN_INCLUDE mark added.12016-08-21 09:43:52DrahtseilCreated DiagnosticsTranslation(s): English - Español
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. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/DynamicDNS.raw.xml b/doc/manual/en/DynamicDNS.raw.xml deleted file mode 100644 index bdd8f991a..000000000 --- a/doc/manual/en/DynamicDNS.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/DynamicDNS182020-08-18 20:52:19fioddorTranslations header added outside include block172020-05-23 20:41:48JamesValleroyadd TableOfContents162019-07-31 13:18:03NikolasNybyfix typo152019-02-26 03:20:16JamesValleroyspelling142018-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:48DanielSteglichTranslation(s): English - Español
Dynamic DNS Client
What is Dynamic DNS?In order to reach a server on the Internet, the server needs to have permanent address also known 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 immediately) Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Firewall.raw.xml b/doc/manual/en/Firewall.raw.xml deleted file mode 100644 index afa9b376d..000000000 --- a/doc/manual/en/Firewall.raw.xml +++ /dev/null @@ -1,13 +0,0 @@ -
FreedomBox/Manual/Firewall332020-08-19 09:36:35fioddorTranslations header added outside include block322020-05-24 08:58:20fioddorMinor clarification312020-05-24 04:43:27SunilMohanAdapaAdd advanced firewall operations section referring to Cockpit302020-05-23 20:42:15JamesValleroyadd TableOfContents292020-05-03 18:56:52JamesValleroyremove link to source file, no longer exists282020-05-03 18:56:08JamesValleroyrename plinth -> freedombox272020-04-12 15:56:21JamesValleroyadd links back to top level pages262019-10-21 14:58:15fioddorMinor correction252018-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 statusTranslation(s): English - Español
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 FreedomBox web interface 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. If an interface is not assigned any zone, it is automatically assigned external 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.
Opening Custom PortsCockpit app provides advanced management of firewall. Both FreedomBox and Cockpit operate over firewalld and are hence compatible with each other. In particular, Cockpit can be used to open custom services or ports on FreedomBox. This is useful if you are manually running your own services in addition to the services provided by FreedomBox on the same machine. firewalld-cockpit.png
FreedomBox Ports/ServicesThe following table attempts to document the ports, services and their default statuses in FreedomBox. If you find this page outdated, see the Firewall status page in FreedomBox interface. ServicePort ExternalEnabled by defaultStatus shown in FreedomBoxManaged by FreedomBox Minetest 30000/udp {*} {X} (./) (./) XMPP Client 5222/tcp {*} {X} (./) (./) XMPP Server 5269/tcp {*} {X} (./) (./) XMPP Bosh 5280/tcp {*} {X} (./) (./) NTP 123/udp {o} (./) (./) (./) FreedomBox Web Interface (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/udp {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: Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/GitWeb.raw.xml b/doc/manual/en/GitWeb.raw.xml deleted file mode 100644 index a06f49231..000000000 --- a/doc/manual/en/GitWeb.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/GitWeb142020-07-19 22:20:56fioddorTranslations header added outside include block132020-07-18 15:37:33fioddorAvailability standardized.122020-07-18 15:26:37fioddorTiny style tuning112020-07-18 15:10:51fioddorAvailability standardized.102020-07-18 11:32:24fioddorIcon added for fast identification92020-05-30 18:07:40SunilMohanAdapaUpdate the title to emphasize app name over its generic name82020-05-23 19:55:40JamesValleroyadd TableOfContents72020-01-29 06:48:44fioddorInhibit autolink and stress to avoid using admin accounts.62020-01-27 12:42:43VeikoAasa52020-01-27 09:50:21VeikoAasa42019-12-16 23:25:10JamesValleroyadd standard manual page footer32019-12-15 19:38:46DrahtseilCopied description from plinth, managing, access22019-12-14 13:44:36JosephNuthalapatiAdd section: HTTP basic auth12019-12-14 13:14:15JosephNuthalapatiCreate GitWeb page with a stub.Translation(s): English - Español
GitWeb (Simple Git Hosting) Gitweb icon Available since: version 19.19 Git is a distributed version-control system for tracking changes in source code during software development. GitWeb provides a web interface to Git repositories. You can browse history and content of source code, use search to find relevant commits and code. You can also clone repositories and upload code changes with a command-line Git client or with multiple available graphical clients. And you can share your code with people around the world. To learn more on how to use Git visit Git tutorial.
Managing the repositoriesAfter installation of GitWeb, a new repository can be created. It can be marked as private to limit access.
AccessGitWeb can be accessed after installation e.g. by the web client through https://<my_freedombox_name>/gitweb.
HTTP basic authGitWeb on FreedomBox currently supports HTTP remotes only. To avoid having to enter the password each time you pull/push to the repository, you can edit your remote to include the credentials. Example: Your username and password will be encrypted. Someone monitoring the network traffic will notice the domain name only. Note: If using this method, your password will be stored in plain text in the local repository's .git/config file. For this reason, you should create a FreedomBox user who has only access to the gitweb and never use an admin account.
MirroringThough your repositories are primarily hosted on your own FreedomBox, you can configure a repository on another Git hosting system like GitLab as a mirror. Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/I2P.raw.xml b/doc/manual/en/I2P.raw.xml deleted file mode 100644 index 5f32454a9..000000000 --- a/doc/manual/en/I2P.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/I2P52020-07-19 22:22:19fioddorTranslations header added outside include block42020-07-18 11:46:28fioddorIcon added for fast identification32020-05-30 18:17:33SunilMohanAdapaUpdate the title to emphasize app name over its generic name22020-05-23 19:59:34JamesValleroyadd TableOfContents12019-04-30 00:40:36SunilMohanAdapaInitial page for I2P application in FreedomBoxTranslation(s): English - Español
I2P (Anonymity Network) I2P icon
About I2PThe Invisible Internet Project is an anonymous network layer intended to protect communication from censorship and surveillance. I2P provides anonymity by sending encrypted traffic through a volunteer-run network distributed around the world. Find more information about I2P on their project homepage.
Services OfferedThe following services are offered via I2P in FreedomBox by default. Additional services may be available when enabled from I2P router console that can be launched from FreedomBox web interface. Anonymous Internet browsing: I2P can be used to browse Internet anonymously. For this, configure your browser (preferable a Tor Browser) to connect to I2P proxy. This can be done by setting HTTP proxy and HTTPS proxy to freedombox.local (or your FreedomBox's local IP address) and ports to 4444 and 4445 respectively. This service is available only when you are reaching FreedomBox using local network (networks in internal zone) and not available when connecting to FreedomBox from the Internet. One exception to this is when you connect to FreedomBox's VPN service from Internet you can still use this service. Reaching eepsites: I2P network can host websites that can remain anonymous. These are called eepsites and end with .i2p in their domain name. For example, is the website for I2P project in the I2P network. eepsites are not reachable using a regular browser via regular Internet connection. To browse eepsites, your browser needs to be configured to use HTTP, HTTPS proxies as described above. This service is available only when you are reaching FreedomBox using local network (networks in internal zone) and not available when connecting to FreedomBox from the Internet. One exception to this is when you connect to FreedomBox's VPN service from Internet you can still use this service. Anonymous torrent downloads: I2PSnark, an application for anonymously downloading and sharing files over the BitTorrent network is available in I2P and enabled by default in FreedomBox. This application is controlled via a web interface that can be launched from 'Anonymous torrents' section of I2P app in FreedomBox web interface or from the I2P router console interface. Only logged-in users belonging to 'Manage I2P application' group can use this service. IRC network: I2P network contains an IRC network called Irc2P. This network hosts the I2P project's official IRC channel among other channels. This service is enabled by default in FreedomBox. To use it, open your favourite IRC client. Then configure it to connect to host freedombox.local (or your FreedomBox's local IP address) with port number 6668. This service is available only when you are reaching FreedomBox using local network (networks in internal zone) and not available when connecting to FreedomBox from the Internet. One exception to this is when you connect to FreedomBox's VPN service from Internet you can still use this service. I2P router console: This is the central management interface for I2P. It shows the current status of I2P, bandwidth statistics and allows modifying various configuration settings. You can tune your participation in the I2P network and use/edit a list of your favourite I2P sites (eepsites). Only logged-in users belonging to 'Manage I2P application' group can use this service. Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.
\ No newline at end of file diff --git a/doc/manual/en/Ikiwiki.raw.xml b/doc/manual/en/Ikiwiki.raw.xml deleted file mode 100644 index a855e8a1c..000000000 --- a/doc/manual/en/Ikiwiki.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Ikiwiki162020-07-19 22:23:13fioddorTranslations header added outside include block152020-07-18 15:35:17fioddorAvailability standardized.142020-07-18 15:33:51fioddorAvailability version132020-07-18 14:05:14fioddorIcon added for fast identification122020-05-30 18:17:11SunilMohanAdapaUpdate the title to emphasize app name over its generic name112020-05-23 19:59:05JamesValleroyadd TableOfContents102020-05-23 17:06:50JamesValleroyrename plinth -> freedombox92016-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 manualTranslation(s): English - Español
Ikiwiki (Wiki and Blog) Ikiwiki icon Avaiable since: version 0.5
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 FreedomBox. 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 FreedomBox (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. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Infinoted.raw.xml b/doc/manual/en/Infinoted.raw.xml deleted file mode 100644 index ecba9fce4..000000000 --- a/doc/manual/en/Infinoted.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Infinoted62020-07-19 22:24:08fioddorTranslations header added outside include block52020-07-18 15:45:52fioddorAvailability version42020-07-18 14:10:47fioddorIcon added for fast identification32020-05-30 18:02:02SunilMohanAdapaUpdate the title to emphasize app name over its generic name22020-05-23 19:53:56JamesValleroyadd TableOfContents12017-01-21 17:23:17JamesValleroycreate page for infinotedTranslation(s): English - Español
Infinoted (Gobby Server) Infinoted icon Available since: version 0.5 infinoted is a server for Gobby, a collaborative text editor. To use it, download Gobby, desktop client and install it. Then start Gobby and select "Connect to Server" and enter your FreedomBox's domain name.
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 infinoted: TCP 6523 Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/JSXC.raw.xml b/doc/manual/en/JSXC.raw.xml deleted file mode 100644 index a8c145b15..000000000 --- a/doc/manual/en/JSXC.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/JSXC52020-07-19 22:24:57fioddorTranslations header added outside include block42020-07-18 15:51:34fioddorAvailability version32020-07-18 10:49:28fioddoralt texts corrected22020-07-17 23:16:16fioddorClarification on needed ports12020-07-17 23:13:18fioddorNew page for existing app.Translation(s): English - Español
JSXC (Web Chat Client) JSXC icon Available since: version 0.11.0 JSXC is a web chat client. It can be used to join compatible chat servers. FreedomBox offers both parties, a server (ejabberd) and a web client (JSXC), from its web interface.
Technical SpecificationsJSXC features the XMPP over BOSH protocol and is implemented in HTML5. XMPP is a federated server-client 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.
InstallationYou can install JSXC through its icon in the Apps section of FreedomBox web interface. The ejabberd (XMPP server) icon also offers to launch the web client (and installs JSXC if not yet installed).
UsageAfter the JSXC module install completes, the JSXC can be accessed through its icon in the Apps section of FreedomBox web interface. The ejabberd (XMPP server) icon also offers to launch the web client. Both will redirect you to https://<your freedombox>/plinth/apps/xmpp/jsxc/. To use it, you need to input the domain name of the server to connect to. It will automatically check the BOSH server connection to the given domain name as you type it. JSXC not connecting JSXC connecting Check for further details. Videoconferencing and file transfer features are offered by JSXC but don't seem to work in FreedomBox yet.
Port ForwardingIf your FreedomBox is behind a router and you want to connect to other servers, you will need to set up port forwarding on your router. You should forward the following ports for XMPP: TCP 5222 (client-to-server) Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/LetsEncrypt.raw.xml b/doc/manual/en/LetsEncrypt.raw.xml deleted file mode 100644 index ef8a81872..000000000 --- a/doc/manual/en/LetsEncrypt.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/LetsEncrypt132020-08-19 09:42:35fioddorTranslations header added outside include block122020-05-30 18:20:55SunilMohanAdapaUpdate the title to emphasize app name over its generic name112020-05-23 20:42:47JamesValleroyadd TableOfContents102019-11-01 00:51:44JosephNuthalapatiFix attachment inlining92019-02-26 03:21:08JamesValleroyspelling82018-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 EncyptTranslation(s): English - Español
Let's Encrypt (Certificates)A digital certificate 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. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/MLDonkey.raw.xml b/doc/manual/en/MLDonkey.raw.xml deleted file mode 100644 index 2f73e02c6..000000000 --- a/doc/manual/en/MLDonkey.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/MLDonkey162020-07-19 22:30:08fioddorTranslations header added outside include block152020-07-18 16:23:50fioddorIcon added for fast identification. Availability standardized.142020-05-30 18:00:14SunilMohanAdapaUpdate the title to emphasize app name over its generic name132020-05-23 19:52:41JamesValleroyadd TableOfContents122019-02-08 06:29:35SunilMohanAdapaUpdate more information about clients112019-02-06 13:52:06jcromero102019-02-02 21:16:52jcromero92019-01-23 21:18:05jcromero82019-01-23 18:34:25jcromero72019-01-23 18:30:54jcromero62019-01-23 18:19:19SunilMohanAdapaEscape from linking52019-01-23 18:18:47SunilMohanAdapaWrite MLdonkey as MLDonkey42019-01-23 18:17:54SunilMohanAdapaWrite MLdonkey as MLDonkey and other minor fixes32019-01-23 17:37:32jcromero22019-01-23 13:37:48jcromero12019-01-23 13:31:23jcromeroTranslation(s): English - Español
MLDonkey (Peer-to-peer File Sharing) MLDonkey icon Available since: version 0.48.0
What is MLDonkey?MLDonkey is an open-source, multi-protocol, peer-to-peer file sharing application that runs as a back-end server application on many platforms. It can be controlled through a user interface provided by one of many separate front-ends, including a Web interface, telnet interface and over a dozen native client programs. Originally a Linux client for the eDonkey protocol, it now runs on many flavors of Unix-like, OS X, Microsoft Windows and MorphOS and supports numerous peer-to-peer protocols including ED2K (and Kademlia and Overnet), BitTorrent, DC++ and more. Read more about MLDonkey at the MLDonkey Project Wiki
ScreenshotMLDonkey Web Interface
Using MLDonkey Web InterfaceAfter installing MLDonkey, its web interface can be accessed from FreedomBox at https://<your freedombox>/mldonkey. Users belonging to the ed2k and admin groups can access this web interface.
Using Desktop/Mobile InterfaceMany desktop and mobile applications can be used to control MLDonkey. MLDonkey server will always be running on FreedomBox. It will download files (or upload them) and store them on FreedomBox even when your local machine is not running or connected to MLDonkey on FreedomBox. Only users of admin group can access MLDonkey on FreedomBox using desktop or mobile clients. This is due to restrictions on which group of users have SSH access into FreedomBox. Create an admin user or use an existing admin user. On your desktop machine, open a terminal and run the following command. It is recommended that you configure and use SSH keys instead of passwords for the this step. Start the GUI application and then connect it to MLDonkey as if MLDonkey is running on the local desktop machine. After you are done, terminate the SSH command by pressing Control-C. See MLDonkey documentation for SSH Tunnel for more information. Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/MatrixSynapse.raw.xml b/doc/manual/en/MatrixSynapse.raw.xml deleted file mode 100644 index f899748fc..000000000 --- a/doc/manual/en/MatrixSynapse.raw.xml +++ /dev/null @@ -1,7 +0,0 @@ -
FreedomBox/Manual/MatrixSynapse242020-07-19 22:26:17fioddorTranslations header added outside include block232020-07-18 15:54:56fioddorAvailability standardized.222020-07-18 15:54:36fioddorAvailability version212020-07-18 14:22:57fioddorBetter clue202020-07-18 14:20:32fioddorIcon added for fast identification192020-05-30 17:56:34SunilMohanAdapaUpdate the title to emphasize app name over its generic name182020-05-23 19:50:39JamesValleroyadd TableOfContents172020-03-21 20:17:34DrahtseilClearer explanation of users activated. Add port forwarding162020-01-03 23:07:19JamesValleroyminor spelling fix152020-01-03 12:47:36fioddorMinor correction142020-01-03 12:46:45fioddorMinor clarifications132019-12-27 15:42:46chkmue122019-10-07 23:01:22JamesValleroyfix spelling112019-09-25 18:31:37SunilMohanAdapaAdd section for advanced administration commands102019-03-01 17:53:22JosephNuthalapatiEscape FreedomBox hyperlinks92019-02-27 21:16:58JosephNuthalapatiMention IRC as an alternative for large Matrix rooms82019-02-13 09:09:45JosephNuthalapatiRemove pop-culture references. Add notes about large rooms and memory usage.72019-01-14 20:16:04DrahtseilSystem requirements62018-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:43rahuldeTranslation(s): English - Español
Matrix Synapse (Chat Server) Matrix Synapse icon Available since: version 0.14.0
What is 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. Matrix Synapse is a federated application where chat rooms can exist on any server and users from any server in the federated network can join them. Learn more about Matrix.
How to access your Matrix Synapse server?We recommend the Riot client to access the Matrix Synapse server. You can download Riot for desktops. Mobile applications for Android and iOS are available from their respective app stores.
Setting up Matrix Synapse on your FreedomBoxTo 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. Currently, you will not be able to change the domain once is it configured. Your router has to be configured to forward port 8448. All the registered users of your FreedomBox will have their Matrix IDs as @username:domain. If public registration is enabled, also your chosen client can be used to register a user account.
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.
Memory usageThe Synapse reference server implemented in Python is known to be quite RAM hungry, especially when loading large rooms with thousands of members like #matrix:matrix.org. It is recommended to avoid joining such rooms if your FreedomBox device only has 1 GiB RAM or less. Rooms with up to a hundred members should be safe to join. The Matrix team is working on a new implementation of the Matrix server written in Go called Dendrite which might perform better in low-memory environments. Some large public rooms in the Matrix network are also available as IRC channels (e.g. #freedombox:matrix.org is also available as #freedombox on irc.debian.org). It is better to use IRC instead of Matrix for such large rooms. You can join the IRC channels using Quassel.
Advanced usageIf you wish to create a large number of users on your Matrix Synapse server, use the following commands on a remote shell as root user: /etc/matrix-synapse/conf.d/registration_shared_secret.yaml -chmod 600 /etc/matrix-synapse/conf.d/registration_shared_secret.yaml -chown matrix-synapse:nogroup /etc/matrix-synapse/conf.d/registration_shared_secret.yaml -systemctl restart matrix-synapse -register_new_matrix_user -c /etc/matrix-synapse/conf.d/registration_shared_secret.yaml]]>If you wish to see the list of users registered in Matrix Synapse, the following as root user: If you wish to create a community in Matrix Synapse, a Matrix user with server admin privileges is needed. In order to grant such privileges to username run the following commands as root user: Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/MediaWiki.raw.xml b/doc/manual/en/MediaWiki.raw.xml deleted file mode 100644 index 52b6c017d..000000000 --- a/doc/manual/en/MediaWiki.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/MediaWiki182020-07-19 22:27:10fioddorTranslations header added outside include block172020-07-18 16:00:25fioddorIcon added for fast identification. Availability standardized.162020-05-30 18:12:57SunilMohanAdapaUpdate the title to emphasize app name over its generic name152020-05-23 19:58:35JamesValleroyadd TableOfContents142020-04-12 16:05:09JamesValleroyadd links back to top level pages132020-01-24 11:40:30JosephNuthalapatiAdd screenshot of editor toolbar122020-01-24 11:38:30JosephNuthalapatiMention the default wiki editor in "Editing Wiki content"112020-01-21 08:09:53fioddorCustomization section moved at the end because the others are more generic.102020-01-18 09:41:15JosephNuthalapatiAdd customization section92018-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 FreedomBoxTranslation(s): English - Español
MediaWiki (Wiki) MediaWiki icon Available since: version 0.20.0
About MediaWikiMediaWiki is the software that powers the Wikimedia suite of wikis. Read more about MediaWiki on Wikipedia
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 app page in web interface.
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 ContentThe MediaWiki installation on FreedomBox ships with a basic editor with a toolbar for common options like Bold, Italics etc. Click on the Advanced section for more options like Headings, bullet lists etc. mediawiki-toolbar.png
Visual EditorMediaWiki's new Visual Editor gives a WYSIWYG user interface to creating wiki pages. This is still a Beta feature and is not provided by default with MediaWiki. 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.
Customization
SkinsMediaWiki's default skin is usually Vector. The default skin set by FreedomBox is Timeless. Vector is a skin best-suited for viewing on desktop browsers. It is not suitable for mobile screen sizes. Wikimedia sites host a separate mobile site. It is not worth hosting a separate mobile site for small MediaWiki installations like those on FreedomBox. Using a mobile-friendly skin like Timeless is a cheaper way of solving the problem. Administrators can choose a default skin from the app configuration. Users of the site also have the choice of viewing it with a different skin. Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Minetest.raw.xml b/doc/manual/en/Minetest.raw.xml deleted file mode 100644 index 1dc7a4d9b..000000000 --- a/doc/manual/en/Minetest.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Minetest82020-07-19 22:28:11fioddorTranslations header added outside include block72020-07-18 16:08:07fioddorIcon added for fast identification. Availability standardized.62020-05-30 17:54:28SunilMohanAdapaUpdate the title to emphasize app name over its generic name52020-05-23 19:49:18JamesValleroyadd TableOfContents42020-05-03 18:37:00JamesValleroyuse https link32017-01-02 13:29:19JamesValleroyfix list22017-01-02 13:26:03JamesValleroyadd port forwarding info12016-09-04 10:20:44Drahtseilstub createdTranslation(s): English - Español
Minetest (Block Sandbox) Minetest icon Available since: version 0.9 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. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/MiniDLNA.raw.xml b/doc/manual/en/MiniDLNA.raw.xml deleted file mode 100644 index f7f05e6bc..000000000 --- a/doc/manual/en/MiniDLNA.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/MiniDLNA112020-07-19 22:29:16fioddorTranslations header added outside include block102020-07-18 16:18:55fioddorPage linked92020-07-18 16:15:10fioddorIcon added for fast identification. Availability standardized.82020-05-30 18:05:07SunilMohanAdapaUpdate the title to emphasize app name over its generic name72020-05-27 00:16:26SunilMohanAdapaAdd section on supported file formats62020-05-26 22:31:38SunilMohanAdapaMinor styling52020-05-26 22:29:28SunilMohanAdapaAdd information about how to use in various devices/media players42020-05-26 04:51:58SunilMohanAdapaAdd note about not being available on OpenVPN32020-05-23 19:54:42JamesValleroyadd TableOfContents22019-11-21 20:18:10NektariosKatakis12019-11-20 16:49:59NektariosKatakisTranslation(s): English - Español
MiniDLNA (Simple Media Server) MiniDLNA icon Available since: version 19.23 MiniDLNA is a media server with the aim to be compliant with DLNA/UPnP clients. Note: This service is available only on networks configured as "internal" zone. It is not available when connected via OpenVPN.
What is UPnP/DLNA?Universal plug & play is a set of networking protocols that allow devices within a network such as PCs, TVs, printers etc. to seamlessly discover each other and establish communication for data sharing. It is zero configuration protocol and requires only a media server and a media player that are compliant with the protocol. DLNA is derived from UPnP as a form of standardizing media interoperability. It forms a standard/certification which many consumer electronics conform to.
Setting up MiniDLNA on your FreedomBoxTo install/enable the media server you need to navigate at MiniDLNA page and enable it. The application is intended to be available in the internal (home) network and therefore it requires a network interface configured for internal traffic. After installation a web page becomes available on . It includes information for how many files the server is detecting, how many connections exist etc. This is very useful if plugging external disks with media to check if the new media files are detected properly. If that is not happening, disabling and enabling the server will fix it.
Using MiniDLNA to play media on your devicesAny DLNA compliant device or media player should be able to automatically detect, browse and play media from MiniDLNA on FreedomBox. The following devices and media players have been tested: GNOME Videos: Videos is the default media player on the popular GNU/Linux desktop environment GNOME. Open Videos, switch to 'Channels'. You should see a channel named 'freedombox: minidlna'. You will be able to browse and play media from it. VLC media player: VLC is a very popular media player for GNU/Linux, Android, Windows and macOS. Open VLC and click on 'View -> Playlist'. In the playlist sidebar that appears, select 'Universal Plug'n'Play'. You should see an item named 'freedombox: minidlna'. You should be able to browse and play media from it. Kodi: Kodi is a popular media centre software with user interface designed for Televisions. Open Kodi, goto 'System -> Service settings -> UPnP/DLNA' and 'Enable UPnP support'. Then visit 'Home -> Videos -> Files -> Add videos... -> Browse -> UPnP devices'. You should see 'freedombox: minidlna'. Select it and choose 'OK'. Then choose 'OK in the 'Add video source' dialog. From now on, you should see 'freedombox: minidlna' in 'Videos -> Files' section. You should be able to browse and play media from it. See Kodi documentation for more information. Roku: Roku is an appliance connected to a TV for playing Internet streaming services. Many TVs also have Roku built into them. In Roku interface, find a channel called 'Roku Media Player' and open it. You should see an item called 'freedombox: minidlna'. You should be able to browse and play media from it. Rhythmbox: Rhythmbox is the default audio player on the popular GNU/Linux desktop environment GNOME. Open Rhythmbox and ensure that the side pane is open by clicking on 'Application menu -> View -> Side Pane'. In the side pane you should see 'freedombox:minidlna' under the 'Shared' section. You should be able to browse and play audio files from it. Video files will not show up.
Supported media formatsMiniDLNA supports a wide variety of video and audio file formats. Video: Files ending with .avi, .mp4, .mkv, .mpg, .mpeg, .wmv, .m4v, .flv, .mov, .3gp, etc. Audio: Files ending with .mp3, .ogg, .flac, .wav, .pcm, .wma, .fla, .aac, etc. Image: Files ending with .jpg, .jpeg Playlist: Files ending with .m3u, .pls Captions: Files ending with .srt, .smi Notably, it does not support the following file extensions. Renaming the file to a known extension seems to work in most cases. Video: Files ending with .webm In addition to file format support from MiniDLNA, your media player or device needs to support the audio/video codecs with which the media has been encoded. MiniDLNA does not have the ability to translate files into a codec understood by the player. If you face problems with media playback, use the VLC player to find the codecs used in the media and the check your device or media player documentation on whether the codecs are supported.
File systems for external drivesIf using an external drive that is used also from a Windows system the preferred filesystem should be NTFS. NTFS will keep Linux file permissions and UTF8 encoding for file names. This is useful if file names are in your language.
External links Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Monkeysphere.raw.xml b/doc/manual/en/Monkeysphere.raw.xml deleted file mode 100644 index 57578adea..000000000 --- a/doc/manual/en/Monkeysphere.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Monkeysphere22020-08-19 10:18:27fioddorTranslations header added outside include block. BEGIN_INCLUDE mark added.12016-09-04 10:12:10Drahtseilstub createdTranslation(s): English - Español
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. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Mumble.raw.xml b/doc/manual/en/Mumble.raw.xml deleted file mode 100644 index 1023d218e..000000000 --- a/doc/manual/en/Mumble.raw.xml +++ /dev/null @@ -1,2 +0,0 @@ -
FreedomBox/Manual/Mumble132020-07-19 22:30:59fioddorTranslations header added outside include block122020-07-18 16:32:32fioddorIcon added for fast identification. Availability standardized.112020-05-30 18:10:11SunilMohanAdapaUpdate the title to emphasize app name over its generic name102020-05-23 19:57:23JamesValleroyadd TableOfContents92019-11-07 03:25:36SunilMohanAdapaUpdate super user section82019-11-07 02:51:23SunilMohanAdapaMinor formatting72019-11-07 02:50:58SunilMohanAdapaAdded section about SuperUser account62017-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.Translation(s): English - Español
Mumble (Voice Chat) Server Mumble icon Available since: version 0.5
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
Managing PermissionsA super user in Mumble has the ability to create administrator accounts who can in turn manage groups and channel permissions. This can be done after logging in with the username "SuperUser" using the super user password. See Mumble Guide for information on how to do this.. FreedomBox currently does not offer a UI to get or set the super user password for Mumble. A super user password is automatically generated during Mumble setup. To get the password, login to the terminal as admin user using Cockpit , Secure Shell or the console. Then, to read the super user password that was automatically generated during Mumble installation run the following command: You should see output such as: 2019-11-06 02:47:41.313 1 => Password for 'SuperUser' set to 'noo8Dahwiesh']]>Alternatively, you can set a new password as follows: Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/NameServices.raw.xml b/doc/manual/en/NameServices.raw.xml deleted file mode 100644 index 23e8e3d0b..000000000 --- a/doc/manual/en/NameServices.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/NameServices52020-08-19 10:32:17fioddorTranslations header added outside include block42019-11-11 16:58:04JosephNuthalapatiRename Tor Hidden Service to Tor Onion Service32016-12-31 04:18:51JamesValleroyreword22016-08-21 17:16:56Drahtseil12016-08-21 17:16:41DrahtseilCreated NameServicesTranslation(s): English - Español
Name ServicesName Services provides an overview of ways the box can be reached from the public Internet: domain name, Tor Onion 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. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Networks.raw.xml b/doc/manual/en/Networks.raw.xml deleted file mode 100644 index 44f06e5bf..000000000 --- a/doc/manual/en/Networks.raw.xml +++ /dev/null @@ -1,5 +0,0 @@ -
FreedomBox/Manual/Networks132020-08-19 09:49:55fioddorTranslations header added outside include block122020-05-24 01:48:46SunilMohanAdapaAdd advanced network operations section referring to Cockpit112020-05-23 20:43:32JamesValleroyadd TableOfContents102020-04-12 16:05:59JamesValleroyadd links back to top level pages92019-06-21 17:52:50SunilMohanAdapaAdd information about Wi-Fi routers causing problem with privacy feature82017-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 networkingTranslation(s): English - Español
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.
Problems with Privacy FeatureNetworkManager used by FreedomBox to connect to the Wi-Fi networks has a privacy feature that uses a different identity when scanning for networks and when actually connecting to the Wi-Fi access point. Unfortunately, this causes problems with some routers that reject connections from such devices. Your connection won't successfully activate and disconnect after trying to activate. If you have control over the router's behaviour, you could also turn off the feature causing problem. Otherwise, the solution is to connect with a remote shell using SSH or Cockpit, editing a file /etc/NetworkManager/NetworkManager.conf and adding the line wifi.scan-rand-mac-address=no in the [device] section. This turns off the privacy feature. Edit a file: Add the following: Then reboot the machine.
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.
Advanced Network OperationsCockpit provides many advanced networking features over those offered by FreedomBox. Both FreedomBox and Cockpit operate over Network Manager and are hence compatible with each other. Some of the functions provided by Cockpit include: Set the maximum transmission unit (MTU) for a network connection Change the hardware address (MAC address) of a network interface Add more DNS servers and configure routing of a network connection Creating bonded devices for highly available network interfaces Creating bridge devices to join network interfaces for aggregating separate networks Manage VLAN for creating virtual partitions in the physical network networks-cockpit.png
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. Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/OpenVPN.raw.xml b/doc/manual/en/OpenVPN.raw.xml deleted file mode 100644 index de21d9e1b..000000000 --- a/doc/manual/en/OpenVPN.raw.xml +++ /dev/null @@ -1,4 +0,0 @@ -
FreedomBox/Manual/OpenVPN242020-07-19 22:31:47fioddorTranslations header added outside include block232020-07-18 16:38:33fioddorIcon added for fast identification. Availability standardized.222020-07-15 11:42:37fioddorLayout improved for lists of working and non-working services212020-06-23 05:01:36SunilMohanAdapaAdd note about proto udp6 not supported during network-manager import202020-05-30 18:09:40SunilMohanAdapaUpdate the title to emphasize app name over its generic name192020-05-26 05:08:38SunilMohanAdapaAdd note about internal services that work and don't work182020-05-23 19:57:01JamesValleroyadd TableOfContents172020-05-23 17:05:41JamesValleroyrename plinth -> freedombox162019-11-18 22:55:39JamesValleroyadd instructions for Network Manager152019-09-16 09:38:50fioddorMinor layout correction142019-05-10 23:08:07JamesValleroyuse standard text for port forwarding132019-03-01 01:28:15SunilMohanAdapaAdd instructions for connecting using mobile client122019-03-01 00:48:12SunilMohanAdapaAdd information about browsing Internet112019-03-01 00:37:30SunilMohanAdapaUpdate information about dealing with profile files102019-02-28 09:38:45JosephNuthalapatiUpdate image and set width92018-11-15 11:47:34JosephNuthalapatiAdd documentation on how to connect to VPN from Debian and check the connection. Update external link82016-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]Translation(s): English - Español
OpenVPN (Virtual Private Network) OpenVPN icon Available since: version 0.7
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.
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 OpenVPN: UDP 1194
Setting upIn FreedomBox 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. OpenVPN service page 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. Users who are not administrators can download the profile from home page after login. The ovpn file contains all the information a vpn client needs to connect to the server. The downloaded profile contains the domain name of the FreedomBox that the client should connect to. This is picked up from the domain configured in 'Config' section of 'System' page. In case your domain is not configured properly, you may need to change this value after downloading the profile. If your OpenVPN client allows it, you can do this after importing the OpenVPN profile. Otherwise, you can edit the .ovpn profile file in a text editor and change the 'remote' line to contain the WAN IP address or hostname of your FreedomBox as follows.
Browsing Internet after connecting to VPNAfter connecting to the VPN, the client device will be able to browse the Internet without any further configuration. However, a pre-condition for this to work is that you need to have at least one Internet connected network interface which is part of the 'External' firewall zone. Use the networks configuration page to edit the firewall zone for the device's network interfaces.
Usage
On Android/LineageOSVisit FreedomBox home page. Login with your user account. From home page, download the OpenVPN profile. The file will be named username.ovpn. OpenVPN Download Profile Download an OpenVPN client such as OpenVPN for Android. F-Droid repository is recommended. In the app, select import profile. OpenVPN App In the select profile dialog, choose the username.opvn file you have just downloaded. Provide a name for the connection and save the profile. OpenVPN import profile Newly created profile will show up. If necessary, edit the profile and set the domain name of your FreedomBox as the server address. OpenVPN profile created OpenVPN edit domain name Connect by tapping on the profile. OpenVPN connect OpenVPN connected When done, disconnect by tapping on the profile. OpenVPN disconnect
On DebianInstall an OpenVPN client for your system Open the ovpn file with the OpenVPN client. .ovpn]]>If you use Network Manager, you can create a new connection by importing the file: .ovpn]]>If you get an error such as configuration error: invalid 1th argument to “proto” (line 5) then edit the .ovpn file and remove the line proto udp6.
Checking if you are connected
On DebianTry to ping the FreedomBox or other devices on the local network. Running the command ip addr should show a tun0 connection. The command traceroute freedombox.org should show you the ip address of the VPN server as the first hop.
Accessing internal servicesAfter connecting to OpenVPN, you will be able to access FreedomBox services that are only meant to be accessed on internal networks. This is in addition to being able to access external services. This can be done by using the IP address 10.91.0.1 as the host name for these services. The following services are known to work: Privoxy, Tor Socks, Shadowsocks, I2P Proxy and Samba. Some services are known not to work at this time: Avahi, bind and MiniDLNA.
External Links Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/PageKite.raw.xml b/doc/manual/en/PageKite.raw.xml deleted file mode 100644 index a2d992b64..000000000 --- a/doc/manual/en/PageKite.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/PageKite162020-08-19 09:46:42fioddorTranslations header added outside include block152020-05-30 18:21:26SunilMohanAdapaUpdate the title to emphasize app name over its generic name142020-05-23 20:44:53JamesValleroyadd TableOfContents132020-05-23 17:09:08JamesValleroyrename plinth -> freedombox122017-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:02planetlargTranslation(s): English - Español
PageKite (Public Visibility)
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 FreedomBox, 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. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Performance.raw.xml b/doc/manual/en/Performance.raw.xml deleted file mode 100644 index 0586b2d3c..000000000 --- a/doc/manual/en/Performance.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Performance122020-07-29 23:25:23fioddorStandards formatting.112020-05-30 18:19:38SunilMohanAdapaUpdate the title to emphasize app name over its generic name102020-05-12 04:51:34SunilMohanAdapaCockpit allows viewing upto 1 year at a time92020-05-12 04:40:54SunilMohanAdapaRename the image, minor formatting82020-05-12 04:39:38SunilMohanAdapaAdd the version availability and minor changes72020-05-08 06:41:27FredLeMeurup to 2 weeks62020-05-08 06:32:56FredLeMeurExplain why performance monitoring is needed.52020-05-05 12:39:58FredLeMeurzoom out button42020-05-04 08:31:15FredLeMeurWIP:performance: introduce Performance Co-Pilot (cockpit-pcp) in ‘System’32020-05-04 08:28:10FredLeMeur22020-05-04 08:07:58FredLeMeurwith "END_INCLUDE"12020-05-04 08:01:29FredLeMeurinit pageTranslation(s): English - Español
Performance (System Monitoring)Available since: version 20.9.7 Performance app allows you to collect, store and view information about utilization of the hardware. This can gives you basic insights into usage patterns and whether the hardware is overloaded by users and services. Performance metrics are collected by Performance Co-Pilot and can be viewed using the Cockpit app. When this system app is installed and enabled, cockpit's graphs shows the past (up to one year at a time). performance-one-week.png Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Power.raw.xml b/doc/manual/en/Power.raw.xml deleted file mode 100644 index 6d9f5a46e..000000000 --- a/doc/manual/en/Power.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Power42020-07-30 08:26:29fioddorSe alinea con la versión 03 en inglés del 30 de julio de 2020.32019-02-28 16:33:32JosephNuthalapatiRestart and shut down options in user menu22017-01-07 20:38:36JamesValleroynote confirmation12016-08-21 09:29:59DrahtseilCreated PowerTranslation(s): English - Español
PowerPower provides an easy way to restart or shut down FreedomBox. After you select "Restart" or "Shut Down", you will be asked to confirm. "Restart" and "Shut Down" options can also be reached from the user dropdown menu on the top right. Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Privoxy.raw.xml b/doc/manual/en/Privoxy.raw.xml deleted file mode 100644 index bcefd5765..000000000 --- a/doc/manual/en/Privoxy.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Privoxy182020-07-19 22:32:31fioddorTranslations header added outside include block172020-07-18 16:46:30fioddorIcon added for fast identification. Availability standardized.162020-05-30 18:11:34SunilMohanAdapaUpdate the title to emphasize app name over its generic name152020-05-23 19:58:09JamesValleroyadd TableOfContents142020-05-23 17:06:11JamesValleroyrename plinth -> freedombox132020-05-03 18:51:16JamesValleroyuse https link for Quickstart122020-05-03 18:49:54JamesValleroyuse https link for FAQ112019-09-16 12:07:52fioddorMinor correction102018-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 definitionTranslation(s): English - Español
Privoxy (Web Proxy) Privoxy icon Available since: version 0.1 A web proxy acts as a filter for incoming and outgoing web 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 FreedomBox, 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. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Quassel.raw.xml b/doc/manual/en/Quassel.raw.xml deleted file mode 100644 index 6a98e4faa..000000000 --- a/doc/manual/en/Quassel.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Quassel162020-07-29 18:09:14fioddorFix152020-07-19 22:33:10fioddorTranslations header added outside include block142020-07-18 16:55:51fioddorIcon corrected.132020-07-18 16:53:41fioddorIcon added for fast identification. Availability standardized.122020-05-30 18:02:30SunilMohanAdapaUpdate the title to emphasize app name over its generic name112020-05-23 19:54:18JamesValleroyadd TableOfContents102020-05-11 23:23:12fioddorExample screenshot in english (previous in german)92020-05-11 23:16:16fioddorPlinth renamed to FreedomBox's web interface,as in the rest of user documentation82020-05-03 18:48:31JamesValleroyupdate quasseldroid links72019-05-10 23:05:32JamesValleroyuse standard text for port forwarding62019-02-27 21:34:38JosephNuthalapatiGrammar corrections and clarification about port forwarding52018-10-04 02:01:15SunilMohanAdapaAdd screenshots to the Quassel Client section42018-10-04 01:26:35SunilMohanAdapaRefactor information on how to connect to core using desktop client32018-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 followTranslation(s): English - Español
Quassel (IRC Client) Quassel icon Available since: version 0.8 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 run 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 FreedomBox's web interface 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
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 Quassel: TCP 4242 Example configuration in router: Quassel_PortForwarding_en_v01.png
ClientsClients to connect to Quassel from your desktop and mobile devices are available.
DesktopIn a Debian system, you can e.g. use quassel-client. The following steps describe how to connect Quassel Client with Quassel Core running on a FreedomBox. The first time you do this connection, Quassel Core will be initialized too. Launch Quassel Client. You will be greeted with a wizard to Connect to Core. Connect to Core Click the Add button to launch Add Core Account dialog. Add Core Account Fill any value in the Account Name field. Fill proper DNS hostname of your FreedomBox in Hostname filed. Port field must have the value 4242. Provide the username and password of the account you wish to create to connect to the Quassel Core in the User and Password fields. Choose Remember if don't wish to be prompted for a password every time you launch Quassel client. After pressing OK in the Add Core Account dialog, you should see the core account in the Connect to Core dialog. Connect to Core Select the newly created core account and select OK to connect to it. If this is the first time you are connecting to this core. You will see an Untrusted Security Certificate warning and need to accept the server certificate. Untrusted Security Certificate Select Continue. Then you will be asked if you wish to accept the certificate permanently. Select Forever. Untrusted Security Certificate If this Quassel Core has not been connected to before, you will then see a Core Configuration Wizard. Select Next. Core Configuration Wizard In the Create Admin User page, enter the username and password you have used earlier to create the core connection. Select Remember password to remember this password for future sessions. Click Next. Create Admin User Page In the Select Storage Backend page, select SQLite and click Commit. Select Storage Backend The core configuration is then complete and you will see a Quassel IRC wizard to configure your IRC connections. Click Next. Welcome Wizard In Setup Identity page next, provide a name and multiple nicknames. This is how you present yourself to other users on IRC. It is not necessary to give your real world name. Multiple nicknames are useful as fallback nicknames when the first nickname can't be used for some reason. After providing the information click Next. Setup Identity In Setup Network Connection page next, provide a network name of your choice. Next provide a list of servers to which Quassel Core should connect to in order to join this IRC network (such as irc.debian.org:6667). Setup Network Connection Select the server in the servers list and click Edit. In the Server Info dialog, set the port 6697 (consult your network's documentation for actual list of servers and their secure ports) and click Use SSL. Click OK. This is to ensure that communication between your FreedomBox and the IRC network server is encrypted. Server Info Server Info SSL Back in the Setup Network Connection dialog, provide a list of IRC channels (such as #freedombox) to join upon connecting to the network. Click Save & Connect. Setup Network Connection You should connect to the network and see the list of channels you have joined on the All Chats pane on the left of the Quassel Client main window. Quassel Main Window Select a channel and start seeing messages from others in the channel and send your own messages.
AndroidFor 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. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Radicale.raw.xml b/doc/manual/en/Radicale.raw.xml deleted file mode 100644 index 7e17a1efc..000000000 --- a/doc/manual/en/Radicale.raw.xml +++ /dev/null @@ -1,25 +0,0 @@ -
FreedomBox/Manual/Radicale602020-07-19 22:34:02fioddorTranslations header added outside include block592020-07-18 17:01:53fioddorIcon added for fast identification. Availability standardized.582020-05-30 17:55:19SunilMohanAdapaUpdate the title to emphasize app name over its generic name572020-05-23 19:49:39JamesValleroyadd TableOfContents562020-05-23 17:01:25JamesValleroyremove (Plinth)552020-05-22 01:21:31JamesValleroyfix matching bracket542020-05-15 11:11:34JamesValleroyrename plinth -> freedombox532020-05-15 11:10:13JamesValleroysuppress wikiword links522020-05-03 18:43:27JamesValleroyupdate links to supported clients in radicale docs512019-08-11 20:39:37SunilMohanAdapaMinro fixes to workaround for bug502019-08-11 20:32:14SunilMohanAdapaAdd information about bug in radicale492019-05-22 20:58:26David JonesAdded instructions for syncronizing calendars over Tor in Thunderbird.482019-04-04 15:49:32JosephNuthalapatiMention a gotcha about a trailing slash in radicale URL472019-03-01 11:29:01JamesValleroyadd screenshot of web interface462019-03-01 04:01:20JamesValleroyadd instructions on using web interface452019-03-01 03:50:42JamesValleroyupdate setup instructions442019-03-01 03:48:19JamesValleroyrename Plinth -> FreedomBox Service (Plinth)432019-02-27 00:07:37SunilMohanAdapaUpdate incorrect reference to collections-root422019-02-26 20:24:11SunilMohanAdapaMinor update412019-02-26 20:20:18SunilMohanAdapaFix instructions for radicale 2.x manual migration402019-02-21 18:48:01SunilMohanAdapaRemove 'not tested' notice392019-02-21 03:38:31SunilMohanAdapaAdd information about radicale 2.x migration382019-02-10 23:10:19JamesValleroyonly need domain name for DAVx5372019-02-10 23:09:14JamesValleroyrename DAVdroid -> DAVx5362019-02-10 22:59:07JamesValleroyradicale is now in testing352018-09-29 11:28:56JamesValleroyUse calendar-name in CalDAV url342018-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 pageTranslation(s): English - Español
Radicale (Calendar and Addressbook) Radicale icon Available since: version 0.9 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 FreedomBox Service: select Apps go to Radicale (Calendar and Addressbook) 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 provides a basic web interface, which only supports creating new calendars and addressbooks. To add events or contacts, an external supported client application is needed. radicale_web.png Creating addressbook/calendar using the web interface Visit https://IP-address-or-domain-for-your-server/radicale/ Log in with your FreedomBox account Select "Create new addressbook or calendar" Provide a title and select the type Optionally, provide a description or select a color Click "Create" The page will show the URL for your newly created addressbook or calendar 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/calendar-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 over TorIn FreedomBox, setting up a calendar with Radicale over Tor is the same as over the clear net. Here is a short summary: When logged in to FreedomBox interface over Tor, click on Radicale, and at the prompt provide your FreedomBox user name and password. In the Radicale web interface, log in using your FreedomBox user name and password. Click on "Create new address book or calendar", provide a title, select a type, and click "Create". Save the URL, e.g., https://ONION-ADDRESS-FOR-YOUR-SERVER.onion/radicale/USERNAME/CALENDAR-CODE/. Items in italics need to be changed to match your settings. These instructions are for Thunderbird/Lightning. Note that you will need to be connected to Tor with the Tor Browser Bundle. Open Thunderbird, install the Torbirdy add-on, and restart Thunderbird. (This may not be necessary.) In the Lightning interface, under Calendar/Home in the left panel right click with the mouse and select "New calendar". Select the location of your calendar as "On the Network". Select CalDAV and for the location copy the URL, e.g., https://ONION-ADDRESS-FOR-YOUR-SERVER.onion/radicale/USERNAME/CALENDAR-CODE/. Items in italics need to be changed to match your settings. Provide a name, etc. Click "Next". Your calendar is now syncing with your FreedomBox over Tor. If you have not generated a certificate for your FreedomBox with "Let's Encrypt", you may need to select "Confirm Security Exception" when prompted.
Synchronizing with your Android phoneThere are various Apps that allow integration with the Radicale server. This example uses DAVx5, 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 DAVx5 Create a new account on DAVx5 by clicking on the floating + button. Select the second option as shown in the first figure below and enter the base url as (don't miss the / at the end). DAVx5 will be able to discover both CalDAV and WebDAV accounts for the user. Follow this video from DAVx5 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) DAVx5 account setup DAVx5 refresh DAVx5 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] 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.
Migrating from Radicale Version 1.x to Version 2.xDuring the month of February 2019, radicale in Debian testing was upgraded from version 1.x to version 2.x. Version 2.x is a better version but is incompatible with data and configuration used with 1.x. Automatic upgrade mechanism in FreedomBox, handled by unattended-upgrades does not automatically upgrade radicale to version 2.x due to changes in configuration files. However, FreedomBox version 19.1, which is available on February 23rd, 2019 in testing will perform data and configuration migration to radicale version 2.x. Typical users require no action, this will happen automatically. If for some reason, you need to manually run apt dist-upgrade on your machine, then radicale will be upgraded to 2.x and then FreedomBox will not be able to perform its upgrade (due to upstream project deciding to remove migration tools in radicale 2.x version). To avoid this situation, the following process is recommended if you wish to perform an upgrade. However, if you already happen to perform an upgrade to radicale 2.x without help from FreedomBox, you need to perform data and configuration migration yourself. Follow this procedure: Notes: python-radicale is an old package from radicale 1.x version that is still available in testing. This is a hack to use the --export-storage feature that is responsible for data migration. This feature is not available in radicale 2.x unfortunately. Files ending with .dpkg-dist will exist only if you have chosen 'Keep your currently-installed version' when prompted for configuration file override during radicale 2.x upgrade. The above process will overwrite the old configuration with new fresh configuration. No changes are necessary to the two configuration files unless you have changed the setting for sharing calendars. Note that during the migration, your data is safe in /var/lib/radicale/collections directory. New data will be created and used in /var/lib/radicale/collections/collections-root/ directory. The tar command takes a backup your configuration and data in /root/radicale_backup.tgz in case you do something goes wrong and you want to undo the changes.
Troubleshooting1. If you are using FreedomBox Pioneer Edition or installing FreedomBox on Debian Buster, then radicale may not be usable immediately after installation. This is due to a bug which has been fixed later. To overcome the problem, upgrade FreedomBox by clicking on 'Manual Update' from 'Updates' app. Otherwise, simply wait a day or two and let FreedomBox upgrade itself. After that install radicale. If radicale is already installed, disable and re-enable it after the update is completed. This will fix the problem and get radicale working properly. Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Repro.raw.xml b/doc/manual/en/Repro.raw.xml deleted file mode 100644 index a409b02dc..000000000 --- a/doc/manual/en/Repro.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Repro122020-07-19 22:34:59fioddorTranslations header added outside include block112020-07-18 22:31:18fioddorTiny style tuning102020-05-30 18:08:11SunilMohanAdapaUpdate the title to emphasize app name over its generic name92020-05-23 19:56:15JamesValleroyadd TableOfContents82019-02-26 23:26:49JamesValleroyremove content from manual72019-02-26 23:25:03JamesValleroyadd note about removal62017-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 pageTranslation(s): English - Español
Repro (SIP Server)App removed repro has been removed from Debian 10 (Buster), and therefore is no longer available in FreedomBox. 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. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Roundcube.raw.xml b/doc/manual/en/Roundcube.raw.xml deleted file mode 100644 index 9f1c53896..000000000 --- a/doc/manual/en/Roundcube.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Roundcube122020-07-19 22:35:33fioddorTranslations header added outside include block112020-07-18 17:12:01fioddorIcon added for fast identification. Availability version.102020-05-30 17:57:13SunilMohanAdapaUpdate the title to emphasize app name over its generic name92020-05-23 19:51:01JamesValleroyadd TableOfContents82019-03-13 21:13:00SunilMohanAdapaMinor formatting.72019-03-13 21:11:10SunilMohanAdapaAdd information about how to login to 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 definitionTranslation(s): English - Español
Roundcube (Email Client) Roundcube icon Available since: version 0.5
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. Enter your username and password. The username for many mail services will be the full email address such as exampleuser@example.org and not just the username like exampleuser. Enter the address of your email service's IMAP server address in the Server field. You can try providing your domain name here such as example.org for email address exampleuser@example.org and if this does not work, consult your email provider's documentation for the address of the IMAP server. Using encrypted connection to your IMAP server is strongly recommended. To do this, prepend 'imaps://' at the beginning of your IMAP server address. For example, imaps://imap.example.org. Logging into your IMAP server
Using Gmail with RoundcubeIf you wish to use Roundcube with your Gmail account, you need to first enable support for password based login in your Google account preferences. This is because Gmail won't allow applications to login with a password by default. To do this, visit Google Account preferences and enable Less Secure Apps. After this, login to Roundcube by providing your Gmail address as Username, your password and in the server field use imaps://imap.gmail.com. Logging into Gmail Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Samba.raw.xml b/doc/manual/en/Samba.raw.xml deleted file mode 100644 index 8adb183c1..000000000 --- a/doc/manual/en/Samba.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Samba142020-07-19 22:36:32fioddorTranslations header added outside include block132020-07-18 17:55:09fioddor122020-07-18 17:52:02fioddorIcon added for fast identification. Availability standardized.112020-05-30 18:01:25SunilMohanAdapaUpdate the title to emphasize app name over its generic name102020-05-25 08:15:46SunilMohanAdapaAdd mention of VLC for Android92020-05-23 19:53:30JamesValleroyadd TableOfContents82020-05-18 23:18:48JamesValleroysimplify wording72020-05-12 02:24:02JosephNuthalapatiChange short description to Network File Storage62020-04-23 13:57:36NektariosKatakis52020-04-23 13:54:36NektariosKatakis42020-04-23 13:50:01NektariosKatakis32020-02-02 07:06:36JosephNuthalapatiAndroid Samba Client needs disk path as well22020-02-01 17:15:51JosephNuthalapatiAdd comparison with Syncthing12020-02-01 17:08:21JosephNuthalapatiFirst draftTranslation(s): English - Español
Samba (Network File Storage) Samba icon Available since: version 19.22 Samba lets you have shared folders over the local network that can be used from multiple computers running different operating systems. We refer to these shared folders as "shares". You can have a personal folder shared between your own devices (Home share), a folder shared with a trusted group (Group share) or one that is shared with every device on the network (Open share). Samba lets you to treat a share as if it's a local folder on your computer. However, shares are available only on the local network. To learn more about Samba, please refer to the user documentation on their wiki.
Using SambaAfter installation, you can choose which disks to use for sharing. Enabled shares are accessible in the file manager on your computer at location \\freedombox (on Windows) or smb://freedombox.local (on Linux and Mac). There are three types of shares you can choose from: Open share - accessible to everyone in your local network. Group share - accessible only to FreedomBox users who are in the freedombox-share group. Home share - every user in the freedombox-share group can have their own private space.
On AndroidTo access Samba shares on an Android device, install "Android Samba Client" from F-Droid or Google Play. Enter smb://freedombox.local/<disk> as the share path in the app. Your shared folders should then be visible in the file manager app. Samba shares can also be used by VLC for Android which automatically discovers them.
Integration with other appsTransmission app on FreedomBox provides a setting to allow downloads to be saved directly to a Samba share. If you want to make available files synchronized with Syncthing through Samba you need to make sure you synchronize in a Samba share folder. Additionally in order to make Syncthing shares available in Samba Open share or Group share you will need to ensure you click "Permissions > Ignore" button under the "Advanced" tab in folder you wish in the Syncthing web UI. This will ensure that the files will be writable through Samba.
Comparison with other apps
SyncthingSyncthing maintains a copy of the shared folder on each device that it is shared with. Samba maintains only one copy on your FreedomBox device. Syncthing can synchronize your shared folders between devices over the Internet. Samba shares are only available on the local network. Since Syncthing is primarily a synchronization solution, it has features like conflict resolution and versioning. Samba has only copy of the file, so it doesn't need such features. For example, if two people are editing a spreadsheet stored on a Samba share, the last one to save the file wins. Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Searx.raw.xml b/doc/manual/en/Searx.raw.xml deleted file mode 100644 index 5bd5e9214..000000000 --- a/doc/manual/en/Searx.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Searx132020-07-19 22:37:17fioddorTranslations header added outside include block122020-07-18 18:05:43fioddorIcon added for fast identification. Availability standardized.112020-05-30 18:12:17SunilMohanAdapaUpdate the title to emphasize app name over its generic name102020-05-23 19:40:54JamesValleroymove TableOfContents above BEGIN_INCLUDE92020-04-12 16:07:28JamesValleroyadd links back to top level pages82019-05-22 17:08:56David JonesAdded information that SearX is accessible via Tor.72018-11-01 09:17:25JosephNuthalapatiAdd ToC62018-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 draftTranslation(s): English - Español
Searx (Web Search) Searx icon Available since: version 0.24.0
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.
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 is easily accessible via Tor. 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. Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/SecureShell.raw.xml b/doc/manual/en/SecureShell.raw.xml deleted file mode 100644 index b70415a19..000000000 --- a/doc/manual/en/SecureShell.raw.xml +++ /dev/null @@ -1,6 +0,0 @@ -
FreedomBox/Manual/SecureShell212020-08-19 09:53:19fioddorTranslations header added outside include block202020-06-22 21:27:55SunilMohanAdapaAdd section for connecting via Pagekite.192020-05-30 18:32:15SunilMohanAdapaMatch title with FreedomBox interface182020-05-23 20:45:18JamesValleroyadd TableOfContents172020-05-23 17:10:07JamesValleroyrename plinth -> freedombox162020-04-12 16:07:49JamesValleroyadd links back to top level pages152020-04-04 20:22:52fioddorPlinth as FreedomBox's web interface142020-04-04 20:03:23fioddorPlinth as FreedomBox's web interface132019-11-11 17:01:45JosephNuthalapatiRename Tor Hidden Service to Tor Onion Service122019-02-26 03:46:55JamesValleroyremove wiki links112018-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 accessTranslation(s): English - Español
Secure Shell (SSH) Sever
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
FreedomBox First Log In: Admin AccountWhen creating an account in FreedomBox's web interface 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 FreedomBox's web interface, then you don't need to do this. You can use the user account created in FreedomBox's web interface 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 FreedomBox 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 FreedomBox you have enabled onion 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 onion service address for your FreedomBox.
SSH Over PagekiteIf in FreedomBox you are using Pagekite to expose services to the Internet, you can access your FreedomBox using SSH over Pagekite. On a GNU/Linux computer install netcat-openbsd. Edit ~/.ssh/config to enable connections over Pagekite. Add the following: Now to connect to FreedomBox, open a terminal and type: Replace USERNAME with, e.g., an admin username, and KITENAME with your kite name provided by pagekite.net as configured in 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 FreedomBox's web interface, use the change password page. However, the fbx default user is not managed by FreedomBox's web interface and its password cannot be changed through it. 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. Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Security.raw.xml b/doc/manual/en/Security.raw.xml deleted file mode 100644 index 5b22a5bb1..000000000 --- a/doc/manual/en/Security.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Security42020-08-19 10:38:08fioddorTranslations header added outside include block. BEGIN_INCLUDE mark added.32019-10-11 23:17:39SunilMohanAdapaClarify information regarding restricting console logins22016-08-31 17:40:56DrahtseilScreenshot12016-08-31 17:37:33DrahtseilcreationTranslation(s): English - Español
SecurityWhen the Restrict console logins option is enabled, only users in the admin group will be able to log in via console, secure shell (SSH) or graphical login. When this option is disabled, any user with an account on FreedomBox will be able to log in. They may be able to access some services without further authorization. This option should only be disabled if all the users of the system are well trusted. If you wish to use your FreedomBox machine also as a desktop and allow non-admin users to login via GUI, this option must be disabled. You can define the list of users belonging to admin group in the Users section. Security.png Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/ServiceDiscovery.raw.xml b/doc/manual/en/ServiceDiscovery.raw.xml deleted file mode 100644 index 41056fda8..000000000 --- a/doc/manual/en/ServiceDiscovery.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/ServiceDiscovery32020-08-19 10:43:02fioddorTranslations header added outside include block. BEGIN_INCLUDE mark added.22017-01-02 13:17:40JamesValleroymention .local address12016-08-21 09:48:13DrahtseilCreated Service DiscoveryTranslation(s): English - Español
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. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Shadowsocks.raw.xml b/doc/manual/en/Shadowsocks.raw.xml deleted file mode 100644 index 5decf86a0..000000000 --- a/doc/manual/en/Shadowsocks.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Shadowsocks82020-07-19 22:38:00fioddorTranslations header added outside include block72020-07-18 18:10:47fioddorCorrection.62020-07-18 18:09:57fioddorIcon added for fast identification. Availability standardized.52020-05-30 18:09:03SunilMohanAdapaUpdate the title to emphasize app name over its generic name42020-05-23 19:56:36JamesValleroyadd TableOfContents32020-05-23 17:04:27JamesValleroyremove redundant reference to Plinth22019-05-10 22:54:33JamesValleroyremove wiki links12018-01-04 19:59:57David JonesTranslation(s): English - Español
Shadowsocks (SOCKS5 proxy) Shadowsocks icon Available since: version 0.18.0
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.
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. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Sharing.raw.xml b/doc/manual/en/Sharing.raw.xml deleted file mode 100644 index 7e7f9d39b..000000000 --- a/doc/manual/en/Sharing.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Sharing82020-07-19 22:38:56fioddorTranslations header added outside include block72020-07-19 22:04:03fioddorAlternatives are only for unrestricted publishing.62020-07-19 21:06:12fioddorAlternatives52020-07-19 18:48:38fioddorTypo fixed42020-07-19 18:47:29fioddorTypo fixed32020-07-19 18:46:55fioddorTypo fixed22020-07-19 18:45:29fioddorApp explained12019-03-22 06:57:47JosephNuthalapatiAdd Sharing app to manualTranslation(s): English - Español
Sharing (File Publishing) Sharing icon Available since: version 0.25
What Is Sharing App?Sharing app allows you to share content over the web. Shared content can be individual files or whole directories. The content can be shared publicly or restricted to the users of listed allowed groups. Allowed users will be able to access the shared content from their web browser at https://your_freedombox/share/content_name. Users not belonging to any of the allowed groups won't see or access the content through this mechanism.
Setting Up SharesFor the users to access the content through their browser it must exist and have a share. A share is an entry in the Sharing app relating: the Name (an thereby the URL) with which the users will ask for the content, the Disk Path of the content to be served and the sharing mode. On restricted mode, it also has the list of allowed groups. Many shares can coexist in the same server. Only admins can create, edit or remove shares. They'll find the Sharing app in the Apps section of FreedomBox web interface. Sharing app is an easy to use web application with an evident interface. Each share has its own sharing mode (public or restricted) setting. Only groups recognized by FreedomBox service can be combined in the list of allowed groups. Groups created in the CLI won't be offered by the Sharing app.
Providing/Updating ContentThe content can be created before or after the share is created and they can be updated independently. The content doesn't need to be provided by an admin either. Any user with write access to the share's disk path can create or update it. Multiple shares might point to the same content. If you are user of FreedomBox and your admin refuses to create shares for you, and you don't need to restrict the access to your content, you still can fall back to the User Websites mechanism or the P2P networks (Deluge or Transmission for Torrent, or MLDonkey) to publish your files.
TechnicalitiesSharing will share the content using the built-in Apache web server. Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Snapshots.raw.xml b/doc/manual/en/Snapshots.raw.xml deleted file mode 100644 index d27c5047a..000000000 --- a/doc/manual/en/Snapshots.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Snapshots42020-08-19 10:54:56fioddorTranslations header added outside include block. BEGIN_INCLUDE mark added.32020-05-30 18:33:06SunilMohanAdapaMatch title with FreedomBox interface22018-03-10 15:11:41JosephNuthalapatiFix oversized image12017-11-14 02:24:01JamesValleroynew page for snapshots moduleTranslation(s): English - Español
Storage 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. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Storage.raw.xml b/doc/manual/en/Storage.raw.xml deleted file mode 100644 index 2723cb766..000000000 --- a/doc/manual/en/Storage.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Storage132020-08-19 10:47:56fioddorTranslations header added outside include block. BEGIN_INCLUDE mark added.122020-05-24 02:11:30SunilMohanAdapaAdd advanced storage operations section referring to Cockpit112018-12-18 00:01:12JamesValleroyfix screenshot parameter102018-12-04 06:20:20JosephNuthalapatiRestrict screenshot width to 800px92018-09-25 06:01:56JosephNuthalapatiUpdate description to match current functionality82018-09-25 05:51:15JosephNuthalapatiReplace screenshot with the latest version72018-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 creationTranslation(s): English - Español
StorageStorage allows you to see the storage devices attached to your FreedomBox and their disk space usage. FreedomBox can automatically detect and mount removable media like USB flash drives. They are listed under the Removable Devices section along with an option to eject them. If there is some free space left after the root partition, the option to expand the root partition is also available. This is typically not shown, since expanding the root partition happens automatically when the FreedomBox starts up for the first time. Storage.png
Advanced Storage OperationsCockpit provides many advanced storage features over those offered by FreedomBox. Both FreedomBox and Cockpit operate over Udisks2 storage daemon and are hence compatible with each other. Some of the functions provided by Cockpit include: Format a disk or partition with a fresh filesystem Add, remove partitions or wipe the partition table Create and unlock encrypted file systems Create and manage RAID devices storage-cockpit.png Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Syncthing.raw.xml b/doc/manual/en/Syncthing.raw.xml deleted file mode 100644 index 79adaf849..000000000 --- a/doc/manual/en/Syncthing.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Syncthing222020-07-19 22:39:32fioddorTranslations header added outside include block212020-07-18 18:16:54fioddorIcon added for fast identification. Availability standardized.202020-05-30 18:00:50SunilMohanAdapaUpdate the title to emphasize app name over its generic name192020-05-23 19:53:08JamesValleroyadd TableOfContents182019-11-11 17:00:38JosephNuthalapatiRename Tor Hidden Service to Tor Onion Service172019-11-01 01:09:33JosephNuthalapatiMinor formatting changes162019-10-31 15:01:33JosephNuthalapatiMinor change to headings152019-10-31 14:42:33JosephNuthalapatiAdd synchronized password manager142019-10-27 05:53:05JosephNuthalapatiAdd tip to avoid using Syncthing relays132019-09-11 15:33:32fioddorCode decoration122019-06-09 11:07:46David Jones112019-06-09 11:00:48David Jonesadded information about syncthing and tor hidden service102018-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 SyncthingTranslation(s): English - Español
Syncthing (File Synchronization) Syncthing icon Available since: version 0.14 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. 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.
Synchronizing over TorSyncthing should automatically sync with your FreedomBox even if it is only accessible as a Tor Onion Service. If you would like to proxy your Syncthing client over Tor, set the all_proxy environment variable: For more information, see the Syncthing documentation on using proxies.
Avoiding Syncthing RelaysSyncthing uses dynamic connections by default to connect with other peers. This means that if you are synchronizing over the Internet, the data might have to go through public Syncthing relays to reach your devices. This doesn't take advantage of the fact that your FreedomBox has a public IP address. When adding your FreedomBox as a device in other Syncthing clients, set the address like "tcp://<my.freedombox.domain>" instead of "dynamic". This allows your Syncthing peers to directly connect to your FreedomBox avoiding the need for relays. It also allows for fast on-demand syncing if you don't want to keep Syncthing running all the time on your mobile devices.
Using Syncthing with other applications
Password ManagerPassword managers that store their databases in files are suitable for synchronization using Syncthing. The following example describes using a free password manager called KeePassXC in combination with Syncthing to serve as a replacement for proprietary password managers that store your passwords in the cloud. KeePassXC stores usernames, passwords etc. in files have the .kdbx extension. These kdbx files can be stored in a Syncthing shared folder to keep them synchronized on multiple machines. Free software applications which can read this file format are available for both desktop and mobile. You typically have to just point the application at the .kdbx file and enter the master password to access your stored credentials. For example, the same kdbx file can be accessed by using KeePassXC on desktop and KeePassDX on Android. KeePassXC can also be used to fill credentials into login fields in the browser by installing a browser extension. Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/TinyTinyRSS.raw.xml b/doc/manual/en/TinyTinyRSS.raw.xml deleted file mode 100644 index 43f09b011..000000000 --- a/doc/manual/en/TinyTinyRSS.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/TinyTinyRSS152020-07-19 22:40:14fioddorTranslations header added outside include block142020-07-18 18:23:50fioddorIcon added for fast identification. Availability version.132020-05-30 18:06:10SunilMohanAdapaUpdate the title to emphasize app name over its generic name122020-05-23 19:55:19JamesValleroyadd TableOfContents112020-05-23 17:03:46JamesValleroyrename plinth -> freedombox102018-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 createdTranslation(s): English - Español
Tiny Tiny RSS (News Feed Reader) Tiny Tiny RSS icon Available since: version 0.9 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 FreedomBox 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. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Tor.raw.xml b/doc/manual/en/Tor.raw.xml deleted file mode 100644 index d6ead873f..000000000 --- a/doc/manual/en/Tor.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Tor292020-08-17 19:44:48JamesValleroyremove accent mark in version282020-07-19 22:40:55fioddorTranslations header added outside include block272020-07-18 18:31:40fioddorIcon added for fast identification. Availability version.262020-05-30 17:52:23SunilMohanAdapaUpdate the title to emphasize app name over its generic name252020-05-23 19:44:12JamesValleroyadd TableOfContents242020-05-23 17:00:18JamesValleroyrename plinth -> freedombox232019-11-28 22:24:36SunilMohanAdapaUpdate link to Tor Relay Guide Closes freedom-maker#169, thanks to Jamie Campbell222019-11-11 16:55:49JosephNuthalapatiRename Hidden Service to Onion Service212019-10-27 06:23:30JosephNuthalapatiAdd screenshot for using Tor SOCKS proxy with Firefox202019-10-27 06:18:47JosephNuthalapatiAdd example for using Tor SOCKS proxy with Firefox192019-06-09 10:47:56David Jonesadded two more apps to list182019-05-22 17:10:34David JonesCorrected formatting; added transition sentence.172019-05-22 17:05:45David JonesStarted a list of apps accessible via Tor162018-12-30 19:13:56Drahtseilrelay requirements152018-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 pageTranslation(s): English - Español
Tor (Anonymity Network) Tor icon Available since: version 0.3
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 Onion Service to access your FreedomBoxTor Onion Service provides a way to access your FreedomBox, even if it's behind a router, firewall, or carrier-grade NAT (i.e., your Internet Service Provider does not provide a public IPv4 address for your router). To enable Tor Onion 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 Onion 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 Onion 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 Configuration - FreedomBox Currently only HTTP (port 80), HTTPS (port 443), and SSH (port 22) are accessible through the Tor Onion Service configured on the FreedomBox.
Apps accessible via TorThe following apps can be accessed over Tor. Note that this list is not exhaustive. Calendar and Addressbook (Radicale) File Synchronization (Syncthing) Feed reader (TinyTinyRSS) Web Search (Searx) Wiki (MediaWiki) Wiki and Blog (Ikiwiki)
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 FreedomBox. At the bottom of the Tor page in FreedomBox, 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. The requirements to run a relay are listed in the Tor Relay Guide. In short, it is recommended that a relay has at least 16 Mbit/s (Mbps) upload and download bandwidth available for Tor. More is better. required that a Tor relay be allowed to use a minimum of 100 GByte of outbound and of incoming traffic per month. recommended that a <40 Mbit/s non-exit relay should have at least 512 MB of RAM available; A relay faster than 40 Mbit/s should have at least 1 GB of RAM.
(Advanced) Usage as a SOCKS proxyFreedomBox 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.
Example with FirefoxYour web browser can be configured to use the Tor network for all of your browsing activity. This allows for censorship circumvention and also hides your IP address from websites during regular browsing. For anonymity, using tor browser is recommended. Configure your local FreedomBox IP address and port 9050 as a SOCKS v5 proxy in Firefox. There are extensions to allow for easily turning the proxy on and off. Configuring Firefox with Tor SOCKS proxy With the SOCKS proxy configured, you can now access any onion URL directly from Firefox. FreedomBox itself has an onion v3 address that you can connect to over the Tor network (bookmark this for use in emergency situations).
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. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Transmission.raw.xml b/doc/manual/en/Transmission.raw.xml deleted file mode 100644 index bd31c5dcc..000000000 --- a/doc/manual/en/Transmission.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Transmission192020-08-17 19:51:34JamesValleroyremove accent mark in version182020-07-19 22:41:29fioddorTranslations header added outside include block172020-07-18 21:18:02fioddorIcon added for fast identification. Availability version.162020-05-30 17:53:11SunilMohanAdapaUpdate the title to emphasize app name over its generic name152020-05-23 19:44:47JamesValleroyadd TableOfContents142019-10-27 04:42:42JosephNuthalapatiRemove irrelevant known issue132019-10-27 04:41:18JosephNuthalapatiMinor fixes122019-10-27 04:40:38JosephNuthalapati112019-09-04 09:19:59fioddorSecurity recommendation102019-03-22 07:08:45JosephNuthalapatiAdd tips on how to transfer downloads from FreedomBox to local PC92016-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 definitionTranslation(s): English - Español
Transmission (BitTorrent Web Client) Transmission icon Available since: version 0.5
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. Transmission uses single sign-on from FreedomBox, which means that if you are logged in on your FreedomBox, you can directly access Transmission without having to enter the credentials again. Otherwise, you will be prompted to login first and then redirected to the Transmission app.
Tips
Transferring Downloads from the FreedomBoxTransmission's downloads directory can be added as a shared folder in the "Sharing" app. You can then access your downloads from this shared folder using a web browser. (Advanced) If you have the ssh access to your FreedomBox, you can use sftp to browse the downloads directory using a suitable file manager or web browser (e.g. dolphin or Konqueror). Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Upgrades.raw.xml b/doc/manual/en/Upgrades.raw.xml deleted file mode 100644 index 9d86163a1..000000000 --- a/doc/manual/en/Upgrades.raw.xml +++ /dev/null @@ -1,8 +0,0 @@ -
FreedomBox/Manual/Upgrades112020-08-18 20:40:30fioddorTranslations header added outside include block102020-08-17 19:53:56JamesValleroyfix spelling: Pinoeer -> Pioneer92020-05-23 20:46:38JamesValleroyadd TableOfContents82020-04-12 15:55:49JamesValleroyadd links back to top level pages72019-08-22 02:42:27SunilMohanAdapaProvide information about properly updating FreedomBox62019-06-19 07:42:18fioddorLack of feedback is not specific to manual procedure.52017-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 pageTranslation(s): English - Español
Software UpdatesFreedomBox can automatically install security updates. On the Update page of the System section in FreedomBox web interface you can turn on automatic updates. 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. Updates 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 updates happen. Alternatively, you can perform manual updates as described below. Note that once the updates start, it may take a long time to complete. During automatic update process that runs every night or during manual update process, you will not be able to install apps from FreedomBox web interface. upgrades.png
When Will I Get the Latest Features?Although updates are done every day for security reasons, latest features of FreedomBox will not propagate to all the users. The following information should help you understand how new features become available to users. Stable Users: This category of users include users who bought the FreedomBox Pioneer Edition, installed FreedomBox on a Debian stable distribution or users who downloaded the stable images from freedombox.org. As a general rule, only security updates to various packages are provided to these users. One exception to this rule is where FreedomBox service itself is updated when a release gains high confidence from developers. This means that latest FreedomBox features may become available to these users although not as quickly or frequently as testing users. If an app is available only in testing distribution but not in stable distribution, then that app will show up in the web interface but will not be installable by stable users. Some apps are also provided an exception to the rule of "security updates only" when the app is severely broken otherwise. Every two years, a major release of Debian stable happens with the latest versions of all the software packages and FreedomBox developers will attempt to upgrade these users to the new release without requiring manual intervention. Testing Users: This category of users include users who installed FreedomBox on a Debian testing distribution or users who downloaded the testing images from freedombox.org. Users who use Debian testing are likely to face occasional disruption in the services and may even need manual intervention to fix the issue. As a general rule, these users receive all the latest features and security updates to all the installed packages. Every two weeks, a new version of FreedomBox is released with all the latest features and fixes. These releases will reach testing users approximately 2-3 days after the release. Unstable Users: This category of users include users who installed FreedomBox on a Debian unstable distribution or users who downloaded the unstable images from freedombox.org. Users who use Debian unstable are likely to face occasional disruption in the services and may even need manual intervention to fix the issue. As a general rule, these users receive all the latest features to all the installed packages. Every two weeks, a new version of FreedomBox is released with all the latest features and fixes. Theses releases will reach unstable users on the day of the release. Only developers, testers and other contributors to the FreedomBox project should use the unstable distribution and end users and advised against using it.
Manual Updates from Web InterfaceTo get updates immediately and not wait until the end of the day, you may want to trigger updates manually. You can do this by pressing the Update now button in Manual update tab for Update page in System section. Note that this step is not necessary if you have enabled Auto-updates as every night this operation is performed automatically. When installing apps you may receive an error message such as This is typically caused by shutting down FreedomBox while it is installing apps, while performing daily updates or during some other operations. This situation can be rectified immediately by running manual update.
Manual Updates from TerminalSome software packages may require manual interaction for updating due to questions related to configuration. In such cases, FreedomBox updates itself and brings in new knowledge necessary to update the package by answering configuration questions. After updating itself, FreedomBox acts on behalf of the user and updates the packages by answering the questions. Until FreedomBox has a chance to update the package, such packages should not be be updated manually. The manual update triggered from the web interface is already mindful of such packages and does not update them. In some rare situations, FreedomBox itself might fail to update or the update mechanism might fall into a situation that might need manual intervention from a terminal. To perform manual upgrades on the terminal, login into FreedomBox on a terminal (if you have monitor and keyboard connected), via a web terminal (using FreedomBox/Manual/Cockpit) or using a remote secure shell (see Secure Shell section). Then run the following commands: -# dpkg --configure -a -# apt update -# apt -f install -# unattended-upgrade --debug -# apt install freedombox -# apt update]]>If apt-get update asks for a confirmation to change Codename or other release information, confirm yes. If during update of freedombox package, if a question about overwriting configuration files is asked, answer to install new configuration files from the latest version of the package. This process will upgrade only packages that don't require configuration file questions (except for freedombox package). After this, let FreedomBox handle the upgrade of remaining packages. Be patient while new releases of FreedomBox are made to handle packages that require manual intervention. If you want to go beyond the recommendation to upgrade all the packages on your FreedomBox and if you are really sure about handling the configuration changes for packages yourself, run the following command: Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/Users.raw.xml b/doc/manual/en/Users.raw.xml deleted file mode 100644 index dd23998b3..000000000 --- a/doc/manual/en/Users.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/Users102020-08-19 09:55:37fioddorTranslations header added outside include block92020-05-23 20:47:07JamesValleroyadd TableOfContents82019-07-29 22:34:11JamesValleroybetter wording72019-07-29 22:22:17JamesValleroyremove "Plinth"62019-07-29 22:10:39JamesValleroymention which releases known issue applies to52019-07-29 22:08:21JamesValleroyadd more supported groups42017-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 UsersTranslation(s): English - Español
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 bit-torrent ed2k feed-reader syncthing web-search 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). A user's groups 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 IssuesIn Debian Stretch, the FreedomBox web interface does not distinguish between users and administrators. Every user added will have full access to the web interface. This issue is fixed in Debian Buster and later. Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/bepasty.raw.xml b/doc/manual/en/bepasty.raw.xml deleted file mode 100644 index 08e901129..000000000 --- a/doc/manual/en/bepasty.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/bepasty102020-08-19 05:23:17SunilMohanAdapaAdd 'Snippet' in the short description92020-08-19 05:22:39SunilMohanAdapaExpand the description of the app82020-08-18 18:21:34fioddorMain title case standardized.72020-08-15 13:01:05JamesValleroyfix screenshot size62020-08-15 12:01:07JamesValleroyadd screenshot52020-08-15 11:51:00JamesValleroydescribe managing passwords42020-08-15 11:42:36JamesValleroydescribe using bepasty32020-08-15 11:33:20JamesValleroydescribe distributing passwords22020-08-15 11:27:46JamesValleroydescribe passwords and permissions12020-08-09 00:54:01JamesValleroyadd stub page for bepastyTranslation(s): English - Español
Bepasty (File & Snippet Sharing) bepasty icon Available since: version 20.14
What is bepasty?bepasty is a web application that allows large files to be uploaded and shared. Text and code snippets can also be pasted and shared. Text, image, audio, video and PDF documents can be previewed in the browser. Shared files can be set to expire after a time period.
ScreenshotScreenshot of bepasty
Passwords and Permissionsbepasty uses only passwords (without usernames) to control access. Depending on which password is used to login to bepasty, the user will have different permissions. They can have any combination of the following permissions: read: Read a file, if they know the URL. list: List all files. create: Paste or upload a new file. delete: Delete a file. admin: Can lock and unlock files. After bepasty is installed, it comes pre-configured for the following roles: Viewer: can view and list files Editor: can view, list, create, and delete files Administrator: has all permissions These roles support a use-case of file sharing between known, authorized users. If needed, you can re-configure bepasty to support other roles and use-cases.
Distributing passwordsBy default, the Public Access configuration is set to None, so a password is required for any use of bepasty. This means that you will need to distribute the passwords to the appropriate users, through any communication channels that you have. Note that you may want to create multiple passwords with the same permissions. This allows you to distribute a unique password to each user (or to a group of users). Then if you want to revoke access to one user, you can simply delete their password. The other users with their own passwords will not be affected.
Using bepastyAfter logging in to bepasty, if you have the Create permission, you will see a large text box where you can paste any text. Optionally, you can provide a filename or Content-Type for the data. After clicking Submit, the file is created. You can also drag and drop files in the area at the bottom. They are uploaded immediate after dropping them in this area. You can also create a list to track a collection of uploaded files. For either case, you can set a maximum lifetime value. After this time expires, the file will be deleted. If you have the List permission, then you will see a link List all Items at the top of the page. This will show all files that have been created or uploaded. If you have the Delete or Admin permission, you will see extra actions shown next to each file on the list page. If you only have the Read permission, then to read files, you will need to have both a password and one or more URLs for existing files.
Managing passwordsThe bepasty configuration page in FreedomBox interface allows you to create new passwords, or to remove a password. When you create a password, you can choose any combination of the permissions described above. Note that a typical Administrator should have all of the permissions (not just "Admin"). You can also set a Comment. This is recommended, and you should use the comment to help yourself remember the purpose of the password, or who will be using the password. You can also configure Public Access, which sets the default permissions that are available even without logging in with a password. You can set this to allow reading files by their URL, or reading and listing all files.
External links Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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
diff --git a/doc/manual/en/ejabberd.raw.xml b/doc/manual/en/ejabberd.raw.xml deleted file mode 100644 index f69f6ff7e..000000000 --- a/doc/manual/en/ejabberd.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
FreedomBox/Manual/ejabberd232020-07-19 22:18:41fioddorTranslations header added outside include block222020-07-18 22:44:17fioddorTiny style tuning212020-07-18 14:35:34fioddorAvailability version202020-07-18 10:48:23fioddoralt text corrected192020-07-17 23:23:52fioddorClient usage details moved to JSXC page.182020-07-17 18:42:35fioddorMore explanations to XMPP and detailed instructions for JSXC (XMPP) web chat client.172020-07-17 17:54:40fioddor162020-07-17 17:52:27fioddorPicture.152020-05-30 17:55:47SunilMohanAdapaUpdate the title to emphasize app name over its generic name142020-05-23 19:50:10JamesValleroyadd TableOfContents132020-05-23 17:01:56JamesValleroyrename plinth -> freedombox122019-03-01 17:43:12JosephNuthalapatiFix PageKite url112019-02-27 00:06:38JamesValleroymake title consistent with FreedomBox interface102018-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 pageTranslation(s): English - Español
Ejabberd (Chat Server) ejabberd icon Available since: version 0.3
What is XMPP?XMPP is a federated server-client 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. Currently FreedomBox offers both, a server (ejabberd) and a web client (JSXC) from its web interface.
PrivacyWith 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 network. If you only need the local network (LAN) users to chat with each other you can invent your domain name, but if you want users from the internet to join your rooms you need a public domain name. 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 FreedomBox users to use XMPPCurrently, all users created through FreedomBox 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.
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) TCP 5280 (?)
Compatible clientsFreedomBox provides a web client: JSXC. XMPP clients are available for various desktop and mobile platforms. Back to Features introduction or manual pages. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/en/freedombox-manual.raw.xml b/doc/manual/en/freedombox-manual.raw.xml deleted file mode 100644 index 109943878..000000000 --- a/doc/manual/en/freedombox-manual.raw.xml +++ /dev/null @@ -1,15362 +0,0 @@ - - -
- - FreedomBox/Manual - - - 106 - 2020-08-19 10:55:41 - fioddor - BEGIN_INCLUDE mark added for Snapshots section. - - - 105 - 2020-08-19 10:48:59 - fioddor - BEGIN_INCLUDE mark added for Storage section. - - - 104 - 2020-08-19 10:43:40 - fioddor - BEGIN_INCLUDE mark added for ServiceDiscovery section. - - - 103 - 2020-08-19 10:39:05 - fioddor - BEGIN_INCLUDE mark added for Security section. - - - 102 - 2020-08-19 10:33:39 - fioddor - BEGIN_INCLUDE mark added for NameServices section. - - - 101 - 2020-08-19 10:21:25 - fioddor - BEGIN_INCLUDE mark added for Monkeysphere section. - - - 100 - 2020-08-19 10:12:53 - fioddor - BEGIN_INCLUDE mark added for Diagnostics section. - - - 99 - 2020-08-19 10:02:24 - fioddor - Begin mark added for DateTime. - - - 98 - 2020-08-15 12:53:09 - JamesValleroy - add bepasty page - - - 97 - 2020-07-30 08:29:02 - fioddor - Page has now a translations header and a BEGIN_INCLUDE mark. - - - 96 - 2020-07-29 23:31:52 - fioddor - Page has now a translations header and a BEGIN_INCLUDE mark. - - - 95 - 2020-07-19 19:32:07 - fioddor - Sharing app included - - - 94 - 2020-07-18 11:17:27 - fioddor - Remove Coquelicot as it is no longer part of FreedomBox - - - 93 - 2020-07-17 23:24:50 - fioddor - JSXC page included - - - 92 - 2020-05-30 18:28:47 - SunilMohanAdapa - Sort apps and system items according to their new titles - - - 91 - 2020-05-26 13:39:35 - fioddor - Bind moved to sort on headers. - - - 90 - 2020-05-26 13:37:10 - fioddor - Include Bind DNS Server under System - - - 89 - 2020-05-24 19:21:23 - JamesValleroy - fix broken includes due to space after page name - - - 88 - 2020-05-24 08:18:14 - fioddor - Improved readability - - - 87 - 2020-05-23 20:53:09 - JamesValleroy - skip TOCs for system pages - - - 86 - 2020-05-23 20:01:24 - JamesValleroy - skip TOCs for included app pages - - - 85 - 2020-05-23 19:47:32 - JamesValleroy - don't include TableOfContents from included pages - - - 84 - 2020-05-06 06:02:24 - SunilMohanAdapa - Include Coturn app - - - 83 - 2020-05-04 07:46:54 - FredLeMeur - manual page entry for Performance (cockpit-pcp) - - - 82 - 2020-05-03 16:44:06 - JamesValleroy - Fix from markers for Contribute and Developer included pages - - - 81 - 2020-02-21 15:51:40 - JosephNuthalapati - Add entry for Samba - - - 80 - 2019-12-25 18:43:42 - Drahtseil - added MiniDLNA - - - 79 - 2019-12-20 19:58:30 - Drahtseil - Placed Simple Gitweb in the correct place - - - 78 - 2019-12-15 19:26:31 - Drahtseil - Added Gitweb (to the end of the manual, but I have no clue how this is sorted) - - - 77 - 2019-04-30 00:45:49 - SunilMohanAdapa - Include I2P application - - - 76 - 2019-04-24 03:14:10 - SunilMohanAdapa - Add link to Pioneer Edition - - - 75 - 2019-04-24 01:39:13 - SunilMohanAdapa - Include Pine A64+ - - - 74 - 2019-02-27 00:28:00 - JamesValleroy - rename Plinth -> FreedomBox Service (Plinth) - - - 73 - 2019-02-27 00:24:53 - JamesValleroy - add link to home page - - - 72 - 2019-02-26 23:20:47 - JamesValleroy - add infinoted page - - - 71 - 2019-02-26 12:50:28 - JamesValleroy - remove reference to freedombox-setup - - - 70 - 2019-02-26 12:41:20 - JamesValleroy - add link to Mastodon account - - - 69 - 2019-02-13 23:16:48 - MikkelKirkgaardNielsen - place dlmonkey after sort order in app. list, add comment about sorting, add draft userdir page - - - 68 - 2019-01-31 00:46:47 - SunilMohanAdapa - Add backups links to manual - - - 67 - 2019-01-28 04:35:54 - JosephNuthalapati - Include MLDonkey manual page - - - 66 - 2019-01-10 21:46:53 - SunilMohanAdapa - Include Cockpit manual page - - - 65 - 2019-01-03 04:17:54 - SunilMohanAdapa - Update link to rpi3b and add link to rpi3b+ - - - 64 - 2018-03-05 12:22:59 - JosephNuthalapati - Renamed Disks to Storage - - - 63 - 2018-03-05 03:57:14 - SunilMohanAdapa - Update link to XMPP to ejabberd - - - 62 - 2018-03-02 12:03:07 - JosephNuthalapati - Rename Matrix to MatrixSynapse - - - 61 - 2018-02-22 12:14:31 - JosephNuthalapati - Include Searx manual entry - - - 60 - 2018-02-10 03:19:17 - JosephNuthalapati - Add Coquelicot and sort Apps section in alphabetical order - - - 59 - 2018-01-17 10:27:42 - JosephNuthalapati - Include MediaWiki manual entry - - - 58 - 2018-01-04 20:04:28 - David Jones - - - 57 - 2017-11-14 02:27:58 - JamesValleroy - include Snapshots page - - - 56 - 2017-10-21 14:53:00 - Drahtseil - Adding Syncthing - - - 55 - 2017-06-06 04:07:40 - SunilMohanAdapa - Include pcDuino3 and RaspberryPi3 - - - 54 - 2017-03-23 06:34:36 - rahulde - - - 53 - 2017-01-21 17:18:07 - JamesValleroy - drop shaarli - - - 52 - 2017-01-18 23:32:13 - JamesValleroy - move release notes down - - - 51 - 2017-01-18 15:25:21 - JamesValleroy - Drop planned apps -- no reason to include them in manual yet - - - 50 - 2017-01-02 13:54:14 - JamesValleroy - include LetsEncrypt page - - - 49 - 2016-12-23 18:52:10 - JamesValleroy - Drop ownCloud page from manual. It has not been available in Debian for some time now. - - - 48 - 2016-12-23 18:32:35 - JamesValleroy - move available apps / planned apps to top level - - - 47 - 2016-12-23 18:27:34 - JamesValleroy - move not available apps to separate section - - - 46 - 2016-12-23 17:49:13 - JamesValleroy - Drop Advanced page from manual. The plugserver repo has not been updated in a long time, and would conflict with our current setup. - - - 45 - 2016-12-23 14:58:06 - JamesValleroy - remove links to old manuals (deleted pages) - - - 44 - 2016-09-04 10:16:09 - Drahtseil - - - 43 - 2016-08-31 17:50:53 - Drahtseil - added security, reordered alphabetically apps and system; dynamic DNS + pagekite -> system; kept secureshell, unhosted, gnusocial - - - 42 - 2016-08-31 17:13:30 - Drahtseil - added Disks - - - 41 - 2016-08-21 17:19:00 - Drahtseil - added NameServices - - - 40 - 2016-08-21 09:50:21 - Drahtseil - added Service Discovery - - - 39 - 2016-08-21 09:44:45 - Drahtseil - added Diagnostics, typo in Power - - - 38 - 2016-08-21 09:30:28 - Drahtseil - added Power - - - 37 - 2016-08-17 20:11:37 - Drahtseil - added include Quassel - - - 36 - 2016-05-27 17:24:54 - JamesValleroy - add repro page - - - 35 - 2016-04-10 07:04:38 - PhilippeBaret - Cleaned Radicale feature link made for page creation - - - 34 - 2016-04-10 06:35:00 - PhilippeBaret - Created manual page "Radicale" [FreedomBox/Manual/Radicale] - - - 33 - 2016-04-10 06:31:49 - PhilippeBaret - Added to FreedomBox manuel new page to do = Radicale - - - 32 - 2016-02-15 12:50:14 - JamesValleroy - use BEGIN_INCLUDE for Debian page - - - 31 - 2016-01-20 16:40:56 - PhilippeBaret - Added GnuSocial Include in the Manual tree - - - 30 - 2015-12-16 00:31:47 - PhilippeBaret - Added OpenVPN page to Apps manual - - - 29 - 2015-11-29 20:55:54 - PhilippeBaret - Added ## BEGIN_INCLUDE - - - 28 - 2015-11-29 20:54:55 - PhilippeBaret - Added ## BEGIN_INCLUDE for [QuickStart] - - - 27 - 2015-11-29 20:20:46 - PhilippeBaret - Fixing include for manual - - - 26 - 2015-11-29 19:27:21 - PhilippeBaret - Text finishing - - - 25 - 2015-11-29 19:20:25 - PhilippeBaret - Fixing TOC [hardware content] - - - 24 - 2015-11-29 19:11:48 - PhilippeBaret - Bug fixing - - - 23 - 2015-11-29 19:10:45 - PhilippeBaret - Added from="## BEGIN_INCLUDE" [fbx/download] - - - 22 - 2015-11-21 16:42:45 - SunilMohanAdapa - Add A20 OLinuXino Lime2/MICRO pages - - - 21 - 2015-11-08 23:03:14 - PhilippeBaret - Added Use page content [Other resources] + [Tell People] - - - 20 - 2015-11-08 22:49:24 - PhilippeBaret - <<TableOfContents(1)>> >> <<TableOfContents(2)>> - - - 19 - 2015-11-08 22:48:14 - PhilippeBaret - TableOfContents(3) >> TableOfContents(1) - - - 18 - 2015-11-08 22:10:12 - PhilippeBaret - Added Introduction page - - - 17 - 2015-11-06 15:23:56 - SunilMohanAdapa - Add APU as supported hardware - - - 16 - 2015-10-23 20:16:08 - MarkusSabadello - adding Unhosted to Apps - - - 15 - 2015-10-04 11:17:00 - SunilMohanAdapa - Include Download page - - - 14 - 2015-09-16 16:38:33 - SunilMohanAdapa - Don't include TOC from developer guide - - - 13 - 2015-09-16 16:24:02 - SunilMohanAdapa - Include the secure shell page - - - 12 - 2015-09-16 12:35:53 - SunilMohanAdapa - Relocate and rename developer section - - - 11 - 2015-09-16 12:18:57 - SunilMohanAdapa - Add hacking section - - - 10 - 2015-09-16 12:01:25 - SunilMohanAdapa - Add contributing section - - - 9 - 2015-09-16 08:29:07 - SunilMohanAdapa - Add USBWiFi page - - - 8 - 2015-09-14 03:41:12 - SunilMohanAdapa - Temporarily remove portal link to avoid Dockbook export issue - - - 7 - 2015-09-14 03:27:32 - SunilMohanAdapa - Remove Dreamplug TOC - - - 6 - 2015-09-13 16:03:28 - SunilMohanAdapa - Add release notes - - - 5 - 2015-09-13 15:26:24 - SunilMohanAdapa - Minor fix to title - - - 4 - 2015-09-13 15:20:46 - SunilMohanAdapa - Move getting help to the top of the manual - - - 3 - 2015-09-13 15:01:14 - SunilMohanAdapa - Don't bottom parts of each page - - - 2 - 2015-09-13 14:45:33 - SunilMohanAdapa - Add FreedomBox category and portal - - - 1 - 2015-09-13 14:43:38 - SunilMohanAdapa - Initial page for FreedomBox aggregated manual - - - -
- FreedomBox: take your online privacy back - FreedomBox is a ready made personal server, designed with privacy and data ownership in mind. It is a subset of the Debian universal operating system and includes free software only. You can run it on a small, inexpensive and power-efficient computer box in your home that is dedicated for that use. It can also be installed on any computer running Debian or in a virtual machine. - In order to replace third-party communication services that are data mining your entire life, you will be able to host services yourself and use them at home or over the Internet through a browser or specialized apps. These services include chat and voice calls, webmail, file sharing and calendar, address book and news feed synchronization. For example, to start using a private chat service, activate the service from the administration interface and add your friends as authorized users of the service. They will be able to connect to the service hosted on your FreedomBox, using XMPP chat clients such as Conversations on Android, Pidgin on Windows and Linux, or Messages on Mac OS, for encrypted communications. - FreedomBox is a product you can just buy, set up and use. Once installed the interface is easy to use, similar to a smart phone. - User documentation: - - - List of applications offered by FreedomBox. - - - - Manual - - - - - Live Help from the community - - - - FreedomBox can also host a Wi-Fi access point, ad blocking proxy and a virtual private network (VPN). More advanced users can replace their router with a FreedomBox. - Setting up FreedomBox on a specific hardware or on your computer running Debian may require a bit of technical expertise or help from the community. - Related technical documentation: - - - - Machines that support FreedomBox - - - - - Download and Install - - - - - FreedomBox Developer Manual - - - -
- Typical usage: Private Cloud - FreedomBox provides services to the computers and mobile devices in your home, and to your friends. This includes secure instant messaging and low-bandwidth, high-quality voice conference calling. FreedomBox lets you publish your content in a blog and wiki to collaborate with the rest of the world. On the roadmap are a personal email server and federated social networking using GNU Social and Diaspora, to provide privacy-respecting alternatives to Gmail and Facebook. -
-
- Advanced usage: Smart Home Router - FreedomBox runs in a physical computer and can route your traffic. It can sit between various devices at home such as mobiles, laptops and TVs and the Internet, replacing a home wireless router. By routing traffic, FreedomBox can remove tracking advertisements and malicious web bugs before they ever reach your devices. FreedomBox can cloak your location and protect your anonymity by "onion routing" your traffic over Tor. FreedomBox provides a VPN server that you can use while you are away from home to keep your traffic secret on untrusted public wireless networks and to securely access various devices at home. - It can also be carried along with your laptop and used to connect to public networks at work, school or office to avail its services. - It could be used in a village to make available digital communications throughout the village. In the future, FreedomBox intends to deliver support for alternative ways of connecting to the Internet such as Mesh networking. -
-
- Advanced usage: For Communities - The primary design goal of FreedomBox is to be used as a personal server at home for use by a single family and their friends. However, at the core, it is a server software that can aid a non-technical user to setup services and maintain them with ease. Security is automatically managed and many of the technical choices in system administration are taken care by the software automatically thereby reducing complexity for a non-technical user. This nature of FreedomBox makes it well-suited for hosting services for small communities like villages or small firms. Communities can host their own services using FreedomBox with minimal effort. They can setup Wi-Fi networks that span the entire area of the community and draw Internet connections from long distances. Community members can enjoy previously unavailable Internet connectivity, ubiquitous Wi-Fi coverage, free VOIP services, offline education and entertainment content, etc. This will also boost privacy for individuals in the community, reduce dependence on centralized services provided by large companies and make them resistant to censorship. - The free e-book FreedomBox for Communities describes the motivation and provides detailed instructions to setup FreedomBox for this use case. Members of the FreedomBox project are involved in setting up Wi-Fi networks with free Internet connectivity in rural India. This e-book documents their knowledge and experiences. -
-
- FreedomBox Interface -
- Screenshot - - - - - - - FreedomBox front page - - - -
-
- Screencast introduction - - Plinth_Introduction.webm - - (36 MB, 13 Min.) -
-
- More video resources - Eben Moglen's talk, Eben Moglen - Freedom in the cloud, delivered before the FreedomBox project was started gives insights into the philosophy behind FreedomBox. - First demonstration of FreedomBox at SFLC, University of Columbia by Sunil Mohan Adapa. -
-
-
-
- Quick Start -
- What you need to get started - The easy way is to buy a FreedomBox kit. - Alternatively you may choose to build it yourself, by gathering all the components: - - - A supported device (including any device that can run Debian). We will call that the FreedomBox in the rest of this manual. - - - A power cable for your device. - - - An ethernet cable. - - - A microSD card (or equivalent storage media for your device), prepared according to the instructions on the Download page. - - -
-
- How to get started - - - Plug one end of your ethernet cord into your FreedomBox's ethernet port, and plug the other end into your router. - - - Power on the FreedomBox. - - - Note: On most single board computers, don't expect any output on a monitor connected via HDMI as the support may not exist in the kernel. See below to access and control your FreedomBox via network. - - - - - On first boot, FreedomBox will perform its initial setup (older versions of FreedomBox reboot after this step). This process may take several minutes on some machines. After giving it about 10 minutes, proceed to the next step. - - - Note: Currently, due a known bug, you need to restart your FreedomBox after 10m and then proceed to the next step. - - - - - After the FreedomBox has finished its initial setup, you can access its web interface through your web browser. - - - If your computer is connected directly to the FreedomBox through a second (LAN) ethernet port, you can browse to: or . - - - If your computer supports mDNS (GNU/Linux, Mac OSX or Windows with mDNS software installed), you can browse to: (or ) - - - If you know your way around the router's web interface, you can look up the IP address of the FreedomBox there, and browse to that address. - - - If none of these methods are available, then you will need to figure out the IP address of your FreedomBox. You can use the "nmap" program from your computer to find its IP address: - - In most cases you can look at your current IP address, and change the last digits with zero to find your home network, like so: XXX.XXX.XXX.0/24 - Your FreedomBox will show up as an IP address with an open tcp port 80 using Apache httpd service on Debian, such as the example below which would make it accessible at : - - If nmap does not find anything with the above command, you can try replacing 192.168.0.0/24 with 10.42.0.255/24. - - The scan report will show something similar to the following: - - In this example, the FreedomBox is accessible at . (10.42.0.1 is my laptop.) - - - - - On accessing FreedomBox's web interface your browser will warn you that it communicates securely but that it regards the security certificate for doing so as invalid. This is a fact you need to accept because the certificate is auto generated on the box and therefore "self-signed" (the browser might also use words such as "untrusted", "not private", "privacy error" or "unknown issuer/authority"). Telling your browser that you are aware of this might involve pressing buttons such as "I understand the Risks", "proceed to ... (unsafe)" or "Add exception". After installation this certificate can be changed to a normal one using the Let's Encrypt option. - - - - - - - - - Self-signed certificate warning - - - - - - - - - - - - Add Security Exception - - - - - - - - The first time you access the FreedomBox web interface, you will see a welcome page. Click the "Start Setup" button to continue. - - - - - - - - - Welcome - - - - If you have installed FreedomBox using a Debian package, you will be asked for a secret key. This secret must have been provided during the installation of the Debian package. It can also be read from the file /var/lib/plinth/firstboot-wizard-secret. - - - - - The next page asks you to provide a user name and password. Fill in the form, and then click "Create Account." - - - Note: The user that you create here has Admin privileges and can also log in using ssh. You might not want to use the user account you will want to use in daily usage, to prevent security issues. You can later add more users. - - - - - - - - - Account - - - - - - - - After completing the form, you will be logged in to FreedomBox's web interface and able to access apps and configuration through the interface. - - - - - - - - - Complete - - - - - - - - Now you can try any of the Apps that are available on FreedomBox. -
-
- Finding your way around -
- Front page - The front page is the page that you will see when accessing the web root of your FreedomBox. You can also access it by clicking the FreedomBox logo in the top-left corner of the FreedomBox's web interface. - The front page includes shortcuts to apps that have been installed and are enabled. For web apps, clicking the shortcut will take you directly to the app's web page. For other services, clicking the shortcut will show more information about the service. - - - - - - - Front page - - - - - - - - - - Front page - - - -
-
- Apps menu - The Apps menu can be accessed by clicking the grid icon, next to the FreedomBox logo. This page lists all of the apps that are available for installing on FreedomBox. Click the name of an app to visit its page, where you can install and configure it. - - - - - - - Apps - - - -
-
- Help menu - The Help menu can be accessed by clicking the question mark icon in the top-right corner. It includes helpful links and the FreedomBox manual. - - - - - - - Help - - - -
-
- System menu - The System menu can be accessed by clicking the gear icon in the top-left corner. It includes a number of pages related to system configuration. - - - - - - - System - - - -
-
- User menu - In the top-right corner, the name of the currently logged-in user is shown. A drop-down menu includes options for editing the current user or logging out of the user interface. - - - - - - - User - - - -
-
- Burger menu - FreedomBox's web interface is responsive. Eventually you might miss the menu options on slim windows. - - - - - - - User - - - - That's because the top menu options collapsed into the burger icon shown at the top right corner of the window. Clicking on it the menu drops down. - - - - - - - User - - - -
-
-
-
- Getting Help - - - - This manual is intended to give you the information you need to get started with your FreedomBox. However, if you have any questions after reading this document, you can get help from community contributors by: - - - Searching/asking on our discussion forum (recommended). - - - Emailing to our mailinglist at freedombox-discuss@lists.alioth.debian.org. You can also sign up to receive copies of every discussion that happens on the mailing list or read the archives. - - - Chatting at #freedombox@irc.oftc.net. - - - Reading the wiki. - - - Reading the FreedomBox Foundation's website. - - - Reading the FreedomBox Project Page. - - -
-
- Download and Install - Welcome to the FreedomBox download page. - - - Note: If you purchased a FreedomBox kit, this section is not meant for you, so you can just skip it entirely. (Unless you specifically want to build an alternative software image). - - - You may either install FreedomBox on one of the supported inexpensive hardware devices, on any Debian operating system, or deploy it on a virtual machine. - Installing on a machine running a Debian system is easy because FreedomBox is available as a package. We do recommend to install FreedomBox on a supported single board computer (SBC). The board will be dedicated for FreedomBox use from home, this will prevent a lot of risks, such as accidental misconfiguration by the user. In case of trouble deciding which hardware is best for you or during the installation, please use the support page or read the Questions and Answers page based on posts on the Freedombox-discuss mailing list archives. -
- Downloading on Debian - If you are installing on an existing Debian installation, you don't need to download these images. Instead, read the instructions on setting up FreedomBox on Debian. -
-
- Downloading for SBC or Virtual Machine -
- Prepare your device - Read the hardware specific instructions on how to prepare your device at the Hardware section. On the web, there is a lot of documentation about setting your device up and flashing USB or SD Cards to boot your hardware. -
-
- Downloading Images - Recent images for supported targets are available here: - - - Official Images: - - - Official Images: - - -
-
- Verifying the Downloaded Images - It is important to verify the images you have downloaded to ensure that the file has not been corrupted during the transmission and that it is indeed the image built by FreedomBox developers. - Note: Testing and nightly images are automatically signed by the FreedomBox CI server. - - - First open a terminal and import the public keys of the FreedomBox developers who built the images: - - If this command shows an error such as new key but contains no user ID - skipped, then use a different keyserver to download the keys: - - Or - - - - Next, verify the fingerprint of the public keys: - -sub 4096R/4C1D4B57 2011-11-12 - -$ gpg --fingerprint 7D6ADB750F91085589484BE677C0C75E7B650808 -pub 4096R/7B650808 2015-06-07 [expires: 2020-06-05] - Key fingerprint = 7D6A DB75 0F91 0855 8948 4BE6 77C0 C75E 7B65 0808 -uid James Valleroy -uid James Valleroy -sub 4096R/25D22BF4 2015-06-07 [expires: 2020-06-05] -sub 4096R/DDA11207 2015-07-03 [expires: 2020-07-01] -sub 2048R/2A624357 2015-12-22 - -$ gpg --fingerprint 013D86D8BA32EAB4A6691BF85D4153D6FE188FC8 -pub rsa4096 2018-06-06 [SC] - 013D 86D8 BA32 EAB4 A669 1BF8 5D41 53D6 FE18 8FC8 -uid [ unknown] FreedomBox CI (Continuous Integration server) -sub rsa4096 2018-06-06 [E]]]> - - - Finally, verify your downloaded image with its signature file .sig. For example: - " -gpg: WARNING: This key is not certified with a trusted signature! -gpg: There is no indication that the signature belongs to the owner. -Primary key fingerprint: BCBE BD57 A11F 70B2 3782 BC57 36C3 6144 0C9B C971]]> - - -
-
- Installation - After the download you can use the image to boot your chosen hardware (including virtual machines). You'll need to copy the image to the memory card or USB stick as follows: - - - Figure out which device your card actually is. - - - Unplug your card. - - - Run dmesg -w to show and follow the kernel messages. - - - Plug your card in. You will see messages such as following: - - - - In the above case, the disk that is newly inserted is available as /dev/sdg. Very carefully note this and use it in the copying step below. - - - - - Decompress the downloaded image using tar: - - The above command is an example for the cubietruck image built on 2015-12-13. Your downloaded file name will be different. - - - Copy the image to your card. Double check to make sure you don't write to your computer's main storage (such as /dev/sda). Also make sure that you don't run this step as root to avoid potentially overriding data on your hard drive due to a mistake in identifying the device or errors while typing the command. USB disks and SD cards inserted into the system should typically be write accessible to normal users. If you don't have permission to write to your SD card as a user, you may need to run this command as root. In this case triple check everything before you run the command. Another safety precaution is to unplug all external disks except the SD card before running the command. - For example, if your SD card is /dev/sdg as noted in the first step above, then to copy the image, run: - - - - An alternative to copy to SD card command - - - /dev/sdg ; sync]]> - - - On MS Windows you will need a tool like etcher. On MacOS (OSX) you can use programs like balenaetcher and rosaimagewriter. - - - The above command is an example for the cubietruck image built on 2015-12-13. Your image file name will be different. - When picking a device, use the drive-letter destination, like /dev/sdg, not a numbered destination, like /dev/sdg1. The device without a number refers to the entire device, while the device with a number refers to a specific partition. We want to use the whole device. Downloaded images contain complete information about how many partitions there should be, their sizes and types. You don't have to format your SD card or create partitions. All the data on the SD card will be wiped off during the write process. - - - Use the image by inserting the SD card or USB disk into the target device and booting from it. Your device should also be prepared (see the Hardware section). - - - Read (the rest of) the Manual for instructions on how to use applications in FreedomBox. - - -
-
-
- Obtaining Source Code - FreedomBox is fully free software and you can obtain the source code to study, modify and distribute improvements. -
- From within FreedomBox - FreedomBox is made up of several software programs and you can obtain the source code to any of them. These instructions are similar to obtaining and building source code for Debian since FreedomBox is a pure blend of Debian. Using this process you can obtain the source code to the exact version of the package you are currently using in FreedomBox. - - - To see the list of software packages installed on your FreedomBox, run the following in a terminal: - - - - To obtain the source code for any of those programs, then run: - ]]> - This requires that the apt sources list contains information about the source code repositories. These are present by default on all FreedomBox images. If you have installed FreedomBox using a package from Debian, you need to ensure that source repositories are added in the file. - - - To build the package from source code, first install its dependencies - ]]> - Switch to the source directory created by the apt source command: - ]]> - Then build the package - - - - Install the package: - .deb]]> - - -
-
- Other Ways to Obtain Source Code - - - Source code for any of the packages can be browsed and searched using the web interface at sources.debian.org. For example, see the plinth package. - - - Source code and pre-built binary package for any version of a package including historic versions can be obtained from snapshot.debian.org. For example, see the plinth package. - - - You can also obtain the links to upstream project homepage, upstream version control, Debian's version control, changelog, etc. from the Debian tracker page for a project at tracker.debian.org. For example, see the tracker page for plinth package. - - - You can build and install a package from its Debian's version control repository. For example, - - - -
-
- Building Disk Images - You can also build FreedomBox disk images for various hardware platforms using the freedom-maker tool. This is also available as a Debian package and source code for it may be obtained using the above methods. Build instructions for creating disk images are available as part of the source code for freedom-maker package. - FreedomBox disk images are built and uploaded to official servers using automated Continuous Integration infrastructure. This infrastructure is available as source code too and provides accurate information on how FreedomBox images are built. -
- U-boot on Pioneer Edition Images - There is one minor exception to the u-boot package present on the hardware sold as FreedomBox Home Server Kits Pioneer Edition. It contains a small but important fix that is not part of Debian sources. The fork of the Debian u-boot source repository along with the minor change done by the FreedomBox is available as a separate repository. We expect this change to be available in upstream u-boot eventually and this repository will not be needed. This package can be built on a Debian armhf machine as follows (cross compiling is also possible, simply follow instructions for cross compiling Debian packages): - - The u-boot Debian package will be available in u-boot-sunxi*.deb. This package will contain - -dd if=temp/usr/lib/u-boot/A20-OLinuXino-Lime2/u-boot-sunxi-with-spl.bin of= seek=8 bs=1k conv=notrunc]]> - The resulting image will have the modified u-boot in it. -
-
-
-
-
- Apps - - Add entries here sorted after the level 2 heading inside the page to keep the list alphabetically sorted - -
- Bepasty (File & Snippet Sharing) - - - - - - - - - - - - - bepasty icon - - - - - - - - - Available since: version 20.14 -
- What is bepasty? - bepasty is a web application that allows large files to be uploaded and shared. Text and code snippets can also be pasted and shared. Text, image, audio, video and PDF documents can be previewed in the browser. Shared files can be set to expire after a time period. -
-
- Screenshot - - - - - - - Screenshot of bepasty - - - -
-
- Passwords and Permissions - bepasty uses only passwords (without usernames) to control access. Depending on which password is used to login to bepasty, the user will have different permissions. They can have any combination of the following permissions: - - - read: Read a file, if they know the URL. - - - list: List all files. - - - create: Paste or upload a new file. - - - delete: Delete a file. - - - admin: Can lock and unlock files. - - - After bepasty is installed, it comes pre-configured for the following roles: - - - Viewer: can view and list files - - - Editor: can view, list, create, and delete files - - - Administrator: has all permissions - - - These roles support a use-case of file sharing between known, authorized users. If needed, you can re-configure bepasty to support other roles and use-cases. -
-
- Distributing passwords - By default, the Public Access configuration is set to None, so a password is required for any use of bepasty. This means that you will need to distribute the passwords to the appropriate users, through any communication channels that you have. - Note that you may want to create multiple passwords with the same permissions. This allows you to distribute a unique password to each user (or to a group of users). Then if you want to revoke access to one user, you can simply delete their password. The other users with their own passwords will not be affected. -
-
- Using bepasty - After logging in to bepasty, if you have the Create permission, you will see a large text box where you can paste any text. Optionally, you can provide a filename or Content-Type for the data. After clicking Submit, the file is created. - You can also drag and drop files in the area at the bottom. They are uploaded immediate after dropping them in this area. You can also create a list to track a collection of uploaded files. - For either case, you can set a maximum lifetime value. After this time expires, the file will be deleted. - If you have the List permission, then you will see a link List all Items at the top of the page. This will show all files that have been created or uploaded. - If you have the Delete or Admin permission, you will see extra actions shown next to each file on the list page. - If you only have the Read permission, then to read files, you will need to have both a password and one or more URLs for existing files. -
-
- Managing passwords - The bepasty configuration page in FreedomBox interface allows you to create new passwords, or to remove a password. When you create a password, you can choose any combination of the permissions described above. Note that a typical Administrator should have all of the permissions (not just "Admin"). - You can also set a Comment. This is recommended, and you should use the comment to help yourself remember the purpose of the password, or who will be using the password. - You can also configure Public Access, which sets the default permissions that are available even without logging in with a password. You can set this to allow reading files by their URL, or reading and listing all files. -
-
- External links - - - -
-
-
- Coturn (VoIP Helper) - - - - - - - - - - - - - Coturn icon - - - - - - - - - Available since: version 20.8 - Coturn is a server to facilitate audio/video calls and conferences by providing an implementation of TURN and STUN protocols. WebRTC, SIP and other communication servers can use it to establish a call between parties who are otherwise unable connect to each other. - It is not meant to be used directly by users. Servers such as Matrix Synapse need to be configured with the details provided on the Coturn app page. Apart from Matrix Synapse, Jitsi, Ejabberd, Nextcloud Talk, etc. can use Coturn server for audio/video calls and conferences. There is no need for the servers to be running on the same machine as FreedomBox and external servers can use Coturn running on FreedomBox. - Coturn is configured in FreedomBox as an advanced app. This means that you need to check "Show advanced apps and features" in "General Configuration" to see Coturn icon in the "Apps" section. -
- How it works - When making an audio/video call, it is best to route the media streams between two peers directly. This will give the best possible latency (better signal quality) and avoid depending on a centralized server (privacy). It scales well because a simple chat server can host thousands of calls without involving the server in any way other than to setup the call. However, this approach does not work most of the time to due to how networks are configured. Most peers on the network do not have a unique IP address allocated to them. They work hidden behind a network device that performs "Network Address Translation" (NAT) for them. This means that the two peers have no way of reaching each other. - To address this problem, a simple technique known as STUN was introduced. With the help of a third party STUN server, the peers can trick the NAT devices, to carry the traffic between the two peers. Unfortunately, this trick only works about 80% of the time. So, if STUN fails, peers have no choice but to route their traffic through an intermediary server called TURN server. All the mechanism of trying out STUN first and then falling back to TURN is described in a protocol known as ICE. - On FreedomBox, Coturn provides both STUN and TURN servers. Both services are provided over TCP as well as UDP. They are provided on unencrypted as well as encrypted channels (with have a higher chance of success). Since STUN servers are very inexpensive and don't consume a lot of server resources, there is no authentication needed to use them. TURN servers on the other hand need authentication. This authentication is highly simplified and does not require maintaining a database of users. A server such as matrix-synapse which is about to setup an audio/video call between two peers will generate a username and password using a shared secret. When the peers use the TURN server, they will be validated using these credentials because the TURN server also knows the same secret. - In summary, a communication server needs to know the URLs of the STUN/TURN servers along with a shared authentication secret for TURN. After that, during audio/video call setup, they will correctly guide the peers to use STUN/TURN servers. Coturn app in FreedomBox provides exactly this information. This information can be used to configure a communication server irrespective of whether it is running on the same FreedomBox or on another server. -
-
- Configuring Matrix Synapse - Matrix Synapse server in FreedomBox can be configured to use Coturn TURN/STUN server. In future, when you install Matrix Synapse, FreedomBox will automatically install Coturn and configure its parameters into Matrix Synapse. To configure Matrix Synapse, edit the file /etc/matrix-synapse/homeserver.yaml with the following lines: - - And then restart matrix-synapse server by disabling and re-enabling the matrix-synapse app. -
-
-
- Deluge (BitTorrent Web Client) - - - - - - - - - - - - - Deluge icon - - - - - - - - - Available since: version 0.5 -
- 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. -
-
-
- Ejabberd (Chat Server) - - - - - - - - - - - - - ejabberd icon - - - - - - - - - Available since: version 0.3 -
- What is XMPP? - XMPP is a federated server-client 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. - Currently FreedomBox offers both, a server (ejabberd) and a web client (JSXC) from its web interface. -
-
- Privacy - 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 network. - If you only need the local network (LAN) users to chat with each other you can invent your domain name, but if you want users from the internet to join your rooms you need a public domain name. 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 FreedomBox users to use XMPP - Currently, all users created through FreedomBox 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. -
-
- 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) - - - TCP 5280 (?) - - -
-
- Compatible clients - - - FreedomBox provides a web client: JSXC. - - - XMPP clients are available for various desktop and mobile platforms. - - -
-
-
- GitWeb (Simple Git Hosting) - - - - - - - - - - - - - Gitweb icon - - - - - - - - - Available since: version 19.19 - Git is a distributed version-control system for tracking changes in source code during software development. GitWeb provides a web interface to Git repositories. You can browse history and content of source code, use search to find relevant commits and code. You can also clone repositories and upload code changes with a command-line Git client or with multiple available graphical clients. And you can share your code with people around the world. - To learn more on how to use Git visit Git tutorial. -
- Managing the repositories - After installation of GitWeb, a new repository can be created. It can be marked as private to limit access. -
-
- Access - GitWeb can be accessed after installation e.g. by the web client through https://<my_freedombox_name>/gitweb. -
-
- HTTP basic auth - GitWeb on FreedomBox currently supports HTTP remotes only. To avoid having to enter the password each time you pull/push to the repository, you can edit your remote to include the credentials. - - Example: - - - Your username and password will be encrypted. Someone monitoring the network traffic will notice the domain name only. - Note: If using this method, your password will be stored in plain text in the local repository's .git/config file. For this reason, you should create a FreedomBox user who has only access to the gitweb and never use an admin account. -
-
- Mirroring - Though your repositories are primarily hosted on your own FreedomBox, you can configure a repository on another Git hosting system like GitLab as a mirror. -
-
-
- I2P (Anonymity Network) - - - - - - - - - - - - - I2P icon - - - - - - - - -
- About I2P - The Invisible Internet Project is an anonymous network layer intended to protect communication from censorship and surveillance. I2P provides anonymity by sending encrypted traffic through a volunteer-run network distributed around the world. - Find more information about I2P on their project homepage. -
-
- Services Offered - The following services are offered via I2P in FreedomBox by default. Additional services may be available when enabled from I2P router console that can be launched from FreedomBox web interface. - - - Anonymous Internet browsing: I2P can be used to browse Internet anonymously. For this, configure your browser (preferable a Tor Browser) to connect to I2P proxy. This can be done by setting HTTP proxy and HTTPS proxy to freedombox.local (or your FreedomBox's local IP address) and ports to 4444 and 4445 respectively. This service is available only when you are reaching FreedomBox using local network (networks in internal zone) and not available when connecting to FreedomBox from the Internet. One exception to this is when you connect to FreedomBox's VPN service from Internet you can still use this service. - - - Reaching eepsites: I2P network can host websites that can remain anonymous. These are called eepsites and end with .i2p in their domain name. For example, is the website for I2P project in the I2P network. eepsites are not reachable using a regular browser via regular Internet connection. To browse eepsites, your browser needs to be configured to use HTTP, HTTPS proxies as described above. This service is available only when you are reaching FreedomBox using local network (networks in internal zone) and not available when connecting to FreedomBox from the Internet. One exception to this is when you connect to FreedomBox's VPN service from Internet you can still use this service. - - - Anonymous torrent downloads: I2PSnark, an application for anonymously downloading and sharing files over the BitTorrent network is available in I2P and enabled by default in FreedomBox. This application is controlled via a web interface that can be launched from 'Anonymous torrents' section of I2P app in FreedomBox web interface or from the I2P router console interface. Only logged-in users belonging to 'Manage I2P application' group can use this service. - - - IRC network: I2P network contains an IRC network called Irc2P. This network hosts the I2P project's official IRC channel among other channels. This service is enabled by default in FreedomBox. To use it, open your favourite IRC client. Then configure it to connect to host freedombox.local (or your FreedomBox's local IP address) with port number 6668. This service is available only when you are reaching FreedomBox using local network (networks in internal zone) and not available when connecting to FreedomBox from the Internet. One exception to this is when you connect to FreedomBox's VPN service from Internet you can still use this service. - - - I2P router console: This is the central management interface for I2P. It shows the current status of I2P, bandwidth statistics and allows modifying various configuration settings. You can tune your participation in the I2P network and use/edit a list of your favourite I2P sites (eepsites). Only logged-in users belonging to 'Manage I2P application' group can use this service. - - -
-
-
- Ikiwiki (Wiki and Blog) - - - - - - - - - - - - - Ikiwiki icon - - - - - - - - - Avaiable since: version 0.5 -
- 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 FreedomBox. 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 FreedomBox (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". - - -
-
-
- Infinoted (Gobby Server) - - - - - - - - - - - - - Infinoted icon - - - - - - - - - Available since: version 0.5 - infinoted is a server for Gobby, a collaborative text editor. - To use it, download Gobby, desktop client and install it. Then start Gobby and select "Connect to Server" and enter your FreedomBox's domain name. -
- 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 infinoted: - - - TCP 6523 - - -
-
-
- JSXC (Web Chat Client) - - - - - - - - - - - - - JSXC icon - - - - - - - - - Available since: version 0.11.0 - JSXC is a web chat client. It can be used to join compatible chat servers. - FreedomBox offers both parties, a server (ejabberd) and a web client (JSXC), from its web interface. -
- Technical Specifications - JSXC features the XMPP over BOSH protocol and is implemented in HTML5. - XMPP is a federated server-client 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. -
-
- Installation - You can install JSXC through its icon in the Apps section of FreedomBox web interface. The ejabberd (XMPP server) icon also offers to launch the web client (and installs JSXC if not yet installed). -
-
- Usage - After the JSXC module install completes, the JSXC can be accessed through its icon in the Apps section of FreedomBox web interface. The ejabberd (XMPP server) icon also offers to launch the web client. Both will redirect you to https://<your freedombox>/plinth/apps/xmpp/jsxc/. - To use it, you need to input the domain name of the server to connect to. It will automatically check the BOSH server connection to the given domain name as you type it. - - - - - - - - - - - - - - JSXC not connecting - - - - - - - - - - - - JSXC connecting - - - - - - - - - Check for further details. - Videoconferencing and file transfer features are offered by JSXC but don't seem to work in FreedomBox yet. -
-
- Port Forwarding - If your FreedomBox is behind a router and you want to connect to other servers, you will need to set up port forwarding on your router. You should forward the following ports for XMPP: - - - TCP 5222 (client-to-server) - - -
-
-
- Matrix Synapse (Chat Server) - - - - - - - - - - - - - Matrix Synapse icon - - - - - - - - - Available since: version 0.14.0 -
- What is 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. Matrix Synapse is a federated application where chat rooms can exist on any server and users from any server in the federated network can join them. Learn more about Matrix. -
-
- How to access your Matrix Synapse server? - We recommend the Riot client to access the Matrix Synapse server. You can download Riot for desktops. Mobile applications for Android and iOS are available from their respective app stores. -
-
- Setting up Matrix Synapse on your FreedomBox - 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. Currently, you will not be able to change the domain once is it configured. - Your router has to be configured to forward port 8448. - All the registered users of your FreedomBox will have their Matrix IDs as @username:domain. If public registration is enabled, also your chosen client can be used to register a user account. -
-
- 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. -
-
- Memory usage - The Synapse reference server implemented in Python is known to be quite RAM hungry, especially when loading large rooms with thousands of members like #matrix:matrix.org. It is recommended to avoid joining such rooms if your FreedomBox device only has 1 GiB RAM or less. Rooms with up to a hundred members should be safe to join. The Matrix team is working on a new implementation of the Matrix server written in Go called Dendrite which might perform better in low-memory environments. - Some large public rooms in the Matrix network are also available as IRC channels (e.g. #freedombox:matrix.org is also available as #freedombox on irc.debian.org). It is better to use IRC instead of Matrix for such large rooms. You can join the IRC channels using Quassel. -
-
- Advanced usage - - - If you wish to create a large number of users on your Matrix Synapse server, use the following commands on a remote shell as root user: - - - /etc/matrix-synapse/conf.d/registration_shared_secret.yaml -chmod 600 /etc/matrix-synapse/conf.d/registration_shared_secret.yaml -chown matrix-synapse:nogroup /etc/matrix-synapse/conf.d/registration_shared_secret.yaml -systemctl restart matrix-synapse -register_new_matrix_user -c /etc/matrix-synapse/conf.d/registration_shared_secret.yaml]]> - - - - - If you wish to see the list of users registered in Matrix Synapse, the following as root user: - - - - - - - - If you wish to create a community in Matrix Synapse, a Matrix user with server admin privileges is needed. In order to grant such privileges to username run the following commands as root user: - - - - - - - -
-
-
- MediaWiki (Wiki) - - - - - - - - - - - - - MediaWiki icon - - - - - - - - - Available since: version 0.20.0 -
- About MediaWiki - MediaWiki is the software that powers the Wikimedia suite of wikis. - Read more about MediaWiki on Wikipedia -
-
- 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 app page in web interface. -
-
- 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 - The MediaWiki installation on FreedomBox ships with a basic editor with a toolbar for common options like Bold, Italics etc. Click on the Advanced section for more options like Headings, bullet lists etc. - - - - - - - mediawiki-toolbar.png - - - -
- Visual Editor - - - MediaWiki's new Visual Editor gives a WYSIWYG user interface to creating wiki pages. This is still a Beta feature and is not provided by default with MediaWiki. 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. - - -
-
-
- Customization -
- Skins - MediaWiki's default skin is usually Vector. The default skin set by FreedomBox is Timeless. - Vector is a skin best-suited for viewing on desktop browsers. It is not suitable for mobile screen sizes. Wikimedia sites host a separate mobile site. It is not worth hosting a separate mobile site for small MediaWiki installations like those on FreedomBox. Using a mobile-friendly skin like Timeless is a cheaper way of solving the problem. - Administrators can choose a default skin from the app configuration. Users of the site also have the choice of viewing it with a different skin. -
-
-
-
-
- Minetest (Block Sandbox) - - - - - - - - - - - - - Minetest icon - - - - - - - - - Available since: version 0.9 - 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 - - -
-
-
- MiniDLNA (Simple Media Server) - - - - - - - - - - - - - MiniDLNA icon - - - - - - - - - Available since: version 19.23 - MiniDLNA is a media server with the aim to be compliant with DLNA/UPnP clients. - Note: This service is available only on networks configured as "internal" zone. It is not available when connected via OpenVPN. -
- What is UPnP/DLNA? - Universal plug & play is a set of networking protocols that allow devices within a network such as PCs, TVs, printers etc. to seamlessly discover each other and establish communication for data sharing. It is zero configuration protocol and requires only a media server and a media player that are compliant with the protocol. - DLNA is derived from UPnP as a form of standardizing media interoperability. It forms a standard/certification which many consumer electronics conform to. -
-
- Setting up MiniDLNA on your FreedomBox - To install/enable the media server you need to navigate at MiniDLNA page and enable it. The application is intended to be available in the internal (home) network and therefore it requires a network interface configured for internal traffic. - After installation a web page becomes available on . It includes information for how many files the server is detecting, how many connections exist etc. This is very useful if plugging external disks with media to check if the new media files are detected properly. If that is not happening, disabling and enabling the server will fix it. -
-
- Using MiniDLNA to play media on your devices - Any DLNA compliant device or media player should be able to automatically detect, browse and play media from MiniDLNA on FreedomBox. The following devices and media players have been tested: - - - GNOME Videos: Videos is the default media player on the popular GNU/Linux desktop environment GNOME. Open Videos, switch to 'Channels'. You should see a channel named 'freedombox: minidlna'. You will be able to browse and play media from it. - - - VLC media player: VLC is a very popular media player for GNU/Linux, Android, Windows and macOS. Open VLC and click on 'View -> Playlist'. In the playlist sidebar that appears, select 'Universal Plug'n'Play'. You should see an item named 'freedombox: minidlna'. You should be able to browse and play media from it. - - - Kodi: Kodi is a popular media centre software with user interface designed for Televisions. Open Kodi, goto 'System -> Service settings -> UPnP/DLNA' and 'Enable UPnP support'. Then visit 'Home -> Videos -> Files -> Add videos... -> Browse -> UPnP devices'. You should see 'freedombox: minidlna'. Select it and choose 'OK'. Then choose 'OK in the 'Add video source' dialog. From now on, you should see 'freedombox: minidlna' in 'Videos -> Files' section. You should be able to browse and play media from it. See Kodi documentation for more information. - - - Roku: Roku is an appliance connected to a TV for playing Internet streaming services. Many TVs also have Roku built into them. In Roku interface, find a channel called 'Roku Media Player' and open it. You should see an item called 'freedombox: minidlna'. You should be able to browse and play media from it. - - - Rhythmbox: Rhythmbox is the default audio player on the popular GNU/Linux desktop environment GNOME. Open Rhythmbox and ensure that the side pane is open by clicking on 'Application menu -> View -> Side Pane'. In the side pane you should see 'freedombox:minidlna' under the 'Shared' section. You should be able to browse and play audio files from it. Video files will not show up. - - -
-
- Supported media formats - MiniDLNA supports a wide variety of video and audio file formats. - - - Video: Files ending with .avi, .mp4, .mkv, .mpg, .mpeg, .wmv, .m4v, .flv, .mov, .3gp, etc. - - - Audio: Files ending with .mp3, .ogg, .flac, .wav, .pcm, .wma, .fla, .aac, etc. - - - Image: Files ending with .jpg, .jpeg - - - Playlist: Files ending with .m3u, .pls - - - Captions: Files ending with .srt, .smi - - - Notably, it does not support the following file extensions. Renaming the file to a known extension seems to work in most cases. - - - Video: Files ending with .webm - - - In addition to file format support from MiniDLNA, your media player or device needs to support the audio/video codecs with which the media has been encoded. MiniDLNA does not have the ability to translate files into a codec understood by the player. If you face problems with media playback, use the VLC player to find the codecs used in the media and the check your device or media player documentation on whether the codecs are supported. -
-
- File systems for external drives - If using an external drive that is used also from a Windows system the preferred filesystem should be NTFS. NTFS will keep Linux file permissions and UTF8 encoding for file names. This is useful if file names are in your language. -
-
- External links - - - - -
-
-
- MLDonkey (Peer-to-peer File Sharing) - - - - - - - - - - - - - MLDonkey icon - - - - - - - - - Available since: version 0.48.0 -
- What is MLDonkey? - MLDonkey is an open-source, multi-protocol, peer-to-peer file sharing application that runs as a back-end server application on many platforms. It can be controlled through a user interface provided by one of many separate front-ends, including a Web interface, telnet interface and over a dozen native client programs. - Originally a Linux client for the eDonkey protocol, it now runs on many flavors of Unix-like, OS X, Microsoft Windows and MorphOS and supports numerous peer-to-peer protocols including ED2K (and Kademlia and Overnet), BitTorrent, DC++ and more. - Read more about MLDonkey at the MLDonkey Project Wiki -
-
- Screenshot - - - - - - - MLDonkey Web Interface - - - -
-
- Using MLDonkey Web Interface - After installing MLDonkey, its web interface can be accessed from FreedomBox at https://<your freedombox>/mldonkey. Users belonging to the ed2k and admin groups can access this web interface. -
-
- Using Desktop/Mobile Interface - Many desktop and mobile applications can be used to control MLDonkey. MLDonkey server will always be running on FreedomBox. It will download files (or upload them) and store them on FreedomBox even when your local machine is not running or connected to MLDonkey on FreedomBox. Only users of admin group can access MLDonkey on FreedomBox using desktop or mobile clients. This is due to restrictions on which group of users have SSH access into FreedomBox. - - - Create an admin user or use an existing admin user. - - - On your desktop machine, open a terminal and run the following command. It is recommended that you configure and use SSH keys instead of passwords for the this step. - - - - Start the GUI application and then connect it to MLDonkey as if MLDonkey is running on the local desktop machine. After you are done, terminate the SSH command by pressing Control-C. - - - See MLDonkey documentation for SSH Tunnel for more information. -
-
-
- Mumble (Voice Chat) Server - - - - - - - - - - - - - Mumble icon - - - - - - - - - Available since: version 0.5 -
- 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 - - -
-
- Managing Permissions - A super user in Mumble has the ability to create administrator accounts who can in turn manage groups and channel permissions. This can be done after logging in with the username "SuperUser" using the super user password. See Mumble Guide for information on how to do this.. FreedomBox currently does not offer a UI to get or set the super user password for Mumble. A super user password is automatically generated during Mumble setup. To get the password, login to the terminal as admin user using Cockpit , Secure Shell or the console. Then, to read the super user password that was automatically generated during Mumble installation run the following command: - - You should see output such as: - 2019-11-06 02:47:41.313 1 => Password for 'SuperUser' set to 'noo8Dahwiesh']]> - Alternatively, you can set a new password as follows: - -
-
-
- OpenVPN (Virtual Private Network) - - - - - - - - - - - - - OpenVPN icon - - - - - - - - - Available since: version 0.7 -
- 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. -
-
- 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 OpenVPN: - - - UDP 1194 - - -
-
- Setting up - - - In FreedomBox 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. - - - - - - - OpenVPN service page - - - - - - 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. Users who are not administrators can download the profile from home page after login. - - - The ovpn file contains all the information a vpn client needs to connect to the server. - - - The downloaded profile contains the domain name of the FreedomBox that the client should connect to. This is picked up from the domain configured in 'Config' section of 'System' page. In case your domain is not configured properly, you may need to change this value after downloading the profile. If your OpenVPN client allows it, you can do this after importing the OpenVPN profile. Otherwise, you can edit the .ovpn profile file in a text editor and change the 'remote' line to contain the WAN IP address or hostname of your FreedomBox as follows. - - - -
-
- Browsing Internet after connecting to VPN - After connecting to the VPN, the client device will be able to browse the Internet without any further configuration. However, a pre-condition for this to work is that you need to have at least one Internet connected network interface which is part of the 'External' firewall zone. Use the networks configuration page to edit the firewall zone for the device's network interfaces. -
-
- Usage -
- On Android/LineageOS - - - Visit FreedomBox home page. Login with your user account. From home page, download the OpenVPN profile. The file will be named username.ovpn. - - - - - - - - - OpenVPN Download Profile - - - - - - - - Download an OpenVPN client such as OpenVPN for Android. F-Droid repository is recommended. In the app, select import profile. - - - - - - - - - OpenVPN App - - - - - - - - In the select profile dialog, choose the username.opvn file you have just downloaded. Provide a name for the connection and save the profile. - - - - - - - - - OpenVPN import profile - - - - - - - - Newly created profile will show up. If necessary, edit the profile and set the domain name of your FreedomBox as the server address. - - - - - - - - - OpenVPN profile created - - - - - - - - - - OpenVPN edit domain name - - - - - - - - Connect by tapping on the profile. - - - - - - - - - OpenVPN connect - - - - - - - - - - OpenVPN connected - - - - - - - - When done, disconnect by tapping on the profile. - - - - - - - - - OpenVPN disconnect - - - - - - - -
-
- On Debian - Install an OpenVPN client for your system - - Open the ovpn file with the OpenVPN client. - .ovpn]]> - If you use Network Manager, you can create a new connection by importing the file: - .ovpn]]> - If you get an error such as configuration error: invalid 1th argument to “proto” (line 5) then edit the .ovpn file and remove the line proto udp6. -
-
-
- Checking if you are connected -
- On Debian - - - Try to ping the FreedomBox or other devices on the local network. - - - Running the command ip addr should show a tun0 connection. - - - The command traceroute freedombox.org should show you the ip address of the VPN server as the first hop. - - -
-
-
- Accessing internal services - After connecting to OpenVPN, you will be able to access FreedomBox services that are only meant to be accessed on internal networks. This is in addition to being able to access external services. This can be done by using the IP address 10.91.0.1 as the host name for these services. - The following services are known to work: - - - Privoxy, - - - Tor Socks, - - - Shadowsocks, - - - I2P Proxy and - - - Samba. - - - Some services are known not to work at this time: - - - Avahi, - - - bind and - - - MiniDLNA. - - -
-
- External Links - - - -
-
-
- Privoxy (Web Proxy) - - - - - - - - - - - - - Privoxy icon - - - - - - - - - Available since: version 0.1 - A web proxy acts as a filter for incoming and outgoing web 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 FreedomBox, 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. - - -
-
-
- Quassel (IRC Client) - - - - - - - - - - - - - Quassel icon - - - - - - - - - Available since: version 0.8 - 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 run 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 FreedomBox's web interface - - - 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 - - - - -
-
- 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 Quassel: - - - TCP 4242 - - - Example configuration in router: - - - - - - - - - Quassel_PortForwarding_en_v01.png - - - - - - - -
-
- Clients - Clients to connect to Quassel from your desktop and mobile devices are available. -
- Desktop - In a Debian system, you can e.g. use quassel-client. The following steps describe how to connect Quassel Client with Quassel Core running on a FreedomBox. The first time you do this connection, Quassel Core will be initialized too. - - - Launch Quassel Client. You will be greeted with a wizard to Connect to Core. - - - - - - - - - Connect to Core - - - - - - - - Click the Add button to launch Add Core Account dialog. - - - - - - - - - Add Core Account - - - - - - - - Fill any value in the Account Name field. Fill proper DNS hostname of your FreedomBox in Hostname filed. Port field must have the value 4242. Provide the username and password of the account you wish to create to connect to the Quassel Core in the User and Password fields. Choose Remember if don't wish to be prompted for a password every time you launch Quassel client. - - - After pressing OK in the Add Core Account dialog, you should see the core account in the Connect to Core dialog. - - - - - - - - - Connect to Core - - - - - - - - Select the newly created core account and select OK to connect to it. - - - If this is the first time you are connecting to this core. You will see an Untrusted Security Certificate warning and need to accept the server certificate. - - - - - - - - - Untrusted Security Certificate - - - - - - - - Select Continue. Then you will be asked if you wish to accept the certificate permanently. Select Forever. - - - - - - - - - Untrusted Security Certificate - - - - - - - - If this Quassel Core has not been connected to before, you will then see a Core Configuration Wizard. Select Next. - - - - - - - - - Core Configuration Wizard - - - - - - - - In the Create Admin User page, enter the username and password you have used earlier to create the core connection. Select Remember password to remember this password for future sessions. Click Next. - - - - - - - - - Create Admin User Page - - - - - - - - In the Select Storage Backend page, select SQLite and click Commit. - - - - - - - - - Select Storage Backend - - - - - - - - The core configuration is then complete and you will see a Quassel IRC wizard to configure your IRC connections. Click Next. - - - - - - - - - Welcome Wizard - - - - - - - - In Setup Identity page next, provide a name and multiple nicknames. This is how you present yourself to other users on IRC. It is not necessary to give your real world name. Multiple nicknames are useful as fallback nicknames when the first nickname can't be used for some reason. After providing the information click Next. - - - - - - - - - Setup Identity - - - - - - - - In Setup Network Connection page next, provide a network name of your choice. Next provide a list of servers to which Quassel Core should connect to in order to join this IRC network (such as irc.debian.org:6667). - - - - - - - - - Setup Network Connection - - - - - - - - Select the server in the servers list and click Edit. In the Server Info dialog, set the port 6697 (consult your network's documentation for actual list of servers and their secure ports) and click Use SSL. Click OK. This is to ensure that communication between your FreedomBox and the IRC network server is encrypted. - - - - - - - - - Server Info - - - - - - - - Server Info SSL - - - - - - - - Back in the Setup Network Connection dialog, provide a list of IRC channels (such as #freedombox) to join upon connecting to the network. Click Save & Connect. - - - - - - - - - Setup Network Connection - - - - - - - - You should connect to the network and see the list of channels you have joined on the All Chats pane on the left of the Quassel Client main window. - - - - - - - - - Quassel Main Window - - - - - - - - Select a channel and start seeing messages from others in the channel and send your own messages. - - -
-
- Android - 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. -
-
-
-
- Radicale (Calendar and Addressbook) - - - - - - - - - - - - - Radicale icon - - - - - - - - - Available since: version 0.9 - 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 FreedomBox Service: - - - select Apps - - - go to Radicale (Calendar and Addressbook) 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 provides a basic web interface, which only supports creating new calendars and addressbooks. To add events or contacts, an external supported client application is needed. - - - - - - - radicale_web.png - - - - - - Creating addressbook/calendar using the web interface - - - Visit https://IP-address-or-domain-for-your-server/radicale/ - - - Log in with your FreedomBox account - - - Select "Create new addressbook or calendar" - - - Provide a title and select the type - - - Optionally, provide a description or select a color - - - Click "Create" - - - The page will show the URL for your newly created addressbook or calendar - - - - - 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/calendar-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 over Tor - In FreedomBox, setting up a calendar with Radicale over Tor is the same as over the clear net. Here is a short summary: - - - When logged in to FreedomBox interface over Tor, click on Radicale, and at the prompt provide your FreedomBox user name and password. - - - In the Radicale web interface, log in using your FreedomBox user name and password. - - - Click on "Create new address book or calendar", provide a title, select a type, and click "Create". - - - Save the URL, e.g., https://ONION-ADDRESS-FOR-YOUR-SERVER.onion/radicale/USERNAME/CALENDAR-CODE/. Items in italics need to be changed to match your settings. - - - These instructions are for Thunderbird/Lightning. Note that you will need to be connected to Tor with the Tor Browser Bundle. - - - Open Thunderbird, install the Torbirdy add-on, and restart Thunderbird. (This may not be necessary.) - - - In the Lightning interface, under Calendar/Home in the left panel right click with the mouse and select "New calendar". - - - Select the location of your calendar as "On the Network". - - - Select CalDAV and for the location copy the URL, e.g., https://ONION-ADDRESS-FOR-YOUR-SERVER.onion/radicale/USERNAME/CALENDAR-CODE/. Items in italics need to be changed to match your settings. - - - Provide a name, etc. Click "Next". Your calendar is now syncing with your FreedomBox over Tor. - - - If you have not generated a certificate for your FreedomBox with "Let's Encrypt", you may need to select "Confirm Security Exception" when prompted. - - -
-
- Synchronizing with your Android phone - There are various Apps that allow integration with the Radicale server. This example uses DAVx5, 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 DAVx5 - - - Create a new account on DAVx5 by clicking on the floating + button. - - - Select the second option as shown in the first figure below and enter the base url as (don't miss the / at the end). DAVx5 will be able to discover both CalDAV and WebDAV accounts for the user. - - - Follow this video from DAVx5 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) - - - - - - - - - DAVx5 account setup - - - - - - - - DAVx5 refresh - - - - - - - - DAVx5 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 - - - - - - [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. -
-
-
- Migrating from Radicale Version 1.x to Version 2.x - During the month of February 2019, radicale in Debian testing was upgraded from version 1.x to version 2.x. Version 2.x is a better version but is incompatible with data and configuration used with 1.x. Automatic upgrade mechanism in FreedomBox, handled by unattended-upgrades does not automatically upgrade radicale to version 2.x due to changes in configuration files. However, FreedomBox version 19.1, which is available on February 23rd, 2019 in testing will perform data and configuration migration to radicale version 2.x. Typical users require no action, this will happen automatically. - If for some reason, you need to manually run apt dist-upgrade on your machine, then radicale will be upgraded to 2.x and then FreedomBox will not be able to perform its upgrade (due to upstream project deciding to remove migration tools in radicale 2.x version). To avoid this situation, the following process is recommended if you wish to perform an upgrade. - - However, if you already happen to perform an upgrade to radicale 2.x without help from FreedomBox, you need to perform data and configuration migration yourself. Follow this procedure: - - Notes: - - - python-radicale is an old package from radicale 1.x version that is still available in testing. This is a hack to use the --export-storage feature that is responsible for data migration. This feature is not available in radicale 2.x unfortunately. - - - Files ending with .dpkg-dist will exist only if you have chosen 'Keep your currently-installed version' when prompted for configuration file override during radicale 2.x upgrade. The above process will overwrite the old configuration with new fresh configuration. No changes are necessary to the two configuration files unless you have changed the setting for sharing calendars. - - - Note that during the migration, your data is safe in /var/lib/radicale/collections directory. New data will be created and used in /var/lib/radicale/collections/collections-root/ directory. - - - The tar command takes a backup your configuration and data in /root/radicale_backup.tgz in case you do something goes wrong and you want to undo the changes. - - -
-
- Troubleshooting - 1. If you are using FreedomBox Pioneer Edition or installing FreedomBox on Debian Buster, then radicale may not be usable immediately after installation. This is due to a bug which has been fixed later. To overcome the problem, upgrade FreedomBox by clicking on 'Manual Update' from 'Updates' app. Otherwise, simply wait a day or two and let FreedomBox upgrade itself. After that install radicale. If radicale is already installed, disable and re-enable it after the update is completed. This will fix the problem and get radicale working properly. -
-
-
- Repro (SIP Server) - - - App removed - - repro has been removed from Debian 10 (Buster), and therefore is no longer available in FreedomBox. - -
-
- Roundcube (Email Client) - - - - - - - - - - - - - Roundcube icon - - - - - - - - - Available since: version 0.5 -
- 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. Enter your username and password. The username for many mail services will be the full email address such as exampleuser@example.org and not just the username like exampleuser. Enter the address of your email service's IMAP server address in the Server field. You can try providing your domain name here such as example.org for email address exampleuser@example.org and if this does not work, consult your email provider's documentation for the address of the IMAP server. Using encrypted connection to your IMAP server is strongly recommended. To do this, prepend 'imaps://' at the beginning of your IMAP server address. For example, imaps://imap.example.org. - - - - - - - Logging into your IMAP server - - - -
-
- Using Gmail with Roundcube - If you wish to use Roundcube with your Gmail account, you need to first enable support for password based login in your Google account preferences. This is because Gmail won't allow applications to login with a password by default. To do this, visit Google Account preferences and enable Less Secure Apps. After this, login to Roundcube by providing your Gmail address as Username, your password and in the server field use imaps://imap.gmail.com. - - - - - - - Logging into Gmail - - - -
-
-
- Samba (Network File Storage) - - - - - - - - - - - - - Samba icon - - - - - - - - - Available since: version 19.22 - Samba lets you have shared folders over the local network that can be used from multiple computers running different operating systems. We refer to these shared folders as "shares". - You can have a personal folder shared between your own devices (Home share), a folder shared with a trusted group (Group share) or one that is shared with every device on the network (Open share). - Samba lets you to treat a share as if it's a local folder on your computer. However, shares are available only on the local network. - To learn more about Samba, please refer to the user documentation on their wiki. -
- Using Samba - After installation, you can choose which disks to use for sharing. Enabled shares are accessible in the file manager on your computer at location \\freedombox (on Windows) or smb://freedombox.local (on Linux and Mac). There are three types of shares you can choose from: - Open share - accessible to everyone in your local network. - Group share - accessible only to FreedomBox users who are in the freedombox-share group. - Home share - every user in the freedombox-share group can have their own private space. -
- On Android - To access Samba shares on an Android device, install "Android Samba Client" from F-Droid or Google Play. Enter smb://freedombox.local/<disk> as the share path in the app. Your shared folders should then be visible in the file manager app. Samba shares can also be used by VLC for Android which automatically discovers them. -
-
-
- Integration with other apps - Transmission app on FreedomBox provides a setting to allow downloads to be saved directly to a Samba share. - If you want to make available files synchronized with Syncthing through Samba you need to make sure you synchronize in a Samba share folder. Additionally in order to make Syncthing shares available in Samba Open share or Group share you will need to ensure you click "Permissions > Ignore" button under the "Advanced" tab in folder you wish in the Syncthing web UI. This will ensure that the files will be writable through Samba. -
-
- Comparison with other apps -
- Syncthing - Syncthing maintains a copy of the shared folder on each device that it is shared with. Samba maintains only one copy on your FreedomBox device. - Syncthing can synchronize your shared folders between devices over the Internet. Samba shares are only available on the local network. - Since Syncthing is primarily a synchronization solution, it has features like conflict resolution and versioning. Samba has only copy of the file, so it doesn't need such features. For example, if two people are editing a spreadsheet stored on a Samba share, the last one to save the file wins. -
-
-
-
- Searx (Web Search) - - - - - - - - - - - - - Searx icon - - - - - - - - - Available since: version 0.24.0 -
- 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. -
-
- 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 is easily accessible via Tor. - - - 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. - - -
-
-
- Shadowsocks (SOCKS5 proxy) - - - - - - - - - - - - - Shadowsocks icon - - - - - - - - - Available since: version 0.18.0 -
- 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. -
-
- 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 -
-
-
- Sharing (File Publishing) - - - - - - - - - - - - - Sharing icon - - - - - - - - - Available since: version 0.25 -
- What Is Sharing App? - Sharing app allows you to share content over the web. Shared content can be individual files or whole directories. - The content can be shared publicly or restricted to the users of listed allowed groups. Allowed users will be able to access the shared content from their web browser at https://your_freedombox/share/content_name. Users not belonging to any of the allowed groups won't see or access the content through this mechanism. -
-
- Setting Up Shares - For the users to access the content through their browser it must exist and have a share. A share is an entry in the Sharing app relating: - - - the Name (an thereby the URL) with which the users will ask for the content, - - - the Disk Path of the content to be served and - - - the sharing mode. On restricted mode, it also has the list of allowed groups. - - - Many shares can coexist in the same server. - Only admins can create, edit or remove shares. They'll find the Sharing app in the Apps section of FreedomBox web interface. Sharing app is an easy to use web application with an evident interface. - Each share has its own sharing mode (public or restricted) setting. Only groups recognized by FreedomBox service can be combined in the list of allowed groups. Groups created in the CLI won't be offered by the Sharing app. -
-
- Providing/Updating Content - The content can be created before or after the share is created and they can be updated independently. - The content doesn't need to be provided by an admin either. Any user with write access to the share's disk path can create or update it. - Multiple shares might point to the same content. - If you are user of FreedomBox and your admin refuses to create shares for you, and you don't need to restrict the access to your content, you still can fall back to the User Websites mechanism or the P2P networks (Deluge or Transmission for Torrent, or MLDonkey) to publish your files. -
-
- Technicalities - Sharing will share the content using the built-in Apache web server. -
-
-
- Syncthing (File Synchronization) - - - - - - - - - - - - - Syncthing icon - - - - - - - - - Available since: version 0.14 - 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. - 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. -
- Synchronizing over Tor - Syncthing should automatically sync with your FreedomBox even if it is only accessible as a Tor Onion Service. - If you would like to proxy your Syncthing client over Tor, set the all_proxy environment variable: - - For more information, see the Syncthing documentation on using proxies. -
-
- Avoiding Syncthing Relays - Syncthing uses dynamic connections by default to connect with other peers. This means that if you are synchronizing over the Internet, the data might have to go through public Syncthing relays to reach your devices. This doesn't take advantage of the fact that your FreedomBox has a public IP address. - When adding your FreedomBox as a device in other Syncthing clients, set the address like "tcp://<my.freedombox.domain>" instead of "dynamic". This allows your Syncthing peers to directly connect to your FreedomBox avoiding the need for relays. It also allows for fast on-demand syncing if you don't want to keep Syncthing running all the time on your mobile devices. -
-
- Using Syncthing with other applications -
- Password Manager - Password managers that store their databases in files are suitable for synchronization using Syncthing. The following example describes using a free password manager called KeePassXC in combination with Syncthing to serve as a replacement for proprietary password managers that store your passwords in the cloud. - KeePassXC stores usernames, passwords etc. in files have the .kdbx extension. These kdbx files can be stored in a Syncthing shared folder to keep them synchronized on multiple machines. Free software applications which can read this file format are available for both desktop and mobile. You typically have to just point the application at the .kdbx file and enter the master password to access your stored credentials. For example, the same kdbx file can be accessed by using KeePassXC on desktop and KeePassDX on Android. KeePassXC can also be used to fill credentials into login fields in the browser by installing a browser extension. -
-
-
-
- Tiny Tiny RSS (News Feed Reader) - - - - - - - - - - - - - Tiny Tiny RSS icon - - - - - - - - - Available since: version 0.9 - 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 FreedomBox 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 - - - -
-
-
- Tor (Anonymity Network) - - - - - - - - - - - - - Tor icon - - - - - - - - - Available since: version 0.3 -
- 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 Onion Service to access your FreedomBox - Tor Onion Service provides a way to access your FreedomBox, even if it's behind a router, firewall, or carrier-grade NAT (i.e., your Internet Service Provider does not provide a public IPv4 address for your router). - To enable Tor Onion 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 Onion 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 Onion 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 Configuration - FreedomBox - - - - Currently only HTTP (port 80), HTTPS (port 443), and SSH (port 22) are accessible through the Tor Onion Service configured on the FreedomBox. -
-
- Apps accessible via Tor - The following apps can be accessed over Tor. Note that this list is not exhaustive. - - - Calendar and Addressbook (Radicale) - - - File Synchronization (Syncthing) - - - Feed reader (TinyTinyRSS) - - - Web Search (Searx) - - - Wiki (MediaWiki) - - - Wiki and Blog (Ikiwiki) - - -
-
- 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 FreedomBox. - At the bottom of the Tor page in FreedomBox, 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. - The requirements to run a relay are listed in the Tor Relay Guide. In short, it is - - - recommended that a relay has at least 16 Mbit/s (Mbps) upload and download bandwidth available for Tor. More is better. - - - required that a Tor relay be allowed to use a minimum of 100 GByte of outbound and of incoming traffic per month. - - - recommended that a <40 Mbit/s non-exit relay should have at least 512 MB of RAM available; A relay faster than 40 Mbit/s should have at least 1 GB of RAM. - - -
-
- (Advanced) Usage as a SOCKS proxy - 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. -
- Example with Firefox - Your web browser can be configured to use the Tor network for all of your browsing activity. This allows for censorship circumvention and also hides your IP address from websites during regular browsing. For anonymity, using tor browser is recommended. - Configure your local FreedomBox IP address and port 9050 as a SOCKS v5 proxy in Firefox. There are extensions to allow for easily turning the proxy on and off. - - - - - - - Configuring Firefox with Tor SOCKS proxy - - - - With the SOCKS proxy configured, you can now access any onion URL directly from Firefox. FreedomBox itself has an onion v3 address that you can connect to over the Tor network (bookmark this for use in emergency situations). -
-
-
- 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 - - - -
-
-
- Transmission (BitTorrent Web Client) - - - - - - - - - - - - - Transmission icon - - - - - - - - - Available since: version 0.5 -
- 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. Transmission uses single sign-on from FreedomBox, which means that if you are logged in on your FreedomBox, you can directly access Transmission without having to enter the credentials again. Otherwise, you will be prompted to login first and then redirected to the Transmission app. -
-
- Tips -
- Transferring Downloads from the FreedomBox - - - Transmission's downloads directory can be added as a shared folder in the "Sharing" app. You can then access your downloads from this shared folder using a web browser. - - - (Advanced) If you have the ssh access to your FreedomBox, you can use sftp to browse the downloads directory using a suitable file manager or web browser (e.g. dolphin or Konqueror). - - -
-
-
-
- User Websites -
- What is User websites? - User websites is a module of the Apache webserver enabled to allow users defined in the FreedomBox system to expose a set of static files on the FreedomBox filesystem as a website to the local network and/or the internet according to the network and firewall setup. - - - - - - - - - Application basics - - - - - - Category - - - File sharing - - - - - Available since version - - - 0.9.4 - - - - - Upstream project website - - - - - - - - - - Upstream end user documentation - - - - - - - - - - -
-
- Screenshot - - Add when/if an interface is made for FreedomBox - -
-
- Using User websites - The module is always enabled and offers no configuration from the FreedomBox web interface. There is no configuration or status page shown for this module in the FreedomBox web interface. - To serve documents, place the files in the designated directory in a FreedomBox user's home directory in the filesystem. - This directory is: public_html - Thus the absolute path for the directory of a user named fbx with home directory in /home/fbx will be /home/fbx/public_html. User websites will serve documents placed in this directory when requests for documents with the URI path "~fbx" are received. For the the example.org domain thus a request for the document example.org/~fbx/index.html will transfer the file in /home/fbx/public_html/index.html. -
-
- Using SFTP to create public_html and upload documents - - To be written - -
-
-
-
- System -
- Backups - FreedomBox includes the ability to backup and restore data, preferences, configuration and secrets from most of the applications. The Backups feature is built using Borg backup software. Borg is a deduplicating and compressing backup program. It is designed for efficient and secure backups. This backups feature can be used to selectively backup and restore data on an app-by-app basis. Backed up data can be stored on the FreedomBox machine itself or on a remote server. Any remote server providing SSH access can be used as a backup storage repository for FreedomBox backups. Data stored remotely may be encrypted and in such cases remote server cannot access your decrypted data. -
- Status of Backups Feature - - - - - - - - - - App/Feature - - - - - Support in Version - - - - - Notes - - - - - - Avahi - - - - - - - no backup needed - - - - - Backups - - - - - - - no backup needed - - - - - Bind - - - 0.41 - - - - - - Cockpit - - - - - - - no backup needed - - - - - Coquelicot - - - 0.40 - - - includes uploaded files - - - - - Datetime - - - 0.41 - - - - - - Deluge - - - 0.41 - - - does not include downloaded/seeding files - - - - - Diagnostics - - - - - - - no backup needed - - - - - Dynamic DNS - - - 0.39 - - - - - - ejabberd - - - 0.39 - - - includes all data and configuration - - - - - Firewall - - - - - - - no backup needed - - - - - ikiwiki - - - 0.39 - - - includes all wikis/blogs and their content - - - - - infinoted - - - 0.39 - - - includes all data and keys - - - - - JSXC - - - - - - - no backup needed - - - - - Let's Encrypt - - - 0.42 - - - - - - Matrix Synapse - - - 0.39 - - - includes media and uploads - - - - - MediaWiki - - - 0.39 - - - includes wiki pages and uploaded files - - - - - Minetest - - - 0.39 - - - - - - MLDonkey - - - 19.0 - - - - - - Monkeysphere - - - 0.42 - - - - - - Mumble - - - 0.40 - - - - - - Names - - - - - - - no backup needed - - - - - Networks - - - No - - - No plans currently to implement backup - - - - - OpenVPN - - - 0.48 - - - includes all user and server keys - - - - - Pagekite - - - 0.40 - - - - - - Power - - - - - - - no backup needed - - - - - Privoxy - - - - - - - no backup needed - - - - - Quassel - - - 0.40 - - - includes users and logs - - - - - Radicale - - - 0.39 - - - includes calendar and cards data for all users - - - - - repro - - - 0.39 - - - includes all users, data and keys - - - - - Roundcube - - - - - - - no backup needed - - - - - SearX - - - - - - - no backup needed - - - - - Secure Shell (SSH) Server - - - 0.41 - - - includes host keys - - - - - Security - - - 0.41 - - - - - - Shadowsocks - - - 0.40 - - - only secrets - - - - - Sharing - - - 0.40 - - - does not include the data in the shared folders - - - - - Snapshot - - - 0.41 - - - only configuration, does not include snapshot data - - - - - Storage - - - - - - - no backup needed - - - - - Syncthing - - - 0.48 - - - does not include data in the shared folders - - - - - Tahoe-LAFS - - - 0.42 - - - includes all data and configuration - - - - - Tiny Tiny RSS - - - 19.2 - - - includes database containing feeds, stories, etc. - - - - - Tor - - - 0.42 - - - includes configuration and secrets such as onion service keys - - - - - Transmission - - - 0.40 - - - does not include downloaded/seeding files - - - - - Upgrades - - - 0.42 - - - - - - Users - - - No - - - No plans currently to implement backup - - - - - -
-
- How to install and use Backups - - Step 1 - - - - - - - - Backups: Step 1 - - - - - Step 2 - - - - - - - - Backups: Step 2 - - - - - Step 3 - - - - - - - - Backups: Step 3 - - - - - Step 4 - - - - - - - - Backups: Step 4 - - - - - Step 5 - - - - - - - - Backups: Step 5 - - - - - Step 6 - - - - - - - - Backups: Step 6 - - - - - Step 7 - - - - - - - - Backups: Step 7 - - - -
-
-
- BIND (Domain Name Server) - BIND enables you to publish your Domain Name System (DNS) information on the Internet, and to resolve DNS queries for your user devices on your network. - Currently, on FreedomBox, BIND is only used to resolve DNS queries for other machines on local network. It is also incompatible with sharing Internet connection from FreedomBox. - Note: This service is available only on networks configured as "internal" zone. It is not available when connected via OpenVPN. -
-
- Cockpit (Server Administration) - Cockpit is a server manager that makes it easy to administer GNU/Linux servers via a web browser. On a FreedomBox, controls are available for many advanced functions that are not usually required. A web based terminal for console operations is also available. - It can be accessed by any user on your FreedomBox belonging to the admin group. Cockpit is only usable when you have proper domain name setup for your FreedomBox and you use that domain name to access Cockpit. See the Troubleshooting section for more information. - - Use cockpit only if you are an administrator of GNU/Linux systems with advanced skills. FreedomBox tries to coexist with changes to system by system administrators and system administration tools like Cockpit. However, improper changes to the system might causes failures in FreedomBox functions. - -
- Using Cockpit - Install Cockpit like any other application on FreedomBox. Make sure that Cockpit is enabled after that. - - - - - - - cockpit-enable.png - - - - Ensure that the user account on FreedomBox that will used for Cockpit is part of the administrators group. - - - - - - - cockpit-admin-user.png - - - - Launch the Cockpit web interface. Login using the configured user account. - - - - - - - cockpit-login.png - - - - Start using cockpit. - - - - - - - cockpit-system.png - - - - Cockpit is usable on mobile interfaces too. - - - - - - - cockpit-mobile.png - - - -
-
- Features - The following features of Cockpit may be useful for advanced FreedomBox users. -
- System Dashboard - Cockpit has a system dashboard that - - - Shows detailed hardware information - - - Shows basic performance metrics of a system - - - Allows changing system time and timezone - - - Allows changing hostname. Please use FreedomBox UI to do this - - - Shows SSH server fingerprints - - - - - - - - - cockpit-system.png - - - -
-
- Viewing System Logs - Cockpit allows querying system logs and examining them in full detail. - - - - - - - cockpit-logs.png - - - -
-
- Managing Storage - Cockpit allows following advanced storage functions: - - - View full disk information - - - Editing disk partitions - - - RAID management - - - - - - - - - cockpit-storage1.png - - - - - - - - - - cockpit-storage2.png - - - -
-
- Networking - Cockpit and FreedomBox both rely on NetworkManager to configure the network. However, Cockpit offers some advanced configuration not available on FreedomBox: - - - Route configuration - - - Configure Bonds, Bridges, VLANs - - - - - - - - - cockpit-network1.png - - - - - - - - - - cockpit-network2.png - - - - - - - - - - cockpit-network3.png - - - -
-
- Services - Cockpit allows management of services and periodic jobs (similar to cron). - - - - - - - cockpit-services1.png - - - - - - - - - - cockpit-services2.png - - - -
-
- Web Terminal - Cockpit offers a web based terminal that can be used perform manual system administration tasks. - - - - - - - cockpit-terminal.png - - - -
-
-
- Troubleshooting - Cockpit requires a domain name to be properly setup on your FreedomBox and will only work when you access it using a URL with that domain name. Cockpit will not work when using IP address in the URL. Using freedombox.local as the domain name also does not work. For example, the following URLs will not work: - - Starting with FreedomBox version 19.15, using .local domain works. You can access Cockpit using the URL . The .local domain is based on your hostname. If your hostname is mybox, your .local domain name will be mybox.local and the Cockpit URL will be . - To properly access Cockpit, use the domain name configured for your FreedomBox.Cockpit will also work well when using a Tor Onion Service. The following URLs will work: - - The reason for this behaviour is that Cockpit uses WebSockets to connect to the backend server. Cross site requests for WebSockets must be prevented for security reasons. To implement this, Cockpit maintains a list of all domains from which requests are allowed. FreedomBox automatically configures this list whenever you add or remove a domain. However, since we can't rely on IP addresses, they are not added by FreedomBox to this domain list. You can see the current list of allowed domains, as managed by FreedomBox, in /etc/cockpit/cockpit.conf. You may edit this, but do so only if you understand web security consequences of this. -
-
-
- 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. The default hostname 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), Matrix Synapse, Certificates (Let's Encrypt), and Monkeysphere. - - -
-
- Webserver Home Page - - - This is an advanced option that allows you to set something other than FreedomBox Service as the home page 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 home page, visiting will take you to instead of the usual . You can set any web application, Ikiwiki wikis and blogs or Apache's default index.html page as the web server home page. - - - - Once some other app is set as the home page, you can only navigate to the FreedomBox Service by typing into the browser. - /freedombox can also be used as an alias to /plinth - - - - Tip: Bookmark the URL of FreedomBox Service before setting the home page to some other app. - - -
-
-
- 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 - - - -
-
- 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. -
-
- Dynamic DNS Client -
- What is Dynamic DNS? - In order to reach a server on the Internet, the server needs to have permanent address also known 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 immediately) - - -
-
-
- 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 FreedomBox web interface 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. If an interface is not assigned any zone, it is automatically assigned external 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. -
-
- Opening Custom Ports - Cockpit app provides advanced management of firewall. Both FreedomBox and Cockpit operate over firewalld and are hence compatible with each other. In particular, Cockpit can be used to open custom services or ports on FreedomBox. This is useful if you are manually running your own services in addition to the services provided by FreedomBox on the same machine. - - - - - - - firewalld-cockpit.png - - - -
-
- FreedomBox 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 Firewall status page in FreedomBox interface. - - - - - - - - - - - - - Service - - - - - Port - - - - - External - - - - - Enabled by default - - - - - Status shown in FreedomBox - - - - - Managed by FreedomBox - - - - - - Minetest - - - 30000/udp - - - - - - - - - {*} - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - XMPP Client - - - 5222/tcp - - - - - - - - - {*} - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - XMPP Server - - - 5269/tcp - - - - - - - - - {*} - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - XMPP Bosh - - - 5280/tcp - - - - - - - - - {*} - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - NTP - - - 123/udp - - - - - - - - - {o} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - FreedomBox Web Interface (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/udp - - - - - - - - - {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: - -
-
-
-
- Let's Encrypt (Certificates) - A digital certificate 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. -
-
-
- 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. -
-
- Name Services - Name Services provides an overview of ways the box can be reached from the public Internet: domain name, Tor Onion 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. -
-
- 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. -
- Problems with Privacy Feature - NetworkManager used by FreedomBox to connect to the Wi-Fi networks has a privacy feature that uses a different identity when scanning for networks and when actually connecting to the Wi-Fi access point. Unfortunately, this causes problems with some routers that reject connections from such devices. Your connection won't successfully activate and disconnect after trying to activate. If you have control over the router's behaviour, you could also turn off the feature causing problem. Otherwise, the solution is to connect with a remote shell using SSH or Cockpit, editing a file /etc/NetworkManager/NetworkManager.conf and adding the line wifi.scan-rand-mac-address=no in the [device] section. This turns off the privacy feature. - Edit a file: - - Add the following: - - Then reboot the machine. -
-
-
- 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. -
-
-
-
- Advanced Network Operations - Cockpit provides many advanced networking features over those offered by FreedomBox. Both FreedomBox and Cockpit operate over Network Manager and are hence compatible with each other. Some of the functions provided by Cockpit include: - - - Set the maximum transmission unit (MTU) for a network connection - - - Change the hardware address (MAC address) of a network interface - - - Add more DNS servers and configure routing of a network connection - - - Creating bonded devices for highly available network interfaces - - - Creating bridge devices to join network interfaces for aggregating separate networks - - - Manage VLAN for creating virtual partitions in the physical network - - - - - - - - - networks-cockpit.png - - - -
-
- 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 -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. -
-
-
- PageKite (Public Visibility) -
- 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 FreedomBox, 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. - - -
-
-
- Performance (System Monitoring) - Available since: version 20.9.7 - Performance app allows you to collect, store and view information about utilization of the hardware. This can gives you basic insights into usage patterns and whether the hardware is overloaded by users and services. - Performance metrics are collected by Performance Co-Pilot and can be viewed using the Cockpit app. When this system app is installed and enabled, cockpit's graphs shows the past (up to one year at a time). - - - - - - - performance-one-week.png - - - -
-
- 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. - "Restart" and "Shut Down" options can also be reached from the user dropdown menu on the top right. -
-
- Secure Shell (SSH) Sever -
- 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 -
- FreedomBox First Log In: Admin Account - When creating an account in FreedomBox's web interface 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 FreedomBox's web interface, then you don't need to do this. You can use the user account created in FreedomBox's web interface 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 FreedomBox 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 FreedomBox you have enabled onion 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 onion service address for your FreedomBox. -
-
- SSH Over Pagekite - If in FreedomBox you are using Pagekite to expose services to the Internet, you can access your FreedomBox using SSH over Pagekite. On a GNU/Linux computer install netcat-openbsd. - - Edit ~/.ssh/config to enable connections over Pagekite. - - Add the following: - - Now to connect to FreedomBox, open a terminal and type: - - Replace USERNAME with, e.g., an admin username, and KITENAME with your kite name provided by pagekite.net as configured in 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 FreedomBox's web interface, use the change password page. However, the fbx default user is not managed by FreedomBox's web interface and its password cannot be changed through it. - 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. -
-
-
- Security - When the Restrict console logins option is enabled, only users in the admin group will be able to log in via console, secure shell (SSH) or graphical login. When this option is disabled, any user with an account on FreedomBox will be able to log in. They may be able to access some services without further authorization. This option should only be disabled if all the users of the system are well trusted. If you wish to use your FreedomBox machine also as a desktop and allow non-admin users to login via GUI, this option must be disabled. You can define the list of users belonging to admin group in the Users section. - - - - - - - Security.png - - - -
-
- 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. -
-
- Storage - Storage allows you to see the storage devices attached to your FreedomBox and their disk space usage. - FreedomBox can automatically detect and mount removable media like USB flash drives. They are listed under the Removable Devices section along with an option to eject them. - If there is some free space left after the root partition, the option to expand the root partition is also available. This is typically not shown, since expanding the root partition happens automatically when the FreedomBox starts up for the first time. - - - - - - - Storage.png - - - -
- Advanced Storage Operations - Cockpit provides many advanced storage features over those offered by FreedomBox. Both FreedomBox and Cockpit operate over Udisks2 storage daemon and are hence compatible with each other. Some of the functions provided by Cockpit include: - - - Format a disk or partition with a fresh filesystem - - - Add, remove partitions or wipe the partition table - - - Create and unlock encrypted file systems - - - Create and manage RAID devices - - - - - - - - - storage-cockpit.png - - - -
-
-
- Storage 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 - - - -
-
- Software Updates - FreedomBox can automatically install security updates. On the Update page of the System section in FreedomBox web interface you can turn on automatic updates. 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. - Updates 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 updates happen. Alternatively, you can perform manual updates as described below. - Note that once the updates start, it may take a long time to complete. During automatic update process that runs every night or during manual update process, you will not be able to install apps from FreedomBox web interface. - - - - - - - upgrades.png - - - -
- When Will I Get the Latest Features? - Although updates are done every day for security reasons, latest features of FreedomBox will not propagate to all the users. The following information should help you understand how new features become available to users. - Stable Users: This category of users include users who bought the FreedomBox Pioneer Edition, installed FreedomBox on a Debian stable distribution or users who downloaded the stable images from freedombox.org. As a general rule, only security updates to various packages are provided to these users. One exception to this rule is where FreedomBox service itself is updated when a release gains high confidence from developers. This means that latest FreedomBox features may become available to these users although not as quickly or frequently as testing users. If an app is available only in testing distribution but not in stable distribution, then that app will show up in the web interface but will not be installable by stable users. Some apps are also provided an exception to the rule of "security updates only" when the app is severely broken otherwise. Every two years, a major release of Debian stable happens with the latest versions of all the software packages and FreedomBox developers will attempt to upgrade these users to the new release without requiring manual intervention. - Testing Users: This category of users include users who installed FreedomBox on a Debiantesting distribution or users who downloaded the testing images from freedombox.org. Users who use Debian testing are likely to face occasional disruption in the services and may even need manual intervention to fix the issue. As a general rule, these users receive all the latest features and security updates to all the installed packages. Every two weeks, a new version of FreedomBox is released with all the latest features and fixes. These releases will reach testing users approximately 2-3 days after the release. - Unstable Users: This category of users include users who installed FreedomBox on a Debianunstable distribution or users who downloaded the unstable images from freedombox.org. Users who use Debian unstable are likely to face occasional disruption in the services and may even need manual intervention to fix the issue. As a general rule, these users receive all the latest features to all the installed packages. Every two weeks, a new version of FreedomBox is released with all the latest features and fixes. Theses releases will reach unstable users on the day of the release. Only developers, testers and other contributors to the FreedomBox project should use the unstable distribution and end users and advised against using it. -
-
- Manual Updates from Web Interface - To get updates immediately and not wait until the end of the day, you may want to trigger updates manually. You can do this by pressing the Update now button in Manual update tab for Update page in System section. Note that this step is not necessary if you have enabled Auto-updates as every night this operation is performed automatically. - When installing apps you may receive an error message such as - - This is typically caused by shutting down FreedomBox while it is installing apps, while performing daily updates or during some other operations. This situation can be rectified immediately by running manual update. -
-
- Manual Updates from Terminal - Some software packages may require manual interaction for updating due to questions related to configuration. In such cases, FreedomBox updates itself and brings in new knowledge necessary to update the package by answering configuration questions. After updating itself, FreedomBox acts on behalf of the user and updates the packages by answering the questions. Until FreedomBox has a chance to update the package, such packages should not be be updated manually. The manual update triggered from the web interface is already mindful of such packages and does not update them. - In some rare situations, FreedomBox itself might fail to update or the update mechanism might fall into a situation that might need manual intervention from a terminal. To perform manual upgrades on the terminal, login into FreedomBox on a terminal (if you have monitor and keyboard connected), via a web terminal (using FreedomBox/Manual/Cockpit) or using a remote secure shell (see Secure Shell section). Then run the following commands: - -# dpkg --configure -a -# apt update -# apt -f install -# unattended-upgrade --debug -# apt install freedombox -# apt update]]> - If apt-get update asks for a confirmation to change Codename or other release information, confirm yes. If during update of freedombox package, if a question about overwriting configuration files is asked, answer to install new configuration files from the latest version of the package. This process will upgrade only packages that don't require configuration file questions (except for freedombox package). After this, let FreedomBox handle the upgrade of remaining packages. Be patient while new releases of FreedomBox are made to handle packages that require manual intervention. - If you want to go beyond the recommendation to upgrade all the packages on your FreedomBox and if you are really sure about handling the configuration changes for packages yourself, run the following command: - -
-
-
- 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 - - - bit-torrent - - - ed2k - - - feed-reader - - - syncthing - - - web-search - - - 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). - A user's groups 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 - - - In Debian Stretch, the FreedomBox web interface does not distinguish between users and administrators. Every user added will have full access to the web interface. - - - This issue is fixed in Debian Buster and later. - - - - -
-
-
-
- Hardware - FreedomBox is designed to be the software for a consumer electronics device that is easy to setup, maintain and use. The project does not aim to create a custom hardware device ourselves, but instead we intend to partner with hardware vendors to build FreedomBox devices and also support existing hardware. Typically, it is run on single board computers because of their small form factor, low power consumption and favourable price. Some users also run it on old/refurbished desktop or laptop computers or even on virtual machines running on their primary computers. - In addition to supporting various single board computers and other devices, any Debian machine can be turned into a FreedomBox by installing the freedombox package. Debian, the universal operating system, supports a much wider range on hardware. After installing Debian, see the manual page for installing FreedomBox on Debian. -
- Recommended Hardware - On April 22nd, 2019, the FreedomBox Foundation announced the sales of the Pioneer Edition FreedomBox Home Server Kits. This is the recommended pre-installed hardware for all users who don't wish to build their own FreedomBox by choosing the right components, downloading the image and preparing an SD card with FreedomBox. - The kit includes all the hardware needed for launching a FreedomBox home server on an Olimex A20-OLinuXino-LIME2 board. This product provides the perfect combination of open source hardware and free and open source software. By purchasing this product, you also support the FreedomBox Foundation's efforts to create and promote its free and open source server software. - - - - - - - - - - - - - - Pioneer Edition FreedomBox Home Server Kits - - - - - - Pioneer Edition FreedomBox Home Server Kits - - - - - - -
-
- Supported Hardware - Use these hardware if you are able to download FreedomBox images and prepare an SD card by following the manual. If you wish for simper setup process, please buy the FreedomBox kits from recommended hardware instead. Look at the list of known issues with a hardware before buying it. - - - - - - - - - - - - - - - - A20 OLinuXino Lime2 - - - - - - A20 OLinuXino Lime2 - - - - - - - - - - - A20 OLinuXino MICRO - - - - - - A20 OLinuXino MICRO - - - - - - - - - - - PC Engines APU - - - - - - PC Engines APU - - - - - - - - - - - - - Cubietruck - - - - - - Cubietruck - - - - - - - - - - - Cubieboard 2 - - - - - - Cubieboard2 - - - - - - - - - - - BeagleBone Black - - - - - - BeagleBone Black - - - - - - - - - - - - - pcDuino3 - - - - - - pcDuino3 - - - - - - - - - - - Debian - - - - - - Debian - - - - - - - - - - - VirtualBox - - - - - - VirtualBox - - - - - - - - - - - - - Pine A64+ - - - - - - Pine A64+ - - - - - - - - - - - Banana Pro - - - - - - Banana Pro - - - - - - - - - - - Orange Pi Zero - - - - - - Orange Pi Zero - - - - - - - - - - - - - - - - - - - - - - RockPro64 - - - - - - RockPro64 - - - - - - - - - - - Rock64 - - - - - - Rock64 - - - - - - - -
- Hardware Comparison - - - - - - - - - - - - - - - - Name - - - - - Speed (GHz) - - - - - Debian arch - - - - - Ram (GB) - - - - - disk (GB) - - - - - battery - - - - - SATA - - - - - Ethernet speed - - - - - - OSHW - - - - - - - APU.1D - - - 1x2 - - - amd64 - - - 2 - - - - - - - - - - - - - - - - - (./) - - - - - - 1000x3 - - - - - - - - - {X} - - - - - - - - APU.1D4 - - - 1x2 - - - amd64 - - - 4 - - - - - - - - - - - - - - - - - (./) - - - - - - 1000x3 - - - - - - - - - {X} - - - - - - - - BeagleBone Black C - - - 1 - - - armhf/omap - - - ½ - - - 4 - - - - - - - - - - - 100 - - - - - - - - - (./) - - - - - - - - Cubieboard2 - - - 1x2 - - - armhf/sunxi - - - 1 - - - 4 - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - 100 - - - - - - - - - {X} - - - - - - - - Cubieboard2-Dual - - - 1x2 - - - armhf/sunxi - - - 1 - - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - 100 - - - - - - - - - {X} - - - - - - - - Cubieboard3/Cubietruck - - - 1x2 - - - armhf/sunxi - - - 2 - - - 8 - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - 1000 - - - - - - - - - {X} - - - - - - - - OLinuXino A20 LIME - - - 1x2 - - - armhf/sunxi - - - ½ - - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - 100 - - - - - - - - - (./) - - - - - - - - OLinuXino A20 LIME2 - - - 1x2 - - - armhf/sunxi - - - 1 - - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - 1000 - - - - - - - - - (./) - - - - - - - - OLinuXino A20 MICRO - - - 1x2 - - - armhf/sunxi - - - 1 - - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - 100 - - - - - - - - - (./) - - - - - - - - pcDunino3 - - - 1x2 - - - armhf/sunxi - - - 1 - - - 4 - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - 100 - - - - - - - - - {X} - - - - - - - - Pine A64+ - - - 1.2x4 - - - arm64/sunxi - - - ½,1,2 - - - - - - - - - - - - - - - 1000 - - - - - - - - - {X} - - - - - - - - Banana Pro - - - 1.2x2 - - - armhf/sunxi - - - 1 - - - - - - - - - - - - - - - - - (./) - - - - - - 1000 - - - - - - - - - {X} - - - - - - - - Orange Pi Zero - - - ?x4 - - - armhf/sunxi - - - ¼,½ - - - - - - - - - - - - - - - 100 - - - - - - - - - {X} - - - - - - - - RockPro64 - - - 1.4x4+1.8x2 - - - arm64 - - - 2,4 - - - 16,32,64,128 - - - - - - - - - - - - - (./) - - - - - - 1000 - - - - - - - - - {X} - - - - - - - - Rock64 - - - 1.5x4 - - - arm64 - - - 1,2,4 - - - 16,32,64,128 - - - - - - - - - - - - - (./) - - - - - - 1000 - - - - - - - - - {X} - - - - - - - - -
-
-
- Additional Hardware -
- Also Working Hardware - This hardware works but is not recommended because the hardware can't run entirely on free software: - - - - - - - - - - - - - - - - Raspberry Pi 2 - - - - - - Raspberry Pi 2 - - - - - - - - - - - Raspberry Pi 3 Model B - - - - - - Raspberry Pi 3 Model B - - - - - - - - - - - Raspberry Pi 3 Model B+ - - - - - - Raspberry Pi 3 Model B+ - - - - - - - - - - - - - Raspberry Pi 4 B - - - - - - Raspberry Pi 4 B - - - - - - - - -
-
- Hardware Supported with Generic Images - If you already have hardware that you wish turn into a FreedomBox, don't let the limited list of supported hardware discourage you. If you are using AMD or Intel architecture machines, you can download the generic images of that specific architecture that image will work on any machine of that architecture. For ARM 32-bit or ARM 64-bit architectures, we have a similar solution. - Starting with August 2020, we started building generic images that would work for all single board computers based on a solution involving UEFI standards and u-boot firmware. In this approach, a small board specific firmware resides on an SPI flash or an SD card. It is responsible for loading a generic FreedomBox image that is placed in an SD card, a USB drive, a SATA drive or an NVMe drive. So, for your hardware, find and get a u-boot based firmware from your board manufacturer and place it on an SPI flash or an SD card. Next, ensure that that kernel in FreedomBox has support for your board and place it on any of the other storage disks. This approach should work well for a lot of boards that are not listed as specifically supported. See firmware section for more details. - We continue to build images specific to some hardware as we used to earlier. These images have the slight advantage that they are easier to setup because of less step involved. We intend, however, to phase out these images because they can't be booted from all the storage devices and involve development overhead limiting the number of boards we support. -
-
- Adding Hardware Support - If your hardware is not listed above but you were able to get it working using the above described method of using a generic image, drop us a line and we will list it as supported. Further, take a look at the list of targeted hardware for boards to support. -
-
- Deprecated Hardware - This hardware was supported earlier but is no longer supported. If you downloaded an earlier image and are running FreedomBox on one of these hardware, you will keep getting software updates. However, no new images will be provided for these hardware. It is recommended that you migrate to newer, supported hardware using backup and restore. - - - - - - - - - - - - - - - DreamPlug - - - - - - DreamPlug - - - - - - - - - - - Raspberry Pi - - - - - - Raspberry Pi - - - - - - - Note: Supported Hardware means that FreedomBox images are built for said hardware and at least one developer has reported the basic functions to be working. -
-
-
- Common Hardware Information - The following sections document common advice related to hardware and peripherals when using them with FreedomBox. -
- Wi-Fi - FreedomBox can use Wi-Fi hardware for two separate purposes. It can be used to provide internet connectivity or it can be used to share internet connectivity already available to FreedomBox (via Ethernet, 3G/4G or another Wi-Fi interface) with devices on the network. See the Networks manual page for instructions on how to configure FreedomBox for these two cases. - Unfortunately, most built-in Wi-Fi adapters and add-on Wi-Fi adapters require firmware that is not free software. So, FreedomBox recommends attaching a USB Wi-Fi device that does not require non-free firmware. Supported devices automatically show up in the network interface list when configuring networks. - If you have a Wi-Fi device, either built-in or as an add-on, that requires non-free firmware and you are willing to install non-free firmware to get it working, see the Debian wiki page. Once the firmware is installed and the device shows up, it can be configured and used by FreedomBox. -
-
- Power Supply - On single board computers, one can easily encounter situations where the board and its peripherals are not provided sufficient power and malfunction in unpredictable ways. To avoid this, use a power adapter that can supply the minimum current recommended by the hardware manufacturer. When additional peripherals such as USB drives, Wi-Fi devices, SATA drives or NVMe drives are attached, the power requirements increase. A power supply that can provide higher current than needed is preferable but voltage should match the manufacturer recommendation exactly. Keep in mind that some cheap power supplies don't supply the current they promise to. -
-
- Firmware - Desktops, laptops and virtual machines have software that runs during machine start-up called UEFI/BIOS. This software, sometimes called firmware, can load and hand over control to the operating system (in our case FreedomBox), when it is present on any of the storage devices. This is not the case with most single board computers. - Single board computers ship with very small amount of software that is typically limited to booting OS from SD cards or eMMCs. They usually can't boot from USB disks, SATA disks or NVMe disks. To remedy this situation, hardware manufacturers started adding a special storage device called SPI flash which is only a few MiB in size. A special software, which we call firmware here, typically based on free and open source boot loader called u-boot is placed in this SPI flash. When the computer starts up, it starts the boot-loader from SPI flash which will in turn load the operating system. Since the firmware is much more powerful, it has the ability to load the OS from any of the storage media. Examples of single board computers with SPI flash include A20-OLinuXino-Lime2 and RockPro64. - This firmware approach can be used even when SPI flash is not available. Say, one wants to boot from a USB drive and the board does not support booting from it. Firmware can be installed on an SD card (a very tiny one is sufficient) and inserted into the board. Then USB disk will contain FreedomBox as we wish it. When the board starts, it boots the firmware from SD card which in turn boots the operating system from USB drive or any other storage. - This firmware approach also allows us to use generic download images that work for a large number of hardware boards. While increasing the effort for the user a bit more, it has the advantage of allowing us to support a lot more hardware and allow the OS to be present on any storage media. - When special firmware is needed for a single board computer, FreedomBox manual for the board discusses how to to obtain and install the firmware before proceeding with installation of FreedomBox. -
-
- Storage - FreedomBox can run from various storage media supported by your computer. Choosing the storage is about balancing reliability, capacity and speed against cost. A minimum storage capacity of 8GB is recommended for running FreedomBox. -
- Secure Digital (SD) Card - SD cards are common on single board computers. Most single board computers can boot directly from an SD card without any additional tweaks. - SD cards are typically slowest among the available storage media. Expect your FreedomBox to perform certain operations slower on these disks. Not all SD cards perform similarly and some perform much better than others. When buying an SD card, pick a card with a speed class of at least 10 (written on the card as a circle around the number 10) or UHS speed class 1 (written on the card as a number 1 inside a bucket). UHS speed class 3 (written on the card as number 3 inside a bucket) or application speed class 1 or above (written as A1 and A2) will perform much better. Finally, users of FreedomBox have reported cases where SD cards have failed. So, other storage media should be preferred for higher reliability. -
-
- Embedded MultiMediaCard (eMMC) - Many recently released single board computers support eMMC cards. Most single board computers can boot directly from an eMMC without any additional tweaks. - eMMC is sometimes soldered onto the board and you will need to choose the size of eMMC when buying the board. An example of this is the Olimex's A20-OLinuXino-Lime2 board. Other times, a manufacturer will provide eMMC as pluggable peripheral. With this approach, you can add eMMC after you buy the board or upgrade existing one with higher capacity. Do not detach and reattach such pluggable eMMCs too often. They have a very limited number of wear cycles (< 100). - eMMC are much faster than SD cards and spinning disk HDDs but are significantly slower than SSDs. They have much better random write speeds which are needed for many FreedomBox operations. In general, they should be preferred over SD cards. - FreedomBox image can be setup on an eMMC in two ways. For a detachable eMMC, there are eMMC to USB converters available. Detach the eMMC from the board, attach it to the USB converter and plug it into your machine and proceed with writing FreedomBox on it as one would for an SD card. In case the eMMC is not detachable, boot the computer with a media other than the eMMC such as an SD card or USB disk. It could be any operating system. After booting, the eMMC will show up as an additional disk. Download and write FreedomBox image onto it as one would for an SD card. -
-
- USB Disk Drive - Most computers and single board computers have USB ports. These ports accept storage media such as USB flash drives, SSDs or HDDs. - A USB flash drive can also serve as a storage medium for running FreedomBox. USB 2.0 flash drives are much slower and comparable to SD cards in their performance. USB 3.0 flash drives yield much better performance. Both USB flash drives and SD cards use similar technology so the read/write cycles and hence the reliability as similarly limited. - Apart from USB flash drives, solid state drives (SSDs) and hard disk drives (HDDs) can be inserted into USB ports. This is possible either by buying drives with USB interface or by using convertors such as USB to SATA or USB to M.2 interface. Both SSDs and HDDs have much higher reliability compared to SD cards, eMMC or USB flash drives. These should be preferred whenever possible. In addition, SSDs provide excellent performance when connected via USB 3.0 interface. - When connecting SSDs and HDDs to USB ports on single board computers, care should be taken about the power supply to the drive. If the drive has an extra power supply there is nothing to worry about. Otherwise, ensure that the single board computer is able to power the drive by checking the power requirements of the drive and what the board supports. For the board, always use a power adapter that can supply the minimum current recommended by the hardware manufacturer. Power supply that can provide higher current than needed is preferable but the voltage supplied should match the manufacturer recommendation exactly. Keep in mind that some cheap power supplies don't supply the current they promise to. - Setting up a FreedomBox image on a USB (flash, SSD or HDD) drive can be straight forward as most computers have USB ports. Plug-in the USB drive to your computer, download and write the FreedomBox image to the USB drive. While laptops, desktops and virtual machines can boot from a USB drive without intervention, many single board computers can't boot from USB drives. To address this, a separate firmware is needed. See firmware section for setting this up. -
-
- SATA disk drive - Some desktops, laptops and single board computers support a SATA interface to connect a solid state drive (SSD) or a hard disk drive (HDD). An example of a single board computer supporting SATA interface is the Olimex's A20-OLinuXino-Lime2. SATA protocol is also used for mSATA ports or M.2 slots (with a B-Key or an M-key). Both SSDs and HDDs have much higher reliability compared to SD cards, eMMC or USB flash drives. SATA interface provides very good data transfer rates (but not as good as NVMe drives based on PCIe). These should be preferred over SD cards, eMMCs or USB flash drives whenever possible. - When connecting SSDs and HDDs to SATA ports on single board computers, care should be taken about the power supply to the drive. If the drive has an extra power supply there is nothing to worry about. Otherwise, ensure that the single board computer is able to power the drive by checking the power requirements of the drive and what the board supports. Always use a power adapter that can supply the minimum current recommended by the hardware manufacturer. Power supply that can provide higher current than needed is preferable but voltage should match the recommendation exactly. Keep in mind that some cheap power supplies don't supply the current they promise to. - To setup FreedomBox image on a SATA disk drive, boot the computer with a media other than the SATA disk such as an SD card. It could be any operating system. After booting, the SATA disk will show up as an additional disk. Download and write FreedomBox image onto it as one would for an SD card. While laptops, desktops and virtual machines can boot from a SATA drives without additional intervention, many single board computers can't boot from SATA drives. To address this, a separate firmware disk is needed. See firmware section for setting this up. -
-
- NVMe disk drive - Most desktops, laptops and some single board computers support an NVMe interface to connect a solid state drive (SSD). This support is provided either with an M.2 slot (with a B-key or an M-key) or by providing a PCIe expansion slot. If a PCIe expansion slot is provided, a PCIe to M.2 convertor can be used to accommodate an NVMe drive. An example of a single board computer supporting an M.2 slot is the Radxa's Rock Pi 4 board. An example of single board computer providing PCIe slot is the Pine64's RockPro64 board. NVMe based SSD have much higher reliability compared to SD cards, eMMC or USB flash drives. NVMe drives provide the fastest data transfer rates. These should be preferred over all other types of drives whenever possible. - When connecting NVMe drives to single board computers, care should be taken about the power supply to the drive. Ensure that the single board computer is able to power the drive by checking the power requirements of the drive and what the board supports. Always use a power adapter that can supply the minimum current recommended by the hardware manufacturer. Power supply that can provide higher current than needed is preferable but voltage should match the manufacturer recommendation exactly. Keep in mind that some cheap power supplies don't supply the current they promise to. - To setup FreedomBox image on an NVMe disk drive, boot the computer with a media other than the NVMe disk such as an SD card. It could be any operating system. After booting NVMe disk will show up as an additional disk. Download and write FreedomBox image onto it as one would for an SD card. While laptops, desktops and virtual machines can boot from NVMe drives without intervention, many single board computers can't boot from NVMe drives. To address this a separate firmware disk is needed. See firmware section for setting this up. -
-
-
-
- Building Your Own Images - All FreedomBox disk images for different hardware is built by the project using a tool known as Freedom Maker. If for some reason, you wish to build your own images instead of downloading the provided images, use this tool. The README file in the project provides information about the list of hardware build targets available and how to build images. -
- Status of Software Used - - - All the software present in FreedomBox images is from Debian repositories. There are some minor tweaks done by the Freedom Maker script. - - - All software present in the images is DFSG compliant free software except in case of Raspberry Pi images where the firmware package is non-free software. - - - All images use the Linux kernel from Debian which is in turn based on the mainline Linux kernel. - - -
-
-
- Pioneer Edition FreedomBox - Pioneer FreedomBox Home Servers are produced and sold by Olimex, a company which specializes in Open Source Hardware (OSHW). The kit includes pocket-sized server hardware, an SD card with the operating system pre-installed, and a backup battery which can power the hardware for 4-5 hours in case of outages. It sells for 69 euro. An optional storage add-on for high capacity hard disk (HDD) or solid-state drive (SSD) is also available from Olimex. By purchasing this product, you also support the FreedomBox Foundation's efforts to create and promote its free and open source server software. - - - - - - - Pioneer Edition FreedomBox Home Server Kit - - - -
- Product Features - The Pioneer Edition FreedomBox Home Server Kit includes all the hardware needed for launching a FreedomBox home server on an Olimex A20-OLinuXino-LIME2 board: - - - the A20-OlinuXino-LIME2, - - - a custom metal case with a laser-engraved FreedomBox logo, - - - a high-speed 32GB micro SD card with the FreedomBox software pre-installed, - - - a backup battery, - - - a power adapter, and - - - an Ethernet cable. - - - an optional storage add-on for hard disk (HDD) or solid-state drive (SSD) - - -
-
- Recommended Hardware - This is the hardware recommended for all users who just want a turn-key FreedomBox, and don't want to build their own one. - (Building your own FreedomBox means some technical stuff like choosing and buying the right components, downloading the image and preparing the SD card). -
-
- Availability - The Pioneer Edition FreedomBox Home Server is the first commercially available version of FreedomBox. - - - Price: 69 EUR - - - - Olimex Store - - - - The US version is also available through Mouser Electronics. - - -
-
- Hardware Specifications - Pioneer Edition FreedomBox Home Server is based on A20-OLinuXino-LIME2 Rev.G. - - - Open Source Hardware (OSHW): Yes - - - CPU: Allwinner A20, ARM Cortex-A7 @ 1GHz dual-core - - - RAM: 1 GiB DDR3 - - - Storage: 32GB class 10+ microSD card pre-loaded with FreedomBox - - - SATA: 1 SATA port 2.6 compliant 3Gb/s - - - USB: 2 USB 2.0 Hi-Speed host ports - - - Battery: 3.3V Li-Po, 1400mAh (4-5 hours of backup without additional devices connected via USB) - - - Ethernet: 10/100/1000, RJ45 (1 meter cable included) - - - Power adapter: 110-220 V input, 5V output, EU style (with optional UK or US sockets) - - - Power consumption: 1.5W and 5W depending on load (0.3A to 1A current) - - - Box: Custom metallic box with FreedomBox decal - - - Further information: - - - - Quick start leaflet - - - - - Hardware source files - - - - - A20-OLinuXino-LIME2 rev.G schematic - - - - - A20 SOC datasheet - - - - The kits run entirely on Free Software. They work with Kernel and u-boot from Debian repositories. Even the boot firmware in ROM called BROM is free software (GPLV2+). -
-
- Storage Add-on - You can order a storage add-on along with the Pioneer Edition FreedomBox Home Server. The storage add-on is a SATA disk drive enclosure case optionally with a hard disk or solid-state drive of size 128GB to 2000GB. If you have already purchased the Home Server without the add-on, you can order the add-on separately. - - - - Olimex Store - - - - Price: 9 EUR (without the hard disk, only for the case, you need to add your own HDD/SSD to it) - - - Price: 42 EUR (with 128GB Solid-State Drive) - - - Price: 69 EUR (with 512GB Solid-State Drive) - - - Price: 42 EUR (with 320GB Hard Disk) - - - Price: 53 EUR (with 500GB Hard Disk) - - - Price: 64 EUR (with 1000GB Hard Disk) - - - Price: 86 EUR (with 2000GB Hard Disk) - - -
-
- Download - The kits come with an SD card pre-loaded with FreedomBox. There's NO need to download images. - However, if you wish to reset your devices to a pristine state, then you can do so with the image provided. Follow the instructions on the download page to create a FreedomBox SD card and boot the device. Make sure to download the Pioneer Edition images. These SD card images are meant for use with the on-board SD card slot and won't work when used with a separate SD card reader connected via USB. - An alternative to downloading these images is to install Debian on the device and then install FreedomBox on it. -
-
- Build Image - FreedomBox images for this hardware can be built using Freedom Maker. -
-
- Known Issues - - - The image that shipped with the kits uses a slightly modified u-boot from Debian and not stock Debian like the rest of FreedomBox. So, if you wish to get the source code, please use the FreedomBox team's u-boot repository. - - -
-
- Obtaining Source Code - After you purchase and receive your Pioneer Edition FreedomBox, you may want to obtain the source code of the software running in it. Continue reading this section for instructions. - FreedomBox is fully free software and you can obtain the source code to study, modify and distribute improvements. -
- From within FreedomBox - FreedomBox is made up of several software programs and you can obtain the source code to any of them. These instructions are similar to obtaining and building source code for Debian since FreedomBox is a pure blend of Debian. Using this process you can obtain the source code to the exact version of the package you are currently using in FreedomBox. - - - To see the list of software packages installed on your FreedomBox, run the following in a terminal: - - - - To obtain the source code for any of those programs, then run: - ]]> - This requires that the file /etc/apt/sources.list file contains the information about the source code repositories. These are present by default on all FreedomBox images. If you have installed FreedomBox using a package from Debian, you need to ensure that source repositories are added in the file. - - - To build the package from source code, first install its dependencies - ]]> - Switch to the source directory created by the apt source command: - ]]> - Then build the package - - - - Install the package: - .deb]]> - - -
-
- Other Ways to Obtain Source Code - - - Source code for any of the packages can be browsed and searched using the web interface at sources.debian.org. For example, see the plinth package. - - - Source code and pre-built binary package for any version of a package including historic versions can be obtained from snapshot.debian.org. For example, see the plinth package. - - - You can also obtain the links to upstream project homepage, upstream version control, Debian's version control, changelog, etc. from the Debian tracker page for a project at tracker.debian.org. For example, see the tracker page for plinth package. - - - You can build and install a package from its Debian's version control repository. For example, - - - -
-
- Building Disk Images - You can also build FreedomBox disk images for various hardware platforms using the freedom-maker tool. This is also available as a Debian package and source code for it may be obtained using the above methods. Build instructions for creating disk images are available as part of the source code for freedom-maker package. - FreedomBox disk images are built and uploaded to official servers using automated Continuous Integration infrastructure. This infrastructure is available as source code too and provides accurate information on how FreedomBox images are built. -
-
- U-boot on Pioneer Edition Images - There is one minor exception to the u-boot package present on the hardware sold as FreedomBox Home Server Kits Pioneer Edition. It contains an small but important fix that is not part of Debian sources. The fork of the Debian u-boot source repository along with the minor change done by the FreedomBox is available as a separate repository. We expect this change to be available in upstream u-boot eventually and this repository will not be needed. This package can be built on a Debian armhf machine as follows (cross compiling is also possible, simply follow instructions for cross compiling Debian packages): - - The u-boot Debian package will be available in u-boot-sunxi*.deb. This package will contain - -dd if=temp/usr/lib/u-boot/A20-OLinuXino-Lime2/u-boot-sunxi-with-spl.bin of= seek=8 bs=1k conv=notrunc]]> - The resulting image will have the modified u-boot in it. -
-
-
-
- Cubietruck -
- FreedomBox Danube Edition - - - - - - - FreedomBox Danube Edition - - - - FreedomBox Danube Edition is a custom casing around Cubietruck and an SSD-hard drive. -
-
- Cubietruck / Cubieboard3 - Cubietruck (Cubieboard3) is a single board computer with very good performance compared to many other boards. FreedomBox images are built for this device. - Important: Read general advice about hardware before building a FreedomBox with this single board computer. -
-
- Download - FreedomBox SD card images are provided for this hardware. These SD card images are meant for use with the on-board SD card slot and do not work when used with a separate SD card reader connected via USB. - An alternative to downloading these images is to install Debian on the Cubietruck and then install FreedomBox on it. -
-
- Availability - Cubietruck / Cubieboard3 - - - Price: 89 USD - - - - List of suppliers - - - -
-
- Hardware - - - Open Hardware: No - - - CPU: Allwinner A20, ARM Cortex-A7 @ 1GHz dual-core - - - RAM: 2 GiB DDR3 @ 480 MHz - - - Storage: 8 GB NAND flash built-in, 1x microSD slot - - - Architecture: armhf - - - Ethernet: 10/100/1000, RJ45 - - - WiFi: Broadcom BCM4329/BCM40181 (no free WiFi drivers + firmware available) - - - SATA: 1x 2.0 port - - -
-
- Non-Free Status - - - Non-free blobs required: ? - - - WiFi: no free WiFi drivers + firmware available - - -
-
- Known Issues - - - The on-board WiFi does not work with free software. A separate USB WiFi device is recommended. - - -
-
-
- Beagle Bone Black - - - - - - - Beagle Bone Black - - - - Beagle Bone Black (Revision C.1) is an Open Source Hardware (OSHW) single board computer. This means that the designer is actively helping people using the platform for their own designs, and supports them in adding hardware functionality and production advice. This is a part of freedom that is often overlooked, but very much aligned with the FreedomBox goals. FreedomBox images are built and tested for this device. - Important: Read general advice about hardware before building a FreedomBox with this single board computer. -
- Download - FreedomBox SD card images are available for this device. Follow the instructions on the download page to create a FreedomBox SD card and boot the device. - Note: This image is for BeagleBone Black (Revision C.1) only. It will not work on the BeagleBone Green, and also not on the Revisions A&B. If you have such a device and would like to help getting FreedomBox to run on it, contact us! - An alternative to downloading these images is to install Debian on the BeagleBone and then install FreedomBox on it. -
-
- Availability - - - Price: ~ 59 USD (50 EUR) - - - - Mouser Electronics - - - - - Full list of suppliers - - - -
-
- Hardware - - - Open Source Hardware (OSHW): Yes - - - CPU: AM335x 1GHz ARM Cortex-A8 - - - RAM: 512MB DDR3L 800 Mhz - - - Storage: Onboard 4GB, 8bit Embedded MMC and microSD - - - Architecture: armhf - - - Ethernet: 10/100, RJ45 - - - WiFi: None, use a USB WiFi device - - - SATA: None - - -
-
- Non-Free Status - - - Non-free blobs required: No - - - WiFi: Not available - - -
-
-
- A20 OLinuXino Lime2 - - - - - - - A20 OLinuXino Lime2 - - - - Olimex's A20 OLinuXino Lime2 is a fully Open Source Hardware (OSHW) single board computer. This means that the designer is actively helping people using the platform for their own designs, and supports them in adding hardware functionality and production advice. This is a part of freedom that is often overlooked, but very much aligned with the FreedomBox goals. It uses the Allwinner A20 Dual Core ARM processor. - Important: Read general advice about hardware before building a FreedomBox with this single board computer. -
- Similar Hardware - The following similar hardware will also work well with FreedomBox. - - - Olimex's A20 OLinuXino Lime2 4GB. This hardware merely has extra 4GB NAND storage that is not used by FreedomBox. - - -
-
- Download - FreedomBox SD card images are available for this device. Follow the instructions on the download page to create a FreedomBox SD card and boot the device. These SD card images are meant for use with the on-board SD card slot and won't work when used with a separate SD card reader connected via USB. - An alternative to downloading these images is to install Debian on the device and then install FreedomBox on it. -
-
- Availability - - - Price: 45 EUR (A20 OLinuXino Lime2) - - - Price: 55 EUR (A20 OLinuXino Lime2 4GB) - - - - Olimex Store - - - -
-
- Hardware - - - Open Source Hardware (OSHW): Yes - - - CPU: Allwinner A20, ARM Cortex-A7 @ 1GHz dual-core - - - RAM: 1 GiB DDR3 - - - Storage: 4 GB NAND flash built-in (only on 4GB model), 1x microSD slot - - - Architecture: armhf - - - Ethernet: 10/100/1000, RJ45 - - - WiFi: None, use a USB WiFi device - - - SATA: 1x port - - -
-
- Non-Free Status - - - Non-free blobs required: No - - - WiFi: Not available - - - Boot Firmware: BROM (GPLV2+) - - -
-
- Known Issues - - - Revision C hardware has poor performance when receiving Ethernet data in Gigabit mode. To workaround the problem, you can switch to 100 Mbps mode instead of Gigabit mode. Login to your FreedomBox as root (or plugin the SD card into another computer) and create the file /etc/NetworkManager/dispatcher.d/20-fix-ethernet-problem with the following contents: - - - - Revision G2 hardware has poor performance when transmitting Ethernet data in Gigabit mode. Download and use the Pioneer Edition image to fix the issue. It contains a slightly modified u-boot. The above workaround to put the Ethernet into 100 Mbps mode also fixes this issue. - - - Revision K hardware is not working properly. - - -
-
-
- A20 OLinuXino MICRO - - - - - - - A20 OLinuXino MICRO - - - - Olimex's A20 OLinuXino MICRO is a fully Open Source Hardware (OSHW) single board computer. This means that the designer is actively helping people using the platform for their own designs, and supports them in adding hardware functionality and production advice. This is a part of freedom that is often overlooked, but very much aligned with the FreedomBox goals. It uses the Allwinner A20 Dual Core ARM processor. - Important: Read general advice about hardware before building a FreedomBox with this single board computer. -
- Similar Hardware - The following similar hardware will also work well with FreedomBox. - - - Olimex's A20 OLinuXino MICRO 4GB. This hardware merely has extra 4GB NAND storage that is not used by FreedomBox. - - -
-
- Download - FreedomBox MicroSD card images are available for this device. Follow the instructions on the download page to create a FreedomBox MicroSD card and boot the device. These MicroSD card images are meant for use with the on-board MicroSD card slot and won't work on the SD card slot or when using a separate MicroSD card reader connected via USB. - An alternative to downloading these images is to install Debian on the device and then install FreedomBox on it. -
-
- Availability - - - Price: 50 EUR (A20 OLinuXino MICRO) - - - Price: 63 EUR (A20 OLinuXino MICRO 4GB) - - - - Olimex Store - - - -
-
- Hardware - - - Open Source Hardware (OSHW): Yes - - - CPU: Allwinner A20, ARM Cortex-A7 @ 1GHz dual-core - - - RAM: 1 GiB DDR3 - - - Storage: 4 GB NAND flash built-in (only on 4GB model), 1x microSD slot - - - Architecture: armhf - - - Ethernet: 10/100, RJ45 - - - WiFi: None, use a USB WiFi device - - - SATA: 1x port - - -
-
- Non-Free Status - - - Non-free blobs required: No - - - WiFi: Not available - - - Boot Firmware: BROM (GPLV2+) - - -
-
- Known Issues - - - Not visible on local network - - - When booting the 'stable' image (made on 2017-06-18) the board does not automatically get an IP address from the router's DHCP server over ethernet. Booting the 'testing' image (2018-06) the board does get an IP address. Tested on MICRO hardware revision J. see also: - - -
-
-
- APU - - - - - - - PC Engines APU 1D - - - - PC Engines APU 1D is a single board computer with 3 Gigabit ethernet ports, a powerful AMD APU and Coreboot firmware. FreedomBox images built for AMD64 machines are tested to work well for it. - Important: Read general advice about hardware before building a FreedomBox with this single board computer. -
- Similar Hardware - Although untested, the following similar hardware is also likely to work well with FreedomBox. - - - Using amd64 image: - - - - apu1c - - - - - apu1c4 - - - - - apu1d4 - - - - - apu2b2 - - - - - apu2b4 - - - - - apu2c0 - - - - - apu2c2 - - - - - apu2c4 - - - - - apu3a2 - - - - - apu3a4 - - - - - apu3b2 - - - - - apu3b4 - - - - - - Using i386 image: - - - - alix1d - - - - - alix1e - - - - - alix2d2 - - - - - alix2d3 - - - - - alix2d13 - - - - - alix3d2 - - - - - alix3d3 - - - - - alix6f2 - - - - - -
-
- Download - FreedomBox disk images for this hardware are available. Follow the instructions on the download page to create a FreedomBox SD card, USB disk, SSD or hard drive and boot into FreedomBox. Pick the image meant for all amd64 machines. - An alternative to downloading these images is to install Debian on the APU and then install FreedomBox on it. -
-
- Networking - The first network port, the left most one in the above picture, is configured by FreedomBox to be an upstream Internet link and the remaining 2 ports are configured for local computers to connect to. -
-
- Availability - - - Price: 110 - 170 USD (depending on the board and supplier) - - - - PC Engines - - - - - Full list of suppliers - - - -
-
- Hardware - - - Open Hardware: No - - - CPU: AMD G series T40E - - - RAM: 2 GB DDR3-1066 DRAM - - - Storage: SD card, External USB - - - Architecture: amd64 - - - Ethernet: 3 Gigabit Ethernet ports - - - WiFi: None, use a USB WiFi device - - - SATA: 1 m-SATA and 1 SATA - - -
-
- Non-Free Status - - - Non-free blobs required: No - - - WiFi: Not available - - - Boot firmware: Coreboot - - -
-
-
- pcDuino3 - - - - - - - LinkSprite pcDuino3S - - - - LinkSprite pcDuino3S is a single board computer running on Allwinner A20 and sold with a good case. FreedomBox images are built and tested for this device. - Note: The FreedomBox logo is simply a sticker on top of device brought from store. - Important: Read general advice about hardware before building a FreedomBox with this single board computer. -
- Similar Hardware - Although untested, the following similar hardware is also likely to work well with FreedomBox. - - - also covers pcDuino3B - - -
-
- Download - FreedomBox disk images for this hardware are available. Follow the instructions on the download page to create a FreedomBox SD card, USB disk, SSD or hard drive and boot into FreedomBox. Pick the image meant for pcduino3. - An alternative to downloading these images is to install Debian on the APU and then install FreedomBox on it. -
-
- Availability - - - Price: 89 USD - - - - LinkSprite - - - - - Full list of suppliers - - - -
-
- Hardware - - - Open Hardware: No - - - CPU: AllWinner A20 SoC, 1GHz ARM Cortex A7 Dual Core - - - RAM: 1 GB - - - Storage: SD card, 4 GB onboard flash - - - Architecture: armhf - - - Ethernet: 10/100 Mbps - - - WiFi: Built-in WiFi requires non-free firmware, use a USB WiFi device instead - - - SATA: 1 SATA host socket - - -
-
- Non-Free Status - - - Non-free blobs required: No - - - WiFi: Requires non-free firmware - - - Boot Firmware: BROM (GPLV2+) - - -
-
-
- Pine A64+ - - - - - - - Pine 64+ - - - - Pine A64+ is an affordable single board computer with good performance. - Important: Read general advice about hardware before building a FreedomBox with this single board computer. -
- Similar Hardware - - - Both 1GB and 2GB versions of Pine A64+ are supported with the same FreedomBox image. - - - Pine A64-LTS is not supported yet. - - -
-
- Download - FreedomBox SD card images for this hardware are available. Follow the instructions on the download page to create a FreedomBox SD card and boot into FreedomBox. Pick the image meant for Pine A64+. - An alternative to downloading these images is to install Debian on the device and then install FreedomBox on it. -
-
- Availability - - - Price: 29 USD (for the 2 GB variant), 21 USD (for the 1 GB variant) - - - - Pine A64+ with 1 GB RAM at Pine64 Store - - - - - Pine A64+ with 2 GB RAM at Pine64 Store - - - -
-
- Hardware - - - Open Source Hardware (OSHW): No - - - CPU: Allwinner A64, Quad-core ARM Cortex A53 64-bit processor - - - RAM: 3 variants - 512 MB (not recommended), 1 GB and 2 GB (recommended) - - - Storage: SD card, eMMC (module sold separately but not tested with FreedomBox) - - - Architecture: arm64 - - - Ethernet: Gigabit Ethernet port - - - Battery: Supports battery backup using a Li-Po battery - - - WiFi: None, use a USB WiFi device - - - SATA: None - - -
-
- Non-Free Status - - - Non-free blobs required: No - - - WiFi: Not available - - -
-
-
- VirtualBox - - - - - - - VirtualBox - - - - This page will help you get started with using FreedomBox on a virtual machine using VirtualBox. While VirtualBox images are primarily used for testing and development, they can also be used for regular use if you have spare resources on one of your machines. This setup is useful if: - - - You don't own one of the supported hardware devices. - - - You don't use Debian GNU/Linux as your operating system. - - - You don't want to disturb your Debian installation to try out FreedomBox. - - - Prebuilt FreedomBox images for VirtualBox are routinely made available in VirtualBox's own VDI image file format. They contain a Debian GNU/Linux operating system and an installation of FreedomBox with all dependencies ready to run on any OS supported by VirtualBox (Windows, Linux, Macintosh, and Solaris). - A more adventurous alternative to downloading one of these images is to install Debian on VirtualBox and then install FreedomBox on it. - VirtualBox itself is available from (or your distribution's package manager). -
- Download - Follow the instructions on the download page to download and verify a VirtualBox image. The latest images are available on freedombox.org. -
-
- Creating a Virtual Machine - - - Decompress the downloaded VDI image (tool for Windows, Mac). - - - Create a new VM in the VirtualBox UI with OS type Linux and Version Debian (32/64-bit according to the downloaded image). - - - - - - - - - VirtualBox Name and OS dialog - - - - - - In the Hard disk dialog choose Use an existing virtual hard disk file and select the .vdi file you extracted in step 1. - - - - - - - - - VirtualBox Hard disk dialog - - - - - - When created, go to the virtual machine's Settings -> [Network] -> [Adapter 1]->[Attached to:] and choose the network type your want the machine to use according to the explanation in Network Configuration below. The recommended type is the Bridged adapter option, but be aware that this exposes the FreedomBox's services to your entire local network. - - - - - - - - - VirtualBox recommended network setting - - - - Note: It is important to make sure that you have provided the correct network interface in the above step. For example, if the virtual machine is running on a laptop connected to a Wi-Fi network, then the wireless interface (starts with wlp) must be chosen as shown in the screenshot. -
-
- First Boot - When satisfied with the VM settings click the start button in the VirtualBox UI and your new FreedomBox will boot. - The console of the VM will show the textual screen below when finished booting, from here most interaction with FreedomBox will be through the web interface in a browser. - - - - - - - FreedomBox console after booting successfully - - - - If everything went well so far, you should be able to access the web interface of FreedomBox by pointing a browser on the host machine to . - In case freedombox.local cannot be resolved, you need to find out your FreedomBox's IP address as described in Finding out the IP address of the virtual machine. Then access this IP from a web browser which is on the same network as the VM (for example, the host). If all is well, you are now presented with a welcome message and invited to complete the first boot process. - - - - - - - FreedomBox welcomes you to the first boot - - - - This mainly consist of creating an administrative user for the system. -
-
- Using - See the FreedomBox usage page for more details. - You can log in to the Debian GNU/Linux system as the user created during FreedomBox first boot on the VirtualBox console or remotely via ssh. - After logging in, you can become root with the command sudo su. -
-
- Build Image - If you wish to build your own images instead of downloading available images, it can be done using Freedom Maker. -
-
- Tips & Troubleshooting -
- Network Configuration - VirtualBox provides many types of networking options. Each has its advantages and disadvantages. For more information about how various networking types work in VirtualBox, see VirtualBox's networking documentation. - For a simple setup, it is recommended that you use a single network interface in your guest machine. This will make the first boot script automatically configure that interface as an internal network with automatic network configuration. Inside the guest machine, the networking is configured automatically and all the services are made available on this network interface. For more information on how networks are configured by default in FreedomBox, see Networks section. - What remains is to make those services available to the host machine or to other machines in the network. You must then choose one of the following types of networking for the network interface on your guest machine. To set a particular type of network for the guest's network adapter, go to the guest VM's settings then the network options and then select the adapter you wish to configure. There, set the network type from the available list of networks. - - - First and the recommended option is to use the Bridged type of network. This option exposes the guest machine to the same network that host network is connected to. The guest obtains network configuration information from a router or DHCP server on the network. The guest will appear as just another machine in the network. A major advantage of this of setup is that the host and all other machines in the network will be able to access the services provided by guest without requiring any further setup. The only drawback of this approach is that if the host is not connected to any network, the guest's network will remain unconfigured making it inaccessible even from the host. - - - Second method is Host only type of networking. With a guest's network interface configured in this manner, it will only be accessible from the host machine. The guest will not able access any other machine but the host, so you do not have internet access on the guest. All services on the guest are available to the host machine without any configuration such as port forwarding. - - - The third option is to use the NAT type of network. This the networking type that VirtualBox assigns to a freshly created virtual machine. This option works even when host is not connected to any network. The guest is automatically configured and is able to access the internet and local networks that host is able to connect to. However, the services provided by the guest require port forwarding configuration setup to be available outside. - To configure this go to VM settings -> [Network] -> [Adapter] -> [Port Forwarding]. Map a port such as 2222 from host to guest port 22 and you will be able to ssh into FreedomBox from host machine as follows: - - Map 4443 on host to 443 on the guest. This make FreedomBox HTTPS service available on host using the URL You will need to add a mapping for each such services from host to guest. - - - The final option is to create two network interfaces, one host only and one NAT type. This way you can access the guest without any additional configuration, and you have internet access on the guest. The guest will be invisible to any other machines on the network. - - - Summary of various network types: - - - - - - - - - - - - - - - - - Guest accessible from other machines - - - - - Guest accessible from host - - - - - Works without port forwarding - - - - - Works without host connected to network - - - - - Guest has internet access - - - - - - - Bridged - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - Host only - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - - - - - {X} - - - - - - - - - NAT - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - - NAT and Host - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - - - - -
-
- Finding out the IP address of the virtual machine - This depends on the network configuration you chose. With a bridged adapter, your virtual machine gets its IP address from the DHCP server of your network, most likely of your Router. You can try the first couple of IP addresses or check your router web interface for a list of connected devices. - If you chose host-only adapter, the IP address is assigned by the DHCP server of your VirtualBox network. In the VirtualBox Manager, go to File -> Preferences -> Network -> Host-only Networks. You can see and edit the DHCP address range there, typically you get assigned addresses close to the Lower Address Bound. - Another possibility of finding the IP address is to login via the VirtualBox Manager (or similar software). The FreedomBox images do not have any default user accounts, so you need to set an initial user and password using the passwd-in-image script. - See also QuickStart for instructions on how to scan your network to discover the IP of the VM. -
-
- Networking Problems with macchanger - The package macchanger can cause network problems with VirtualBox. If you have a valid IP address on your guest's host network adapter (like 192.168.56.101) but are not able to ping or access the host (like 192.168.56.1), try uninstalling macchanger: - - You might have to manually remove the script /etc/network/if-prep-up/macchanger. If Debian complains about unmet dependencies when you use a package manager (apt-get, aptitude, dpkg), try to remove 'macchanger' from the dependencies of 'freedombox-setup' in the file /var/lib/dpkg/status. -
-
- Mounting Images Locally - If you want to mount images locally, use the following to copy built images off the VirtualBox: - -
-
- Fixing the time after suspend and resume - The virtual machine loses the correct time/date after suspending and resuming. One way to fix this is to create a cron-job that restarts the time service ntp. You can add a crontab entry as root to restart ntp every 15 minutes by typing 'crontab -e' and adding this line: - - Do not restart this service too often as this increases the load of publicly and freely available NTP servers. -
-
- UUID collision in VB - Whenever this happens VirtualBox shows following error message: Cannot register the hard disk A with UUID ... because a hard disk B with UUID ... already exists in the media registry - Creating several VMs from the same image causes collisions due to ID's (hostname, IP, UUID, etc) that are expected to be universally unique. Most can be handeled operating the running VM. But VirtualBox complains before that (at the very creation of the VM) about the hard disk's UUID. This is usual stuff when you develop/test e.g. FreedomBox. - You can change a clone's UUID in the terminal as follows: - -
-
-
-
- Debian - FreedomBox is a pure blend of Debian. This means that all the work on FreedomBox is available in Debian as packages. It also means that any machine running Debian can be turned into a FreedomBox. - This page describes the process of installing FreedomBox on a Debian system. Currently, FreedomBox works in Debian Stable (Buster), Testing (Bullseye), and Unstable (Sid). - Important: Read general advice about hardware before building a FreedomBox with this approach. - - - Use a fresh Debian installation - - Installing FreedomBox changes your Debian system in many important ways. This includes installing a firewall and regenerating server certificates. It is hence recommended that you install FreedomBox on a fresh Debian installation instead of an existing setup. - - - - Console/GUI logins for non-admin users will be disabled - - After FreedomBox is fully setup, your system will no longer allow users not belonging to the admin group to log in to the system via console, secure shell (SSH) or graphical login. This behaviour can be disabled from the Security page. Use the administrator account created during FreedomBox first boot for console logins and add further user accounts to admin group, if necessary. - -
- Installing on Debian 10.0 (Buster) or newer - Check the Troubleshooting section below, for any tips or workarounds that might help during the install. - - - Install Debian 10.0 (Buster), or Unstable (Sid) on your hardware. - - - Update your package list. - - - - Install freedombox package. - - - - The "DEBIAN_FRONTEND=noninteractive" will avoid several configuration prompts that would otherwise appear during the install. - - - - - During the installation, you will be provided a secret key that needs to be entered during the initial configuration process. Note this down. The secret can also be read at a later time from the file /var/lib/plinth/firstboot-wizard-secret. - - - You can start using FreedomBox. During initial wizard, you will need to enter the secret noted above. - - -
-
- Installing on Debian 9 (Stretch) - Check the Troubleshooting section below, for any tips or workarounds that might help during the install. - - - Install Debian 9 (Stretch) on your hardware. - - - Update your package list. - - - - Install freedombox-setup package. - - - - The "DEBIAN_FRONTEND=noninteractive" will avoid several configuration prompts that would otherwise appear during the install. - - - - - Run FreedomBox setup program. This installs further packages and sets up basic configuration. - - You may have to clear your existing network configuration. See Troubleshooting note #2 below. - - - Reboot the system. This is necessary to trigger the first-run script. - - - - After the system boots up, wait for it to reboot again. The first-run scripts sets up a few things and initiates a reboot. - - - After the second reboot you can start using FreedomBox. - - -
-
- Tips and Troubleshooting - - - There is a bug in policykit-1 package that causes errors and hangs during installation of freedombox-setup package. This bug is only applicable to Debian 9 (Stretch) and older. A workaround is to first install policykit-1 package and then reboot. After that, follow the above setup procedure. - - - - FreedomBox uses NetworkManager to manage network configuration. If you have configured your network interfaces using Debian installer or by editing /etc/network/interfaces, FreedomBox will not manage those interfaces. (See bug #797614.) To let FreedomBox/NetworkManager manage your network interfaces, edit the /etc/network/interfaces manually and ensure that it contains only the following: - - If you have already completed the setup process without doing this step, you will need to clear out the /etc/network/interfaces file keeping only the above lines. Then perform a reboot. On Debian 9 (Stretch), after this network connections configured by the setup step above will configure your network. Network interfaces will then be in the internal or external firewall zone. This is essential for the FreedomBox's web interface to be reachable from other machines in the network. You can tweak network manager connections with the nmtui command if you wish. - - - FreedomBox will use an automatically configured IP address by default. You can assign a static IP address if necessary. Network configuration changes can be done using FreedomBox web interface or by using the nmtui or nmcli commands. nmcli can be used as follows: - - - - ..with the block capitals and somedomain.com replaced with your actual address, mask description, gateway and dns server details. - - -
-
-
- DreamPlug - - - - - - - DreamPlug - - - - - - Deprecated Hardware - - This hardware was supported earlier but is no longer supported. If you downloaded an earlier image and are running FreedomBox on this hardware, you will keep getting software updates. You can stay secure and up-to-date. However, no new images will be provided for this hardware. It is recommended that you migrate to newer, supported hardware using backup and restore. - - DreamPlug is the hardware for which FreedomBox has been originally targeted. FreedomBox images are built and tested for it. For using this device as FreedomBox, a USB WiFi device that does not require non-free firmware is recommended. - You can find more support and discussion for DreamPlug on the official forum. - Recommendation: If you are using a board that uses SD cards, when you flash the FreedomBox image onto your SD card, we recommend that you use an SD card with at least 8GB of storage space. -
- Download - FreedomBox SD card images for this hardware are available. Follow the instructions on the download page to create a FreedomBox SD card and boot into FreedomBox. See also instructions for using an internal micro-SD with DreamPlug. - An alternative to downloading these images is to install Debian on DreamPlug and then install FreedomBox on it. -
-
- Networking - The network port towards the middle of the box, is configured by FreedomBox to be an upstream Internet link. The remaining port is configured for a local computer to connect to. -
-
- Firmware - Note that the factory firmware configurations may vary between revisions of the hardware, and render some images incompatible. See the DreamPlug firmware page for information on what images are compatible and how to update your DreamPlug firmware. -
-
- Build Image - FreedomBox images for this hardware can be built using Freedom Maker. -
-
- Testing - Instructions on how to test this hardware are available. -
-
- Availability - - - Price: 159 USD - - - - DreamPlug manufacturer - - - - Reseller Spinifex in Australia - - -
-
- Hardware - - - Open Hardware: No - - - CPU: Marvell Kirkwood 88F6281 @ 1.2GHz - - - RAM: 512MB 16bit DDR2-800 MHz - - - Storage: 4 GB on board micro-SD - - - Architecture: armel - - - Ethernet: 2x 10/100/1000, RJ45 - - - WiFi: SD8787, 802.11 b/g/n - - - SATA: eSATA 2.0 port - - -
-
- Non-Free Status - - - Non-free blobs required: built-in WiFi - - - WiFi: no free WiFi drivers + firmware available - - - Works with stock Debian kernel: yes - - -
-
- Known Issues - - - WiFi does not work with free software. A separate USB WiFi device is recommended. - - -
-
-
- Raspberry Pi Model B+ - - - - - - - Raspberry Pi (Model B+) - - - - - - Deprecated Hardware - - This hardware was supported earlier but is no longer supported. If you downloaded an earlier image and are running FreedomBox on this hardware, you will keep getting software updates. You can stay secure and up-to-date. However, no new images will be provided for this hardware. It is recommended that you migrate to newer, supported hardware using backup and restore. - - Raspberry Pi (Model B+) is a popular single board computer developed with the intention of promoting teaching of basic computer science in schools. FreedomBox images are built and tested for it. For using this board as FreedomBox, a USB WiFi device that does not require non-free firmware is recommended. - Note: The Debian architecture used for this device is armel. This means floating point computations are done in software and most operations are slower than what Raspberry Pi is capable of. - Recommendation: When you flash the FreedomBox image onto your SD card, we recommend that you use an SD card with at least 8GB of storage space. -
- Download - FreedomBox SD card images for this hardware are available. Follow the instructions on the download page to create a FreedomBox SD card and boot into FreedomBox. -
-
- Build Image - FreedomBox images for this hardware can be built using Freedom Maker. -
-
- Availability - - - Price: 35 USD - - - - List of official distributors - - - -
-
- Hardware - - - Open Hardware: No - - - CPU: ARM1176JZF-S (ARMv6k) 700 MHz - - - RAM: 512 MB - - - Storage: MicroSD card slot - - - Architecture: armel - - - Ethernet: 10/100, RJ45 - - - WiFi: None, use a USB WiFi device - - - SATA: None - - -
-
- Non-Free Status - - - Non-free blobs required: boot firmware - - - WiFi: Not available - - - Works with stock Debian kernel: No - - -
-
- Known Issues - - - The Debian architecture used for this device is armel. This means floating point computations are done in software and generally most operations are slower than what Raspberry Pi is capable of. - - -
-
-
- Raspberry Pi 2 Model B - - - - - - - Raspberry Pi 2 - - - - Raspberry Pi 2 (Model B ) is a popular single board computer developed with the intention of promoting teaching of basic computer science in schools. It is a successor to Raspberry Pi Model B+ with much faster processor and more RAM. FreedomBox images are built and tested for it. - Please do not expect any output on a monitor connected via HDMI to this device as it does not display anything beyond the message 'Starting kernel...'. See the Quick Start page to access and control your FreedomBox from network. - Important: Read general advice about hardware before building a FreedomBox with this single board computer. -
- Download - FreedomBox SD card images for this hardware are available. Follow the instructions on the download page to create a FreedomBox SD card and boot into FreedomBox. -
-
- Availability - - - Price: 35 USD - - - - List of official distributors - - - -
-
- Hardware - - - Open Hardware: No - - - CPU: 900 MHz quad-core ARM Cortex-A7 - - - RAM: 1 GB - - - Storage: MicroSD card slot - - - Architecture: armhf - - - Ethernet: 10/100, RJ45 - - - WiFi: None, use a USB WiFi device - - - SATA: None - - -
-
- Non-Free Status - - - Non-free blobs required: boot firmware - - - WiFi: Not available - - -
-
-
- Raspberry Pi 3 Model B - - - - - - - Raspberry Pi 3 Model B - - - - Raspberry Pi 3 Model B is a popular single board computer developed with the intention of promoting teaching of basic computer science in schools. It is a successor to Raspberry Pi 2 Model B with a 64-bit processor and on-board Wi-Fi. A FreedomBox "testing" image is available for Raspberry Pi 3 Model B. - Please do not expect any output on a monitor connected via HDMI to this device as it does not display anything beyond the message 'Starting kernel...'. See the Quick Start page to access and control your FreedomBox from network. - Important: Read general advice about hardware before building a FreedomBox with this single board computer. -
- Download - FreedomBox SD card images for this hardware are available. Download the "testing" image for Raspberry Pi 3 Model B. Follow the instructions on the download page to create a FreedomBox SD card and boot into FreedomBox. -
-
- Availability - - - Price: 35 USD - - - - List of official distributors - - - -
-
- Hardware - - - Open Hardware: No - - - CPU: 1.2GHz 64-bit quad-core ARMv8 CPU - - - RAM: 1 GB - - - Storage: MicroSD card slot - - - Architecture: armhf - - - Ethernet: 10/100, RJ45 - - - WiFi: 802.11n but requires non-free firmware, instead use a USB WiFi device - - - SATA: None - - -
-
- Non-Free Status - - - Non-free blobs required: boot firmware - - - WiFi: Requires non-free firmware - - -
-
-
- Raspberry Pi 3 Model B+ - - - - - - - Raspberry Pi 3 Model B+ - - - - Raspberry Pi 3 Model B+ is a popular single board computer developed with the intention of promoting teaching of basic computer science in schools. It is a successor to Raspberry Pi 3 Model B with better Ethernet and a 5Ghz Wi-Fi. A FreedomBox "testing" image is available for Raspberry Pi 3 Model B+. - Please do not expect any output on a monitor connected via HDMI to this device as it does not display anything beyond the message 'Starting kernel...'. See the Quick Start page to access and control your FreedomBox from network. - Important: Read general advice about hardware before building a FreedomBox with this single board computer. -
- Download - FreedomBox SD card images for this hardware are available. Download the "testing" image for Raspberry Pi 3 Model B+. Follow the instructions on the download page to create a FreedomBox SD card and boot into FreedomBox. -
-
- Availability - - - Price: 35 USD - - - - List of official distributors - - - -
-
- Hardware - - - Open Hardware: No - - - CPU: 1.4GHz 64-bit quad-core ARMv8 CPU - - - RAM: 1 GB - - - Storage: MicroSD card slot - - - Architecture: armhf - - - Ethernet: 10/100/1000, RJ45 - - - WiFi: 802.11ac but requires non-free firmware, instead use a USB WiFi device - - - SATA: None - - -
-
- Non-Free Status - - - Non-free blobs required: boot firmware - - - WiFi: Requires non-free firmware - - -
-
-
- USB Wi-Fi - FreedomBox works on many single board computers. However, many of these boards do not have built-in Wi-Fi capabilities. Even when Wi-Fi capability is available, non-free proprietary firmware is required to make them work. - A solution to the problem is to plug-in a USB Wi-Fi device into one of the available USB ports. There are many such devices available which do not require non-free firmware to work. The following is a list of such devices that work with FreedomBox devices. Some devices based on these chips have tested to work well with FreedomBox including functions such as access point mode. - - - - Devices with Atheros AR7010 chip - - - - - Devices with Atheros AR9271 chip - - - -
- Firmware Installation - The free firmware for these devices is not packaged in Debian yet. You can manually download and install the firmware as follows: - -
-
- Resources - - - - Debian Wiki on WiFi drivers - - - - - Wikipedia: Comparison of open-source Linux wireless network drivers - - - - - WikiDevi: database of computer hardware - - - -
-
-
- Release Notes - The following are the release notes for each FreedomBox version. -
- FreedomBox 20.13 (2020-07-18) -
- Highlights - - - upgrades: Update apt cache before manual update - - - minidlna: Do not expose statistics over public web - - -
-
- Other Changes - - - backups: Allow remote repository usernames to start with numbers - - - locale: Update translations for Chinese (Simplified), Hungarian, Kannada, Norwegian Bokmål, Spanish, Swedish - - - security: Move backports notice to security page - - - upgrades: Add button to activate backports if needed for current release - - - debian: Rename source package from plinth to freedombox - - -
-
-
- FreedomBox 20.12.1 (2020-07-05) - - - cfg, frontpage: Ignore errors while reading config and shortcuts - - - locale: Update translations for French, German, and Norwegian Bokmål - - -
-
- FreedomBox 20.12 (2020-06-29) -
- Highlights - - - apt: Recover from errors before installing apps or updating system - - - apache: Add strict content security policy, sandbox and other security headers - - - storage: Allow ejecting SATA disks - - - configuration: Allow changes using .d drop-in files - - -
-
- Other Changes - - - configuration: Move default configuration into source code - - - configuration: Read from multiple locations in /etc/ and /usr/share/ - - - debian: Add ssl-cert and nscd as proper dependencies - - - frontpage: Allow adding shotcuts using .d drop-in files - - - frontpage: Read shortcuts from multiple locations in /etc/, /usr/share and /var/lib - - - locale: Update translations for Czech, Danish, French, German, Russian, Spanish, Swedish, Telugu, Turkish - - - storage: Automount system disks without partition table but ignore all loopback devices - - - storage: Allow ejecting SATA disks - - - storage: Show only physical disks and not all mount points - - - upgrades: Skip enabling backports on testing and unstable - - - upgrades: Show more logs - - - ui: Show a spinner and disable button on form submit - - -
-
-
- FreedomBox 20.11 (2020-06-15) -
- Top Highlight - - - locale: Add new translation for Arabic (Saudi Arabia) - - -
-
- Other Changes - - - javascript: Remove use of Turbolinks library - - - locale: Update translations for French, Norwegian Bokmål, German, Swedish, Polish, and Spanish - - - matrixsynapse: Handle upgrade to versions 1.15.x - - - upgrades: Avoid manual update interruption when upgrading freedombox package - - - upgrades: Don't enable backports on Debian derivatives - - -
-
-
- FreedomBox 20.10 (2020-06-01) -
- Top Highlights - - - pagekite: Fix expired certificates causing connection failures - - - tor: Fix problems with running a relay - - -
-
- Other Changes - - - backups: Add optional field - Name - - - cockpit: Promote for advanced storage/firewalld/networking ops - - - firewall: Don't show tun interface in internal zone warning - - - firewall: Mention that internal services are available over VPN - - - ikiwiki: Enable 'attachment' plugin by default - - - locale: Update translations for Spanish, French, Russian, Norwegian Bokmål, Czech, Hungarian, and Greek - - - minidlna: Add link to manual page - - - minidlna: Fix internationalization for name of the app - - - mldonkey: Add app to freedombox-share group - - - openvpn: Use app toggle button and common app view - - - radicale: Fix link in description to clients - - - samba: Add clients information - - - templates: Fix setup state check - - - users: Avoid error when user's groups cannot be parsed - - -
-
-
- FreedomBox 20.9 (2020-05-18) -
- Top Highlights - - - performance: Add app for system monitoring - - - upgrades: Restart services and system when needed after upgrades - - - System restart will happen at 02:00 local time - - - - -
-
- Other Changes - - - bind: Add service alias for bind9 -> named - - - firewall: Reload firewalld so it works with newly installed services - - - first_setup: Fix regression with logo not showing - - - locale: Update translations for Norwegian Bokmål, German, Swedish, Spanish, and Russian - - - mediawiki: Stop jobrunner during backup/restore - - - minidlna: Stop service during backup/restore - - - mumble: Stop service during backup/restore - - - package: Fix error log when checking if package manager is busy - - - performance: Launch the Cockpit graphs directly if possible - - - quassel: Fix stopping service during backup/restore - - - quassel: Use systemd sandboxing features - - - samba: Change description to Network File Storage - - - snapshot: Fix issues with restore and delete - - - snapshot: Set as essential module - - - storage: Auto-mount disks, notify of failing disks - - - tor: Fix stopping service during backup/restore - - -
-
-
- FreedomBox 20.8 (2020-05-04) - - - syncthing: Add service to freedombox-share group - - - users: When adding service to sharing group, only restart if already running - - - datetime: Ignore time synchronization service in containers and virtual machines - - - minidlna: Make app installable inside unprivileged container - - - web_server: Suppress warnings that static directories don't exist - - - debian: Remove unused timer - - - static: Use SVG logo during first wizard welcome step - - - static: Reduce the size of the background noise image - - - setup.py: Don't install/ship .po files - - - static: Don't ship visual design file and unused images - - - all: Update links to repository and project page - - - coturn: Add app to manage Coturn TURN/STUN server - - - mediawiki: Partial fix for installing on testing - - - datetime: Disable diagnostics when no tests are available - - - data: Print hostname and IP addresses before console login - - - snapshot: Fix message when not available - - - snapshot: Fix title - - - mumble: Add Mumla to the list of clients - - - locale: Update translations for Spanish, Telugu, Russian, German, French, and Swedish - - -
-
- FreedomBox 20.7 (2020-04-20) - - - matrixsynapse: Fix initial installation and upgrade from backports - - - gitweb: Improve error handling when creating repository - - - locale: Update translations for French, Serbian, and Telugu - - -
-
- FreedomBox 20.6.1 (2020-04-11) - - - users: Restore line of help text that was accidentally dropped - - - debian: Add firmware-ath9k-htc to Recommends - - - gitweb: Use proper ellipsis char when showing clone progress - - - locale: Update translations for Norwegian Bokmål, German, French, Portuguese, Italian, Russian, and Serbian - - -
-
- FreedomBox 20.6 (2020-04-06) - - - app: Ensure toggle buttons work independently of configuration form - - - networks, monkeysphere: Make styling more specific to avoid interference - - - syncthing: Update description to mention 'syncthing' group - - - radicale: Support upgrade up to any 2.x version - - - packages: Hold freedombox package during package installs - - - users: Add component for managing users and groups - - - app: Fix grammar in developer documentation string - - - ikiwiki: Disable public edits of blog pages - - - ikiwiki: Add moderation of blog comments - - - firewalld: Support upgrade up to any 0.8.x version - - - infinoted: Fix permissions of sync directory - - - locale: Added Serbian translation - - - locale: Update translations for Russian, French, German, Czech, Italian, Hindi, Telugu, and Spanish - - -
-
- FreedomBox 20.5.1 (2020-03-26) - - - networks: Update label wording in topology form - - - jsxc: Fix issue with serving static files - - - debian: Separate binary packages for each language manual - - - locale: Update translations for Norwegian Bokmål and German - - -
-
- FreedomBox 20.5 (2020-03-23) - - - app: Fix description block in app header - - - pagekite: Don't signal new domain on init if app is disabled - - - pagekite: Don't attempt to notify about domain if app is disabled - - - pagekite: Remove app enabled checking from getting configuration - - - pagekite: On enable/disable, add/remove domain from names module - - - pagekite: Fix an error message in custom services form - - - matrixsynapse: Handle release of matrix-synapse 1.11 - - - setup: Fix regression to force-upgrade caused by Info changes - - - pagekite: Don't allow non-unique custom services - - - index: Reintroduce clients button in front page - - - upgrades: Don't ship apt backport preferences file - - - upgrades: Use internal scheduler instead of systemd timer - - - shadowsocks: Change default configuration - - - shadowsocks: Fix incorrect setting of state directory - - - shadowsocks: When editing configuration, don't re-enable - - - mediawiki: Don't allow anonymous edits - - - names: Fix Local Network Domain is not shown - - - shadowshocks: Fix setting configuration on Buster - - - locale: Update translations for Swedish, Spanish, and French - - -
-
- FreedomBox 20.4 (2020-03-09) - - - apache: Handle transition to php 7.4 - - - app: Fix showing app name in port forwarding information - - - apps: Do not show status block if service is running - - - i2p: New style app page layout - - - locale: Update translations for French, Telugu, Spanish, and Swedish - - - networks: Add first boot step for network topology wizard - - - networks: Add form for network topology - - - networks: Don't show router wizard if not behind a router - - - networks, firewall: Support newer version of policykit - - - networks: Fixes for networks wizards access and user experience - - - networks: If topology wizard is skipped, skip router wizard too - - - networks: Show router wizard before Internet connection type wizard - - - plinth: Increase sqlite busy timeout from default 5s to 30s - - - quassel: Fix unable to disable application without choosing a domain name - - - shadowsocks: Move user settings to state directory - - - storage: Directory selection form improvements - - - transmission: Allow to submit download directory if it is creatable - - - upgrades: Clean apt cache every week - - - views: Improve template security - - -
-
- FreedomBox 20.3 (2020-02-24) - - - apps: Update style for toggle button - - - apps: Drop border shadow for app icon in mobile view - - - apps: Show short description as secondary title - - - apps: Remove css filters and glow from app icons - - - cards: Remove the transition delay on hover effect - - - system: Implement new style for cards - - - framework: Generate secret key (existing sessions will get logged out) - - - framework: Cleanup expired sessions every week - - - networks: Add setting for internet connection type - - - networks: Ask about internet connection type during setup - - - shadowsocks: Fix shadowsocks not able to start - - - jsxc: Bypass issue with stronghold to get the app working again - - - monkeysphere: Fix regression with reading Apache configuration - - - help: Fix attribute on download manual button - - - firewall: Improve speed of some operations using DBus API - - - css: Add missing license identifier on some CSS files - - - deluge: Use safer method for editing configuration - - - deluge: More reliable initial configuration setup - - - samba: Add link to manual page - - - searx: Update search engines for 0.16.0 - - - openvpn: Fix spelling for Tunnelblick - - - bind: Show served domains - - - Update translations for German, Swedish, Italian, Spanish, Norwegian Bokmål, Hungarian, Polish, and French - - -
-
- FreedomBox 20.2 (2020-02-10) - - - networks: Support virtual Ethernet (veth) devices - - - diagnostics: Show firewall service status - - - storage: Show disks if FreedomBox is running in an unprivileged container - - - service: Stop service not before but after disabling it - - - users: Use more precise username validation - - - sso, users: Turn off autocapitalization on the username field - - - help: Fix anchor hidden under navbar - - - searx: Fix installation issue for 0.16.0 - - - firewall: Show Run Diagnostics button in app - - - glib: Introduce method to schedule an operation at regular intervals - - - notification: Show a drop down from main navbar for notifications - - - storage: Show low disk space warning using notifications API - - - upgrades: Show notification when FreedomBox is updated - - - security: Add Sandbox Coverage to report page - - - matrixsynapse: Enable systemd sandboxing - - - locale: Update translations for Telugu, French, Norwegian Bokmål, German, Spanish, and Swedish - - -
-
- FreedomBox 20.1 (2020-01-27) - - - deluge: Allow to set a download directory - - - deluge: Fix installation failure on slow machine - - - storage: Make external disk mounts accessible to other users - - - gitweb: Add link to the manual page - - - style: Fix incorrect margins for containers in mobile view - - - style: Fix responsiveness for app header - - - network: Fix activating connections that don't have real devices - - - wireguard: Add WireGuard VPN app - - - networks: Add router configuration page - - - networks: Add first boot step for router config helper - - - bind: Enable sandboxing for bind service - - - locale: Updated translations for Dutch, Norwegian Bokmål, German, Spanish, Swedish, French, and Greek - - -
-
- FreedomBox 20.0 (2020-01-13) - - - samba: Improve speed of actions - - - deluge: Manage deluged service and connect automatically from web interface - - - openvpn: Enable support for communication among all clients - - - storage: Ignore errors resizing partition during initial setup - - - storage: Make partition resizing work with parted 3.3 - - - debian: Add powermgmt-base as recommended package - - - openvpn: Enable IPv6 for server and client outside the tunnel - - - networks: Fix crashing when accessing network manager D-Bus API - - - mediawiki: Use a mobile-friendly skin by default - - - mediawiki: Allow admin to set default skin - - - matrixsynapse: Allow upgrade to 1.8.* - - - security: Add explanation of sandboxing - - - Update translations for Greek, German, Swedish, Hungarian, Norwegian Bokmål, and French - - -
-
- FreedomBox 19.24 (2019-12-30) - - - app: Fix JavaScript doesn't run on first visit - - - samba: Add private shares - - - firewall: Support upgrading firewalld to 0.8 - - - deluge: Add systemd sandboxing features - - - infinoted: Add systemd sandboxing features - - - storage: Add systemd sandboxing features to udiskie service - - - upgrades: Add systemd sandboxing features to repository setup service - - - security: List whether each app is sandboxed - - - mediawiki: Avoid delay in update script - - - diagnostics: Use new component based API for all diagnostic tests - - - minidlna: Fix showing clients information - - - mediawiki: Fix problem with session cache failing logins - - - locale: Update translations for French, German, Swedish, Greek, Hungarian, Norwegian Bokmål, and Dutch - - -
-
- FreedomBox 19.23 (2019-12-16) - - - minidlna: New app for MiniDLNA (Simple Media Server) - - - apps: Show app icons in app pages - - - apps: Implement responsive layout for app pages - - - samba: Recursively set open share directory permissions - - - transmission: Add directory selection form - - - mumble: Add option to set SuperUser password - - - cockpit: Extend apps description with access info - - - cockpit: Add list of valid urls to access the app - - - Update translations for French, German, Spanish, Portuguese, and Swedish - - -
-
- FreedomBox 19.22 (2019-12-02) - - - samba: Add new app for Samba file sharing - - - pagekite: Remove tabs in the configuration page - - - openvpn: Fix text with manual link - - - pagekite: Show existing services only if there are any - - - pagekite: Move Custom Services under Configuration - - - pagekite: Use the new app toggle button - - - openvpn: Add client apps - - - backups: Fix title not appearing - - - diagnostics: Don't run on disabled modules - - - apps: Remove link to webapps in app descriptions - - - interface: Fix error with app toggle input - - - templates: Add toolbar for apps - - - toolbar: Move diagnostics button into dropdown menu - - - ssh: Fix Avahi SFTP service file - - - diagnostics: Fix IPv6 failures - - - matrix-synapse: Fix installation of 1.5 from buster-backports - - - app: Fix javascript constant redeclaration error - - - ikiwiki: Move the create button to manage section - - - gitweb: Move create button into manage section - - - networks: Move actions button into connection section - - - users: Move create button into users section - - - locale: Update translations for French, German, and Swedish - - -
-
- FreedomBox 19.21 (2019-11-18) - - - gitweb: Allow to import from a remote repository - - - interface: Disable turbolinks on links that don't point to /plinth/... - - - backups: Show proper error when SSH server is not reachable - - - tor: Rename "Hidden Service" to "Onion Service" - - - ejabberd: Handle case where domain name is not set - - - tahoe: Mark Tahoe-LAFS as an advanced app - - - searx: Set safe_search to Moderate by default - - - backups: Make verify ssh host page string translatable - - - backups: Simplify SSH fingerprint verification command - - - doc: Fix unavailability of manual images - - - tor: Fix port diagnostics by correcting port data type - - - tor: Expect obfs service to be also available on IPv6 - - - tor: Listen on IPv6 for OrPort - - - clients: implement launch button feature - - - apps: Implement toggle button in apps pages - - - Update translations for German, Hungarian, Swedish, Norwegian Bokmål, French, Polish - - -
-
- FreedomBox 19.20 (2019-11-04) - - - doc: Add Spanish manual - - - ssh: Add option to disable password authentication - - - sharing: Fix wrong links on Apache2 directory index page - - - gitweb: Set correct access rights after enabling application - - - gitweb: Fix links leading to blank page - - - gitweb: Set proper access after restoration of a backup - - - snapshot: Sort snapshot list from newest to oldest - - - infinoted: Add missing manual page link - - - backups: Fix typo - - - Update translations for German, Spanish, Swedish, Czech, French, Norwegian Bokmål, Hungarian - - -
-
- FreedomBox 19.19 (2019-10-21) - - - gitweb: New app for simple git hosting - - - ikiwiki: Allow full Unicode text in wiki/blog title names - - - users: reload Apache2 to flush LDAP cache after user operations - - - ssh: Show server fingerprints in SSH page - - - frontpage: Show public shortcuts to all users regardless of group - - - ikiwiki: Remove extra create button when no wiki/blog is present - - - quassel: Add Let's Encrypt component for certificates - - - Update translations for Czech, French, Bulgarian, Dutch, German, and Norwegian Bokmål - - -
-
- FreedomBox 19.18 (2019-10-07) - - - diagnostics: Ensure that exceptions are reported as failures - - - users: Rearrange UI to match with other apps - - - upgrades, ikiwiki, networks, backups: Replace page tabs with buttons - - - dynamicdns, i2p, pagekite, snapshot: Cleanup page templates - - - deluge: Support deluge 2 by starting it properly - - - minetest: Remove mod-torches no longer available in testing/unstable - - - security: Add past vulnerabilities count, move report to new page - - - Update translations for Spanish, Norwegian Bokmål, German - - -
-
- FreedomBox 19.17 (2019-09-23) - - - firstboot: Add new help menu to firstboot navbar - - - firstboot: Hide left menu during first boot as intended - - - Update translations for Chinese (Simplified) and Czech - - - Fix tests for letsencrypt and tor - - -
-
- FreedomBox 19.16 (2019-09-09) - - - backups: Allow adding backup repositories on multiple disks - - - help: Add buttons for contribute, support, and feedback - - - action_utils: Workaround problem with setting debconf answers - - - views: Fix failure in redirecting from language selection page - - - manual: Move PDF download link to HTML manual page - - - help: Convert help icon in the navbar to dropdown - - - ejabberd: Fix listen port configuration for ejabberd 19.x - - - cockpit, ejabberd: Prevent restart on freedombox startup - - - ejabberd: Perform host/domain name operations only when installed - - - logging: Improve formatting and reduce noise - - - translations: Update Hungarian, German, Italian, French, and Norwegian Bokmål - - -
-
- FreedomBox 19.15 (2019-08-26) - - - security: Hide vulnerability table by default - - - names: Perform better layout of domain names table on small screens - - - cockpit: Apply domain name changes immediately - - - ejabberd: Prevent processing empty domain name - - - config: Send hostname change signal only after fully processing it - - - letsencrypt: Don't try to obtain certificates for .local domains - - - avahi: Expose .local domain as a proper domain - - - cockpit: Make essential and install by default - - - tt-rss: Force upgrade to 18.12-1.1 and beyond - - - updates: Allow matrix-synapse 1.3 to be installed for buster users - - - javascript: Don't resubmit when refreshing the page - - - storage: Fix regression with restoring backups with storage - - - matrix-synapse: Use recommended reverse proxy configuration - - - Update translations for German, Hungarian, and Norwegian Bokmål - - -
-
- FreedomBox 19.14 (2019-08-12) - - - storage: Handle all device paths during eject - - - storage: Fix incorrect internationalization when throwing an error - - - upgrades: Use collapsible-button style for logs - - - firewall: Allow automatic upgrade to 0.7.x - - - upgrades: Handle release info change - - - frontpage: Fix regression with loading custom shortcuts - - - names: Add dynamic domain name - - - names: Add button to configure each type of name - - - names: Update page layout for clearer presentation - - - names: Introduce new API for domain name handling - - - api: Fix regression with listing only enabled apps in mobile app - - - Update translations for Czech, Hungarian, French, Chinese (Simplified), Turkish, Polish, and Norwegian Bokmål - - -
-
- FreedomBox 19.13 (2019-07-29) - - - backups: Make UI more consistent with other apps - - - backups: Make backup location tables collapsible - - - Updated translations for Chinese (Simplified), German, and Norwegian Bokmål - - - help: Show security notice when backports are in use - - - security: Show vulnerability counts - - -
-
- FreedomBox 19.12 (2019-07-22) - - - sharing: Allow directories to be publicly shared - - - backups: Add option to select/deselect all apps for backup or restore - - - dbus: Allow plinth user to own FreedomBox DBus service - - - letsencrypt: Simplify renewal hooks implementation - - - cockpit: Don't handle domains if app is not installed - - - dynamicdns: Send domain added signal properly during init - - - ejabberd: Backup and restore TLS certificates - - - Started new Galician translation on Weblate - - - Updated translations for Czech, Norwegian Bokmål, Hungarian, Spanish, Telugu, Chinese (Simplified), German, Turkish, and Russian - - -
-
- FreedomBox 19.2.2 (2019-07-17) - This release does not contain any functional changes, but fixes test failures when building the package. -
-
- FreedomBox 19.2.1 (2019-07-09) - This is a bugfix release for 19.2. - - - dbus: Allow plinth user to own FreedomBox DBus service - - -
-
- FreedomBox 19.11 (2019-07-08) - - - backups: Fixes to issues while adding SSH remotes: - - - Improve UX of adding ssh remote - - - Avoid creating duplicate SSH remotes - - - Fix issue with repository not being initialized - - - Verify SSH hostkey before mounting - - - Allow SSH directory paths with : in them - - - Require passphrase for encryption in add repository form - - - Don't send passphrase on the command line - - - Un-mount SSH repositories before deleting them - - - - - matrixsynapse: Fix missing translation mark - - - Started new Greek translation on Weblate - - - Updated translations for Chinese (Simplified), Hungarian, Spanish, and Russian - - -
-
- FreedomBox 19.10 (2019-06-24) - - - syncthing: Open firewall ports for listening and discovery - - - radicale: Workaround issue with creating log directory - - - Update translations for Turkish, German, Czech, Norwegian Bokmål, and Portuguese - - - Introduce components for firewall, webserver, uwsgi, and daemons - - -
-
- FreedomBox 19.9 (2019-06-10) - - - config: Add option to show advanced apps, which are hidden by default - - - monkeysphere: Hide by default - - - searx: Add option to allow public access to the application - - - Introduce component architecture for apps, with components for menus and shortcuts - - - Start new translation for Bulgarian - - - Update translations for Turkish and Norwegian Bokmål - - -
-
- FreedomBox 19.8 (2019-05-27) - - - Switch to using SVG icons for all apps. - - - Updated translations for Czech, Norwegian Bokmål, Hungarian, German, Turkish, and Spanish. - - -
-
- FreedomBox 19.7 (2019-05-13) - - - i2p: Include default favorites. - - - Separate enabled and disabled apps. - - - Display port forwarding info for apps. - - - Added Slovenian translation. - - - Updated translations for Dutch, German, Hungarian, Norwegian Bokmål, Polish, Portuguese, Telugu. - - -
-
- FreedomBox 19.6 (2019-04-29) - - - i2p: Enable new application for I2P Anonymity Network. - - - Updated translations for Czech, German, Norwegian Bokmål, and Turkish. - - - letsencrypt: Provide link to configure domain if not configured. - - - firewall: Show port numbers and types. - - -
-
- FreedomBox 19.5 (2019-04-15) - - - storage: Use more reliable method to list disks and disk space usage. - - - Updated translations for Russian and German. - - -
-
- FreedomBox 19.4 (2019-04-01) - - - clients: Open web app in a new browser tab - - - matrix-synapse: Change client diagnostics url - - - minetest: Fix duplicate domain names being displayed in UI - - - storage: Do not show an eject button on /boot partitions - - - letsencrypt: Call letsencrypt manage_hooks with correct arguments - - - dynamicdns: Install module by default - - - storage: Don't check type of the disk for / and /boot - - - storage: Don't log error when checking if partition is expandable - - - Updated translations for Norwegian Bokmål, Czech, German, Hungarian, Spanish, German, and Russian. - - -
-
- FreedomBox 19.3 (2019-03-18) - - - UI: Move tabs below descriptions. - - - firewall: Style heading - - - names: Add description - - - pagekite: Change heading text - - - ikiwiki: Consistent styling for delete warning page - - - main: Show service version in logs - - - setup: Organize data files into various apps - - - Updated translations for Czech, Hungarian, Norwegian Bokmål, Spanish, German, French, Italian, and Turkish. - - -
-
- FreedomBox 19.2 (2019-03-02) - - - config: Fix Ikiwiki entries not showing up as default apps - - - config: Migrate default app configuration to new conf file - - - config: Rename Default App to Webserver Home Page - - - config: Add option to use Apache's default home page as home page - - - config: Fix error when setting JSXC as the home page - - - Disable Coquelicot for Buster release - - - matrix-synapse: Fix LDAP login issue - - - config: Revert changes in freedombox.conf to avoid conffile prompt - - - openvpn: Migration from easy-rsa 2 to 3 for existing installations - - - tor: Use fixed 9001 port for relaying - - - package: Implement identifying packages that need conffile prompts - - - setup: Trigger force upgrade for app that implement it - - - bind: Handle conffile prompt during upgrade - - - apache: Pre-enable necessary apache modules - - - apache: Use cgid module instead of cgi - - - openvpn: Make frontpage shortcut appear after an upgrade - - - openvpn: Work around firewalld bug 919517 - - - firewalld: Implement upgrading from 0.4.x to 0.6.x - - - ttrss: Implement upgrade from 17.4 to 18.12 - - - radicale: Add description of web interface - - - ttrss: Add backup support - - - security: Migrate access config to new file - - - Updated translations for Czech, Hungarian, Norwegian Bokmål, Spanish, German, Telugu. - - -
-
- FreedomBox 19.1 (2019-02-14) - - - radicale: Increment module version to trigger upgrade handling - - - radicale: Remove obsolete diagnostics - - - radicale: Fix server URLs in client info - - - Updated translations for Czech, Norwegian Bokmål, and Spanish. - - - setup: Add option to handle configuration prompts during install - - - radicale: Simplify upgrading to newer packages - - - matrixsynapse: Use Let's Encrypt certificates - - -
-
- FreedomBox 19.0 (2019-02-09) - - - mldonkey: Add some more clients to the module page - - - mldonkey: Add to the description the three available front-ends - - - monkeysphere: Fix handling of multiple domains and keys - - - monkeysphere: Fix regression with reading new apache domain config - - - apache: Switch to mod_ssl from mod_gnutls - - - mldonkey: Enable app - - - upgrades: Fix priority for buster-backports version - - - upgrades: Fix premature adding of buster-backports sources - - - Updated translations for Czech, German, and Spanish - - - Switched to a new version number scheme: YY.N - - - YY is the year of release. - - - N is the release number within that year. - - - - -
-
- Version 0.49.1 (2019-02-07) - - - ui: Fix regression with configure button in home page. - - - backups: Rename 'Abort' buttons to 'Cancel'. - - - backups: Use icon for add repository button. - - - backups: Move subsubmenu below description. - - - backups: Add title and description to other pages. - - - backups: Add link to manual page. - - - backups: Fix styling for upload size warning. - - - backups: Increase timeout for SSH operations to 30 seconds. - - - letsencrypt: UI: Fix checkbox disabling. - - - datetime: Switch from chrony to systemd-timesyncd. - - - Updated translations for Czech, Norwegian Bokmål, and Spanish. - - -
-
- Version 0.49.0 (2019-02-05) - - - security: Update javascript for Content Security Policy. - - - help: Use correct package to determine available version. - - - repro: Disable app due to issues with Debian package. - - - ui: Fix regression with card icon style in front page. - - - js: Support full librejs compatibility. - - - js: Remove javascript license link from footer. - - - backups: Remove incorrectly set buffer size during download. - - - backups: Fix incomplete download archives. - - - backups: Improve performance of backup download. - - - radicale: Handle migration from 1.x to 2.x. - - - datetime: Switch from ntp to chrony. - - - backports: Add buster-backports to apt sources list. - - - Updated translations for Czech, Norwegian Bokmål, and Hungarian. - - -
-
- Version 0.48.0 (2019-01-28) - - - Updated translations for Czech, Hungarian, German, and Norwegian Bokmål. - - - UI improvements: - - - Fix top margin for content containers. - - - Fix setting width of card-list at various page sizes. - - - Show help nav item text when navbar is collapsed. - - - Hide restart/shutdown items when navbar is collapsed. - - - Compact pages on extra small screen sizes. - - - - - Backups improvements: - - - Add backup/restore support for syncthing and openvpn. - - - Upgrade apps before restoring them - - - Fix showing not-installed apps in create backup page - - - Automatically install required apps before restore. - - - Add a loader to the restore button to indicate progress. - - - - - Serve default favicon for apps that don't provide one. - - - radicale: Fix issue with configuration changes not applying. - - - storage: Fix false error message in log when visiting home page. - - - infinoted: Handle timeout issue when stopping daemon during setup. - - - matrix-synapse: Fix startup error caused by bind_address setting. - - - radicale: Avoid changes to conffile for radicale 2.x. - - - help: Fix showing status logs when an error occurs. - - - fail2ban: Enable bans for apache auth failures. - - - mldonkey: Initial work on new module for the eDonkey network. - - - Not available yet, due to bug in package. - - - - -
-
- Version 0.47.0 (2019-01-14) - - - Show Gujarati in the list of languages. - - - Replace glyphicons with forkawesome icons. - - - Snapshots: - - - Change configuration to avoid filling up disk. - - - Handle "Config in use" error. - - - Update descriptions and configuration options. - - - - - Firewall: Fix issue with transition from iptables. - - - Security: Switch to Argon2 password hash. - - - Cockpit: Add link to manual page and update description. - - - Radicale: Add initial support for radicale 2.x. - - - Setup: - - - Handle showing setup page after app completes installation. - - - Optimize installation in-progress checks and refresh time. - - - - -
-
- Version 0.46.0 (2018-12-31) - - - Updated translations for Czech, German, Spanish, Ukrainian, and Norwegian Bokmål. - - - Use systemd journal for logging. - - - Rename plinth binary package to "freedombox", and merge freedombox-setup package into it. - - -
-
- Version 0.45.0 (2018-12-17) - - - Storage: Merge list of removable media into existing table. - - - Backups: Allow remote backups to SSH servers using sshfs. - - - Backups: Removed asking for backup archive name. - - - Automatically handle future versions of PHP. - - - Updated translations for Hungarian, Czech, Spanish, Chinese (Simplified), Italian, Norwegian Bokmål, French, and German. - - -
-
- Version 0.44.0 (2018-12-03) - - - UI: Add card style and gray noise background to apps pages. - - - UI: Fix distortion of the client apps buttons. - - - ejabberd: Handle BOSH port change from TCP 5280 to 5443. - - - Minetest: Update mods list to available Debian packages. - - - Firewall: Use nftables instead of iptables. - - - Snapshots: Fix default snapshot listing. - - - Snapshots: Show description above either tab. - - - Snapshots: Allow snapshots to be selected for deletion. - - - Translations: Updated Czech, Norwegian Bokmål, Spanish, German, and Portuguese. - - -
-
- Version 0.43.0 (2018-11-19) - - - Backups improvements: - - - Allow backups to be downloaded directly, without export step. - - - Restore directly from uploaded backup. - - - Avoid error for apps with no data to backup. - - - Show free disk space on upload and restore page. - - - Do not limit maximum upload size. - - - - - openvpn: Migrate to easy-rsa 3 and fix setup issues. - - - Make single sign-on tickets valid for 12 hours. - - - Use consistent terminology for updates. - - - Updated translations for Czech and Portuguese. - - -
-
- Version 0.42.0 (2018-11-05) - - - Fix wrong color in mobile menu - - - snapshot: Fix broken snapshot management after snapper update - - - Enable backup/restore for tor, upgrades, monkeysphere, letsencrypt, tahoe - - - monkeysphere: Handle importing new OpenSSH format keys - - - udiskie: unmount drive as superuser - - - Updated translations for Telugu, Indonesian, and Italian - - -
-
- Version 0.41.0 (2018-10-22) - - - Enable backup/restore for datetime, deluge, avahi, backups, bind, security, snapshot, ssh, firewall, diagnostics, names, power, and storage. - - - snapshot: Fix issue with setting configuration. - - - backups: Fix backup archives ownership issue. - - - backups: Fix issue with showing exports from disks without labels. - - - backups: Don't rely on disk labels during export/restore. - - - backups: Fix downloading extracted archive files. - - - Updated translations for Norwegian Bokmål, French, Russian, and Spanish. - - -
-
- Version 0.40.0 (2018-10-08) - - - Backups - - - Enable backup/restore for mumble, privoxy, roundcube, searx, jsxc, coquelicot, transmission, quassel, shadowsocks, sharing, pagekite, and cockpit. - - - Allow backup archives to be downloaded/uploaded through browser. - - - mediawiki: Backup/restore settings as well as data. - - - - - User Interface - - - Change card text style and position. - - - Change maximum cards per row. - - - Add tint effect on card icons under "Apps". - - - - - mediawiki: Run update script for 1.31 upgrade. - - - customization: Show custom shortcuts on frontpage. - - - Updated translations for Norwegian Bokmål, Portuguese, Spanish, Czech, German, French, and Italian. - - -
-
- Version 0.39.0 (2018-09-24) - - - Updated translations for Hungarian and Norwegian Bokmål. - - - Merge Removable Media (udiskie) into Storage module. - - - Add Backups module for backing up apps data. - - -
-
- Version 0.38.0 (2018-09-10) - - - mediawiki: Enable SVG support for MediaWiki - - - upgrades: Clean up old kernel packages during automatic upgrades - - - Make the progress bar at the top of the page more visible. - - - Updated translations for Norwegian Bokmål, Czech, Russian, German, Hungarian, and Spanish. - - -
-
- Version 0.37.0 (2018-08-27) - - - Updated translations for Czech, Norwegian Bokmål, Russian, Spanish, Hungarian, and Dutch. - - - install: Use Post/Response/Get pattern for reloads. - - -
-
- Version 0.36.0 (2018-08-13) - - - Updated translations for Hindi, Spanish, Russian, Telugu, German, Hungarian, Czech, and French - - - ejabberd: Remove deprecated settings from already existing config files - - - mediawiki: Fix issue with re-installation - - - mediawiki: Enable Instant Commons - - - mediawiki: Fix images throwing 403s - - - turbolinks: Reload page using JavaScript - - - Add Lato woff2 fonts - - - Disable launch button for web client when not installed - - -
-
- Version 0.35.0 (2018-07-30) - - - configuration: Add an option to set a default app for FreedomBox. The root URL path (https://domainname/) will redirect to the selected app. - - - ejabberd: Remove deprecated iqdisc setting. To apply this fix, disable and then re-enable the Message Archive Management setting. - - - ejabberd: Replace logo with original version. - - - mediawiki: Enable short URLs, which look like https://domainname/mediawiki/ArticleName. - - - radicale: Clarify description for shared calendar/addressbook. - - - storage: Handle mount points with spaces. - - - udiskie: Add button to eject drives. - - - udiskie: Also show read-only filesystems. - - - udiskie: Remove internal networks warning. - - - udiskie: Show special message when no storage device available. - - - Add turbolinks library for smoother navigation. - - - Removed extra text from icons for mediawiki, radicale, and tahoe-lafs. - - - Updated translations for Russian, Spanish, Dutch, Hungarian, Hindi, Italian, Telugu, German, and Norwegian Bokmål. - - -
-
- Version 0.34.0 (2018-07-16) - - - Prompt for secret during firstboot welcome - - - (Does not apply to downloadable FreedomBox images, but only when installed using freedombox-setup package.) - - - - - Updated translations for Italian, Dutch, Hindi, Hungarian - - -
-
- Version 0.33.1 (2018-07-04) - - - Fix issue where editing a user would remove them from admin group - - - Updated translations for Hungarian, Czech, Spanish, Russian, Hindi - - -
-
- Version 0.33.0 (2018-07-02) - - - Updated translations for Hungarian, Norwegian Bokmål, Spanish, Russian, Czech, Hindi, Dutch, Italian - - - firewall: Display information that a service is internal only - - - users: Don't show Create User link to non-admin users - - - users: Redirect to users list on successful user creation - - - packages: Show button to refresh package lists when a package is not available for install - - - Only show front page shortcuts that a user is allowed to access - - - Restrict removal of last admin user - - - Use logos instead of icons in the apps page - - - udiskie: New module for automatic mounting of removable media - - -
-
- Version 0.32.0 (2018-06-18) - - - Apply new card based design - - - Fix client info table size and flickering - - - first-setup: Automatically expand root partition - - - mediawiki: Enable image uploads - - - mediawiki: Make private mode and public registrations mutually exclusive - - - mediawiki: Hide frontpage shortcut when private mode is enabled - - - Updated translations for Norwegian Bokmål, Czech, Spanish, Russian, Hindi, Telugu, Italian, Dutch, German, and Hungarian - - -
-
- Version 0.31.0 (2018-06-04) - - - Updated translations for Czech, Spanish, Russian, German, Italian, Hindi, Telugu, and Norwegian Bokmål - - - mediawiki: Added private mode option - - - users: Fix user permissions not being saved - - - users: internationalize a string - - - mediawiki: Run update script for 1.30 upgrade - - - shortcuts: Fix urls for ikiwiki shortcuts - - -
-
- Version 0.30.0 (2018-05-21) - - - Updated translations for Russian, Italian, Norwegian Bokmål, Hungarian, and Hindi - - - setup: Remove unavailable as a state in setup_helper - - -
-
- Version 0.29.1 (2018-05-08) - - - security: Fix issue with Plinth locked out from sudo - - - Updated translations for Czech and Spanish - - -
-
- Version 0.29.0 (2018-05-07) - - - security: Allow console login access to user plinth - - - Add an option to enable/disable public registrations in mediawiki - - - tt-rss: Skip the check for SELF_URL_PATH - - - searx: Fix issue with uwsgi crashing - - - Updated translations for Czech, Spanish, German, Norwegian Bokmål, and Italian - - -
-
- Version 0.28.0 (2018-04-23) - - - setup: disable install button for currently unavailable apps - - - Add locale for Lithuanian (lt) - - - Translation updates for Italian, Czech, Russian, Spanish, German, Norwegian Bokmål, Telugu, and Dutch - - -
-
- Version 0.27.0 (2018-04-09) - - - middleware: Skip 'installed' message for essential apps - - - users: Fix admin group appearing twice in permissions - - - apps: Fix app names and short descriptions not being translated - - - snapshots: Move manual page link to the index page - - - UI: Fix progress bar not appearing - - - snapshots: Fix for permissions issue when updating configuration - - - snapshots: Add option to enable/disable software installation snapshots - - - Translation updates for Italian, Czech, Russian, Spanish, Dutch, German, Norwegian Bokmål, and Ukrainian - - -
-
- Version 0.26.0 (2018-03-26) - - - snapshots: Update description - - - searx: Rewrite url from /searx to /searx/ - - - manual: Link to manual from each service - - - Workaround security issues in django-axes - - - apache: Only regenerate snake oil cert when needed - - - apache: Explicitly enable the latest version of PHP module - - - apache: Increase module version number to fix php7.2 - - - Update translations for Chinese (Simplified), Russian, Czech, German, Norwegian Bokmål, Hungarian, Spanish, and Italian - - -
-
- Version 0.25.0 (2018-03-12) - - - sharing: Add app for sharing disk folders. - - - ttrss: Update list of client apps. - - - infinoted: Allow setup to recover after timeout issue. - - - snapshots: Add configuration tab with settings for time-based snapshots. - - -
-
- Plinth v0.24.0 (2018-02-26) - - - Add file-sharing application Coquelicot. - - - Add metasearch engine application Searx. - - - Add locale for Hungarian (hu). - - - mediawiki: Allow shortcut to be publicly visible on front page. - - - clients: Add and correct Client Apps. - - - locale: Preferred language can be set in each user's profile. - - - locale: Anonymous users can select preferred language. - - - config: Remove language selection from config page. - - - matrixsynapse: Fix mail attribute for ldap login. - - -
-
- Plinth v0.23.0 (2018-02-12) - - - snapshots: Modify configurations to reduce disk usage. - - - snapshots: Skip currently active snapshot when deleting all snapshots. - - - jsxc: Use consistent url format. - - - sso: Increase timeout to 60 minutes. - - - theme: Change font from Helvetica to Lato. - - - Translation updates for Czech, German, Gujarati, and Telugu. - - -
-
- Plinth v0.22.0 (2018-01-30) - - - matrix-synapse: Make sure configuration file does not get corrupted. - - - tor: Show enabled status properly. - - - first_setup: Fix not showing admin user creation step. - - - Migrate from GitHub to Salsa - - - Migrate from CirceCI to GitLab CI on Salsa. - - - Translation updates for Czech, Dutch, Gujarati, Hindi, Russian and Telugu. - - - Started new translation for Ukrainian. - - -
-
- Plinth v0.21.0 (2018-01-15) - - - navigation bar: Change label from 'Configuration' to 'System'. - - - storage: Removed beta warning for expanding partition. - - - groups: Consistently show available user groups, even before applications are installed. - - - syncthing: Restrict administration to users in "syncthing" group. - - - help: Show menu on smaller screens also. - - - diagnostics: Enable the "Run Diagnostics" button when applications are enabled but not running. - - -
-
- Plinth v0.20.0 (2018-01-01) - - - bind: Don't use forwarders by default - - - ejabberd: Remove redundant button Client Apps - - - mediawiki: Add wiki application - - - users: Make sure first run actually works - - - bind: Add information about current utility - - -
-
- Plinth v0.19.0 (2017-12-18) - - - ejabberd: Use dynamic reload instead of restart when changing configuration. - - - manual: Make manual available as a PDF download. - - - minetest: Show domain information for users to connect to minetest. - - - snapshots: Add button to delete all snapshots. - - - snapshots: Add option to enable/disable automatic timeline snapshots. - - - users: Add groups for bit-torrent and feed-reader, available when these applications are installed. - - -
-
- Plinth v0.18.0 (2017-12-04) - - - Add Shadowsocks client with socks5 proxy. - - - Fix SSO regressions and conflict with captcha. - - - transmission: Fix sso not being enabled on upgrade. - - - avahi: Add service for FreedomBox discovery. - - - Add client information for modules. - - -
-
- Plinth v0.17.0 (2017-11-20) - - - transmission: Enable Single Sign On. - - - cockpit: Add short description to frontpage shortcut. - - - fail2ban: Fix spelling and sentence structure. - - -
-
- Plinth v0.16.0 (2017-11-06) -
- Added - - - Add mobile, web and desktop client info for modules. - - - Enable django SecurityMiddleware to improve security ratings. - - - cockpit: New module for server administration and web terminal. - - -
-
- Fixed - - - letsencrypt: Fix internal server error when obtaining a certificate. - - - ejabberd: Fix LDAP server entry in config file during setup. - - - jsxc: Fix outdated URLs for connecting to local ejabberd server. - - -
-
-
- Plinth v0.15.3 (2017-10-20) -
- Changed - - - Rename Disks to Storage. - - - Rename Snapshot to Storage Snapshots. - - - tt-rss: Enable API access by default. - - - Allow access to Plinth from outside the LAN. - - - matrix-synapse: Disable public registration by default. - - - power: Merge actions into the user dropdown. - - -
-
- Added - - - Add locales for Kannada (kn) and for Bengali (bn). - - - ejabberd: Use Let's Encrypt certificate, also across renewals. - - - matrix-synapse: Add enable/disable public registrations. - - - Add captcha validation on 3 failed attempts. - - - matrix-synapse: Enable LDAP integration. - - - letsencrypt: Automatically obtain and revoke SSL certificates. - - -
-
- Fixed - - - Fix front page label names. - - - Fix vertical alignment of shortcut icons. - - - storage: Fix issue with locales that use other decimal separators. - - - Make tt-rss api accessible using Apache basic auth. - - - letsencrypt: Handle case where current domain is empty. - - - Handle both admin and non-admin user names in update user template. - - -
-
-
- Plinth v0.15.2 (2017-09-24) -
- Added - - - letsencrypt: Show more info on cert validity status. - - - letsencrypt: Add option to delete certificates. - - - letsencrypt: Add option to let Plinth manage certbot's renewal hooks. - - - power: Warn if a package manager is running before shutdown/restart. - - - security: Install and manage fail2ban. - - - names: Include domain and services from dynamicdns. - - - disks: Add low disk space warning to system and disks page. - - - ssh: New application to manage SSH server. - - - Add api module to get enabled services and access info. - - - Add Django password validators. - - - ejabberd, ikiwiki, ttrss: Add user login descriptions. - - -
-
- Removed - - - diaspora: Disable for this release due to issues affecting package. - - - Remove help from navbar before firstboot complete. - - -
-
- Fixed - - - i18n: Don't use backslash-newline for wrapping long lines. - - - radicale: Update link to documentation. - - - sso: Upgrade crypto to 4096-bit RSA and SHA-512. - - - Users: Allow non-admin users to log out. - - -
-
- Changed - - - letsencrypt: Make Let's Encrypt an essential module. - - - UI: Make apps and configure pages responsive on small screens. - - - Make help accessible for logged-in non-admin users. - - -
-
-
- Plinth v0.15.0 (2017-07-01) - - - Added Tahoe-LAFS module for distributed file storage. - - - Added Diaspora* module for federated social networking. - - - Currently only available in "contrib" repository. - - - - - New Locales for Czech (cs) and Tamil (ta). - - - Added SSO using auth_pubtkt for Syncthing, TT-RSS, and the Repro admin panel. - - - If you are logged in to Plinth, you will be automatically logged in to these web apps. - - - - - ejabberd: Added option to enable/disable Message Archive Management. - - - help: Added Debian release name to about page. - - - firstboot: De-bloat first welcome screen. - - - Pinned footer to the bottom of the viewport. - - - disks: Restrict precision of reported available space on root partition. - - - diagnostics: Disable button if app/service is not running. - - - help: Only show help pages if user is logged in. - - - navbar: Moved logout to user drop-down and added a new power drop-down. - - - disks: Show disabled partition resize option if no space is available. - - - Added line break to titles to fix frontpage layout. - - - syncthing: Fixed typos and clarity in description. - - - firewall: Fix 500 error when firewalld is not running. - - - setup: Disable install/upgrade when dpkg/apt is running. - - - disks: Use information from lsblk for more accuracy. - - - datetime: Show timezone properly when it not in expected list. - - -
-
- Plinth v0.14.0 (2017-04) - - - tor: Added option to use upstream bridges. - - - openvpn: Added shortcut to front page, shown only when logged-in. - - - openvpn: Non-admin users can download their own profiles. - - - Added new locales for Hindi (hi) and Gujarati (gu). - - - Added Syncthing module for file synchronization. - - - Added Matrix Synapse as chat server with groups, audio and video. - - - Require admin access for all system configuration pages. - - - Changed appearance of topbar and footer. - - - openvpn: Regenerate user key or certificate if empty. - - - disks: Workaround issue in parted during resize. - - -
-
- Plinth v0.13.1 (2017-01-22) - - - Two new apps were added: - - - Gobby Server (infinoted) for collaborative editing of text documents - - - Domain Name Server (BIND), in system menu - - - - - Added JavaScript license web labels to provide partial support for LibreJS. - - - Added basic configuration form for Minetest server. - - - Added indicator to Help->About page if new Plinth version is available. - - - Show app logos on front page instead of generic icons. - - - Prevent anonymous users from accessing setup pages. - - - Split Chat Server (XMPP) app into Chat Server (ejabberd) and Chat Client (jsxc). - - -
-
- Plinth v0.12.0 (2016-12-08) - - - Open up RTP ports in the firewall for repro (SIP server). - - - Front page shortcuts for services show a Configure button in the details box for logged-in users. - - - Add mods packages to be installed with Minetest server. - - - Fix issue with reading Dynamic DNS status as non-root user. - - - After the hostname is changed, ensure the domain name is still set correctly. - - - Allow the domain name to be cleared, and properly set the configuration in this case. - - - On the Certificates (Let's Encrypt) page, show a more informative message when no domains are configured. - - - On the Chat Server (XMPP) page, show more clearly if domain is not set. - - - Apps that require login will not be shown on the front page, unless the user is logged in. - - - Show status block for News Feed Reader (Tiny Tiny RSS). - - - Change appearance of front page with larger icons and repositioned text. - - - Firewall page only lists services that have been setup. The port lists are collapsible under each service. - - - Support configuring IPv6 networks. - - - Make it less likely to accidentally delete the only Plinth user. - - - Updated to work with JSXC 3.0.0 (XMPP web client). - - -
-
- Plinth v0.11.0 (2016-09-29) - - - Added loading icon for additional busy operations. - - - Added basic front page with shortcuts to web apps, and information about enabled services. - - - networks: Add batctl as dependency, required for batman-adv mesh networking. - - - users: - - - Fixed checking restricted usernames. - - - Display error message if unable to set SSH keys. - - - Flush nscd cache after user operations to avoid some types of errors. - - - - - monkeysphere: - - - Adopted to using SHA256 fingerprints. - - - Sort items for consistent display. - - - Handle new uid format of gpg2. - - - Fixed handling of unavailable imported domains. - - - - - minetest: Fixed showing status block and diagnostics. - - - Fixed stretched favicon. - - - Switched base template from container-fluid to container. This will narrow the content area for larger displays. - - - Plinth is now able to run as "plinth" user instead of root user. - - - xmpp: Replaced jwchat with jsxc. - - - ikiwiki: Allow only alphanumerics in wiki/blog name to avoid invalid paths. - - -
-
- Plinth v0.10.0 (2016-08-21) - - - Updated Plinth to support Django 1.10. - - - Added a page to display recent status log from Plinth. It is accessible from the 500 error page. - - - Tor: Added options to toggle relay and bridge relay modes. - - - Radicale: Added access rights control. - - - Ikiwiki: Updated suggested packages. - - - Users and Groups: Fixed editing users without SSH keys. - - - Networks: Added basic support for configuring batman-adv mesh networking. - - - Networks: Fixed incorrect access for retrieving DNS entries. - - - New languages: - - - Persian (50% translated) - - - Indonesian (not started, contributions needed) - - - - - New modules added to Plinth: - - - Disks: Shows free space of mounted partitions, and allows expanding the root partition. - - - Security: Controls login restrictions. - - - Snapshots: Manages Btrfs snapshots. - - - - -
-
- Version 0.9.4 (2016-06-24) - - - Added Polish translation. - - - Fixed issue preventing access to Plinth on a non-standard port. - - - Dealt with ownCloud removal from Debian. The ownCloud page in Plinth will be hidden if it has not been setup. Otherwise, a warning is shown. - - - Fixed issue in Privoxy configuration. Two overlapping listen-addresses were configured, which prevented privoxy service from starting. - - - Fixed issue that could allow someone to start a module setup process without being logged in to Plinth. - - - Fixed issues with some diagnostic tests that would show false positive results. - - - Added check to Diagnostics to skip tests for modules that have not been setup. - - - Fixed some username checks that could cause errors when editing the user. - - - Added sorting of menu items per locale. - - - Moved Dynamic DNS and Pagekite from Applications to System Configuration. - - - Allowed setting IP for shared network connections. - - - Switched Dreamplug image from "non-free" to "free". This means that we no longer include the non-free firmware for the built-in wifi on Dreamplug. - - - Added the "userdir" module for the Apache web server. This allows users in the "admin" group to create a folder called "public_html" under their home folder, and to publicly share files placed in this folder. - - - New wiki and manual content licence: Creative Commons Attribution-ShareAlike 4.0 International (from June 13rd 2016). - - - Switched to using apt-get for module setup in Plinth. This fixes several issues that were seen during package installs. - - -
-
- Version 0.9 (2016-04-24) - - - Fixed Wi-Fi AP setup. - - - Prevent lockout of users in 'sudo' group after setup is complete. - - - Improved setup mechanism for Plinth modules. Allows users to see what a module is useful for, before doing the setup and package install. Also allows essential modules to be setup by default during FreedomBox install. - - - Added HTTPS certificates to Monkeysphere page. Reorganized so that multiple domains can be added to a key. - - - Added Radicale, a CalDAV and CardDAV server. - - - Added Minetest Server, a multiplayer infinite-world block sandbox. - - - Added Tiny Tiny RSS, a news feed reader. - - -
-
- Version 0.8 (2016-02-20) - - - Added Quassel, an IRC client that stays connected to IRC networks and can synchronize multiple frontends. - - - Improved first boot user interface. - - - Fixed Transmission RPC whitelist issue. - - - Added translations for Turkish, Chinese, and Russian. Fixed and updated translations in other languages. - - - Added Monkeysphere, which uses PGP web of trust for SSH host key verification. - - - Added Let's Encrypt, to obtain certificates for domains, so that browser certificate warnings can be avoided. - - - Added repro, a SIP server for audio and video calls. - - - Allow users to set their SSH public keys, so they can login over SSH without a password. - - -
-
- Version 0.7 (2015-12-13) - - - Translations! Full translations of the interface in Danish, Dutch, French, German and Norwegian Bokmål, and partial Telugu. - - - Support for OLinuXino A20 MICRO and LIME2 - - - New Plinth applications: OpenVPN, reStore - - - Improved first-boot experience - - - Many bugfixes and cleanups - - -
-
- Version 0.6 (2015-10-31) - - - New supported hardware target: Raspberry Pi 2 - - - New modules in Plinth: - - - Shaarli: Web application to manage and share bookmarks - - - Date & Time: Configure time zone and NTP service - - - Service Discovery: Configure Avahi service - - - - - Documentation revamp including new user manual and developer guide - - - Improved diagnostic tests, available in Plinth - - - Avoid unnecessary changes when installing on existing Debian system - - - Network configuration supports PPPoE connections - - - Debian packages can be download over Tor - - -
-
- Version 0.5 (2015-08-07) - - - New targets: CubieTruck, i386, amd64 - - - New apps in Plinth: Transmission, Dynamic DNS, Mumble, ikiwiki, Deluge, Roundcube, Privoxy - - - NetworkManager handles network configuration and can be manipulated through Plinth. - - - Software Upgrades (unattended-upgrades) module can upgrade the system, and enable automatic upgrades. - - - Plinth is now capable of installing ejabberd, jwchat, and privoxy, so they are not included in image but can be installed when needed. - - - User authentication through LDAP for SSH, XMPP (ejabberd), and ikiwiki. - - - Unit test suite is automatically run on Plinth upstream. This helps us catch at least some code errors before they are discovered by users! - - - New, simpler look for Plinth. - - - Performance improvements for Plinth. - - -
-
- Version 0.3 (2015-01-20) - - - Tor Bridges: All boxes now act as non-exit Tor bridges, routing traffic for the Tor network. - - - Firewall: firewall is on by default and is automatically managed. - - - Add BeagleBone support. We now have images for BeagleBone, RaspberryPi, VirtualBox i386/amd64, and DreamPlug. - - - Ability to enable and use Tor Hidden Services. Works with Ejabberd/JWChat and ownCloud services. - - - Enable Tor obfsproxy with scramblesuit. - - - Drop well-known root password (an account with sudo capabilities still exists for now but will be removed soon). - - - Switch to unstable as suite of choice for easier development. - - - Newer images are built with systemd by default (due to Debian change). - - - Install and operate firewall automatically (uses firewalld). - - - Major restructuring of Plinth UI using Python3, Django web development framework and Bootstrap3. Code quality is much better and UI is more polished. - - - Introduced packaging framework in Plinth UI for on-demand application installation. - - -
-
- Version 0.2 (2014-03-16) - - - Support for Raspberry Pi and VirtualBox (x86) in addition to the DreamPlug. - - - New Services: - - - Configuration Management UI. - - - Instant Messaging. - - - OwnCloud. - - - dnsmasq. - - - Low-Level Configuration Management. - - - Service Announcement. - - - LDAP Server. - - - LXC Support. - - - Source Packages. - - - - - The privoxy setup is now the default from Debian. - - -
-
- Version 0.1 (2013-02-26) - - - First FreedomBox software release (0.1 image, developer release). - - - Full hardware support in Debian - - - Support for DreamPlug. - - - Basic software tools selected as common working environment: - - - User interface system "plinth" - - - Cryptography tools: gpg or "monkeysphere" - - - Box-to-box communication design: Freedom-buddy (uses TOR network) - - - Web cleaning: "privoxy-freedombox". - - - - -
-
-
-
- Contributing - From code, design and translation to spreading the word and donation, here are a number of ways to contribute to FreedomBox. -
- Quick Links - - FreedomBox Developer Manual - - - Progress calls - - - TODO page - - - Donation page - -
-
- Welcome to newcomers - As a new contributor, you are more than welcome to introduce yourself to others on the FreedomBox discussion forum, mailing list or on the #freedombox IRC channel. In addition to make useful contacts, you can start reporting bugs and translate (see below) the wiki website and the FreedomBox web interface. -
-
- Development priorities - Upcoming priorities are discussed on an regular basis. You find the progress of the FreedomBox Service with its priorities here: issues board and milestones. - Please check next progress calls to keep yourself on track and meet members of the release team. A TODO page aggregates the complete list of the items to work on for FreedomBox. -
-
- Contributions needed -
- Add an Application - If you are a developer and wish to see an application available in FreedomBox, you can contribute by adding the application to FreedomBox. See the FreedomBox Developer Manual. -
-
- Bugs - List of bugs, feature requests and improvements are tracked on the FreedomBox issue tracker. In addition to that, see list of bugs to help out the Debian package we depend on. Also see the FreedomBox packaging team's dashboard for status of various packages that we use. -
-
- Code - If you are a developer, you can contribute code to one of the sub-projects of FreedomBox. Step-by-step process of contributing code to FreedomBox is available. - - - FreedomBox Service: a web interface to administer the functions of FreedomBox. - - - Freedom Maker: a script to build FreedomBox disk images for use on various hardware devices or virtual machines. - - - You can pickup a task from one of the TODO lists. The individual page project pages contain information availabily of the code, how to build and TODO lists. -
-
- Design -
- User Experience Design - If you are a user experience designer, you can help FreedomBox with the following items: - - - UI experience for the FreedomBox Service web interface - - - Web design for freedombox.org, freedomboxfoundation.org and the wiki pages - - - Logo and branding (we currently have an identity manual and logos) - - - Possible designs for custom FreedomBox cases on single board computers - - - - User experience design - - - -
-
- Technical Design - FreedomBox needs your technical expertise to devise implementation plans for upcoming features. You can contribute to the discussion on various technical design and implementation aspects of FreedomBox. See FreedomBox discussion forum's development category. -
-
-
- Donate - The FreedomBox Foundation is a 501(c)(3) federal nonprofit corporation with recognition from the IRS. FreedomBox project is run by volunteers. You can help the project financially by donating via PayPal, Bitcoin or by mailing a check. Please see the donation page for details on how to donate. -
-
- Document: User Manual, Website and Wiki - FreedomBox needs better documentation for users and contributors. FreedomBox manual is prepared by aggregating various pages on the wiki and exporting to various formats. The manual is then used in FreedomBox Service and elsewhere. - If you wish to contribute to the FreedomBox wiki (and consequently the FreedomBox manual), you can create a wiki account and start editing. - For contributing to the website please start a discussion on the FreedomBox discussion forum's development category. -
-
- Quality Assurance - - - FreedomBox already runs on many platforms and it is not possible for developers to test all possible platforms. If you have one of the supported hardware you can help with testing FreedomBox on the platform. - - - When an application is made available on FreedomBox, not all of its functionality is tested in the real world by developer doing the work. Deploying the application and testing it will help ensure high quality applications in FreedomBox. - - - See the quality assurance page for a basic list of test cases to check for and information on reporting bugs. -
-
- Localization - All text visible to users of FreedomBox needs to be localized to various languages. This translation work includes: - - - Web Interface for FreedomBox - - - FreedomBox documentation - - - FreedomBox wiki, website and foundation website. - - - Django web framework that FreedomBox uses. - - - Individual applications that FreedomBox exposes to users. - - - You can contribute to the localization effort using the web-based tool at Weblate or directly to the source tree via Salsa. - If you wish to see FreedomBox available for one of your languages, please start a discussion on the FreedomBox discussion forum's development category to work with others translating for that language. - For more information, please visit the FreedomBox translators page. -
-
- Spread the Word - Speak to your family, friends, local community or at global conferences about the importance of FreedomBox. To be a successful project we need many more participants, be it users or contributors. Write about your efforts at the talks page and on the wiki. -
-
-
-
- Developer Guide - The FreedomBox Developer Manual provides a step by step tutorial for writing apps for FreedomBox and an API reference. It is available from docs.freedombox.org. -
-
- Hacking - FreedomBox consists of two main projects: - - - FreedomBox Service (Plinth), the web interface - - - Freedom Maker, a script to build disk images for various hardware - - -
- FreedomBox Service (Plinth) - FreedomBox Service (Plinth) is a web interface to administer the functions of the FreedomBox. - FreedomBox Service is Free Software under GNU Affero General Public License version 3 or (at your option) a later version. -
- Using - - - FreedomBox Service comes installed with all FreedomBox images. You can download FreedomBox images and run on any of the supported hardware. Then, you can access FreedomBox Service by visiting the URL or . - - - If you are on a Debian box, you may install FreedomBox Service from Debian package archive. Currently, only Buster (stable), Bullseye (testing), and Sid (unstable) are supported. To install FreedomBox Service run: - - - - - - You can also get FreedomBox Service from its Git repository and install from source. - - -
-
- Screenshots - - - - - - - - Home Page - - - - - - - - - - Apps Page - - - - - - - - - - System Page - - - - - - - - - - - - Enabling Tor Onion Services - - - - - - - - - - Newsfeed from anywhere - - - - - - - - - - Email Client - - - - - - - - - - - - Manual Pages - - - - - - - - - - About Page - - - - -
-
- Support - You may ask for support on - - - - The discussion forum - - - - - The mailing list - - - - - #freedombox IRC channel - - - - - FreedomBox Matrix channel - - - -
-
- Contributing - We are looking for help to improve FreedomBox Service. You can contribute to FreedomBox Service by not just by coding but also by translating, documenting, designing, packaging and providing support. - - - Instructions on how to contribute code are available. - - - The primary Git repository is hosted at FreedomBox Salsa Page. - - - Instructions for installing from source and hacking the source are available. - - - List of bugs, TODO items and feature requests are available on the issue tracker. - - - Before contributing to FreedomBox Service code, you need understand Python and Django on top which it is built. - - - You can request for development assistance on the discussion forum, the mailing list or the #freedombox IRC channel. - - -
- Debian Package - - - FreedomBox Service is packaged for Debian. FreedomBox Service is a native package and packaging source code is part of the main package source code. - - - Issues related to packaging are listed on Debian BTS. - - -
-
-
-
- Freedom Maker - Freedom Maker is a script to build FreedomBox disk images for use on various hardware devices or virtual machines. - Freedom Maker can currently build FreedomBox disk images for the following: - - - - A20-OlinuXino-LIME - - - - - A20-OlinuXino-LIME2 - - - - - A20-OLinuXino-MICRO - - - - - Banana Pro - - - - - BeagleBone - - - - - Cubieboard2 - - - - - Cubietruck - - - - - pcDuino3 - - - - - Raspberry Pi 2 - - - - - Raspberry Pi 3 Model B - - - - - Raspberry Pi 3 Model B+ - - - - - VirtualBox - - - - - QEMU - - - - AMD64 (x86-64) Machines, X86 Machines and other virtual machines (using raw disk images) - - - If a hardware platform is capable of running Debian, it should not be too much effort adopt Freedom Maker to create FreedomBox images for the platform. - Freedom Maker is Free Software licensed under GNU General Public License version 3 or (at your option) a later version. -
- Building FreedomBox Images - - - You can get Freedom Maker from its Git repository and follow the instructions in the README to build a FreedomBox image. - - -
-
- Support - You may ask for support on - - - - The discussion forum - - - - - The mailing list - - - - - #freedombox IRC channel - - - - - FreedomBox Matrix channel - - - -
-
- Contributing - We are looking for help to improve Freedom Maker. - - - Instructions on how to contribute code are available. - - - Freedom Maker is hosted at FreedomBox Salsa Project. The primary Git repository is hosted there. - - - You can contribute to FreedomBox by adding support for more hardware platforms. Freedom Maker can be easily adopted to newer platforms if they already support running Debian. - - - You can create and test images with Freedom Maker regularly to test for new features and check for regressions. - - - List of bugs, TODO items and feature requests are available on the issue tracker. - - - You can request for development assistance on the discussion forum, the mailing list or the #freedombox IRC channel. - - -
-
-
-
- Tell people around you - - - - FreedomBox - - - - - FreedomBox in the Press - - - - - Conferences - - - - - Talks and presentations - - - - Available Material Slides and other raw material - - - - - - Facebook - - - - - Twitter - - - - - Mastodon - - - - - Debconf11 Videos - - - -
-
diff --git a/doc/manual/es/Apache_userdir.raw.xml b/doc/manual/es/Apache_userdir.raw.xml deleted file mode 100644 index 5e68f9c48..000000000 --- a/doc/manual/es/Apache_userdir.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Apache_userdir82020-07-19 23:28:06fioddorTranslations header added outside include block72020-05-30 19:46:57SunilMohanAdapaUpdate the title to emphasize app name over its generic name62020-05-23 22:51:13fioddorSe alinea con la versión 07 en inglés del 23 de mayo de 202052020-03-01 11:59:06fioddorSe alinea con la versión 06 en inglés del 26 de febrero de 202042019-10-21 14:19:20fioddorCorrección menor32019-10-21 14:17:11fioddorCorrección menor22019-08-29 12:55:24fioddorCorrección menor12019-08-29 12:50:13fioddorSe crea la versión española.Translation(s): English - Español
Sitios Web de Usuario (User websites)
¿Qué es User websites?User websites es un módulo del servidor web Apache habilitado para permitir a los usuarios definidos en el sistema FreedomBox exponer un conjunto de archivos del sistema de ficheros de FreedomBox como sitio web a la red local y/o a internet de acuerdo a la configuración de la red y el cortafuegos. Datos básicos de la aplicaciónCategoría Compartición de archivos Disponible desde la versión 0.9.4Sitio web del proyecto original Documentación original de usuario
Captura de pantallaAñadir cuando/si se crea un interfaz para FreedomBox
Usar User websitesEl módulo está siempre activado y el interfaz web de FreedomBox no ofrece configuración ni página de estado para este módulo. Para servir documentos con el módulo solo se necesita poner los documentos en un subdirectorio designado /home/<un_usuario_de_plinth>/public_html. User websites servirá los archivos que haya en este directorio cuando se reciban peticiones con la URI ~<un_usuario_de_freedombox>. Por tanto para un dominio ejemplo.org con un usuario pepe una petición ejemplo.org/~pepe/index.html transferirá el fichero /home/pepe/public_html/index.html.
Usar SFTP para crear public_html y subir archivosPendiente de redactar Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Backups.raw.xml b/doc/manual/es/Backups.raw.xml deleted file mode 100644 index f377d81f8..000000000 --- a/doc/manual/es/Backups.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Backups102020-08-19 09:18:53fioddorSe alinea con la versión 33 en inglés del 19 de agosto de 202092020-05-24 07:22:56fioddorSe alinea con la versión 32 en inglés del 23 de mayo de 202082020-04-11 10:33:24fioddorhttps://salsa.debian.org/freedombox-team/plinth/-/issues/1831#note_15425872020-04-04 13:32:23fioddorCorrección menor62020-04-04 13:31:45fioddorImágenes indicativas52020-04-04 13:10:54fioddorCorrección.42020-04-04 13:09:42fioddorSe usan imágenes traducidas y más actuales.32020-04-04 13:06:11fioddorCorrección. Descripción de pasos como texto en los títulos en vez de como imágenes (mejor accesibilidad)22019-11-14 18:14:48fioddorSe alinea con la versión 31 en inglés del 11 de noviembre de 201912019-06-18 15:14:43fioddorSe crea la versión española.Translation(s): English - Español
Copias de respaldo (backups)FreedomBox incluye la posibilidad de copiar y restaurar datos, preferencias, configuración y secretos de la mayoría de las aplicaciones. La funcionalidad de Backups se resuelve con el software de backup Borg. Borg es un programa de backup con deduplicación y compresión. Está diseñado para hacer backups eficientes y seguros. Esta funcionalidad de backups se puede emplear para respaldar y recuperar datos aplicación por aplicación. Las copias de respaldado se pueden almacenar en la propia máquina FreedomBox o en un servidor remoto. Cualquier servidor remoto con acceso por SSH se puede emplear como almacenamiento para los backups de la FreedomBox. Las copias remotas se pueden cifrar para que el servidor remoto no pueda leer los datos que alberga.
Estados de la Funcionalidad de Backups App/Funcionalidad Soporte en Versión Notas Avahi - no precisa backup Backups - no precisa backup Bind 0.41 Cockpit - no precisa backup Coquelicot 0.40 incluye ficheros subidos Datetime 0.41 Deluge 0.41 no incluye archivos descargados ni semillas Diagnostics - no precisa backup Dynamic DNS 0.39 ejabberd 0.39 incluye todos los datos y configuración Firewall - no precisa backup ikiwiki 0.39 incluye todos los wikis/blogs y sus contenidos infinoted 0.39 incluye todos los datos y claves JSXC - no precisa backup Let's Encrypt 0.42 Matrix Synapse 0.39 incluye media y cargas MediaWiki 0.39 incluye páginas de wiki y archivos adjuntos Minetest 0.39 MLDonkey 19.0 Monkeysphere 0.42 Mumble 0.40 Names - no precisa backup Networks No sin planes para implementar backup, de momento OpenVPN 0.48 incluye a todos los usuarios y claves de servidor Pagekite 0.40 Power - no precisa backup Privoxy - no precisa backup Quassel 0.40 incluye usuarios y registros de ejeución (logs) Radicale 0.39 incluye calendario y datos de tarjetas de todos los usuarios repro 0.39 incluye a todos los usuarios, datos y claves Roundcube - no precisa backup SearX - no precisa backup Secure Shell (SSH) Server 0.41 incluye las claves del servidor Security 0.41 Shadowsocks 0.40 solo secretos Sharing 0.40 no incluye datos de las carpetas compartidas Snapshot 0.41 solo configuración, no incluye datos de capturas (snapshots) Storage - no precisa backup Syncthing 0.48 no incluye datos de las carpetas compartidas Tahoe-LAFS 0.42 incluye todos los datos y configuración Tiny Tiny RSS 19.2 incluye base de datos con feeds, historias, etc. Tor 0.42 includes configuración y secretos como las claves de servicios Tor Onion Transmission 0.40 no incluye archivos descargados ni semillas Upgrades 0.42 Users No sin planes para implementar backup, de momento
Cómo instalar y usar BackupsPaso 1: Ir a la página de Copias de Seguridad Backups: Paso 1 Paso 2: Pulsar el botón Instalar Backups: Paso 2 Paso 3: Esperar a que se instalen todos los componentes de la aplicación Backups: Paso 3 Paso 4: Pulsar el botón de Crear Copia de Seguridad Backups: Paso 4 Paso 5: Seleccionar las aplicaciones a respaldar y pulsar Enviar Backups: Paso 5 Paso 6: Pulsar en el botón Descargar Backups: Paso 6 Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Bind.raw.xml b/doc/manual/es/Bind.raw.xml deleted file mode 100644 index e1faf3c25..000000000 --- a/doc/manual/es/Bind.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Bind42020-05-30 19:48:23SunilMohanAdapaUpdate the title to emphasize app name over its generic name32020-05-26 14:04:08fioddorCorrección.22020-05-26 13:55:43fioddorEnlaces a traducciones12020-05-26 13:51:17fioddorNueva página traducidaTranslation(s): - English - Español
BIND (Servidor de Nombre de Dominio)BIND te permite publicar en Internet tu información de Sistema de Nombre de Dominio (DNS) y resolver consultas DNS de los dispositivos de usuario en tu red. Actualmente en FreedomBox BIND solo se usa para resolver consultas DNS de otras máquinas en tu red local. También es incompatible con compartir conexiones a Internet de tu FreedomBox. Nota: Este servicio solo está disponible en redes configuradas como zona "interna". Tampoco está disponble a través de OpenVPN (es incompatible). Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Cockpit.raw.xml b/doc/manual/es/Cockpit.raw.xml deleted file mode 100644 index 08c102abb..000000000 --- a/doc/manual/es/Cockpit.raw.xml +++ /dev/null @@ -1,3 +0,0 @@ -
es/FreedomBox/Manual/Cockpit102020-08-18 21:01:37fioddorSe alinea con la versión 08 en inglés del 18 de agosto de 202092020-05-30 19:48:03SunilMohanAdapaUpdate the title to emphasize app name over its generic name82020-05-24 07:23:47fioddorSe alinea con la versión 07 en inglés del 23 de mayo de 202072019-11-14 18:06:47fioddorSe alinea con la versión 06 en inglés del 14 de noviembre de 201962019-11-14 18:01:18fioddorSe alinea con la versión 05 en inglés del 11 de noviembre de 201952019-08-28 07:46:04fioddorTítulo explicativo y el nombre de la app entre paréntesis como aclaración adicional42019-08-22 11:10:28fioddorSe actualiza a la versión inglesa 4 del 20 de agosto de 2019.32019-07-22 17:57:58fioddorSe incorpora la traducción de una sección nueva.22019-07-01 12:32:35fioddorClaridad.12019-07-01 09:47:44fioddorSe crea la versión española.Translation(s): English - Español
Cockpit (Administración de Servidor)Cockpit es una aplicación que facilita administrar servidores GNU/Linux desde el navegador web. En una FreedomBox, hay disponibles controles para muchas funciones avanzadas que normalmente no se necesitan. También hay disponible un terminal web para operaciones de consola. Cualquier usuario del grupo de administradores de to FreedomBox puede acceder a Cockpit. Cockpit solo se puede usar si tienes una configuración de nombre de dominio apropiada para tu FreedomBox y usas ese nombre de dominio para acceder a Cockpit. Para más información mira la sección de Resolución de Problemas. Usa cockpit sólo si eres un administrador de sistemas GNU/Linux con habilidades avanzadas. FreedomBox intenta coexistir con los cambios al sistema que efectúan los administradores y sus herramientas, como Cockpit. Sin embargo, los cambios al sistema inadecuados pueden causar fallos en las funciones de FreedomBox.
Usar CockpitInstala Cockpit como cualquier otra aplicación de FreedomBox. Y a continuación asegúrate de que Cockpit está habilitado. cockpit-enable.png Asegúrate de que la cuenta de usuario de FreedomBox que se empleará con Cockpit es parte del grupo de administradores. cockpit-admin-user.png Arranca el interfaz web de Cockpit. Ingresa con la cuenta de usuario configurada. cockpit-login.png Empieza a usar cockpit. cockpit-system.png Cockpit también funciona con interfaces mobiles. cockpit-mobile.png
FuncionalidadesLas siguientes funcionalidades de Cockpit pueden ser útiles para usuarios avanzados de FreedomBox.
Cuadro de Mando del SistemaCockpit tiene un cuadro de mando del sistema que Muestra información detallada del hardware. Muestra métricas básicas de rendimiento del sistema. Permite cambiar la hora y el huso del sistema. Permite cambiar el hostname. Por favor usa el interfaz de usuario de FreedomBox UI para hacer esto. Muestra las huellas del servidor SSH. cockpit-system.png
Visualización de los Registros de Ejecución (logs) del SistemaCockpit permite consultar los registros de ejecución (logs) del sistema y examinarlos a todo detalle. cockpit-logs.png
Administración de AlmacenamientoCockpit permite las siguientes funciones avanzadas de almacenamiento: Visualización de llenado de discos. Edición de particiones de disco. Administración de RAID. cockpit-storage1.png cockpit-storage2.png
RedesTanto Cockpit como FreedomBox se apoyan en NetworkManager para configurar la red. No obstante, Cockpit ofrece alguna configuración avanzada no disponible en FreedomBox: Configuración de rutas. Configuración de enlaces, puentes y VLANs. cockpit-network1.png cockpit-network2.png cockpit-network3.png
ServiciosCockpit permite agendar servicios y tareas periódicas (como cron). cockpit-services1.png cockpit-services2.png
Terminal WebCockpit ofrece un terminal web que se puede usar para ejecutar tareas manuales de administración del sistema. cockpit-terminal.png
Resolución de ProblemasCockpit require un nombre de dominio adecuadamente configurado en tu FreedomBox y solo funcionará cuando accedas a él mediante una URL con ese nombre de dominio. Cockpit no funcionará con una dirección IP en la URL. Tampoco con freedombox.local como nombre de dominio. Por ejemplo, las URLs siguientes no funcionarán: A partir de la versión 19.15 funciona el dominio .local. Puedes acceder a Cockpit mediante la URL . El dominio .local se basa en tu hostname. Si tu hostname es mifb tu nombre de dominio .local será mifb.local y la URL de Cockpit será . Para acceder apropiadamente a Cockpit, usa el nombre de dominio configurado en tu FreedomBox. Cockpit también funcionará cuando se use un Servicio Tor Onion. Las siguientes URLs funcionarán: La razón para este comportamiento es que Cockpit emplea WebSockets para conectar con el servidor de backend. Por seguridad se deben evitar las peticiones a WebSockets con servidores cruzados. Para implementar esto Cockpit maintiene una lista de todos los dominios desde los que se admiten peticiones. FreedomBox configura automaticamente esta lista cuando añades o borras un dominio. Sin embargo, como no podemos fiarnos de las direcciones IP, FreedomBox no las añade a esta lista. Puedes mirar la lista actual de dominios aceptados administrada por FreedomBox en /etc/cockpit/cockpit.conf. Puedes editarla pero hazlo solo si comprendes sus consecuencias para la seguridad web. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Configure.raw.xml b/doc/manual/es/Configure.raw.xml deleted file mode 100644 index 72bdca335..000000000 --- a/doc/manual/es/Configure.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Configure42020-08-19 09:13:00fioddorSe alinea con la versión 12 en inglés del 19 de agosto de 202032020-05-23 23:06:23fioddorSe alinea con la versión 11 en inglés del 23 de mayo de 202022019-06-18 15:50:11fioddorCorrección menor12019-06-18 15:46:38fioddorSe crea la versión española.Translation(s): English - Español
ConfigurarConfigurar tiene algunas opciones generales de configuración:
HostnameHostname es el nombre local por el que otros dispositivos pueden alcanzar tu FreedomBox desde la red local. El hostname por defecto es freedombox.
Nombre de DominioEl Nombre de Dominio es el nombre global por el que otros dispositivos pueden alcanzar tu FreedomBox desde la Internet. El valor que se asigne aquí es el que usarán Chat Server (XMPP), Matrix Synapse, Certificates (Let's Encrypt), y Monkeysphere.
Página Principal (home) del Servidor WebEsta es una opción avanzada que te permite establecer como home algo diferente al servicio FreedomBox para que se sirva a quien acceda con el navegador al nombre de dominio de FreedomBox. Por ejemplo, si el nombre de dominio de tu FreedomBox es y estableces a MediaWiki como home, al visitar te llevará a en vez de a . Puedes asignar la home a cualquier aplicación web, los wikis y blogs de Ikiwiki o la página index.html por defecto de Apache. Una vez asignada como home otra aplicación, ya solo puedes navegar al servicio FreedomBox tecleando en el navegador . /freedombox también se puede usar como alias para /plinth Consejo: Guarda la URL del servicio FreedomBox antes de asignar la home a otra app. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Coturn.raw.xml b/doc/manual/es/Coturn.raw.xml deleted file mode 100644 index 25ef4105b..000000000 --- a/doc/manual/es/Coturn.raw.xml +++ /dev/null @@ -1,4 +0,0 @@ -
es/FreedomBox/Manual/Coturn102020-07-19 22:49:23fioddorTranslations header added outside include block92020-07-18 15:39:37fioddorAlineada con la versión 12 en inglés del 18 de julio de 202082020-07-18 15:06:59fioddorCorrección menor.72020-07-18 15:06:21fioddorSe alinea con la versión 11 en inglés del 18 de julio de 2020. Pendiente de capturar imágen traducida.62020-05-30 20:00:26SunilMohanAdapaUpdate the title to emphasize app name over its generic name52020-05-24 07:12:27fioddorSe alinea con la versión 09 en inglés del 23 de mayo de 202042020-05-19 20:56:07fioddorSe alinea con la versión 08 en inglés del 19 de mayo de 202032020-05-10 10:31:28fioddorImprovement22020-05-10 10:30:35fioddorCorrection12020-05-10 10:10:39fioddorNueva página traducidaTranslation(s): English - Español
Coturn (Asistente para VoIP) icono de Coturn Disponible desde: versión 20.8 Coturn es un servidor para facilitar llamadas y conferencias de audio/video proporcionando una implementación de los protocolos TURN y STUN. Los servidores de comunicación por WebRTC, SIP y otros pueden usarlo para establecer una llamada entre partes que de otro modo no podrían conectarse entre si. No está pensado para que lo usen diréctamente los usuarios. Los servidores como Matrix Synapse necesitan configurarse con los datos proporcionados en la página de app de Coturn. Además de Matrix Synapse, Jitsi, Ejabberd, Nextcloud Talk, etc. pueden usar el servidor Coturn para llamadas y conferencias de audio/video. No hace falta que los servidores se ejecuten en la misma máquina que FreedomBox. Los servidores externos pueden usar un Coturn ejecutado en FreedomBox. Coturn está configurada en FreedomBox como app avanzada. Esto implica que para ver el icono de Coturn en la sección "Apps" necesitas marcar en "Mostrar apps y funcionalidades avanzadas" en "Configuración General".
Cómo funcionaAl hacer una llamada de audio/video lo mejor es enrutar los flujos multimedia directamente entre los pares porque minimiza la latencia (mejor calidad de señal) y evita depender de un servidor centralizado (privacidad). Esto escala bien porque un servidor de chat simple puede albergar miles de llamadas sin involucrarse de ningún otro modo que para establecer la llamada. Sin embargo este enfoque no suele funcionar la mayoría de las veces por cómo se configuran las redes. La mayoría de los pares de la red carecen de una dirección IP propia reservada para ellos y suelen operar detrás de un dispositivo de red que les traduce las direcciones de red (NAT: "Network Address Translation"). Esto significa que en realidad estos pares no tienen modo de alcanzarse entre sí directamente. Para abordar este problema se introdujo una técnica simple conocida como STUN. Con ayuda de un servidor STUN los pares pueden prescindir de los dispositivos NAT para transmitir entre ellos. Desafortunadamente este truco solo funciona un 80% de las ocasiones. Así que si STUN falla, los pares no tienen más opción que enrutar su comunicación a través de un intermediario llamado servidor TURN. Todo el mecanismo de intentar primero con STUN y recaer en TURN se describe en un protocolo llamado ICE. En FreedomBox, Coturn proporciona servidores STUN y TURN. Ambos servicios se proporcionan tanto sobre TCP como sobre UDP y tanto en canales cifrados (que tienen mayor probabilidad de éxito) como sin cifrar. Como los servidores STUN son baratos y no consumen muchos recursos no se necesita autenticación para usarlos. Por otra parte los servidores TURN sí la necesitan. Esta autenticación está altamente simplificada y no requiere mantener una base de datos de usuarios. Un servidor como matrix-synapse que vaya a establecer una llamada de audio/video entre dos pares generará un nombre de usuario y contraseña empleando un secreto compartido. Cuando los pares usen el servidor TURN se les validará usando estas credenciales porque el servidor TURN conoce este secreto. En resumen, un servidor de comunicaciones necesita saber las URLs de los servidores STUN/TURN junto con el secreto de autenticación para TURN. Después, durante el establecimiento de la llamada de audio/video guiarán a los pares a usar los servidores STUN/TURN. La app Coturn de FreedomBox proporciona exactamente ésta información, que se puede usar para configurar un servidor de comunicaciones independientemente de que se ejecute en la misma máquina que FreedomBox o en otro servidor.
Configurar Matrix SynapseEl servidor de Matrix Synapse de FreedomBox se puede configurar para que use el servidor de TURN/STUN Coturn. En el futuro, cuando instales Matrix Synapse FreedomBox instalará Coturn automáticamente y configurará sus parámetros en Matrix Synapse. Para configurar Matrix Synapse, edita el fichero /etc/matrix-synapse/homeserver.yaml con las siguientes líneas: Y luego reinicia el servidor matrix-synapse deshabilitando y rehabilitando la app de matrix-synapse. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/DateTime.raw.xml b/doc/manual/es/DateTime.raw.xml deleted file mode 100644 index ce9b7ad7c..000000000 --- a/doc/manual/es/DateTime.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/DateTime52020-08-19 10:05:37fioddorSe alinea con la versión 06 en inglés del 19 de agosto de 202042020-04-11 10:24:24fioddorhttps://salsa.debian.org/freedombox-team/plinth/-/issues/1831#note_15425832020-04-03 18:15:29fioddorSe usa imagen traducida y más actual.22020-04-03 17:08:45fioddorSe alinea con la versión 03 en inglés del 30 de marzo de 202012019-06-19 10:26:32fioddorSe crea la versión española.Translation(s): English - Español
Fecha y horaEste servidor de hora de red es un programa que mantiene el tiempo del sistema sincronizado con servidores de Internet. Puedes seleccionar el huso horario escogiendo una capital cercana (están ordenadas por Continente/Ciudad) o seleccionando directamente el huso en relación a GMT (Greenwich Mean Time). DateTime_es_v01.png Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Deluge.raw.xml b/doc/manual/es/Deluge.raw.xml deleted file mode 100644 index a28b43dbe..000000000 --- a/doc/manual/es/Deluge.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Deluge82020-07-19 22:50:08fioddorTranslations header added outside include block72020-07-18 14:38:34fioddorSe alinea con la versión 16 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.62020-07-18 11:29:46fioddorSe alinea con la versión 14 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.52020-05-30 20:00:52SunilMohanAdapaMatch title with FreedomBox interface42020-05-30 19:33:24SunilMohanAdapaUpdate the title to emphasize app name over its generic name32020-05-24 06:26:30fioddorSe alinea con la versión 12 en inglés del 23 de mayo de 202022019-09-04 09:35:32fioddorCorrección menor12019-09-04 09:33:21fioddorSe crea la versión española.Translation(s): English - Español
Deluge (Cliente web de BitTorrent) icono de Deluge Disponible desde: versión 0.5
¿Qué es Deluge?BitTorrent es un protocolo de comunicaciones para compartir ficheros entre pares (P2P = peer-to-peer). No es anónimo; debes asumir que otros puedan ver qué ficheros estás comprtiendo. Hay 2 clientes web para BitTorrent disponibles en FreedomBox: Transmission y Deluge. Tienen funcionalidades similares pero quizá prefieras uno sobre otro. Deluge es un cliente BitTorrent altamente configurable. Se puede añadir funcionalidad adicional instalando extensiones (plugins).
Captura de pantallaDeluge Web UI
Configuración InicialTras instalar Deluge se puede acceder apuntando tu navegador a https://<tu freedombox>/deluge. Necesitarás introducir una contraseña para ingresar: Deluge Login La contraseña inicial es deluge. La primera vez que ingreses Deluge te preguntará si quieres cambiarla. Debes cambiarla por algo más dificil de adivinar. A continuación se te mostrará el administrador de conexiones. Haz clic sobre la primera entrada (Offline - 127.0.0.1:58846). Luego pulsa "Arrancar el Demonio" para que arranque el servicio Deluge service que se ejecutará en segundo plano. Deluge Connection Manager (Offline) Ahora debería poner "Online". Haz clic en "Conectar" para completar la configuración. Deluge Connection Manager (Online) En este punto ya estás usando Deluge. Puedes hacer más cambios en las Preferencias o añadir un fichero o una URL de torrent. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Diagnostics.raw.xml b/doc/manual/es/Diagnostics.raw.xml deleted file mode 100644 index 5880b67a3..000000000 --- a/doc/manual/es/Diagnostics.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Diagnostics22020-08-19 10:14:36fioddorNueva marca BEGIN_INCLUDE en es/.../Diagnostics12019-06-19 10:39:40fioddorSe crea la versión española.Translation(s): English - Español
DiagnósticosLa prueba de diagnóstico del sistema ejecutará varias verificaciones sobre tu sistema para confirmar que las aplicaciones y servicios están funcionando como se espera. Sólo haz clic Ejecutar Diagnósticos. Esto puede llevar varios minutos. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/DynamicDNS.raw.xml b/doc/manual/es/DynamicDNS.raw.xml deleted file mode 100644 index cf7648bfb..000000000 --- a/doc/manual/es/DynamicDNS.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/DynamicDNS72020-08-18 20:55:25fioddorSe alinea con la versión 18 en inglés del 18 de agosto de 202062020-05-24 07:27:37fioddorSe alinea con la versión 17 en inglés del 23 de mayo de 202052019-08-20 10:59:21fioddorSe incorpora la traducción de una sección nueva.42019-08-20 10:52:54fioddorSe incorpora la traducción de una sección nueva.32019-08-20 10:35:42fioddorSe incorpora la traducción de una sección nueva.22019-08-20 10:26:28fioddorSe incorpora la traducción de una sección nueva.12019-08-20 10:15:28fioddorSe crea la versión española (traducción incompleta).Translation(s): English - Español
Cliente de DNS Dinamico
¿Qué es DNS Dinamico?Para que se pueda llegar a un servidor desde Internet este necesita tener una dirección pública permanente, también conocida como dirección IP estática o fija. Muchos proveedores de servicio de Internet no otorgan IP fija a sus usuarios normales o la cobran. En su lugar les otorgan una IP temporal diferente cada vez que el usuario se conecta a internet. O una que cambia de vez en cuando. Si es tu caso los clientes que quieran contactar con tu servidor tendrán dificultades. Los proveedores de servicio de DNS Dinamico ayudan a solventar este problema. Primero te dan un nombre de dominio, como 'miservidor.ejemplo.org' y te permiten asociar tu dirección IP temporal a este nombre de dominio cada vez que esta cambia. De este modo quien quiera llegar a tu servidor empleará el nombre de dominio 'miservidor.ejemplo.org' que siempre apuntará a la última dirección IP de tu servidor. Para que esto funcione cada vez que te conectes a Internet tendrás que decirle a tu proveedor de servicio de DNS Dinamico cual es tu dirección IP provisional actual. Por esto necesitas tener un software especial en tu servidor que haga esto. La funcionalidad DNS Dinamico de tu FreedomBox permite a los usuarios sin dirección IP pública fija mantener su dirección IP pública temporal actualizada en el servicio de DNS Dinamico. Esto te permite exponer servicios de tu FreedomBox, como ownCloud, a Internet.
GnuDIP vs. Update URLEisten 2 mecanismos principales para notificar al the servicio de DNS Dinamico cual es tu dirección IP provisional actual: empleando el protocolo GnuDIP o empleando el mecanismo URL de actualización. Si un servicio expuesto usando URL de actualización no se securiza apropiadamente mediante HTTPS, tus credenciales podrían quedar expuestas. Una vez que un atacante accede a tus credenciales podrá reproducir tus comunicaciones con el servicio de DNS Dinamico y suplantar tu dominio. Por otra parte el protocolo GnuDIP solo transportará un valor MD5 salpimentado de tu contraseña de tal forma que es seguro contra ataques de este tipo.
Emplear el protocolo GnuDIPRegistra una cuenta en cualquier proveedor de servicio de DNS Dinamico. Hay un servicio gratuito provisto por la comunidad FreedomBox disponible en . Habilita el Servicio de DNS Dinamico en el interfaz de usuario de FreedomBox. Selecciona GnuDIP como tipo de servicio, introduce la dirección de tu proveedor de servicio de DNS Dinamico (por ejemplo, gnudip.datasystems24.net) en el campo Dirección del servidor GnuDIP. Dynamic DNS Settings Completa la información que te ha dado tu proveedor en los campos correspondientes Nombre de Dominio, Usuario y Contraseña.
Emplear URL de actualizaciónSe implementa esta funcionalidad porque los proveedores de servicio de DNS Dinamico más populares están empleando el mecanismo URL de actualización. Registra una cuenta en el proveedor de servicio de DNS Dinamico que emplea el mecanismo Update URL. Se listan algunos proveedores de ejemplo en la propia página de configuración. Habilita el Servicio de DNS Dinamico en el interfaz de usuario de FreedomBox. Selecciona URL de actualización como tipo de servicio, introduce la URL de actualización que te ha dado tu proveedor de servicio de DNS Dinamico en el campo URL de actualización. Si vas a la URL de actualización con tu navegador de Internet y te muestra un aviso acerca de un certificado no confiable, activa aceptar todos los certificados SSL. AVISO: ¡Tus credenciales podrían quedar expuestas en este punto a un ataque MIM (man-in-the-middle)! Valora la posibilidad de elegir otro proveedor de servicio mejor. Si vas a la URL de actualización con tu navegador de Internet y te muestra la caja de usuario/contraseña, selecciona usar autenticación HTTP basica e introduce el usuario y la contraseña. Si la URL de actualización contiene tu dirección IP temporal actual reemplaza la dirección IP por la cadena de texto <Ip>.
Comprobar si funcionaAsegúrate de que los servicios externos que has habilitado como /jwchat, /roundcube o /ikiwiki están disponibles en tu dirección de dominio. Ve a la página Estado y asegúrate de que el tipo de NAT se detecta correctamente. Si tu FreedomBox está detrás de un dispositivo NAT debería detectarse en este punto (Texto: Detrás de NAT). Si tu FreedomBox tiene una dirección IP pública asignada el texto debería ser "Conexión directa a Internet". Comprueba que el último estado de actualización no sea fallida.
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 immediately) Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Firewall.raw.xml b/doc/manual/es/Firewall.raw.xml deleted file mode 100644 index 6ad6bc4f5..000000000 --- a/doc/manual/es/Firewall.raw.xml +++ /dev/null @@ -1,13 +0,0 @@ -
es/FreedomBox/Manual/Firewall172020-08-19 09:38:59fioddorSe alinea con la versión 33 en inglés del 19 de agosto de 2020162020-06-01 23:33:56JamesValleroyadd TableOfContents152020-05-24 08:59:22fioddorSe alinea con la versión 32 en inglés del 24 de mayo de 2020142020-05-24 08:56:37fioddorSe alinea con la versión 31 en inglés del 24 de mayo de 2020132020-05-10 00:57:07fioddorSe alinea con la versión 29 en inglés del 03 de mayo de 2020122020-04-13 16:15:55fioddorSe alinea con la versión 27 en inglés del 12 de abril de 2020112020-04-11 10:25:56fioddorhttps://salsa.debian.org/freedombox-team/plinth/-/issues/1831#note_154258102020-04-04 16:56:41fioddorMejora menor. Algo más claro.92020-04-04 16:52:56fioddorEnlace a página traducida.82020-04-04 16:49:56fioddorSe usan imágenes traducidas y más actuales.72019-10-21 15:03:44fioddorCorrección menor62019-10-21 14:58:42fioddorCorrección menor52019-08-20 12:16:19fioddorS42019-08-20 12:07:57fioddorSe incorpora la traducción de una sección nueva.32019-08-20 11:59:19fioddorSe incorpora la traducción de una sección nueva.22019-08-20 11:54:54fioddorSe incorpora la traducción de una sección nueva.12019-08-20 11:39:24fioddorSe crea la versión española (traducción incompleta).Translation(s): English - Español
CortafuegosUn cortafuegos es un sistema de seguridad de red que controla el tráfico de entrada y salida desde/a la red. Mantener un cortafuegos habilitado y apropiadamente configurado reduce el riesgo de amenazas a la seguridad desde Internet. La operación del cortafuegos desde el interfaz web de FreedomBox es automática. Cuando habilitas un servicio se le abre automáticamente el cortafuegos y cuando lo deshabilitas se le cierra también automáticamente. Para servicios habilitados por defecto en FreedomBox los puertos se abren en el cortafuegos por defecto durante el proceso de la primera ejecución. Firewall La administración del cortafuegos en FreedomBox se hace empleando FirewallD.
InterfacesCada interfaz de red necesita asignarse a 1 (y sólo 1) zona. Si no se le establece zona, automáticamente se le asigna la zona externa. Las reglas que tenga activas la zona se aplicarán al interfaz. Por ejemplo, si se permite el trafico HTTP en una zona en particular las peticiones web se acceptarán en todas las direcciones configuradas para todos los interfaces asignados a esa zona. Principalmente se emplean 2 zonas de cortafuegos. La zona interna está pensada para servicios ofrecidos a todas las máquinas de la red local. Esto podría incluir servicios como streaming multimedia o compartición simple de archivos. La zona externa está pensada para servicios públicamente expuestos a Internet. Esto podría incluir servicios como blog, sitio web, cliente web de correo electrónico etc. Para más detalles acerca de como se configuran por defecto los interfaces de red mira la sección Redes.
Abrir Puertos PropiosCockpit proporciona administración avanzada de cortafuegos. Ambos, FreedomBox y Cockpit operan sobre firewalld y son por tanto compatibles entre sí. En particular, Cockpit se puede usar en FreedomBox para abrir servicios o puertos. Esto resulta útil si además de los servicios proporcionados por FreedomBox estás ejecutando manualmente tus propios servicios en la misma máquina. firewalld-cockpit.png
Puertos/Servicios de FreedomBoxLa siguiente tabla trata de documentar los puertos, servicios y sus estados por defecto en FreedomBox. Si encuentras esta página desactualizada mira la página de estado del cortafuegos en el interfaz web de FreedomBox. ServicioPuerto ExternoHabilitado por defectoEstado mostrado en FreedomBoxAdministrado por FreedomBox Minetest 30000/udp {*} {X} (./) (./) XMPP Client 5222/tcp {*} {X} (./) (./) XMPP Server 5269/tcp {*} {X} (./) (./) XMPP Bosh 5280/tcp {*} {X} (./) (./) NTP 123/udp {o} (./) (./) (./) Interfaz web de FreedomBox 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/udp {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}
Operación ManualPara completar información acerca de los conceptos basicos o más allá, mira la documentación de FirewallD.
Habilitar/deshabilitar el cortafuegosPara deshabilitar el cortafuegos o con systemd Para vover a habilitar el cortafuegos o con systemd
Modificar servicios/puertosPuedes añadir o eliminar un servicio de una zona manualmente. Para ver la lista de servicios habilitados: --list-services]]>Ejemplo: Para ver la lista de puertos habilitados: --list-ports]]>Ejemplo: Para eliminar un servicio de una zona: --remove-service= -firewall-cmd --permanent --zone= --remove-service=]]>Ejemplo: Para eliminar un puerto de una zona: / -firewall-cmd --permanent --zone=internal --remove-port=/]]>Ejemplo: Para añadir un servicio a una zona: --add-service= -firewall-cmd --permanent --zone= --add-service=]]>Ejemplo: Para añadir un puerto a una zona: / -firewall-cmd --permanent --zone=internal --add-port=/]]>Ejemplo:
Modificar la zona de los interfacesPuedes cambiar la asignación de zona de cada interfaz de red manualmente tras la asignación automática del proceso de primer arranque. Para ver la asignación actual de interfaces de red a las zonas. Para eliminar un interfaz de una zona: --remove-interface= -firewall-cmd --permanent --zone= --remove-interface=]]>Ejemplo: Para añadir un interfaz a una zona: --add-interface= -firewall-cmd --permanent --zone= --add-interface=]]>Ejemplo: Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/GitWeb.raw.xml b/doc/manual/es/GitWeb.raw.xml deleted file mode 100644 index 69fd7fad7..000000000 --- a/doc/manual/es/GitWeb.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/GitWeb112020-07-27 23:30:31fioddorSimplificado y con menos redundancia.102020-07-27 22:08:32JamesValleroyremove wikilinks to non-existing page92020-07-19 22:51:35fioddorTranslations header added outside include block82020-07-18 15:28:11fioddorSe alinea con la versión 12 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.72020-07-18 11:36:54fioddorSe alinea con la versión 10 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.62020-05-30 19:35:09SunilMohanAdapaMatch title with FreedomBox interface52020-05-30 19:34:33SunilMohanAdapaUpdate the title to emphasize app name over its generic name42020-05-24 07:04:04fioddorSe alinea con la versión 08 en inglés del 23 de mayo de 202032020-01-29 06:49:24fioddorSe alinea con la versión 7 en inglés del 29 de enero de 202022019-12-17 21:25:32fioddorSe alinea con la versión 04 en inglés del 17 de diciembre de 201912019-12-15 19:00:01fioddorSe traduce una página nuevaTranslation(s): English - Español
GitWeb (Alojamiento simple para Git) icono de Gitweb Disponible desde versión: 19.19 GitWeb proporciona alojamiento Git en FreedomBox. Proporciona un interfaz web para realizar acciones comunes sobre repositorios Git como ver archivos, diferencias, descripciones de cambio, etc. Git es un sistema de control de versiones distribuído para trazar cambios en código fuente durante el desarrollo de software. Con GitWeb puedes hojear la historia y el contenido del código fuente, y usar la búsqueda para encontrar cambios y código específicos. También puedes clonar repositorios y subir cambios al código con un cliente Git de línea de órdenes o con múltiples clientes gráficos que hay disponibles. Y puedes compartir tu código con gente de todo el mundo. Para aprender a usar Git visita su tutorial.
Administrar los repositoriosTras instalar GitWeb se puede crear un nuevo repositorio. Se puede marcar como privado para limitar el acceso.
AccesoTras instalar GitWeb se puede acceder a GitWeb mediante el cliente web (p.ej) en https://<mi_freedombox>/gitweb.
Autenticación básica HTTPActualmente el GitWeb de FreedomBox solo soporta remotos HTTP. Para evitar tener que introducir la contraseña cada vez que haces pull/push al repositorio puedes editar tu remoto para incluír credenciales. Ejemplo: Tu nombre de usuario y contraseña se cifrarán. Quien monitorize el tráfico de la red solo apreciará el nombre de dominio. Nota: Al usar este método tu contraseña se almacenará en claro en el fichero .git/config del repositorio local. Por este motivo debes crear un usuario FreedomBox que solo tenga acceso a gitweb y no usar nunca una cuenta de administrador.
Réplicas EspejoAunque tus repositorios se albergan principalmente en tu propia FreedomBox puedes configurar un repositorio en otro servicio de alojamiento Git como GitLab a modo de copia espejo. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/I2P.raw.xml b/doc/manual/es/I2P.raw.xml deleted file mode 100644 index c70ab8c08..000000000 --- a/doc/manual/es/I2P.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/I2P112020-07-19 22:52:33fioddorTranslations header added outside include block102020-07-18 11:49:32fioddorSe alinea con la versión 04 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.92020-07-18 11:45:10fioddorIcon added for fast identification82020-05-30 19:35:54SunilMohanAdapaUpdate the title to emphasize app name over its generic name, match with FreedomBox interface72020-05-24 07:21:04fioddorSe alinea con la versión 02 en inglés del 23 de mayo de 202062019-09-17 13:59:23fioddorCorrección52019-09-17 13:58:00fioddorCorrecciones menores.42019-09-17 13:56:45fioddorCorrección32019-09-17 13:55:36fioddorMejora menor22019-09-17 13:54:52fioddorSe crea la versión española.12019-09-17 12:37:09fioddorSe crea la versión española (traducción incompleta).Translation(s): English - Español
I2P (Red anónima) I2P icon
Acerca de I2PEl Proyecto Internet Invisible (I2P) es una capa anonimizadora de red concebida para protejer las comunicaciones de la censura y la vigilancia. I2P proporciona anonimato enviando tráfico cifrado a través de una red distribuída alrededor del mundo gestionada por voluntarios. Más información acerca de I2P en la página principal del proyecto.
Servicios OfrecidosLos siguientes servicios se ofrecen en FreedomBox a través de I2P de serie. Se pueden habilitar más servicios desde la consola de enrutado I2P que se puede abrir desde el interfaz web de FreedomBox. Navegación web anónima: I2P se puede usar para navegar por la web de forma anónima. Para ello configura tu navegador (preferíblemente un navegador Tor) para conectar al proxy I2P. Esto se puede hacer estableciendo los proxies HTTP y HTTPS a freedombox.local (o la IP local de tu FreedomBox) con sus respectivos puertos a 4444 y 4445. Este servicio está disponible sólo cuando accedes a la FreedomBox usando la red local (redes de la zona interna del cortaguegos) y no cuando llegas a la FreedomBox desde Internet. Una excepción a esto es cuando te conectas al servicio VPN de la FreedomBox desde Internet, en cuyo caso sí puedes usar el servicio de navegación web anónima a través de I2P. Acceso a eepsites: La red I2P puede albergar sitios web anónimos llamados eepsites cuyo nombre de dominio acaba en .i2p. Por ejemplo, http://i2p-projekt.i2p/ es el sitio web del proyecto I2P en la red I2P. Los eepsites son inaccesibles a un navegador normal a través de una conexión Internet normal. Para navegar a los eepsites tu navegador necesita configurarse para usar los proxies HTTP y HTTPS como se describió antes. Este servicio solo está disponible cuando accedes a la FreedomBox usando la red local (redes de la zona interna del cortaguegos) y no cuando llegas a la FreedomBox desde Internet. Una excepción a esto es cuando te conectas al servicio VPN de la FreedomBox desde Internet, en cuyo caso sí puedes usar el servicio de acceso a eepsites a través de I2P. Descargas anónima de torrentes: I2PSnark, una aplicación para descargar y compartir archivos anónimamente mediante la red BitTorrent está disponible y habilitada por defecto en FreedomBox. Esta aplicación se controla mediante un interfaz web que se puede abrir desde la sección Torrentes Anonimos de la app I2P en el interfaz web de FreedomBox o de la consola de enrutado I2P. Solo los usuarios ingresados pertenecientes al grupo Manage I2P application pueden usar este servicio. Red IRC: La red I2P contiene una red IRC llamada Irc2P. Esta red alberga el canal IRC oficial del proyecto I2P, entre otros. Este servicio viene habilitdo de serie en FreedomBox. Para usarlo abre tu cliente IRC favorito y configuralo para conectar con freedombox.local (o la IP local de tu FreedomBox) en el puerto 6668. Este servicio solo está disponible cuando accedes a la FreedomBox usando la red local (redes de la zona interna del cortaguegos) y no cuando llegas a la FreedomBox desde Internet. Una excepción a esto es cuando te conectas al servicio VPN de la FreedomBox desde Internet, en cuyo caso sí puedes usar el servicio de IRC a través de I2P. Consola de enrutado I2P: Este es el interfaz central de administración de I2P. Muestra el estado actual de I2P, estadísticas de ancho de banda y permite modificar varias preferencias de configuración. Puedes adecuar tu participación en la red I2P y usar/editar una lista con tus sitios I2P (eepsites) favoritos. Solo los usuarios ingresados pertenecientes al grupo Manage I2P application pueden usar este servicio. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0).
\ No newline at end of file diff --git a/doc/manual/es/Ikiwiki.raw.xml b/doc/manual/es/Ikiwiki.raw.xml deleted file mode 100644 index 29a888b17..000000000 --- a/doc/manual/es/Ikiwiki.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Ikiwiki72020-07-19 22:53:10fioddorTranslations header added outside include block62020-07-18 14:08:03fioddorSe alinea con la versión 13 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.52020-05-30 19:36:25SunilMohanAdapaUpdate the title to emphasize app name over its generic name42020-05-24 07:17:47fioddorSe alinea con la versión 11 en inglés del 23 de mayo de 202032019-09-17 12:09:26fioddorMejora menor22019-09-17 12:07:08fioddorMejora menor12019-09-17 12:05:55fioddorSe crea la versión española.Translation(s): English - Español
Ikiwiki (Wiki y Blog) icono de Ikiwiki
¿Qué es Ikiwiki?Ikiwiki convierte páginas wiki a páginas HTML listas para publicar en un sitio web. En particular, proporciona blogs, podcasts, calendarios y una amplia selección de extensiones (plugins).
Inicio rápidoTras instalar la app en el interfaz de administración de tu FreedomBox: Ve a la sección Crear y crea un wiki o un blog. Vuelve a la sección Configurar y haz clic en el enlace /ikiwiki. Haz clic en el nombre de tu nuevo wiki o blog bajo Directorio Padre. Disfruta de tu nueva página de publicación.
Crear un wiki o blogPuedes crear un wiki o blog para albergarlo en tu FreedomBox mediante la página Wiki y Blog (Ikiwiki). La primera vez que visites esta página te pedirá instalar paquetes requiridos por Ikiwiki. Tras completar la instalación de paquetes selecciona la solapa Crear. Puedes elegir el tipo: Wiki o Blog. Teclea también un nombre para el wiki o blog, y el usuario y contraseña para su cuenta de administrador. Al hacer clic en Actualizar configuración verás el wiki/blog añadido a tu lista. Observa que cada wiki/blog tiene su propia cuenta de administrador. ikiwiki: Create
Acceder a tu wiki o blogDesde la página de Wiki y Blog (Ikiwiki) selecciona la solapa Administrar y verás una lista de tus wikis y blogs. Haz clic en un nombre para navegar a ese wiki o blog. ikiwiki: Manage Desde aquí, si le das a Editar o a Preferencias se te llevará a una página de ingreso. Para ingresar con la cuenta de administrador que creaste antes selecciona la solapa Otros, introduce el usuario y la contraseña y haz clic en Ingresar.
Ingreso único de usuarios (SSO)Se puede dar permiso para editar a otros usuarios de FreedomBox además de al administrador del wiki/blog. Sin embargo no tendrán todos los permisos del administrador. Podrán añadir o editar páginas pero no podrán cambiar la configuración del wiki. Para añadir a un usuario al wiki ve a la página Usuarios y Grupos de FreedomBox (bajo Configuración del Sistema, el icono del engranaje de la esquina superior derecha de la página). Crea o modifica un usuario y añádele al grupo wiki. (Los usuarios del grupo admin tendrán también acceso al wiki.) Para ingresar como usuario FreedomBox ve a la página de ingreso del wiki/blog y selecciona la solapa Otros. Luego haz clic en el botón Ingresar con autenticación HTTP. El navegador mostrá un diálogo emergente en el que podrás introducir el usuario y la contraseña del usuario de FreedomBox.
Añadir usuarios FreedomBox como admnistradores de wikiIngresa al wiki con su cuenta de administrador. Haz clic en Preferencias y luego en Configurar. Debajo de Principal, en usuarios administradores de algún wiki, añade el nombre de un usuario de FreedomBox. (Opcional) Desmarca la opción habilitar autenticación mediante contraseña de extensión de autenticación: autenticación mediante contraseña. (Nota: Esto deshabilitará el ingreso con la cuenta de administrador anterior. Solo se podrá ingresar mediante ingreso único usando autenticación HTTP.) Haz clic en Grabar Configuración. Pulsa Preferencias y a continuación Salir. Ingresa como el nuevo usuario administrador usando Ingresar con autenticación HTTP. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Infinoted.raw.xml b/doc/manual/es/Infinoted.raw.xml deleted file mode 100644 index 9479e167f..000000000 --- a/doc/manual/es/Infinoted.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Infinoted72020-07-18 15:47:07fioddorSe alinea con la versión 05 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.62020-07-18 14:16:40fioddorSe alinea con la versión 04 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.52020-07-18 14:13:08fioddorSe alinea con la versión 04 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.42020-05-30 19:37:00SunilMohanAdapaUpdate the title to emphasize app name over its generic name32020-05-24 06:57:06fioddorSe alinea con la versión 02 en inglés del 23 de mayo de 202022019-09-12 11:09:53fioddorMejora menor12019-09-12 11:08:05fioddorSe crea la versión española.
Infinoted (Servidor Gobby) icono de Infinoted Disponible desde: versión 0.5 Infinoted es un servidor de edición colaborativa de textos para Gobby. Para usarlo descarga el cliente Gobby para escritorio e instalalo. Inicialo, selecciona "Conectar a un Servidor" e introduce el nombre de dominio de tu FreedomBox.
Redirección de PuertosSi tu FreedomBox está detras de un router necesitarás configurar la redirección de puertos en tu router. Redirije los siguientes puertos de infinoted: TCP 6523 Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/JSXC.raw.xml b/doc/manual/es/JSXC.raw.xml deleted file mode 100644 index 8b022f4e7..000000000 --- a/doc/manual/es/JSXC.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/JSXC42020-07-19 22:53:49fioddorTranslations header added outside include block32020-07-18 15:52:55fioddorSe alinea con la versión 04 en inglés del 18 de julio de 2020.22020-07-18 10:50:24fioddoralt texts corrected12020-07-18 00:15:26fioddorNueva página traducida a partir de la versión 02 en inglés del 18 de julio de 2020Translation(s): English - Español
JSXC (Cliente Web de Mensajería Instantánea) icono de JSXC Disponible desde: versión 0.11.0 JSXC is un cliente web de mensajería instantánea. Sirve para conectar con servidores de mensajería instantánea compatibles. FreedomBox ofrece ambas partes desde su interfaz web: un servidor (ejabberd) y un cliente web (JSXC).
Especificaciones técnicasJSXC está hecho con HTML5 e implementa el protocolo XMPP sobre BOSH. XMPP es un protocolo cliente-servidor para Mensajería Instantánea federado. Esto significa que los usuarios con cuenta en un servidor pueden conversar con usuarios de otro servidor. Se puede usar XMPP también para llamadas de voz y/o vídeo, si los clientes las soportan.
InstalaciónPuedes instalar JSXC mediante su icono de la sección Apps de la interfaz web de FreedomBox. El icono de ejabberd (servidor XMPP) también ofrece lanzar el cliente web (instalando JSXC de paso si fuera preciso).
UsoTras completar la instalación del módulo JSXC, queda accesible mediante su icono en la sección Apps de la interfaz web de FreedomBox. El icono de ejabberd (servidor XMPP) también ofrece lanzar el cliente web. Ambos te redirigirán a https://<tu_freedombox>/plinth/apps/xmpp/jsxc/. Para usarlo necesitas introducir el nombre de dominio del servidor al que quieres conectarte. Automáticamente comprueba la conexión al servidor BOSH cuando tecléas el nombre de dominio. JSXC sin conexión JSXC con conexión Más detalles en . JSXC ofrece funcionalidades de videoconferencia y transferencia de ficheros pero no parecen funcionar aún en FreedomBox.
Redirección de puertosSi tu FreedomBox está detrás de un router y quieres conectarte a otros servidores, necesitarás configurar la redirección de puertos de tu router. Para XMPP deberás redirigir los siguientes puertos: TCP 5222 (cliente-a-servidor) Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/LetsEncrypt.raw.xml b/doc/manual/es/LetsEncrypt.raw.xml deleted file mode 100644 index a56d4c938..000000000 --- a/doc/manual/es/LetsEncrypt.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/LetsEncrypt62020-08-19 09:44:44fioddorSe alinea con la versión 13 en inglés del 19 de agosto de 202052020-05-30 19:48:56SunilMohanAdapaUpdate the title to emphasize app name over its generic name42020-05-24 07:38:10fioddorSe alinea con la versión 11 en inglés del 23 de mayo de 202032020-04-04 17:19:32fioddorCorrección.22019-08-20 12:56:47fioddorSe incorpora la traducción de una sección nueva.12019-08-20 12:48:05fioddorSe incorpora la traducción de una sección nueva.Translation(s): English - Español
Let's Encrypt (Certificados)Un certificado digital permite a los usuarios de un servicio web verificar la identidad del servicio y comunicar con él de modo seguro. FreedomBox puede obtener y configurar automaticamente certificados digitales para cada dominio disponible. Lo hace probando a Let's Encrypt, una authoridad de certificación (CA) ser el dueño de un dominio. Let's Encrypt es una autoridad de certificación abierta, automatizada, libre y gratuita administrada para beneficio público por el Internet Security Research Group (ISRG). Por favor, lee y acepta los términos del Acuerdo de Suscripción de Let's Encrypt antes de usar este servicio.
Por Qué Usar CertificadosLa comunicación con tu FreedomBox se puede asegurar de modo que se imposibilite interceptar los contenidos que tus servicios intercambian con sus usuarios.
Cómo configurarSi tu FreedomBox está detrás de un router, necesitarás configurar la redirección de puertos en tu router. Debes redirigir los siguientes puertos: TCP 80 (http) TCP 443 (https) Publica tu nombre de dominio: En Configurar inserta tu nombre de dominio, p.ej. MiWeb.com Let's Encrypt Verifica que se aceptó tu nombre de dominio Comprueba que está habilitado en Servicio de Nombres Let's Encrypt Name Services Ve a la página de los Certificados (Let's Encrypt) y completa la instalación del modulo si hace falta. Entonces haz clic en el botón "Obtain" de tu nombre de dominio. Tras algunos minutos estará disponible un certificado válido Let's Encrypt Verifica en tu navegador comprobando https://MiWeb.com Let's Encrypt Certificate Screencast: Let's Encrypt
UsarEl certificado es válido por 3 meses. Se renueva automáticamente y también se puede volcer a obtener o revocar manualmente. Ejecutando diagnostics se puede también verificar el certificado. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/MLDonkey.raw.xml b/doc/manual/es/MLDonkey.raw.xml deleted file mode 100644 index e9a20ec48..000000000 --- a/doc/manual/es/MLDonkey.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/MLDonkey72020-07-19 22:58:06fioddorTranslations header added outside include block62020-07-18 16:26:15fioddorCorrección menor.52020-07-18 16:25:41fioddorSe alinea con la versión 15 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.42020-05-30 19:40:24SunilMohanAdapaUpdate the title to emphasize app name over its generic name, match with FreedomBox interface32020-05-24 06:51:48fioddorSe alinea con la versión 13 en inglés del 23 de mayo de 202022019-09-11 14:51:57fioddorCorrecciones menores.12019-09-11 14:46:33fioddorSe crea la versión española.Translation(s): English - Español
MLDonkey (Compartir archivos entre pares) icono de MLDonkey Disponible desde: versión 0.48.0
¿Qué es MLDonkey?MLDonkey es una aplicación libre y multiprotocolo para compartir archivos entre pares (P2P) que ejecuta un servidor back-end sobre muchas plataformas. Se puede controlar mediante algún interfaz front-end, ya sea web, telnet o cualquier otro de entre una docena de programas cliente nativos. Originalmente era un cliente Linux para el protocolo eDonkey pero ahora se ejecuta en multiples sabores de Unix y derivados, OS X, Microsoft Windows y MorphOS. Y soporta muchos protocolos P2P, incluyendo ED2K (y Kademlia sobre Overnet), BitTorrent, DC++ y más. Más información acerca de MLDonkey en el Wiki del Proyecto MLDonkey
Captura de PantallaMLDonkey Web Interface
Usar el Interfaz Web MLDonkeyTras instalar MLDonkey su interfaz web está accesible a los usuarios de los grupos ed2k y admin en https://<tu_freedombox>/mldonkey.
Usar el Interfaz para Escritorio/MóvilSe pueden usar muchas aplicaciones de escritorio y móviles para controlar a MLDonkey. El servidor MLDonkey estará ejecutándose siempre en la FreedomBox y (cargará o) descargará archivos y los mantendrá almacenados incluso cuando tu máquina local esté apagada o desconectada del MLDonkey de FreedomBox. Por restricciones de acceso via SSH a la FreedomBox solo los usuarios del grupo admin pueden acceder a su MLDonkey. Crea un usuario nuevo en el grupo admin o usa uno que ya esté allí. En tu máquina de escritorio abre una terminal y ejecuta el siguiente comando. Para este paso se recomienda que configures y uses claves SSH en vez de contraseñas. Arranca la aplicación gráfica y conéctala a MLDonkey como si MLDonkey se estuviera ejecutando en la máquina local de escritorio. Cuando hayas terminado mata el proceso SSH pulsando Control-C. Para más información lee acerca de los túneles SSH en la documentación MLDonkey. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/MatrixSynapse.raw.xml b/doc/manual/es/MatrixSynapse.raw.xml deleted file mode 100644 index d48a435fb..000000000 --- a/doc/manual/es/MatrixSynapse.raw.xml +++ /dev/null @@ -1,7 +0,0 @@ -
es/FreedomBox/Manual/MatrixSynapse162020-07-19 22:54:26fioddorTranslations header added outside include block152020-07-18 15:56:09fioddorSe alinea con la versión 23 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.142020-07-18 14:25:49fioddor132020-07-18 14:24:48fioddorpath corrected122020-07-18 14:24:03fioddorSe alinea con la versión 21 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.112020-07-18 00:20:54fioddor102020-05-30 19:37:48SunilMohanAdapaUpdate the title to emphasize app name over its generic name92020-05-24 06:37:15fioddorSe alinea con la versión 18 en inglés del 23 de mayo de 202082020-03-25 19:19:30fioddorSe alinea con la versión 17 en inglés del 21 de marzo de 202072020-01-03 12:50:08fioddorSe alinea con la versión 15 en inglés de hoy62019-09-26 06:27:14fioddorSe actualiza a la versión inglesa 11 del 25 de septiembre de 2019.52019-09-11 08:05:05fioddorCorrecciones menores.42019-09-11 07:28:27fioddorSe crea la versión española.32019-09-11 07:20:22fioddorSe crea la versión española (traducción incompleta).22019-09-11 07:19:53fioddor12019-09-11 07:18:36fioddorSe crea la versión española (traducción incompleta).Translation(s): English - Español
Matrix Synapse (Servidor de Mensajería Instantánea) icono de Matrix Synapse Disponible desde: versión 0.14.0
¿Qué es Matrix?Matrix es un estándar abierto para comunicaciones sobre IP en tiempo real interoperables y descentralizadas. Synapse es la implementación de referencia de un servidor Matrix. Se puede usar para montar mensajería instantánea sobre FreedomBox para albergar grandes salones de chat, comunicaciones cifradas punto a punto y llamadas de audio/vídeo. Matrix Synapse es una aplicación federada en la que puede haber salas de chat en un servidor y los usuarios de cualquier otro servidor de la red federada pueden unirse a ellas. Más información acerca de Matrix.
¿Cómo acceder a tu servidor Matrix Synapse?Para acceder al servidor Matrix Synapse recomendamos el cliente Riot. Puedes descargar Riot para escritorio. Las aplicaciones para Android e iOS están disponibles en sus tiendas (app stores) respectivas.
Configurar Matrix Synapse en tu FreedomBoxPara habilitar Matrix, primero navega a la página de tu servidor de chat (Matrix Synapse) e instálalo. Matrix necesita un nombre de dominio válido configurado. Tras la instalación, se te pedirá que lo configures seleccionandolo de entre un menú desplegable con dominios disponibles. Los dominios se configuran en la página Sistema -> Configuración y actualmente no podrás cambiar el dominio una vez esté configurado. Tras configurar un dominio verás que el servicio se está ejecutando. El servicio estará accesible en el dominio de FreedomBox configurado. Tendrás que configurar tu router para que reenvíe el puerto 8448 a tu FreedomBox. Todos los usuarios registrados en tu FreedomBox tendrán sus IDs Matrix @usuario:dominio. Si está habilitado el registro público tu cliente se puede usar también para registrar una cuenta de usuario nueva.
Federarse con otras instancias MatrixPodrás interactuar con cualquier otra persona que ejecute otra instancia de Matrix. Esto se hace simplemente iniciando una conversación con ellos usando su matrix ID que seguirá el formato @su-usuario:su-dominio. También podrás unirte a salas de otros servidores y tener llamadas de audio/video con contactos de otros servidores.
Uso de MemoriaEl servidor de referencia Synapse implementado en Python es conocido por consumir mucha RAM, especialmente al cargar salones grandes con miles de participantes como #matrix:matrix.org. Se recomienda evitar unirse a estos salones si tu dispositivo FreedomBox solo tiene 1 GiB RAM o menos. Debería ser seguro unirse a salas con hasta 100 participantes. El equipo de Matrix está trabajando en una implementación de servidor Matrix escrita en Go llamada Dendrite que debería tener mejor rendimiento en entornos con poca memoria. Algunos salones públicos muy grandes de la red Matrix están también disponibles como canales IRC (p.ej. #freedombox:matrix.org está disponible también como #freedombox en irc.debian.org). Es mejor usar IRC en vez de Matrix para estos salones tán grandes. Puedes unirte a los canales de IRC usando Quassel.
Uso AvanzadoSi quieres crear una gran cantidad de usuarios en tu servidor de Matrix Synapse usa los siguientes comandos en una shell remota como usuario root: /etc/matrix-synapse/conf.d/registration_shared_secret.yaml -chmod 600 /etc/matrix-synapse/conf.d/registration_shared_secret.yaml -chown matrix-synapse:nogroup /etc/matrix-synapse/conf.d/registration_shared_secret.yaml -systemctl restart matrix-synapse -register_new_matrix_user -c /etc/matrix-synapse/conf.d/registration_shared_secret.yaml]]>Si quieres ver la lista de usuarios registrados en Matrix Syanpse haz lo siguiente como usuario root: Para crear una comunidad en Matrix Synapse se necesita un usuario Matrix con privilegios de admin en el servidor. Para dárselos a miusuario ejecuta los siguientes comandos como usuario root: Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/MediaWiki.raw.xml b/doc/manual/es/MediaWiki.raw.xml deleted file mode 100644 index 8a67e1e99..000000000 --- a/doc/manual/es/MediaWiki.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/MediaWiki152020-07-19 22:54:58fioddorTranslations header added outside include block142020-07-18 16:27:37fioddorCorrección menor.132020-07-18 16:02:49fioddorSe alinea con la versión 17 en inglés del 18 de julio de 2020.122020-05-30 19:38:23SunilMohanAdapaUpdate the title to emphasize app name over its generic name112020-05-24 07:15:06fioddorSe alinea con la versión 15 en inglés del 23 de mayo de 2020102020-04-13 16:22:33fioddorSe alinea con la versión 14 en inglés del 12 de abril de 202092020-01-29 06:38:07fioddorSe alinea con la versión 13 en inglés del 24 de enero de 202082020-01-21 08:10:38fioddorSe alinea con la versión 11 en inglés del 21 de enero de 202072020-01-21 08:07:02fioddorSe alinea con la versión 10 en inglés del 18 de enero de 202062019-10-14 08:01:12fioddorEnlace a nueva página traducida.52019-10-11 00:38:07SunilMohanAdapaRemove formatting on link to MediaWiki page that is causing issues with PDF conversion42019-09-17 11:26:11fioddorMejora menor32019-09-17 11:24:09fioddorCorrección menor22019-09-17 11:22:32fioddorMejora menor12019-09-17 11:21:21fioddorSe crea la versión española.Translation(s): English - Español
MediaWiki (Wiki) icono de MediaWiki Disponible desde: versión 0.20.0
Acerca de MediaWikiMediaWiki es el software de base de la gama de wikis Wikimedia. Lee más acerca de MediaWiki en Wikipedia
MediaWiki en FreedomBoxMediaWiki viene configurado en FreedomBox para ser públicamente legible y editable en privado. Sólo los usuarios ingresados pueden editar el wiki. Esta configuración evita publicidad indeseada (spam) y otros vandalismos en tu wiki.
Administración de UsuariosSolo el administrador de MediaWiki (usuario "admin") puede crear los usuarios. El usuario "admin" puede usarse también para restablecer contraseñas de usuarios MediaWiki. Si se olvida la contraseña del administrador se puede restablecer desde la página de MediaWiki del interfaz web de FreedomBox.
Casos de usoMediaWiki es muy versátil y se puede emplear para muchos usos creativos. También es áltamente adaptable y viene con un montón de extensiones (plugins) y estilos estéticos.
Repositorio Personal de ConocimientoEl MediaWiki de FreedomBox puede ser tu propio repositorio de conocimiento personal. Como MediaWiki tiene buen soporte multimedia puedes escribir notas, almacenar imágenes, crear listas de comprobación, guardar referencias y enlaces, etc. de manera organizada. Puedes almacenar el conocimiento de una vida en tu instancia de MediaWiki.
Wiki ComunitarioUna comunidad de usuarios podría usar MediaWiki como su repositorio común de conocimiento y material de referencia. Se puede emplear como un tablón de anunciós de universidad, como un servidor de documentación para una pequeña empresa, como un bloc de notas para grupos de estudio o como un wiki de fans al estilo de wikia.
Sitio Web Personal implementado mediante un WikiVarios sitios web de internet son sólo instancias de MediaWiki. El MediaWiki de FreedomBox es de solo lectura para visitantes. Se puede por tanto adaptar para servir como tu sitio web y/o blog personal. El contenido de MediaWiki es fácil de exportar y puede moverse después a otro motor de blogs.
Editar Contenido del WikiFreedomBox monta MediaWiki con un editor básico con una barra de herramientas con opciones de uso habitual como negrita, cursiva etc. Haz clic en la sección Avanzadas para acceder a más opciones como cabaceras, listas con viñetas, etc. mediawiki-toolbar.png
Editor VisualComo su nombre indica, el nuevo Editor Visual de MediaWiki ofrece un interfaz de usuario visual (WYSIWYG) para crear páginas del wiki. Pero esta funcionalidad está todavía en pruebas y MediaWiki no la trae de serie. Una solución temporal posible sería escribir tu contenido con el Editor Visual del borrador de Wikipedia, cambiar el modo de edición a texto y copiarlo a tu wiki.
Otros FormatosNo es imprescindible que aprendas el lenguaje de formateo de MediaWiki. Puedes escribir en tu formato favorito (Markdown, Org-mode, LaTeX etc.) y convertirlo al formato de MediaWiki usando Pandoc.
Cargar ImágenesSe puede habilitar la carga de imágenes desde FreedomBox versión 0.36.0. También puedes usar directamente imágenes de Wikimedia Commons mediante una funcionalidad llamada Instant Commons.
Personalización
Temas de estiloEl tema por defecto de MediaWiki suele ser Vector. El de FreedomBox es Timeless. Vector es un tema optimizado para visualizarlo en pantallas grandes pero no se adecúa bien a los tamaños de pantalla de los móviles. Wikimedia usa otro sitio específico para móviles. Para instalaciones pequeñas como las de FreedomBox no merece la pena un segundo sitio dedicado. Usar un tema de estilo más polivalente como Timeless es una solución más eficiente al problema. Los administradores pueden elegir el tema por defecto desde la configuración de la app. Los usuarios del sitio tienen también la opción de visualizarlo con temas diferentes. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Minetest.raw.xml b/doc/manual/es/Minetest.raw.xml deleted file mode 100644 index 354dc45ba..000000000 --- a/doc/manual/es/Minetest.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Minetest92020-07-19 22:56:11fioddorTranslations header added outside include block82020-07-18 16:28:30fioddorCorrección menor.72020-07-18 16:10:08fioddorSe alinea con la versión 07 en inglés del 18 de julio de 2020. Pendiente de capturar imágen traducida.62020-07-18 16:05:24fioddorIcon added for fast identification. Availability standardized.52020-05-30 19:38:57SunilMohanAdapaUpdate the title to emphasize app name over its generic name, match with FreedomBox interface42020-05-24 06:30:24fioddorSe alinea con la versión 05 en inglés del 23 de mayo de 202032020-05-10 00:36:41fioddorSe alinea con la versión 04 en inglés del 03 de mayo de 202022019-09-04 09:50:46fioddorCorrección menor12019-09-04 09:50:27fioddorSe crea la versión española.Translation(s): English - Español
Minetest (Sandbox de bloques) icono de Minetest Disponible desde: versión 0.9 Minetest es un Block Sandbox multijugador para mundos infinitos. Este módulo permite ejecutar el servidor Minetest en esta FreedomBox, en su puerto por defecto (30000). Para conectar al servidor se necesita un cliente de Minetest.
Enrutado de PuertosSi tu FreedomBox está detrás de un router necesitarás configurar la redirección de puertos en tu router para los siguientes puertos de Minetest: UDP 30000 Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/MiniDLNA.raw.xml b/doc/manual/es/MiniDLNA.raw.xml deleted file mode 100644 index 599df0a6f..000000000 --- a/doc/manual/es/MiniDLNA.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/MiniDLNA102020-08-01 00:28:47JamesValleroyremove extra spaces92020-07-19 22:56:51fioddorTranslations header added outside include block82020-07-18 16:19:26fioddorSe alinea con la versión 10 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.72020-07-18 16:17:51fioddorSe alinea con la versión 09 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.62020-05-30 19:39:39SunilMohanAdapaUpdate the title to emphasize app name over its generic name, match with FreedomBox interface52020-05-28 20:42:49fioddorSe alinea con la versión 07 en inglés del 27 de mayo de 202042020-05-26 13:29:06fioddorMejora menor. Algo más claro.32020-05-26 13:26:16fioddorSe alinea con la versión 04 en inglés del 26 de mayo de 202022020-05-24 06:59:45fioddorSe alinea con la versión 03 en inglés del 23 de mayo de 202012019-12-25 21:05:55fioddorSe traduce una página nuevaTranslation(s): English - Español
MiniDLNA (Servidor multimedia básico) icono de MiniDLNA Disponible desde: versión 19.23 MiniDLNA es un servidor multimedia que intenta ser compatible con clientes DLNA/UPnP. Nota: Este servicio solo está disponible en redes configuradas como zona "interna". Tampoco está disponble a través de OpenVPN (es incompatible).
¿Qué es UPnP/DLNA?UPnP (Universal plug & play) es un conjunto de protocolos de red que permite a los dispositivos de una red, como PCs, TVs, impresoras etc, reconocerse entre sí y establecer comunicación para compartir datos. Es un protocolo con cero configuración y require solo un servidor multimedia y un reproductor multimedia compatibles con el protocolo. DLNA se deriva de UPnP como una forma de estandarizar interoperabilidad entre medios. Conforma un estándar/certificación que cumplen muchos dispositivos electrónicos de consumo.
Desplegando MiniDLNA en tu FreedomBox.Para instalar/habilitar el servidor multimedia necesitas navegar a la página MiniDLNA y habilitarlo. Se intenta que la aplicación esté disponible en la red interna y por ello requiere asignarle un interfaz de red configurado para tráfico interno. Tras la instalación queda disponible una página web en . Incluye información de cuántos ficheros detecta el servidor, cuántas conexiones existen etc. Esto resulta muy útil cuando conectas discos externos con contenido para para verificar que detecta los nuevos archivos como debe. Si no ocurre así, desconectar y activar el servidor lo arreglará.
Usar MiniDLNA para reproducir contenidos multimedia en tus dispositivosCualquier dispositivo compatible con DLNA debiera ser capaz de detectar, hojear y reproducir automáticamente contenido multimedia de MiniDLNA en FreedomBox. Los siguientes dispositivos y reproductores se han probado: GNOME Videos: Videos es el reproductor multimedia por defecto en el popular entorno de escritorio GNU/Linux GNOME. Abre Videos, cambia a 'Canales'. Deberías ver un canal denominado 'freedombox: minidlna'. Deberías poder hojear y reproducir su contenido. VLC media player: VLC es un reproductor multimedia para GNU/Linux, Android, Windows y macOS muy popular. Abre VLC y haz clic en 'Ver -> Lista de reproducción'. En la barra lateral de la lista de reproducción que aparece selecciona 'Universal Plug'n'Play'. Deberías ver un elemento denominado 'freedombox: minidlna'. Deberías poder hojear y reproducir su contenido. Kodi: Kodi es un software popular de centro multimedia con un interfaz de usuario diseñado para televisores. Abre Kodi, ve a 'Sistema -> Configuración del Servicio -> UPnP/DLNA' y 'Habilitar soporte UPnP'. Visita entonces 'Home -> Videos -> Archivos -> Añadir videos... -> Navegar -> dispositivos UPnP'. Deberías ver 'freedombox: minidlna'. Selecciónalo y elige 'OK'. Entonces, elige 'OK en el diálogo 'Anadir entrada de video'. A partir de ahora , deberías ver 'freedombox: minidlna' en la sección 'Videos -> Archivos'. Deberías poder hojear y reproducir su contenido. Para más información mira la documentación de Kodi. Roku: Roku es un aparato conectado a una TV para reproducir contenido de servicios de retransmisión por Internet. También hay muchas TVs que llevan a Roku integrado. Encuentra en el interfaz de Roku un canal denominado 'Roku Media Player' y ábrelo. Deberías ver un elemento denominado 'freedombox: minidlna'. Deberías poder hojear y reproducir su contenido. Rhythmbox: Rhythmbox es el reproductor de sonido por defecto en el popular entorno de escritorio GNU/Linux GNOME. Abre Rhythmbox y asegura que el panel lateral esté abierto pulsando en 'Menú de Aplicación -> Ver -> Panel Lateral'. En el panel lateral deberías ver 'freedombox:minidlna' bajo la sección 'Compartidos'. Deberías poder hojear y reproducir sus archivos de sonido. Los archivos de video no aparecerán.
Formatos multimedia soportadosMiniDLNA soporta una amplia variedad de formatos de archivo de video y sonido. Video: Archivos terminados en .avi, .mp4, .mkv, .mpg, .mpeg, .wmv, .m4v, .flv, .mov, .3gp, etc. Sonido: Archivos terminados en .mp3, .ogg, .flac, .wav, .pcm, .wma, .fla, .aac, etc. Imágen: Archivos terminados en .jpg, .jpeg Listas de Reproducción: Archivos terminados enh .m3u, .pls Subtítulos: Archivos terminados en .srt, .smi Obsérvese que no soporta archivos con las siguientes extensiones. Parece que renombrar el archivo a una extensión reconocida funciona el la mayoría de casos. Video: Archivos terminados en .webm Además del soporte al formato de archivo por parte de MiniDLNA, tu dispositivo o reproductor de medios necesita soportar el codec de sonido/video con el que se haya codificado tu contenido. MiniDLNA carece de la habilidad de traducir archivos a un codec compatible con el reproductor. Si te topas con problemas en la reproducción de contenido, usa VLC para identificar el codec empleado en el contenido y comprueba en la documentación de tu dispositivo o reproductor de medios si lo soporta.
Sistemas de archivo para discos externos.Al usar un disco externo que se usa también desde sistemas Windows el mejor formato para el sistema de archivos es NTFS. NTFS conservará los permisos de acceso de Linux y la codificación UTF-8 para los nombres de fichero. Esto es útil si los nombres de archivos tienen tildes, eñes u otros signos raros.
Enlaces externos (en) Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Monkeysphere.raw.xml b/doc/manual/es/Monkeysphere.raw.xml deleted file mode 100644 index 9cbe839f5..000000000 --- a/doc/manual/es/Monkeysphere.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Monkeysphere32020-08-19 10:22:34fioddorSe alinea con la versión 02 en inglés del 19 de agosto de 202022020-04-04 17:28:08fioddorCorrección.12019-08-23 10:48:17fioddorSe crea la versión española.Translation(s): English - Español
MonkeysphereCon Monkeysphere se puede generar una clave OpenPGP para cada dominio configurado para servir SSH. La clave pública OpenPGP se puede subir entonces a los servidores de claves OpenPGP. Los usuarios que se conecten mediante SSH podrán verificar que se están conectando a la máquina correcta. Para que los usuarios puedan confiar en la clave alguien (generalmente el dueño de la máquina) tiene que firmarla siguiendo el proceso normal de firmado de claves OpenPGP. Para más detalles, ver la documentación de Monkeysphere SSH. Monkeysphere también puede generar una clave OpenPGP para cada certificado de servidor web seguro (HTTPS) instalado en esta máquina. La clave pública OpenPGP se puede subir entonces a los servidores de claves OpenPGP. Los usuarios que se conecten mediante HTTPS podrán verificar que se están conectando a la máquina correcta. Para validar el certificado el usuario deberá instalar cierto software disponible en el sitio web de Monkeysphere. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Mumble.raw.xml b/doc/manual/es/Mumble.raw.xml deleted file mode 100644 index 732fc2e7a..000000000 --- a/doc/manual/es/Mumble.raw.xml +++ /dev/null @@ -1,2 +0,0 @@ -
es/FreedomBox/Manual/Mumble82020-07-19 22:58:35fioddorTranslations header added outside include block72020-07-18 16:35:03fioddorCorrección menor.62020-07-18 16:34:18fioddorSe alinea con la versión 12 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.52020-05-30 19:41:05SunilMohanAdapaUpdate the title to emphasize app name over its generic name, match with FreedomBox interface42020-05-24 07:11:26fioddorSe alinea con la versión 10 en inglés del 23 de mayo de 202032019-11-14 16:30:35fioddorCorrecciones menores22019-11-14 16:29:09fioddorSe alinea con la versión 09 del 07 de noviembre de 201912019-09-16 10:58:59fioddorSe crea la versión española.Translation(s): English - Español
Servidor Mumble (Chat de voz) Mumble icon Disponible desde: versión 0.5
¿Qué es Mumble?Mumble es un software de conversaciones de voz. Principalmente diseñado para uso con juegos multijugador por red, sirve para hablar con alta calidad de audio, cancelación de ruido, comunicación cifrada, autenticación de interlocutores por defecto mediante par de claves pública/privada, y "asistentes" para configurar tu micrófono, por ejemplo. Se puede marcar a un usuario dentro de un canal como "interlocutor prioritario".
Usar MumbleFreedomBox incluye el servidor Mumble. Para conectar con el servidor los usuarios pueden descargar algún cliente de entre los disponibles para plataformas de escritorio y móviles.
Redirección de PuertosSi tu FreedomBox está detrás de un router necesitarás configurar la redirección de puertos de tu router. Deberías redirigir los siguientes puertos para Mumble: TCP 64738 UDP 64738
Administrar PermisosEn Mumble un superusuario puede crear cuentas de administrador que a su vez pueden administrar permisos a grupos y canales. Esto se puede hacer tras ingresar con el usuario "SuperUser" y la contraseña de superusuario. Ver la Guía de Mumble para obtener información respecto a cómo hacer esto. Actualmente FreedomBox no ofrece una interfaz gráfica para obtener o establecer la contraseña de superusuario en Mumble. Se genera una contraseña de superusuario automáticamente durante la instalación de Mumble. Para obtenerla ingresa en el terminal como admin usando Cockpit , la Shell Segura o la consola. Y ejecuta el siguiente comando: Deberás ver una salida como esta: 2019-11-06 02:47:41.313 1 => Password for 'SuperUser' set to 'noo8Dahwiesh']]>O puedes establecer una contraseña nueva así: Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/NameServices.raw.xml b/doc/manual/es/NameServices.raw.xml deleted file mode 100644 index 74d812be7..000000000 --- a/doc/manual/es/NameServices.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/NameServices32020-08-19 10:34:10fioddorSe alinea con la versión 05 en inglés del 19 de agosto de 202022019-11-14 18:09:00fioddorSe alinea con la versión 04 en inglés del 11 de noviembre de 201912019-06-20 15:23:22fioddorSe crea la versión española.Translation(s): English - Español
Servicios de NombreLos Servicios de Nombre proporcionan una vista general a las formas de acceder desde la Internet pública a tu !Freedombox: nombre de dominio, servicio Tor Onion y cometa (Pagekite). Para cada tipo de nombre se indica si los servicios HTTP, HTTPS, y SSH están habilitados o deshabilitados para conexiones entrantes. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Networks.raw.xml b/doc/manual/es/Networks.raw.xml deleted file mode 100644 index 972319848..000000000 --- a/doc/manual/es/Networks.raw.xml +++ /dev/null @@ -1,5 +0,0 @@ -
es/FreedomBox/Manual/Networks202020-08-19 09:51:16fioddorSe alinea con la versión 13 en inglés del 19 de agosto de 2020192020-06-01 23:34:30JamesValleroyadd TableOfContents182020-05-24 09:05:35fioddorCorrecciones menores172020-05-24 08:36:30fioddorSe alinea con la versión 12 en inglés del 24 de mayo de 2020162020-04-13 16:23:26fioddorSe alinea con la versión 10 en inglés del 12 de abril de 2020152020-04-04 17:43:48fioddorCorrección menor142020-04-04 17:41:35fioddorCorrección menor132020-04-04 17:40:01fioddorCorrección menor122020-04-04 17:33:37fioddorCorrección.112019-08-28 07:38:21fioddorCorrección menor102019-08-28 07:34:37fioddorCorrección menor92019-08-28 07:32:06fioddorCorrección menor82019-08-28 07:31:14fioddorSe incorpora la traducción de una sección nueva.72019-08-28 07:12:51fioddorSe incorpora la traducción de una sección nueva.62019-08-27 13:09:22fioddorCorrección menor52019-08-27 13:06:19fioddorSe incorpora la traducción de una sección nueva.42019-08-27 12:27:43fioddorSe incorpora la traducción de una sección nueva.32019-08-23 13:02:33fioddorSe incorpora la traducción de una sección nueva.22019-08-23 12:32:31fioddorSe incorpora la traducción de una sección nueva.12019-08-23 11:53:13fioddorSe crea la versión española (traducción incompleta).Translation(s): English - Español
RedesEsta sección describe como se configura por defecto la red en FreedomBox y como se puede adaptar. Ver también la sección Cortafuegos para más información acerca de cómo funciona éste.
Configuración por defectoEn una imágen fresca de FreedomBox la red no está configurada. La configuración se realiza cuando la imágen se graba en una tarjeta SD y el dispositivo arranca. Durante el primer arranque el paquete FreedomBox setup detecta los interfaces (tarjetas) de red e intenta configurarlos automáticamente de modo que la FreedomBox quede disponible para seguir configurandola a través del interfaz web desde otra máquina, sin necesidad de conectar un monitor a la FreedomBox. La configuración automática también procura dejar la FreedomBox operativa para sus escenarios de uso más importantes. Trata 2 escenarios: cuando hay 1 único interfaz (tarjeta) ethernet cuando hay múltiples interfaces (tarjetas) ethernet
Interfaz (tarjeta) ethernet únicoCuando el dispositivo hardware solo tiene 1 único interfaz (tarjeta) ethernet hay poco margen para que haga de router. En tal caso se asume que el dispositivo es solo una máquina más en la red. En consecuencia el único interfaz (tarjeta) disponible se configura para ser un interfaz interno en modo de configuración automática. Esto significa que se conecta a Internet empleando la configuración provista por un router de la red y que hace todos sus servicios (internos y externos) accesibles a todos los clientes que haya en esta red. network_single.png
Múltiples interfaces (tarjetas) ethernetCuando el dispositivo hardware tiene múltiples interfaces (tarjetas) ethernet el dispositivo puede actuar como router. Entonces los interfaces se configuran para ejecutar esta función. El primer interfaz (tarjeta) de red se configura para ser una WAN o interfaz externo en modo de configuración automático. Esto significa que se conecta a Internet empleando la configuración provista por el proveedor de servicio de internet (ISP). En este interfaz solo se expondrán los servicios concebidos para consumo desde Internet (servicios externos). Tu conexión a Internet tiene que llegar por el puerto de este interfaz (tarjeta) ethernet. Si quieres que tu router de siempre siga administrando tu conexión por tí conecta un cable desde tu router al puerto de este interfaz. Los demás interfaces de red se configuran como clientes de router, como LAN o interfaces internos en modo de configuración compartido. Esto significa que todos sus servicios (internos y externos) se exponen a todos los clientes que entren desde esta red. Compartido implica además que los clientes podrán recibir detalles para conexión automática a la red. En concreto, la configuración DHCP y los servidores DNS se exponen en este interfaz. La conexión a Internet disponible para el dispositivo a través del primer interfaz se compartirá con los clientes que usen este interfaz. Todo esto implica que puedes conectar tus ordenadores a esta interfaz (tarjeta) de red y se configurarán automáticamente pudiendo acceder a Internet a través de tu FreedomBox. Aunque el proceso de asignación es determinista actualmente no está muy claro qué interfaz será WAN (los demás serán LAN). Así que averiguar cual es cual conllevará un poco de prueba y error. En el futuro esto estará bien documentado para cada dispositivo.
Configuración de la Wi-FiTodos los interfaces Wi-Fi se configuran para ser LAN o interfaces internos en modo de configuración compartido. También se configuran para ser puntos de acceso Wi-Fi con los siguientes datos: El nombre de cada punto de acceso será FreedomBox más el nombre del interfaz (para tratar el caso de que haya varios). La contraseña para conectar a los interfaces será freedombox123.
Compartición de la Conexión a InternetAunque la principal obligación de FreedomBox es proporcionar servicios descentralizados también puede ejercer como router casero. Por tanto en la mayoría de los casos FreedomBox se conecta a Internet y proporciona a otras máquinas de la red la posibilidad de usar esa conexión a Internet. FreedomBox puede hacer esto de 2 formas: usando un modo de conexión compartido o empleando una conexión interna. Cuando se configura un interfaz en modo compartido puedes conectarle tu máquina directamente, sea por cable desde este interfaz a tu máquina o conectando a través del punto de acceso Wi-Fi. Este caso es el más facil de usar porque FreedomBox automáticamente proporciona a tu máquina la configuración de red necesaria. Tu máquina conectará automáticamente a la red proporcionada por FreedomBox y podrá conectar a Internet ya que FreedomBox puede a su vez conectarse a Internet. En ocasiones la configuración anterior podría no ser posible porque el dispositivo hardware tenga un único interfaz de red o por otros motivos. Incluso en este caso tu máquina puede todavía conectarse a Internet a través de la FreedomBox. Para que esto funcione asegúrate de que el interfaz de red al que se está conectando tu máquina esté en modo interno. Entonces conecta tu máquina a la red en la que está la FreedomBox. Después de esto configura la red de tu máquina indicando como puerta de enlace la dirección IP de la FreedomBox. FreedomBox aceptará entonces el tráfico de red de tu maquina y lo enviará a Internet. Esto funciona porque los interfaces de red en modo interno están configurados para enmascarar hacia Internet los paquetes que lleguen desde máquinas locales, así como para recibir paquetes desde Internet y reenviarlos hacia las máquinas locales.
AdaptacionesLa configuración por defecto anterior podría no servir para tu caso. Puedes adecuar la configuración para ajustarla a tus necesidades desde el área Redes de la sección Configuración del interfaz web de tu FreedomBox.
Conexiones PPPoESi tu ISP no proporciona configuración de red automática via DHCP y te obliga a conectar por PPPoE, para configurarlo elimina toda conexión de red existente en el interfaz y añade una de tipo PPPoE. Aquí, si procede, indica el usuario y la contraseña que te ha dado tu ISP y activa la conexión.
Conectar a Internet mediante Wi-FiPor defecto durante el primer arranque los dispositivos Wi-Fi se configurarán como puntos de acceso. Sin embargo se pueden reconfigurar como dispositivos Wi-Fi normales para conectar a la red local o a un router WiFi existente. Para hacer esto haz clic en la conexión Wi-Fi para editarla. Cambia el modo a Infraestructura en vez de Punto de Acceso y Método de direccionamiento IPv4 a Automático (DHCP) en vez de Modo compartido. SSID proporcionado significa el nombre de la red Wi-Fi a la que quieres conectar. Rellena la frase clave.
Problemas con la Funcionalidad de PrivacidadEl gestor de red que emplea FreedomBox para conectar con las redes Wi-Fi tienen una funcionalidad de privacidad que usa una identidad para buscar redes diferente de la que emplea para conectar con el punto de acceso Wi-Fi. Desafortunadamente esto causa problemas con algunos routers que rechazan estas conexiones. Tu conexión no se activará con éxito y se desconectará. Si tienes control sobre el comportamiento del router puedes desactivar esta funcionalidad. Si no la solución es desactivar la funcionalidad de privacidad: Entra a la FreedomBox por SSH o Cockpit. Edita el fichero /etc/NetworkManager/NetworkManager.conf: Añade la linea wifi.scan-rand-mac-address=no en la sección [device]: Luego reinicia la FreedomBox.
Añadir un nuevo dispositivo de redAl añadir un nuevo dispositivo de red network manager lo configurará automáticamente. En la mayoría de los casos esto no funcionará. Borra la configuración creada automáticamente en el interfaz y crea una conexión de red nueva. Selecciona tu interfaz recién creado en la página "añadir conexión". Configura la zona del cortafuegos como corresponda. Puedes configurar los interfaces para conectar a la red o proporcionar configuración de red a cualquier máquina que se le conecte. De modo similar, si es un interfaz Wi-Fi puedes configurarlo para ser un punto de acceso Wi-FI o para conectarse a puntos de acceso existentes en la red.
Configurar una red MeshFreedomBox tiene un soporte rudimentario para participar en redes mesh basadas en BATMAN-Adv. Es posible unirse a una red existe en tu zona o crear una red mesh nueva y compartir tu conexión a Internet con el resto de nodos que se unan a tu red. Tanto para unirte a una red mesh como para crear otra, actualmente hay que crear 2 conexiones y activarlas manualmente.
Unirse a una red MeshPara unirse a una red mesh existente en tu zona primero consulta a sus organizadores y obtén información acerca de la red. Crea una conexión nueva y selecciona el tipo de conexión Wi-Fi. En el siguiente diálogo rellena los valores como se indica: Nombre del campoValor de ejemploExplicación Nombre de la Conexión Mesh Join - BATMAN El nombre tiene que acabar en BATMAN (con mayúsculas). Interfaz físico wlan0 El dispositivo Wi-Fi que quieres usar para conectar a la red mesh. Zona del cortafuegos Externa Ya que no quieres que los participantes en la red mesh usen dispositivos internos de tu FreedomBox. SSID ch1.freifunk.net Tal como te lo hayan dado los operadores de la red mesh. Esta red debería mostrarse en Redes Wi-Fi accesibles. Modo Ad-hoc Porque esta red es una red de pares (peer-to-peer). Banda de Frecuencia 2.4Ghz Tal como te lo hayan dado los operadores de la red mesh. Canal 1 Tal como te lo hayan dado los operadores de la red mesh. BSSID 12:CA:FF:EE:BA:BE Tal como te lo hayan dado los operadores de la red mesh. Autenticación Abierta Déjala abierta salvo que sepas que tu red mesh necesite otro valor. Contraseña Déjala en blanco salvo que sepas el valor que necesite tu red mesh. Método de direccionamiento IPv4 Deshabilitado Todavía no queremos pedir una configuración IP. Graba la conexión y únete a la red mesh activándola. Crea una segunda conexión nueva y selecciona el tipo Genérica. En el siguiente diálogo rellena los valores como se indica: Nombre del campoValor de ejemploExplicación Nombre de la Conexión Mesh Connect Cualquier nombre para identificar ésta conexión. Interfaz físico bat0 Este interfaz solo aparecerá tras activar con éxito la conexión del paso anterior. Zona del cortafuegos Externa Ya que no quieres que los participantes en la red mesh usen dispositivos internos de tu FreedomBox. Método de direccionamiento IPv4 Auto Generalmente las redes mesh tienen un servidor DHCP en algún sitio que le proporciona una configuración IP a tu máquina. Si no, consulta al operador y configura la dirección IP como te diga por el método manual. Graba la conexión. Configura tu maquina para participar en la red activando esta conexión. Actualmente hay que activarla manualmente cada vez que quieras unirte a la red. En el futuro FreedomBox lo hará automáticamente. Ahora debieras poder llegar a otros nodos de la red. También podrás conectar a Internet a través de la red mesh si los operadores han instalado algúna puerta de enlace.
Crear una red MeshPara crear tu propia red mesh y compartir tu conexión a Internet con el resto de los nodos de la red: Sigue las instrucciones del paso 1 de Unirse a una red Mesh empleando los valores válidos para tu red en SSID (un nombre para tu red Mesh), Banda de Frecuencia (generalmente 2.4Ghz), Canal (entre 1 y 11 para la banda de 2.4Ghz) y BSSID (una secuencia hexadecimal como 12:CA:DE:AD:BE:EF). Crea esta conexión y actívala. Sigue las instrucciones del paso 2 de Unirse a una red Mesh seleccionando Compartido para Método de direccionamiento IPv4d. Esto proporcionará automáticamente una configuración IP a otros nodos de la red y compartirá la conexión a Internet de tu maquina (ya sea mediante un segudo interfaz Wi-Fi, Ethernet, etc.) con el otros nodos de la red mesh. Corre la voz entre tus vecinos acerca de tu red mesh y pásales los parámetros que has empleado al crearla. Cuando otros nodos se conecten a esta red mesh tendrán que seguir las instrucciones del paso 1 de Unirse a una red Mesh empleando en SSID, Banda de Frecuencia y Canal los valores que has elegido para tu red mesh al crearla.
Operación avanzada de RedCockpit proporciona muchas funcionalidades de red más avanzadas que las de FreedomBox. Ambos, FreedomBox y Cockpit, operan sobre Network Manager y son por ello compatibles entre sí. Entre las funciones de Cockpit se incluyen: Establer de la unidad máxima de transmisión (MTU) para una conexión de red. Cambiar de la dirección hardware (MAC) de un interfaz de red. Añadir más servidores DNS y configurar el enrutado de una conexión de red. Crear dispositivos coordinados para interfaces de red de alta disponibilidad. Crear dispositivos en puente para agregar redes diferentes en un mismo interfaz de red. Administrar VLAN para crear particiones virtuales en la red física. networks-cockpit.png
Operación manual de RedFreedomBox configura redes automáticamente por defecto y proporciona un interfaz simplificado para personalizar la configuración a necesidades específicas. En la mayoría de los casos la operación manual no es necesaria. Los siguientes pasos describen cómo operar la configuración de red a mano en caso de que el interfaz de FreedomBox le resulte insuficiente a un usuario para realizar una tarea o para diagnosticar un problema que FreedomBox no identifique. En el interfaz de línea de comandos: Para acceder a un interfaz de configuración de conexiones de red basado en texto: Para ver la lista de dispositivos de red disponibles: Para ver la lista de conexiones configuradas: Para ver el estado actual de una conexión: ']]>Para ver la zona asignada actualmente en el cortafuegos a un interfaz de red: ' | grep zone]]>o Para crear una conexión nueva: " ifname "" type ethernet -nmcli con modify "" connection.autoconnect TRUE -nmcli con modify "" connection.zone internal]]>Para cambiarle la zona a una conexión en el cortafuegos: " connection.zone ""]]>Para más información acerca del uso del comando nmcli mira su página man. Para obtener una lista completa de configuraciones y tipos de conexión que acepta Network Manager mira: Para ver el estado actual del cortafuegos y operarlo manualmente lee la sección Cortafuegos. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/OpenVPN.raw.xml b/doc/manual/es/OpenVPN.raw.xml deleted file mode 100644 index 1b8232127..000000000 --- a/doc/manual/es/OpenVPN.raw.xml +++ /dev/null @@ -1,4 +0,0 @@ -
es/FreedomBox/Manual/OpenVPN112020-07-19 22:59:10fioddorTranslations header added outside include block102020-07-18 16:40:15fioddorSe alinea con la versión 23 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.92020-07-15 11:58:39fioddorSección 'Acceso a servicios internos' incluída82020-06-23 11:00:40fioddorSe alinea con la versión 21 en inglés del 23 de junio de 202072020-05-30 19:41:32SunilMohanAdapaUpdate the title to emphasize app name over its generic name62020-05-24 07:09:33fioddorSe alinea con la versión 18 en inglés del 23 de mayo de 202052019-11-20 11:00:10fioddorSe alinea con la versión 16 en inglés del 18 de noviembre de 201942019-10-10 19:50:32JosephNuthalapatiFix FreedomBox Portal include in the footer32019-09-16 09:36:03fioddorCorrección menor22019-09-16 09:34:40fioddorCorrección menor12019-09-16 09:32:56fioddorSe crea la versión española.Translation(s): English - Español
OpenVPN (Red Privada Virtual) icono de OpenVPN Disponible desde: versión 0.7
¿Qué es OpenVPN?OpenVPN proporciona un servicio de red privada virtual a tu FreedomBox. Puedes usar este software para acceso remoto, VPNs punto-a-punto y seguridad Wi-Fi. OpenVPN incluye soporte para direcciones IP dinámicas y NAT.
Redirección de puertosSi tu FreedomBox está detrás de un router necesitarás configurar la redirección de puertos en tu router. Debes redirigir los siguientes puertos para OpenVPN: UDP 1194
ConfigurarEn el menú de apps de FreedomBox selecciona Red Privada Virtual (OpenVPN) y haz clic en Instalar. Tras instalar el módulo todavía queda un paso de configuración que puede llevar largo tiempo completar. Haz clic en "Iniciar configuración" para empezar. OpenVPN service page Espera a que termine la configuración. Puede tardar un rato. Una vez completada la configuración del servidor OpenVPN puedes descargar tu perfil. Esto descargará un archivo llamado <usuario>.ovpn, siendo <usuario> un usuario de FreedomBox. Todos los usuarios de FreedomBox podrán descargar un perfil propio y diferente. Los usuarios que no sean administradores pueden descargar el perfil desde la portada después de ingresar. El archivo ovpn contiene toda la información que necesita un cliente vpn para conectar con un servidor. El perfil descargado contiene el nombre de dominio de FreedomBox al que debe conectarse el cliente. Este se obtiene del dominio configurado en la sección 'Configuración' de la página de 'Sistema'. En caso de que tu dominio no esté configurado adecuadamente quizá necesites cambiar este valor después de descargar el perfil. Si tu cliente OpenVPN lo permite puedes hacer esto después de importar el perfil OpenVPN. De lo contrario puedes editar el perfil .ovpn con un editor de texto y cambiar la línea 'remote' para que contenga la dirección IP WAN o el hostname de tu FreedomBox como se indica aquí.
Navegar por Internet tras conectar a una VPNTras conectar a la VPN el dispositivo cliente podrá navegar por Internet sin más configuración adicional. No obstante una pre-condición para que esto funcione es que necesitas tener al menos 1 interfaz (tarjeta) de red conectado a Internet en la zona Externa del cortafuegos. Usa la página de configuración de redes para editar la zona del cortafuegos con los interfaces (tarjetas) de red del dispositivo.
Uso
En Android/LineageOSVisita la página principal de FreedomBox. Ingresa con tu cuenta de usuario. Desde la página principal descarga el perfil OpenVPN. El archivo se llamará <usuario>.ovpn. OpenVPN Download Profile Descarga un cliente OpenVPN como OpenVPN for Android. Se recomienda el repositorio F-Droid. En la app, selecciona Importar perfil. OpenVPN App En el diálogo Seleccionar perfil elige el archivo <usuario>.opvn que acabas de descargar. Pon un nombre a la conexión y graba el perfil. OpenVPN import profile El perfil recién creado aparecera. Si hace falta edita el perfil y pon el nombre de dominio de tu FreedomBox como dirección de servidor. OpenVPN profile created OpenVPN edit domain name Conecta haciendo clic sobre el perfil. OpenVPN connect OpenVPN connected Cuando esté desconecta haciendo clic sobre el perfil. OpenVPN disconnect
En DebianInstala un cliente OpenVPN para tu sistema Abre el archivo ovpn con el cliente OpenVPN. .ovpn]]>Si te sale un error como configuration error: invalid 1th argument to “proto” (line 5) edita el fichero .ovpn y elimina la línea proto udp6.
Comprobar si estás conectado
En DebianTrata de hacer ping a tu FreedomBox u otros dispositivos de tu red. El comando ip addr debe mostrar una conexión tun0. El comando traceroute freedombox.org debiera mostrar la dirección IP del servidor VPN como primer salto. Si usas Network Manager puedes crear una conexión nueva importando el fichero: .ovpn]]>
Acceso a servicios internosTras conectar por OpenVPN, podrás acceder a algunos servicios FreedomBox restringidos a acceso interno, además de a los de acceso externo. Esto se puede hacer usando la dirección IP 10.91.0.1 como hostname para esos servicios. Los siguientes servicios funcionan con OpenVPN: Privoxy, Tor Socks, Shadowsocks, I2P Proxy and Samba. Algunos servicios no funcionan aún con OpenVPN: Avahi, bind and MiniDLNA.
Enlaces Externos Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/PageKite.raw.xml b/doc/manual/es/PageKite.raw.xml deleted file mode 100644 index b215aee7d..000000000 --- a/doc/manual/es/PageKite.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/PageKite62020-08-19 09:47:43fioddorSe alinea con la versión 16 en inglés del 19 de agosto de 202052020-07-15 10:18:36fioddorCorrección.42020-05-30 19:49:21SunilMohanAdapaUpdate the title to emphasize app name over its generic name32020-05-24 07:40:58fioddorSe alinea con la versión 14 en inglés del 23 de mayo de 202022020-04-04 19:54:42fioddorEnlace a página traducida.12019-06-20 15:13:14fioddorSe crea la versión española.Translation(s): English - Español
PageKite (Visibilidad Publica)
¿Qué es PageKite?PageKite hace inmediata y públicamente accesibles desde internet a los sitios web y servicios locales sin tener que crear tu mismo una dirección IP pública. Lo hace tunelando protocolos como HTTPS o SSH a través de cortafuegos y NAT. Usar PageKite require ana cuenta en un servicio de repetidor de PageKite. es uno de de estos servicios. Un servicio de repetidor de PageKite te permitirá crear cometas (kites). Las cometas son similares a los nombres de dominio pero con ventajas y desventajas diferentes. Una cometa puede tener varios servicios configurados. Se sabe que PageKite funciona con HTTP, HTTPS, y SSH, y muchas funcionan con otros servicios, pero no todas.
Usar PageKiteCréate una cuenta en un servicio de repetidor de PageKite. Añade una cometa a tu cuenta. Anota el nombre y el secreto de tu cometa. En FreedomBox, vé a la solapa "Configurar PageKite" de la página Visibilidad Publica (PageKite). Marca la caja "Habilitar PageKite" e introduce el nombre y el secreto de tu cometa. Haz clic en "Grabar propiedades". En la solapa "Servicios Estándar" puedes habilitar HTTP y HTTPS (recomendado) y SSH (opcional). HTTP se necesita para obtener el certificado Let's Encrypt. Puedes deshabilitarlo (HTTPS) más tarde. En la página Certificados (Let's Encrypt) puedes obtener un certificado Let's Encrypt para el nombre de tu cometa. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Performance.raw.xml b/doc/manual/es/Performance.raw.xml deleted file mode 100644 index a80f98683..000000000 --- a/doc/manual/es/Performance.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Performance42020-07-29 23:27:46fioddor32020-07-29 23:27:14fioddorCorrección menor22020-07-29 23:26:38fioddorCorrección.12020-07-29 23:23:19fioddorNueva página traducida. Alineada con la versión 11 del 30 de mayo de 2020.Translation(s): English - Español
Performance (Monitorización del sistema)Disponible desde: versión 20.9 La app Performance permite recabar, almacenar y ver información acerca de la utilización del hardware. Esto proporciona visibilidad acerca de patrones de uso y si el hardware está sobrecargado por usuarios y/o servicios. Las métricas de Performance las recaba Performance Co-Pilot se pueden ver mediante la app Cockpit. Cuando se instala y habilita esta app del sistema, los gráficos de Cockpit muestran el pasado (hasta un año atrás). FreedomBox/Manual/Performance/performance-one-week.png Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Power.raw.xml b/doc/manual/es/Power.raw.xml deleted file mode 100644 index 7e506c03c..000000000 --- a/doc/manual/es/Power.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Power42020-07-30 08:27:21fioddorCorrección menor32020-07-30 08:25:15fioddorCorrección.22020-07-30 08:23:59fioddor12019-06-18 15:25:34fioddorSe crea la versión española.Translation(s): English - Español
ApagadoPower proporciona un modo fácil de reiniciar o apagar tu FreedomBox. Después de seleccionar "Reiniciar" o "Apagar", se te pedirá confirmación. Se puede llegar también a las opciones "Reiniciar" y "Apagar" desde el menú desplegable del usuario en la esquina superior derecha. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Privoxy.raw.xml b/doc/manual/es/Privoxy.raw.xml deleted file mode 100644 index fe352b1cc..000000000 --- a/doc/manual/es/Privoxy.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Privoxy72020-07-19 22:59:50fioddorTranslations header added outside include block62020-07-18 16:48:57fioddorSe alinea con la versión 17 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.52020-05-30 19:41:57SunilMohanAdapaUpdate the title to emphasize app name over its generic name42020-05-24 07:14:06fioddorSe alinea con la versión 15 en inglés del 23 de mayo de 202032020-05-10 00:49:54fioddorSe alinea con la versión 13 en inglés del 03 de mayo de 202022019-09-16 11:36:07fioddor12019-09-16 11:33:00fioddorSe crea la versión española.Translation(s): English - Español
Privoxy (Proxy Web) icono de Privoxy Disponible desde: versión 0.1 Un proxy web actúa como filtro para tráfico web entrante y saliente. Por tanto, puedes ofrecer a los ordenadores de tu red pasar su tráfico internet a través del proxy para eliminar anuncios y mecanismos de rastreo indeseados. Privoxy es un software para la seguridad, privacidad, y control certero sobre la web. Proporciona una navegación web mucho más controlada (y anónima) que la que te puede ofrecer tu navegador. Privoxy "es un proxy enfocado principalmente al aumento de la privacidad, eliminación de anuncios y morralla, y a liberar al usuario de las restricciones impuestas sobre sus propias actividades" (fuente: Preguntas frecuentes acerca de Privoxy).
VídeoMira el vídeo acerca de como configurar y usar Privoxy en FreedomBox.
ConfigurarInstala Proxy Web (Privoxy) desde FreedomBox Privoxy Installation Adapta las preferencias de proxy de tu navegador al hostname (o dirección IP) de tu FreedomBox con el puerto 8118. Observa por favor que Privoxy sólo puede tratar tráfico HTTP y HTTPS. No funciona con FTP u otros protocolos. Privoxy Browser Settings Vé a la página o . Si Privoxy está instalado adecuadamente podrás configurarlo en detalle y si no verás un mensaje de fallo. Si usas un portátil que tenga a veces que conectarse con FreedomBox y Privoxy pasando por routers de terceros quizá quieras instalar una extensión proxy switch que te permite activar y desactivar el proxy más fácilmente.
Usuarios AvanzadosLa instalación de serie debería proporcionar un punto de partida razonable para la mayoría de los usuarios. Indudablemente habrá ocasiones en las que quieras ajustar la configuración. Eso se puede afrontar cuando surja la necesidad. Con Privoxy activado puedes ver su documentación y los detalles de su configuración en http://config.privoxy.org/ o en http://p.p. Para habilitar los cambios en estas configuraciones primero tienes que cambiar el valor de habilitar-acciones-de-edición en /etc/privoxy/config a 1. Antes de hacerlo lee el manual con atención, especialmente: No se puede controlar por separado el accesso al editor por "ACLs" o authenticación HTTP, así que cualquiera con acceso a Privoxy puede modificar la configuración de todos los usuarios. Esta opción no se recomienda para entornos con usuarios no confiables. Nota que un código de cliente malicioso (p.ej. Java) también puede usar el editor de acciones y no deberías habilitar estas opciones a no ser que entiendas las consecuencias y estés seguro de que los navegadores están correctamente configurados. Ahora encontrarás un botón EDITAR en la pantalla de configuración de http://config.privoxy.org/. La Guía rápida es un buen punto de partida para leer acerca de cómo definir reglas de bloqueo y filtrado propias. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Quassel.raw.xml b/doc/manual/es/Quassel.raw.xml deleted file mode 100644 index 3c6d5aef5..000000000 --- a/doc/manual/es/Quassel.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Quassel182020-07-30 08:24:36fioddorCorrección.172020-07-29 18:10:10fioddorSe alinea con la versión 16 en inglés del 29 de julio de 2020.162020-07-29 16:08:10fioddor152020-07-19 23:00:41fioddorTranslations header added outside include block142020-07-18 16:57:39fioddorSe alinea con la versión 14 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.132020-05-30 19:42:16SunilMohanAdapaUpdate the title to emphasize app name over its generic name122020-05-24 06:58:26fioddorSe alinea con la versión 11 en inglés del 23 de mayo de 2020112020-05-11 23:17:26fioddorSe alinea con la versión 09 en inglés del 12 de mayo de 2020102020-05-11 18:51:37fioddorImagen traducida92020-05-11 18:44:58fioddorLiteral alineado con la imágen (pero traducido)82020-05-11 18:42:24fioddorErrata72020-05-11 18:40:56fioddorLiterales alineados con las imágenes62020-05-11 18:16:52fioddorMás imágenes traducidas52020-05-11 17:36:30fioddorAlgunas imágenes traducidas42020-05-10 00:47:37fioddorenlace a la página en español32020-05-10 00:45:37fioddorSe alinea con la versión 08 en inglés del 03 de mayo de 202022019-09-12 12:18:51fioddorSe crea la versión española.12019-09-12 12:11:29fioddorSe crea la versión española.Translation(s): English - Español
Quassel (Cliente IRC) icono de Quassel Disponible desde: versión 0.8 Quassel es una aplicación IRC separada en 2 partes: un "núcleo" y un "cliente". Esto permite que el núcleo permanezca conectado a los servidores IRC recibiendo mensajes aunque el cliente esté desconectado. Ejecutando el servicio nucleo de Quassel FreedomBox puede mantenerte siempre en línea. Se pueden usar uno o varios clentes Quassel para conectarse intermitentemente desde escritorios o dispositivos móviles.
¿Para qué ejecutar Quassel?Muchos debates acerca de FreedomBox tienen lugar en el canal IRC irc://irc.debian.org/freedombox. Si tu FreedomBox ejecuta Quassel recolectará todos ellos mientras estás ausente, capturando las respuestas a tus preguntas. Recuerda que el proyecto FreedomBox es mundial y participa gente de casi todos los husos horarios. Usarás tu cliente para conectar al núcleo de Quassel y leer y/o responder cuando tengas tiempo y disponibilidad.
¿Cómo activar Quassel?En el interfaz web de FreedomBox selecciona Aplicaciones ve a Cliente IRC (Quassel) e instala la aplicación y asegúrate de que está habilitada Quassel Installation tu núcleo de Quassel se está ejecutando
Redirección de PuertosSi tu FreedomBox está detras de un router necesitarás configurar la redirección de puertos en tu router. Redirije los siguientes puertos de Quassel: TCP 4242 Ejemplo de configuración en el router: Quassel_PortForwarding_es_v01.png
ClientesHay disponibles clientes para escritorio y dispositivos móviles para conectar a Quassel.
EscritorioEn un sistema Debian puedes, p. ej. usar quassel-client. Los siguientes pasos describen cómo conectar el Cliente Quassel con el Núcleo de Quassel de tu FreedomBox. La primera vez que te conectes el Núcleo de Quassel se inicializará también. Abre el Cliente Quassel. Te guiará paso a paso para Conectarse al núcleo. Connect to Core Haz clic en el botón Añadir para abrir el diálogo Añadir cuenta de núcleo. Add Core Account Rellena cualquier cosa en el campo Nombre de la cuenta. Introduce el hostname DNS de tu FreedomBox en el campo Servidor. El campo Puerto debe tener el valor 4242. Pon el usuario y la contraseña de la cuenta que quieres crear para conectar con el Núcleo de Quassel en los campos Usuario y Contraseña. Si no quieres que se te pida la contraseña cada vez que arranques el cliente de Quassel marca la opción Recordar. Tras pulsar OK en el diálogo Añadir cuenta de núcleo deberías ver la cuenta en el diálogo Conectarse al núcleo. Connect to Core Selecciona la cuenta del núcleo recién creada y dale a OK para conectar con él. Si es la primera vez que te conectas a este núcleo verás un aviso de Certificado de seguridad no confiable y necesitarás aceptar el certificado del servidor. Untrusted Security Certificate Selecciona Continuar. Se te preguntará si quieres aceptar el certificado permanentemente. Selecciona Para siempre. Untrusted Security Certificate Si nadie se ha conectado nunca antes a este Núcleo Quassel antes verás un diálogo por pasos Asistente de configuración del núcleo. Selecciona Siguiente. Core Configuration Wizard En la página Crear usuario administrador introduce el usuario y la contraseña que has usado antes para crear la conexión al núcleo. Selecciona Recordar la contraseña para que recuerde la contraseña para futuras sesiones. Haz clic en Siguiente. Create Admin User Page En la página Seleccionar un motor de almacenamiento selecciona SQLite y haz clic en Enviar. Select Storage Backend La configuración del núcleo está completa y verás un asistente Quassel IRC para configurar tus conexiones IRC. Haz clic en Siguiente. Welcome Wizard A continuación en la página de Configurar identidad pon un nombre y múltiples pseudónimos. Te presentarás con estos a otros usuarios de IRC. No es necesario dar tu nombre real. Los pseudónimos múltipes son útiles como suplentes cuando el primero no se pueda usar por cualquier motivo. Tras aportar la información haz clic en Siguiente. Setup Identity A continuación en la página de Configurar conexión de red pon el nombre de red que quieras y una lista de servidores a los que se deba conectar el Núcleo de Quassel para unirte a esa red IRC (por ejemplo irc.debian.org:6667). Setup Network Connection Selecciona un servidor de la lista y dale a Editar. En el diálogo Información del servidor pon el puerto 6697 (consulta la lista real de servidores y sus puertos seguros en la documentación de tu red) y haz clic en Usar conexión cifrada. Clic en OK. Esto es para asegurar que la comunicación entre tu FreedomBox y el servidor de la red IRC va cifrada. Server Info Server Info SSL Ya de vuelta en el diálogo Configuración de Conexión de Red proporciona una lista de canales IRC (como #freedombox) a los que unirte al conectarte a la red. Dale a Grabar y Conectar. Setup Network Connection Deberías conectar con la red y ver la lista de canales a los que te has unido en el panel Todas las conversaciones de la izquierda de la ventana principal del Cliente Quassel. Quassel Main Window Selecciona un canal y empieza a recibir mensajes de otros participantes del canal y a enviar los tuyos.
AndroidPara dispositivos Android puedes usar p.ej. Quasseldroid obtenido desde F-Droid introduce el núcleo, usuario, etc. Quasseldroid.png Por cierto el verbo alemán quasseln significa hablar mucho, rajar. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Radicale.raw.xml b/doc/manual/es/Radicale.raw.xml deleted file mode 100644 index 3c10ae15e..000000000 --- a/doc/manual/es/Radicale.raw.xml +++ /dev/null @@ -1,25 +0,0 @@ -
es/FreedomBox/Manual/Radicale152020-07-19 23:01:18fioddorTranslations header added outside include block142020-07-18 17:06:20fioddorSe alinea con la versión 59 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.132020-05-30 19:46:20SunilMohanAdapaUpdate the title to emphasize app name over its generic name122020-05-24 06:32:26fioddorSe alinea con la versión 57 en inglés del 23 de mayo de 2020112020-05-22 10:11:41fioddorSe alinea con la versión 55 en inglés del 22 de mayo de 2020102020-05-15 17:00:38fioddorSe alinea con la versión 54 en inglés del 15 de mayo de 202092020-05-10 00:39:59fioddorSe alinea con la versión 52 en inglés del 03 de mayo de 202082019-09-06 08:16:54fioddorSe mejoran las referencias a Debian Testing en línea con la nomenclatura de https://www.debian.org/releases/72019-09-04 13:36:27fioddorSe completa la traducción.62019-09-04 13:26:30fioddorSe incorpora la traducción de una sección nueva.52019-09-04 12:55:18fioddorSe incorpora la traducción de una sección nueva.42019-09-04 12:52:32fioddorSe incorpora la traducción de una sección nueva.32019-09-04 12:40:55fioddorSe incorpora la traducción de una sección nueva.22019-09-04 12:23:33fioddorSe incorpora la traducción de una sección nueva.12019-09-04 12:00:49fioddorSe crea la versión española (traducción incompleta).Translation(s): English - Español
Radicale (Calendario y Contactos) icono de Radicale Disponible desde: versión 0.9 Con Radicale puedes sincronizar tus calendarios, listas de tareas y agendas de contactos personales entre varios ordendores, tabletas, y/o teléfonos inteligentes y compartirlos con tus amistades. Todo sin tener que permitir a terceros que accedan a tu información privada.
¿Porque debería usar Radicale?Usando Radicale puedes evitar servicios centralizados como Google Calendar o Apple Calendar (iCloud) que explotan los datos de tus eventos y conexiones sociales.
¿Cómo configurar Radicale?Primero el servidor Radicale necesita estar activado en tu FreedomBox. En el servicio FreedomBox selecciona Apps ve a Radicale (Calendario y Libreta de contactos) e instala la aplicación. Tras completar la instalación asegúrate de que la aplicación está marcada como "habilitada" en el interfaz de FreedomBox. Habilitar la aplicación arranca el servidor CalDAV/CardDAV Radicale. define los permisos de acceso: Solo el dueño de un calendario/libreta de contactos puede ver o hacer cambios Cualquier usuario puede ver cualquier calendario/libreta de contactos pero solo el dueño puede hacer cambios Cualquier usuario puede ver o hacer cambios en cualquier calendario/libreta Nota: Solo los usuarios dados de alta en FreedomBox pueden acceder a Radicale. Radicale-Plinth.png Si quieres compartir un calendario solo con algunos usuarios determinados la manera más simple es crear un nuevo usuario común para ellos y compartir con ellos el nombre del usuario común y su contraseña. Radicale proporciona un interfaz web básico que solo soporta crear calendarios y libretas nuevos. Para añadir eventos o contactos se necesita una aplicación cliente soportada externa. radicale_web.png Crear calendarios y/o libretas usando el interfaz web Visita https://<dirección_IP_o_dominio_de_tu_servidor>/radicale/ Ingresa con tu cuenta de FreedomBox Selecciona "Crear nuevo calendario o libreta" Proporciona un título y selecciona el tipo Opcionalmente, proporciona una descripción o selecciona un color Haz clic en "Crear" La página mostrará la URL de tu created nuevo calendario o libreta Ahora abre tu aplicación cliente para crear calendarios y/o libretas nuevos que usarán tu FreedomBox y servidor Radicale. El sitio web de Radicale proporciona una lista de clientes soportados pero no uses las URLs que se mencionan allí; sigue este manual porque FreedomBox usa otra configuración. A continuación se muestran los pasos para 2 ejemplos: Ejemplo de configuración con el cliente Evolution: Calendario Crea un calendario nuevo Selecciona el "Tipo" "CalDAV" Con "CalDAV" seleccionado aparecerán más opciones en el cuadro de diálogo. URL: https://<dirección_IP_o_dominio_de_tu_servidor>/radicale/<usuario>/<nombre_del_calendario>.ics/ cambiando los elementos marcados entre <> de acuerdo a tu configuración. nota: la / inicial de la ruta es importante. Habilita "Usar una conexión segura." Nombre del calendario Radicale-Evolution-Docu.png Lista de tareas: Añadir una lista de tareas es prácticamente igual que con un calendario. Contactos Sigue los mismos pasos anteriores reemplazando CalDAV por WebDAV y la extensión de la libreta por .vcf.
Sincronizar via TorConfigurar un calendario en FreedomBox con Radicale sobre Tor es lo mismo que sobre la red en claro, en resumen: Cuando hayas ingresado al interfaz web de FreedomBox desde Tor haz clic en Radicale e introduce un usuario de tu FreedomBox y su contraseña. Ingresa en el interfaz web de Radicale usando el usuario de tu FreedomBox y su contraseña. Haz clic en "Crear libreta o calendario nuevo", proporciona un título, selecciona un tipo y haz clic en "Crear". Anota la URL, p.ej. https://<direccion_onion_de_tu_servidor>.onion/radicale/<usuario>/<código_del_calendario>/ cambiando los elementos marcados entre <> de acuerdo a tu configuración. Estas instrucciones son para Thunderbird/Lightning. Nota: necesitarás estar conectado a Tor con el Tor Browser Bundle. Abre Thunderbird, la extensión (add-on) Torbirdy y reinicia Thunderbird. (Quizá no haga falta.) En el interfaz Lightning, en el panel izquierdo bajo Calendario haz clic con el botón derecho del ratón y selecciona "Nuevo calendario". Selecciona "En la red" como localización de tu calendario. Selecciona "CalDAV" copia la URL, p.ej., https://<direccion_onion_de_tu_servidor>.onion/radicale/<usuario>/<código_del_calendario>/. como localización cambiando los elementos marcados entre <> de acuerdo a tu configuración. Proporciona un nombre, etc. Haz clic en "Siguiente". Tu calendario está ahora sincronizando con tu FreedomBox a través de Tor. Si no has generado un certificado con "Let's Encrypt" para tu FreedomBox quizá necesites seleccionar "Confirmar Excepción de Seguridad" cuando se te indique.
Sincronizar con tu teléfono AndroidHay varias Apps que admiten integración con el servidor Radicale. Este ejemplo usa DAVx5, que está disponible p.ej. en F-Droid. Si también quieres usar listas de tareas hay que instalar primero la app compatible OpenTasks. Sigue estos pasos para configurar tu cuanta con el servidor Radicale de tu FreedomBox. Instala DAVx5. Crea una cuenta nueva en DAVx5 haciendo clic en el botón flotante [+]. Selecciona la 2ª opción como se muestra en la primera imagen más abajo e introduce la URL base (no olvides la / del final). DAVx5 averiguará las cuentas CalDAV y WebDAV del usuario. Sigue este video del FAQ de DAVx5 para aprender cómo importar tus contactos existentes a Radicale. Sincronizar contactos Haz clic en los menús de hamburguesa de CalDAV y CardDAV y selecciona "Refrescar ..." en caso de cuentas existentes o "Crear ..." en caso de cuentas nuevas (ver la 2ª captura de pantalla más abajo). Marca las cajas de las libretas y/o contactos que quieras sincronizar y haz clic en el botón de sincronización de la cabecera. (ver la 3ª captura de pantalla más abajo) DAVx5 account setup DAVx5 refresh DAVx5 account sync
Usuarios Avanzados
Compartir recursosArriba se mostrá una manera fácil de crear un recurso para un grupo de gente creando una cuenta dedicada común. Aquí de describe un método alternativo con el que se otorga acceso a un calendario a 2 usuarios Usuario1 y Usuario2. Esto requiere acceso por SSH a la FreedomBox. crea un archivo /etc/radicale/rights [calendario_de_mis_amigos] es solo un identificador, puede ser cualquier nombre. La sección [owner-write] asegura que los dueños tengan acceso a sus propios archivos. Edita el archivo /etc/radicale/config y haz los siguientes cambios en la sección [rights] Reinicia el servidor Radicale o la FreedomBox
Importar archivosSi estás usando un archivo de contactos exportado desde otro servicio o aplicación hay que copiarlo a: /var/lib/radicale/collections/<usuario>/<nombre_del_archivo_de_contactos>'.vcf.
Migrar desde Radicale versión 1.x a versión 2.xEn Febrero de 2019 se actualizó Radicale en las versiones "en pruebas" (testing) de Debian desde la versión 1.x a la 2.x. La versión 2.x es mejor pero incompatible con los datos y la configuración empleados en la 1.x. El mecanismo automático de actualización de FreedomBox que emplean las actualizaciones desatendidas no actualiza automaticamente la version 2.x de Radicale debido a cambios en los archivos de configuración. No obstante la version 19.1 de FreedomBox, disponible en en las versiones "en pruebas" (testing) desde el 23 de Febrero de 2019, realizará la migración de los datos y la configuración a la versión 2.x de Radicale. No se requiere ninguna acción por parte de los usuarios típicos. Ocurrirá automáticamente. Si por algún motivo necesitas ejecutar a mano apt dist-upgrade en tu máquina Radicale se actualizará a 2.x y entonces tu FreedomBox no podrá ejecutar esta actualización (ya que el proyecto de origen decidió eliminar las herramientas de migración de la versión 2.x de Radicale). Para evitar esta situación se recomienda el siguiente procedimiento para actualizar. En cualquier caso, si ya has actualizado a Radicale 2.x sin ayuda de FreedomBox necesitas realizar la migración de los datos y la configuración por tí mismo. Sigue este procedimiento: Notas: python-radicale es un paquete antigüo de la versión 1.x de Radicale que sigue disponible en las versiones "en pruebas" (testing) de Debian. Esto es un hack alternativo para emplear la funcionalidad --export-storage que es responsable de la migración de datos. Por desgracia esta funcionalidad ya no está disponible en Radicale 2.x. Los ficheros que acaban en .dpkg-dist solo existirán si has elegido "Conservar tu versión actualmente instalada" cuando se te preguntó durante la actualización a Radicale 2.x. El procedimiento anterior sobrescribirá la configuración antigüa con una nueva. No se necesitan cambios a los 2 ficheros de configuración salvo que hayas cambiado la preferencia de compartición de calendario. Nota: Durante la migración tus datos permanecen a salvo en el directorio /var/lib/radicale/collections. Los datos nuevos se crearán y usarán en el directorio /var/lib/radicale/collections/collections-root/. El comando tar hace una copia de seguridad de tu configuración y tus datos en /root/radicale_backup.tgz por si haces o algo va mal y quieres deshacer los cambios.
Resolución de Problemas1. Si estás usando FreedomBox Pioneer Edition o instalando FreedomBox sobre Debian Buster Radicale podría no estar operativo inmediatamente después de la instalación. Esto se debe a un defecto ya corregido posteriormente. Para superar el problema actualiza FreedomBox haciendo clic en 'Actualización Manual' desde la app 'Actualizaciones'. Otra opción es simplemente esperar un par de días y dejar que FreedomBox se actualice solo. Después instala Radicale. Si Radicale ya está instalado deshabilitalo y rehabilitalo después de que se complete la actualización. Esto arreglará el problema y dejará a Radicale trabajando correctamente. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Repro.raw.xml b/doc/manual/es/Repro.raw.xml deleted file mode 100644 index f0abd00c4..000000000 --- a/doc/manual/es/Repro.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Repro42020-07-19 23:01:58fioddorTranslations header added outside include block32020-05-30 20:02:13SunilMohanAdapaUpdate the title to emphasize app name over its generic name22020-05-24 07:04:52fioddorSe alinea con la versión 09 en inglés del 23 de mayo de 202012019-09-14 08:59:56fioddorSe crea la versión española (traducción incompleta).Translation(s): English - Español
Repro (Servidor SIP)App eliminada Repro ha sido eliminada de Debian 10 (Buster) y por tanto ya no está disponible en FreedomBox. Repro es un servidor de SIP, un estándar para llamadas de voz sobre IP (VoIP). Se requiere un cliente SIP de escritorio o móvil para usar Repro.
Cómo configurar el servidor SIPConfigura el dominio en la página /repro/domains.html de la FreedomBox. Repro Domains Añade usuarios en /repro/addUser.html. Repro Users Deshabilita y vuelve a habilitar la aplicaión Repro en Plinth.
Redirección de PuertosSi tu FreedomBox estrá detrás de un router necesitarás configurar la redirección de puertos de tu router. Deberías redirigir los siguientes puertos para Repro: TCP 5060 TCP 5061 UDP 5060 UDP 5061 Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Roundcube.raw.xml b/doc/manual/es/Roundcube.raw.xml deleted file mode 100644 index 4781ddcb7..000000000 --- a/doc/manual/es/Roundcube.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Roundcube92020-07-19 23:02:43fioddorTranslations header added outside include block82020-07-18 17:14:04fioddorSe alinea con la versión 11 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.72020-05-30 19:42:50SunilMohanAdapaUpdate the title to emphasize app name over its generic name62020-05-24 06:42:50fioddorSe alinea con la versión 09 en inglés del 23 de mayo de 202052019-09-11 09:40:48fioddorCorrección menor42019-09-11 09:40:18fioddorCorrección menor32019-09-11 09:39:03fioddorCorrección menor22019-09-11 09:37:31fioddor12019-09-11 09:35:26fioddorSe crea la versión española.Translation(s): English - Español
Roundcube (Cliente de Correo Electrónico (Email)) icono de Roundcube Disponible desde: versión 0.5
¿Qué es Roundcube?Roundcube es un cliente de correo electrónico (email) para navegador con un interfaz de usuario parecido a una aplicación de escritorio. Admite varios lenguajes. Roundcube usa el protocolo de acceso a mensajes de Internet (IMAP = Internet Message Access Protocol) para acceder a los correos en un servidor remoto. Soporta MIME para enviar archivos adjuntos y en particular proporciona libreta de contactos, gestión de carpetas, búsquedas de mensajes y verificación ortográfica.
Usar RoundcubeTras instalar Roundcube se puede acceder a él en https://<tu_freedombox>/roundcube. Introduce tu usuario y contraseña. El usuario de muchos servicios de correo electrónico suele ser la propia dirección completa, como usuario_de_ejemplo@servicio_de_ejemplo.org, no solo el usuario usuario_de_ejemplo. Introduce la dirección del servidor IMAP de tu servicio de correo electrónico en el campo Servidor. Puedes probar a poner aquí tu nombre de dominio como servicio_de_ejemplo.org si la dirección es usuario_de_ejemplo@servicio_de_ejemplo.org y si esto no funciona consulta la dirección del servidor IMAP en la documentación de tu proveedor de correo electrónico. Se recomienda encarecidamente usar una conexión cifrada a tu servidor IMAP. Para ello inserta el prefijo "imaps://" al principio de la dirección del servidor IMAP. Por ejemplo, imaps://imap.servicio_de_ejemplo.org. Logging into your IMAP server
Usar Gmail con RoundcubeSi quieres usar Roundcube con tu cuenta Gmail necesitas habilitar primero el ingreso con contraseña en las preferencias de tu cuenta Google porque Gmail no va a permitir por defecto que ingresen aplicaciones mediante contraseña. Para hacerlo visita las preferencias de la Cuenta Google y habilita Apps Menos seguras. A continuación ingresa en Roundcube introduciendo tu dirección de Gmail como Usuario y tu contraseña. En el campo servidor pon imaps://imap.gmail.com. Logging into Gmail Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Samba.raw.xml b/doc/manual/es/Samba.raw.xml deleted file mode 100644 index 629976ba0..000000000 --- a/doc/manual/es/Samba.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Samba122020-07-19 23:03:25fioddorTranslations header added outside include block112020-07-18 17:57:25fioddorSe alinea con la versión 13 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.102020-07-18 17:50:04fioddorIcon added for fast identification. Availability standardized.92020-05-30 19:43:15SunilMohanAdapaUpdate the title to emphasize app name over its generic name82020-05-26 13:19:06fioddorSe alinea con la versión 10 en inglés del 25 de mayo de 202072020-05-24 06:55:40fioddorSe alinea con la versión 09 en inglés del 23 de mayo de 202062020-05-12 08:53:09fioddorMejora menor. Algo más exacto.52020-05-12 08:49:07fioddorSe alinea con la versión 07 en inglés del 12 de abril de 202042020-04-25 14:47:22fioddorSe alinea con la versión 6 en inglés del 23 de abril de 202032020-02-23 11:59:11fioddornomenclatura normalizada22020-02-11 21:56:57fioddorMinor corrections12020-02-11 21:55:07fioddorSe traduce una página nuevaTranslation(s): English - Español
Samba (Almacenamiento de Ficheros en Red) icono de Samba Disponible desde: versión 19.22 Samba te permite tener una carpeta compartida en la red local que se puede usar desde multiples ordenadores con sistemas operativos diferentes. De ahora en adelante nos referiremos a estas carpetas como "shares". Puedes tener una carpeta personal compartida por tus propios dispositivos (share casero), una compartida con un grupo de confianza (share de grupo) o una compartida con todo dispositivo de la red (share abierto). Samba te permite tratar un share como si fueran carpetas locales de tu ordenador. No obstante los shares solo están disponibles en la red local. Para aprender más acerca de Samba, mira la documentación de usuario de su wiki.
Usar SambaTras la instalación, puedes elegir qué discos compartir. Los shares habilitados están accesibles en el administrador de archivos de tu ordenador en la ruta \\freedombox (en Windows) o smb://freedombox.local (en Linux y Mac). Hay 3 tipos de share para elegir: Share abierto - accesible a cualquiera en tu red local. Share de grupo - accesible solo a usuarios FreedomBox que estén en el grupo freedombox-share. Share casero - cada usuario del grupo freedombox-share puede tener su propio espacio privado.
En AndroidPara acceder a shares Samba desde un dispositivo Android instala el "Cliente Samba para Android" desde F-Droid o Google Play. Introduce smb://freedombox.local/<disco> como ruta del share en la app. Tus carpetas compartidas deberían estar visibles en la app de administración de archivos. También VLC para Android puede detectar automáticamente y usar los shares Samba.
Integración con otras appsLa app Transmission de FreedomBox proporciona una configuración para permitir que las descargas se graben directamente en un share Samba. Si quieres dejar disponibles en Samba ficheros sincronizados con Syncthing tienes que asegurarte de sincronizar en la carpeta compartida de Samba. Además, para dejar las carpetas de Syncthing disponibles en carpetas abiertas o de grupo de Samba necesitas asegurarte de pulsar el botón "Permisos > Ignorar" bajo la pestaña "Avanzado" de la carpeta en el interfaz web de usuario de Syncthing. Esto permitirá escribir los ficheros mediante Samba.
Comparación con otras apps
SyncthingSyncthing mantiene una copia de la carpeta compartida en cada dispositivo con el que se comparte. Samba mantiene solo una copy en tu dispositivo FreedomBox. Syncthing puede sincronizar tus carpetas compartidas entre dispositivos por Internet. Los shares Samba solo están disponibles en tu red local. Como Syncthing es primordialmente una solución de sincronización, tiene funcionalidades como resolución de conflictos y versionado. Samba solo tiene una copia del fichero, así que no necesita tales funcionalidades. Por ejemplo, si dos personas están editando una hoja de cálculo almacenada en un share Samba el último que grabe el fichero gana. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Searx.raw.xml b/doc/manual/es/Searx.raw.xml deleted file mode 100644 index 90c7d74cb..000000000 --- a/doc/manual/es/Searx.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Searx82020-07-19 23:04:01fioddorTranslations header added outside include block72020-07-18 18:07:18fioddorSe alinea con la versión 12 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.62020-05-30 19:43:39SunilMohanAdapaUpdate the title to emphasize app name over its generic name52020-05-23 22:49:23fioddorSe alinea con la versión 10 en inglés del 23 de mayo de 202042020-04-13 16:25:42fioddorSe alinea con la versión 09 en inglés del 12 de abril de 202032019-09-16 12:06:12fioddorCorrección menor22019-09-16 12:04:34fioddorSe crea la versión española.12019-09-16 11:39:36fioddorTranslation(s): English - Español
Searx (Búsqueda Web) icono de Searx Disponible desde: versión 0.24.0
Acerca de SearxSearx es un metabuscador. Un metabuscador agrega los resultados de varios buscadores y los presenta en un interfaz unificado. Lee más acerca de Searx en su sitio web oficial.
Captura de pantallaSearx Screenshot
VídeoSearx installation and first steps (14 MB)
¿Por qué usar Searx?
Personalización y Burbujas por FiltradoLos buscadores tienen la capacidad de perfilar a sus usuarios y les sirven los resultados más relevantes para ellos, encerrandoles en burbujas por filtrado y distorsionando la visión que la gente tiene del mundo. Los buscadores tienen un incentivo financiero para servir publicidad interesante a sus usuarios, ya que incrementa la probabilidad de que hagan clic en los anuncios. Un metabuscador es una solución posible a este problema, ya que agrega resultados de multiples buscadores puenteando así los intentos de personalización de los buscadores. Searx evita almacenar cookies de buscadores para eludir traceos y perfilados de buscadores.
Filtrado de publicidadSearx filtra anuncios de los resultados de búsqueda antes de servirlos al usuario, con lo que mejora la relevancia de tus resultados y te evita distracciones.
PrivacidadSearx usa por defecto HTTP POST en vez de GET para enviar tus consultas de búsqueda a los buscadores, así que si alguien espía tu tráfico no podrá leerlas. Tampoco se almacenarán las consultas en el histórico de tu navegador. Nota: Searx usado desde la barra (omnibar) del navegador Chrome hará peticiones GET en vez de POST.
Searx en FreedomBoxEn FreedomBox Searx usa las credenciales únicas de Single Sign On. Esto implica que tienes que haber ingresado en tu FreedomBox con el navegador en el que estás usando Searx. Se puede acceder fácilmente a SearX a través de Tor. Se puede añadir a Searx a la barra de buscadores del navegador Firefox. Mira la Ayuda de Firefox acerca de este asunto. Una vez esté Searx añadido también podrás establecerlo como tu buscador por defecto. Searx también ofrece resultados de búsqueda en formatos csv, json y rss, que se pueden usar desde scripts para automatizar algunas tareas. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/SecureShell.raw.xml b/doc/manual/es/SecureShell.raw.xml deleted file mode 100644 index 124e71c5e..000000000 --- a/doc/manual/es/SecureShell.raw.xml +++ /dev/null @@ -1,4 +0,0 @@ -
es/FreedomBox/Manual/SecureShell142020-08-19 09:54:12fioddorSe alinea con la versión 21 en inglés del 19 de agosto de 2020132020-08-17 18:20:56fioddorTítulo vacío eliminado.122020-08-01 01:03:21JamesValleroyComment out empty header, it seems to break conversion to pdf112020-07-23 16:17:02fioddorSpike102020-05-24 07:50:22fioddorSe alinea con la versión 18 en inglés del 23 de mayo de 202092020-04-13 16:26:38fioddorSe alinea con la versión 16 en inglés del 12 de abril de 202082020-04-04 20:24:38fioddorSe alinea con la versión 15 inglés del 04 de abril de 202072020-04-04 20:18:47fioddorCorrección menor62020-04-04 20:05:06fioddorSe alinea con la versión 14 inglés del 04 de abril de 202052020-04-04 20:00:07fioddorCorrección menor42019-11-14 18:13:56fioddorSe alinea con la versión 13 en inglés del 11 de noviembre de 201932019-08-20 08:32:32fioddorSe incorpora la traducción de una sección nueva.22019-08-20 07:08:46fioddorSe incorpora la traducción de una sección nueva.12019-08-20 07:02:24fioddorSe crea la versión española.Translation(s): English - Español
Shell Segura
¿Qué es Shell Segura?FreedomBox ejecuta el servidor openssh-server por defecto permitiendo así accesos remotos desde todos los interfaces. Si tu dispositivo hardware está conectado a un monitor y un teclado, también puedes ingresar directamente. Para la operación habitual de FreedomBox no necesitas usar la shell. No obstante, algunas tareas o identificación de algún problema podrían requerirlo.
Configurando una Cuenta de Usuario
Primer ingreso a FreedomBox: Cuenta de AdminAl crear una cuenta en FreedomBox por primera vez, el usuario tendrá automaticamente privilegios de administrador. Los usuarios Admin pueden ingresar mediante ssh (abajo se explica cómo) y escalar sus privilegios a superusuario mediante sudo.
Cuenta de Usuario por DefectoNota: Si puedes acceder al interfaz web de FreedomBox es que no necesitas hacer esto. Puedes usar la cuenta de usuario del interfaz web de FreedomBox para conectar por SSH. Las imagenes precompiladas FreedomBox tienen una cuenta de usuario llamada fbx pero no tiene contraseña establecida, así que no se puede ingresar con esta cuenta. Hay un script incluído en el programa freedom-maker que permite establecer la contraseña de esta cuenta si fuera necesario: Descomprime la imagen. Obtén una copia de freedom-maker en . Ejecuta sudo ./bin/passwd-in-image <archivo_de_imagen> fbx. Copia el archivo de la imagen a la tarjeta SD e inicia el dispositivo. El usuario "fbx" también tiene privilegios de superusuario mediante sudo.
Ingresando
LocalPara ingresar mediante SSH a tu FreedomBox: Reemplaza fbx por el usuario con el que quieres ingresar. Hay que reemplazar freedombox por el hostname o dirección IP de tu dispositivo FreedomBox como se indica en el proceso de Inicio rápido. fbx es el usuario de FreedomBox con privilegios de superusuario por defecto. Cualquier otro usuario creado con FreedomBox que pertenezca al grupo admin podrá ingresar. La cuenta root no tiene contraseña configurada y no podrá ingresar. A todos los demás usuarios se les denegará el acceso. fbx y los otros usuarios del grupo admin podrán ingresar directamente por el terminal. A todos los demás usuarios se les denegará el acceso. Si fallas repetidamente intentando ingresar se te bloqueará el acceso por algún tiempo. Esto se debe al paquete libpam-abl que FreedomBox instala por defecto. Para controlar este comportamiento consulta la documentación de libpam-abl.
SSH via TorSi tienes habilitados en FreedomBox los servicios Tor Onion puedes acceder a tu FreedomBox mediante ssh sobre Tor. Instala netcat-openbsd. Edita ~/.ssh/config para habilitar conexiones sobre Tor. Añade lo siguiente: Reemplaza USUARIO por un usuario del grupo admin (ver arriba). En algunos casos podrías necesitar reemplazar 9050 por 9150. Ahora, para conectar a la FreedomBox abre un terminal y teclea: Reemplaza USUARIO por un usuario del grupo admin y DIRECCION por la dirección del servicio Tor Onion para SSH de tu FreedomBox.
Escalar a SuperusuarioSi después de ingresar quieres volverte superusuario para realizar actividades administrativas: Habitúate a ingresar como root solo cuando sea estrictamente necesario. Si no ingresas como root no puedes romperlo todo accidentalmente.
Cambiar ContraseñasPara cambiar la contraseña de un usuario administrado en el interfaz web de FreedomBox usa la página Cambiar clave de acceso. El usuario por debecto fbx no se administra en el interfaz web de FreedomBox y su contraseña no se puede cambiar desde él. Para cambiar la contraseña en el terminal ingresa a tu FreedomBox con el usuario cuya contraseña quieres cambiar y ejecuta el siguiente comando: Esto te preguntará tu contraseña actual antes de darte la oportunidad de establecer la nueva. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Security.raw.xml b/doc/manual/es/Security.raw.xml deleted file mode 100644 index 0d80f33d6..000000000 --- a/doc/manual/es/Security.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Security72020-08-19 10:40:16fioddorSe alinea con la versión 04 en inglés del 19 de agosto de 202062020-04-11 10:27:12fioddorhttps://salsa.debian.org/freedombox-team/plinth/-/issues/1831#note_15425852020-04-04 20:36:39fioddorSe alinea la traducción del literal con el interfaz web.42020-04-04 20:34:34fioddorSe usa imagen traducida y más actual.32020-04-04 20:32:39fioddorSe alinea la traducción del nombre de la página con el interfaz web.22019-10-14 07:25:52fioddorSe actualiza a la versión inglesa 03 del 12 de octubre de 2019.12019-06-19 12:14:30fioddorSe crea la versión española.Translation(s): English - Español
ProtecciónCuando se habilita esta opción sólo los usuarios del grupo "admin" podrán entrar a la consola o mediante SSH. Los usuarios de consola podrán acceder a algunos servicios sin más autorización. La sección Usuarios explica cómo definir grupos de usuarios. Cuando la opción Acceso a consola restringido está habilitada, sólo los usuarios del grupo admin podrán ingresar via consola, shell segura (SSH) o interfaz gráfico. Al desactivar esta funcionalidad cualquier usuario con cuenta en FreedomBox podrá ingresar y quizá tener acceso a ciertos servicios sin más autorización. Esta opción solo debería desactivarse si se confía plenamente en todos los usuarios del sistema. Si quieres usar tu máquina FreedomBox también como escritorio y admitir que usuarios no-admin ingresen mediante interfáz gráfica esta opción debe estar desactivada. Puedes determinar la lista de usuarios admin en la sección Users. Security_es_v01.png Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/ServiceDiscovery.raw.xml b/doc/manual/es/ServiceDiscovery.raw.xml deleted file mode 100644 index 72314dd39..000000000 --- a/doc/manual/es/ServiceDiscovery.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/ServiceDiscovery22020-08-19 10:44:26fioddorSe alinea con la versión 03 en inglés del 19 de agosto de 202012019-06-19 12:36:54fioddorSe crea la versión española.Translation(s): English - Español
Detección de ServiciosLa Detección de Servicios permite a otros dispositivos de la red detectar a tu FreedomBox y a los servicios que expone. Si un cliente de la red local soporta mDNS, puede encontrar tu FreedomBox en <hostname>.local (por ejemplo: freedombox.local). También permite a FreedomBox detectar otros dispositivos y servicios que están funcionando en tu red local. La Detección de Servicios no es esencial y solo funciona en redes internas. Se puede deshabilitar para mejorar la seguridad especialmente cuando la conectas a una red local hostil. Volver a la descripción de Funcionalidades o a las páginas del manual. InformationSupportContributeReportsPromoteOverview Hardware Live Help Where To Start Translate Calls Talks Features Vision Q&A Design To Do Releases Press Download Manual Code Contributors Blog FreedomBox for Communities FreedomBox Developer Manual HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 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/manual/es/Shadowsocks.raw.xml b/doc/manual/es/Shadowsocks.raw.xml deleted file mode 100644 index d3ad9a70d..000000000 --- a/doc/manual/es/Shadowsocks.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Shadowsocks62020-07-19 23:04:31fioddorTranslations header added outside include block52020-07-18 18:12:48fioddorSe alinea con la versión 07 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.42020-05-30 19:43:58SunilMohanAdapaUpdate the title to emphasize app name over its generic name32020-05-24 07:07:26fioddorSe alinea con la versión 04 en inglés del 23 de mayo de 202022019-09-14 09:52:23fioddorCorrección menor12019-09-14 09:45:29fioddorSe crea la versión española.Translation(s): English - Español
Shadowsocks (Proxy SOCKS5) icono de Shadowsocks Disponible desde: versión 0.18.0
¿Qué es Shadowsocks?Shadowsocks es un proxy SOCKS5 ligero y seguro, diseñado para proteger tu tráfico Internet. Se puede usar para eludir la censura y los filtros de Internet. Tu FreedomBox puede ejecutar un cliente Shadowsocks que puede conectar con un servidor Shadowsocks. También ejecutará un proxy SOCKS5. Los dispositivos locales pueden conectar con este proxy y sus datos serán cifrados y retransmitidos a través del sevidor Shadowsocks. Nota: Shadowsocks está disponible en FreedomBox a partir de la versión 0.18.
Usar el cliente ShadowsocksLa implementación actual de Shadowsocks en FreedomBox solo soporta configurar FreedomBox como cliente Shadowsocks. Este caso de uso sería así: El client de Shadowsocks (FreedomBox) está en una región en la que partes de Internet están bloqueadas o censuradas. El servidor de Shadowsocks está en una región diferente que no tiene esos bloqueos. FreedomBox proporciona un servicio de proxy SOCKS en la red local para que otros dispositivos hagan uso de la conexión Shadowsocks. En el futuro será posible configurar FreedomBox como servidor Shadowsocks.
Configurar tu FreedomBox para el cliente ShadowsocksPara habilitar Shadowsocks primero navega a la página Proxy Socks5 (Shadowsocks) e instalalo. Servidor: el servidor Shadowsocks no es la IP o la URL de FreedomBox, sino que será otro servidor o VPS configurado como tal (servidor Shadowsocks). También hay algunos servidores Shadowsocks públicos listados en la web, pero sé consciente de que quienquiera que opere el servidor puede ver a dónde van las peticiones y cualquier dato no cifrado que se transmita. Para usar Shadowsocks una vez instalado configura la URL del proxy SOCKS5 en tu dispositivo, navegador o aplicación como http://<tu_freedombox>:1080/. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Sharing.raw.xml b/doc/manual/es/Sharing.raw.xml deleted file mode 100644 index b12047768..000000000 --- a/doc/manual/es/Sharing.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Sharing42020-07-19 23:05:03fioddorTranslations header added outside include block32020-07-19 22:05:32fioddorSe alinea con la versión 07 en inglés del 19 de julio de 2020.22020-07-19 21:10:50fioddorSe alinea con la versión 06 en inglés del 19 de julio de 2020.12020-07-19 19:24:08fioddorSe alinea con la versión 05 en inglés del 19 de julio de 2020.Translation(s): English - Español
Sharing (Publicación de Archivos) Sharing icon Disponible desde: versión 0.25
¿Qué es la app Sharing?Sharing es una aplicación que te permite compartir contenido via web. El contenido compartido pueden ser archivos individuales o directorios completos. El contenido se puede compartir públicamente o restringido a usuarios de una lista de grupos autorizados. Los usuarios autorizados podrán acceder al contenido compartido desde su navegador web en https://tu_freedombox/share/nombre_del_contenido. Los usuarios que no pertenezcan a ninguno de los grupos autorizados no verán ni accederán al contenido mediante este mecanismo.
Editando comparticionesPara que los usuarios accedan al contenido mediante su navegador debe existir y tener una compartición. Una compartición es una entrada en la aplicación Sharing que relaciona: El Nombre (y por tanto la URL) que usarán los usuarios para solicitar el contenido, el Ruta de acceso al contenido a servir y el modo de compartición. Si es restringido, también contendrá la lista de grupos autorizados. En el mismo servidor pueden coexistir múltiples comparticiones. Sólo los administradores pueden crear, editar o eliminar comparticiones. Encontrarán la aplicación Sharing en la sección Aplicacions del interfaz web de FreedomBox. La aplicación Sharing es una aplicación web fácil de usar y con un interfaz evidente. Cada compartición tiene su priopio ajuste de modo de compartición (pública o restrigida). Sólo los grupos que reconoce el servicio FreedomBox se pueden combinar en la lista de grupos autorizados. La aplicación Sharing no ofrecerá los grupos creados en el interfaz de línea de órdenes.
Provisionar/actualizar el contenidoEl contenido se puede crear antes o después de crear la compartición y se pueden actualizar independientemente. No hay que ser administrador para provisionar el contenido. Cualquier usuario con acceso de escritura en la ruta de acceso a la compartición puede crearlo o actualizarlo. Varias comparticiones podrían apuntar al mismo contenido. Si eres usuario de FreedomBox y tu administrador se niega a crearte comparticiones, y no necesitas restringir el acceso a tu contenido, todavía puedes recurrir al mecanismo de Sitios web de Usuario o a las redes entre pares (P2P) (Deluge o Transmission para Torrent, o MLDonkey) para publicar tus archivos.
TecnicismosSharing compartirá el contenido usando el servidor web Apache que viene de serie. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Snapshots.raw.xml b/doc/manual/es/Snapshots.raw.xml deleted file mode 100644 index 6abcaf49f..000000000 --- a/doc/manual/es/Snapshots.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Snapshots42020-08-19 10:56:10fioddorSe alinea con la versión 04 en inglés del 19 de agosto de 202032020-05-30 19:55:19SunilMohanAdapaMatch title with FreedomBox interface22020-04-04 21:17:11fioddorCorrección menor12019-06-20 14:29:35fioddorSe crea la versión española.Translation(s): English - Español
Almacén de instantáneasLas Instantáneas te permiten crear instantáneas del sistema de archivos y devolver al sistema a un estado anterior. Nota: Esta funcionalidad requiere un sistema de archivos Btrfs. Todas las imágenes de disco de FreedomBox estables usan Btrfs. Instantáneas Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Storage.raw.xml b/doc/manual/es/Storage.raw.xml deleted file mode 100644 index 8071bc59a..000000000 --- a/doc/manual/es/Storage.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Storage32020-08-19 10:50:42fioddorSe alinea con la versión 13 en inglés del 19 de agosto de 202022020-05-24 08:44:49fioddorSe alinea con la versión 12 en inglés del 24 de mayo de 202012019-06-20 14:42:39fioddorSe crea la versión española.Translation(s): English - Español
AlmacenamientoAlmacenamiento te permite ver los dispositivos de almacenamiento conectados a tu FreedomBox y el uso de su espacio. FreedomBox puede detectar y montar automáticamente medios extraíbles como unidades flash USB. Se muestran listados bajo la sección Dispositivos extraíbles junto con una opción para expulsarlos. Si queda espacio libre detrás de la partición de root, se mostrará también la opción para expandirla. Normalmente no se muestra ya que en el primer arranque de la FreedomBox se produce automáticamente una expansión total de la partición de root. Storage.png
Operación de almacenamiento avanzadaCockpit proporciona muchas funcionalidades de almacenamiento más avanzadas que las de FreedomBox. Ambos, FreedomBox y Cockpit, operan sobre el demonio de almacenamiento Udisks2 y son por ello compatibles entre sí. Entre las funciones proporcionadas por Cockpit se incluyen: Formatear un disco o partición con un nuevo sistema de ficheros. Añadir, eliminar particiones o borrar la tabla de particiones. Crear y desbloquear sistemas de ficheros cifrados. Crear y administrar dispositivos RAID. storage-cockpit.png Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Syncthing.raw.xml b/doc/manual/es/Syncthing.raw.xml deleted file mode 100644 index cca1c8e79..000000000 --- a/doc/manual/es/Syncthing.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Syncthing102020-07-19 23:24:47fioddorTraducida sección: Usar Syncthing con otras aplicaciones92020-07-19 23:05:42fioddorTranslations header added outside include block82020-07-18 18:19:54fioddorSe alinea con la versión 21 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.72020-05-30 19:44:24SunilMohanAdapaUpdate the title to emphasize app name over its generic name62020-05-24 06:54:22fioddorSe alinea con la versión 19 en inglés del 23 de mayo de 202052019-11-14 18:11:07fioddorSe alinea con la versión 18 en inglés del 11 de noviembre de 201942019-11-04 11:25:50fioddorSe alinea con la versión 14 del 01 de noviembre de 201932019-10-28 09:30:15fioddorSe alinea con la versión 14 del 27 de octubre de 201922019-09-11 15:32:18fioddorSe crea la versión española.12019-09-11 15:25:11fioddorSe crea la versión española.Translation(s): English - Español
Syncthing (Sincronización de Archivos) icono de Syncthing Disponible desde: versión 0.14.0 Con Syncthing instalado en tu FreedomBox puedes sincronizar contenido desde otros dispositivos a tu FreedomBox y vice-versa. Por ejemplo puedes mantener sincronizadas las fotos tomadas desde tu teléfono móvil con tu FreedomBox. Syncthing es una solución de sincronización entre pares, no una de tipo cliente-servidor. Esto implica que FreedomBox no es realmente el servidor y tus otros dispositivos no son sus clientes. Desde la perspectiva de Syncthing todos son dispositivos equivalentes. Puedes emplear Syncthing para sincronizar tus archivos entre cualquiera de tus dispositivos. La ventaja que aporta FreedomBox consiste en que como es un servidor está encendida (casi) siempre. Supón que quieres sincronizar las fotos de tu teléfono con tu portátil. Si sincronizas tu teléfono con FreedomBox el portátil podrá obtenerlas desde la FreedomBox cuando vuelva a conectarse. No necesitas preocuparte de cuando se conectan los otros dispositivos. Si tu FreedomBox es uno de los dispositivos configurados con la carpeta compartida de Syncthing puedes estár tranquilo que tus otros dispositivos se sincronizarán en cuanto se conecten. Tras instalarlo sigue estas instrucciones del proyecto Syncthing: Arrancando. Syncthing permite compartir selectivamente carpetas individuales. Antes de compartir los dispositivos tienen que estar emparejados leyendo códigos QR o introduciendo manualmente identificadores de dispositivo. Syncthing tiene un servicio de autodescubrimiento para identicar fácilmente a los otros dispositivos de la misma subred que tengan Syncthing instalado. Para acceder al cliente web de la instancia Syncthing que se ejecuta en tu FreedomBox, usa la ruta /syncthing. Actualmente este cliente web está accesible solo a los usuarios de FreedomBox que tengan privilegios de administrador aunque en alguna futura versión podría estarlo a todos los usuarios de FreedomBox. Syncthing web interface Syncthing tiene apps Android disponibles en F-Droid y Google Play. También hay disponibles aplicaciones de escritorio multiplataforma. Para más información acerca de Syncthing visita su sitio web oficial y su documentación.
Sincronizar via TorSyncthing debe sincronizar automáticamente con tu FreedomBox incluso cuando esta solo sea accesible como servicio Tor Onion. Si quieres enrutar tu cliente Syncthing via Tor configura la variable de entorno all_proxy: Para más información mira la documentación de Syncthing acerca de el uso de proxies.
Evitar repetidores de SyncthingSyncthing emplea por defecto conexiones dinámicas para conectar con otros pares. Esto significa que si estás sincronizando a través de Internet, los datos quizá tengan que atravesar repetidores de Syncthing públicos para alcanzar tus dispositivos. Esto desaprovecha que tu FreedomBox tenga una dirección IP pública. Al añadir tu FreedomBox como dispositivo en otros clientes de Syncthing establece tu dirección como "tcp://<mi.dominio.freedombox>" en vez de "dinámica". Esto permite a tus pares Syncthing conectarse diréctamente a tu FreedomBox eludiendo la necesidad de repetidores. También permite sincronización rápida bajo demanda si no quieres mantener a Syncthing ejecuándose todo el tiempo en tus dispositivos móviles.
Usar Syncthing con otras aplicaciones
Administrador de contraseñasLos administradores de contraseñas que almacenan sus bases de datos en ficheros son susceptibles de sincronizarse usando Syncthing. El siguiente ejemplo describe el uso de un administrador de contraseñas libre llamado KeePassXC en combinación con Syncthing para servir como remplazo para administradores de contraseñas privativos que almacenan tus contraseñas en la nube. KeePassXC almacena usuarios, contraseñas, etc en ficheros con la extensión .kdbx. Estos ficheros .kdbx se pueden almacenar en una carpeta compartida Syncthing para mantenerlos sincronizados en multiples máquinas. Hay disponibles, tanto para escritorio como para dispositivos móviles, aplicaciones de software libre que pueden leer este formato de fichero. Habitualmente sólo tienes que apuntar la aplicación al fichero .kdbx e introducir la contraseña maestra para acceder a tus credenciales almacenadas. Por ejemplo, el mismo fichero .kdbx se puede consultar empleando KeePassXC en el escritorio y KeePassDX en Android. Instalando una extensión se puede usar también KeePassXC para rellenar credenciales en los campos de ingreso (login) en el navegador. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/TinyTinyRSS.raw.xml b/doc/manual/es/TinyTinyRSS.raw.xml deleted file mode 100644 index a5fd7bb04..000000000 --- a/doc/manual/es/TinyTinyRSS.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/TinyTinyRSS52020-07-19 23:25:47fioddorTranslations header added outside include block42020-07-18 18:25:42fioddorSe alinea con la versión 14 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.32020-05-30 19:44:55SunilMohanAdapaUpdate the title to emphasize app name over its generic name22020-05-24 07:02:15fioddorSe alinea con la versión 12 en inglés del 23 de mayo de 202012019-09-13 17:05:05fioddorSe crea la versión española.Translation(s): English - Español
Tiny Tiny RSS (Lector de Feeds de Noticias) Tiny Tiny RSS icon Disponible desde: versión 0.9 Tiny Tiny RSS es un lector y agregador de feeds de noticias (RSS/Atom) diseñado para leer noticias desde cualquier lugar con una experiencia lo más parecida posible a una aplicación de escritorio. Cualquier usuario creado mediante el interfaz web de FreedomBox podrá ingresar y usar esta app. Cada usuario tiene sus propios feeds, estado y preferencias.
Usar el interfaz webCuando esté habilitado Tiny Tiny RSS estará disponible en la ruta /tt-rss del servidor web. Cualquier usuario creado mediante FreedomBox podrá ingresar y usar esta app. Tiny Tiny RSS
Añadir un nuevo feed1. Ve a la página cuyo feed quieras y copia su enlace RSS/Atom feed. Selecting feeds 2. Selecciona "Subscribirse al feed.." en el desplegable Acciones. Subscribe to feed 3. Pega la URL que has copiado en el diálogo que aparece y pulsa el botón Subscribirse. Subscription dialog box Dale un minuto a la aplicación para obtener los feeds. En algunos sitios web el botón de feeds RSS no está claramente visible. En tal caso simplemente pega la URL del sitio web en el diálogo Subscribirse y deja que TT-RSS detecte automáticamente los feeds RSS que haya en la página. Puedes probarlo ahora con la página principal de WikiNews Como puedes ver en la imagen seguiente TT-RSS ha detectado y añadido el feed Atom de WikiNews a nuestra lista de feeds. WikiNews feed added Si no quieres conservar este feed haz clic con el botón derecho del ratón en el feed de la imagen anterior, selecciona Editar feed y dale a Desubscribir en el diálogo que aparece. Unsubscribe from a feed
Importar tus feeds desde otro lectorEncuentra en tu lector de feeds previo una opción para Exportar tus feeds a un fichero. Si tiene que elegir entre varios formatos elige OPML. Pongamos que tu fichero de feeds exportados se llama Subscriptions.opml Haz click en la esquina superior izquierda el menú Acciones y selecciona Preferencias. Se te llevará a otra página. En la cabecera superior selecciona la 2ª solapa llamada Feeds. Tiene varias secciones y la 2ª se llama OPML. Selecciónala. OPML feeds page Para importar tu fichero Subscriptions.opml a TT-RSS, Haz clic en Examinar... y selecciona el fichero en tu sistema de archivos. Haz clic en Importar mi OPML Tras importar se te llevará a la sección Feeds que está en la página encima de la de OPML. Puedes ver que los feeds del lector previo figuran ahora importados en Tiny Tiny RSS. Ahora puedes empezar a usar Tiny Tiny RSS como tu lector principal.
Usar la app móvilLa app oficial para Android del proyecto Tiny Tiny RSS funciona con el servidor Tiny Tiny RSS de FreedomBox. Se sabe que la aplicación anterior TTRSS-Reader no funciona. Desafortunadamente la app oficial para Android solo está disponible en la Play Store de Google y no en F-Droid. Todavía puedes obtener el código fuente y compilar el fichero apk por tu cuenta. Para configurarla, primero instálala y entonces en la página de configuración pon como URL. Pon tu usuario y contraseña en los detalles del Login así como los detalles de Autenticación HTTP. Si tu FreedomBox no tiene un certificado HTTPS válido configuralo para que admita cualquier certificado SSL y cualquier servidor. Tiny Tiny RSS Tiny Tiny RSS Tiny Tiny RSS Tiny Tiny RSS Tiny Tiny RSS Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Tor.raw.xml b/doc/manual/es/Tor.raw.xml deleted file mode 100644 index b29f06f72..000000000 --- a/doc/manual/es/Tor.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Tor142020-07-19 23:26:26fioddorTranslations header added outside include block132020-07-18 21:15:28fioddorSe alinea con la versión 27 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.122020-05-30 19:45:14SunilMohanAdapaUpdate the title to emphasize app name over its generic name112020-05-23 22:56:09fioddorSe alinea con la versión 25 en inglés del 23 de mayo de 2020102019-11-30 18:08:09fioddorSe alinea con la versión 23 en inglés del 28 de noviembre de 201992019-11-14 17:59:44fioddorSe alinea con la versión 22 en inglés del 11 de noviembre de 201982019-10-28 09:44:53fioddorSe alinea con la versión 21 del 27 de octubre de 201972019-10-21 13:54:58fioddorCorrección menor62019-09-03 15:18:40fioddorMejora menor52019-09-03 15:17:22fioddortraducción de la sección TOR finalizada.42019-09-03 15:11:56fioddorSe incorpora la traducción de una sección nueva.32019-09-03 15:04:38fioddorSe incorpora la traducción de una sección nueva.22019-09-03 14:49:23fioddorSe incorpora la traducción de una sección nueva.12019-09-03 14:32:43fioddorSe crea la versión española (traducción incompleta).Translation(s): English - Español
Tor (Red para el anonimato) icono de Tor Disponible desde: versión 0.3
¿Qué es Tor?Tor es una red de servidores operada por voluntarios. Permite a los usuarios de esos servidores mejorar su privacidad y seguridad cuando navegan por Internet. Tu y tus amigos podéis acceder a tu FreedomBox a través de la red Tor sin revelar su dirección IP. Activando la aplicación Tor en tu FreedomBox podrás ofrecer servicios remotos (chat, wiki, file sharing, etc...) sin mostrar tu localización. Esta aplicación te dará una protección mejor que un servidor web público porque estarás menos expuesto a gente intrusiva.
Usar Tor para navegación anónimaTor Browser es la manera recomendada para navegar la web a través de Tor. Puedes descargar Tor Browser desde y seguir sus instrucciones para instalarlo y ejecutarlo.
Usar Servicio Tor Onion para acceder a tu FreedomBoxEl Servicio Tor Onion proporciona una manera de acceder a tu FreedomBox incluso aunque esté detrás de un router, cortafuegos, o redirector NAT (p.ej. si tu proveedor de Internet no proporciona una dirección pública IPv4 para tu router). Para habilitar el Servicio Tor Onion primero navega a la página Red para el anónimato (Tor). (Si no la ves haz clic en el logo de FreedomBox de arriba a la izquierda de la página y ve a la página principal de Apps.) En la página Red para el anónimato (Tor), bajo Configuración, habilita la caja Habilitar los Servicios Tor Onion y pulsa el botón de Actualizar configuración. Tor se reconfigurará y se reiniciará. Transcurrido un rato la página se refrescará bajo Estado verás la tabla que lista la dirección .onion del servicio. Copia toda la dirección (que termina en .onion) y pégala en el campo dirección de Tor Browser. Deberías poder acceder a tu FreedomBox. (Quizá veas un aviso de certificado porque FreedomBox tiene un certificado autofirmado.) Tor Configuration - FreedomBox Onion Actualmente solo HTTP (puerto 80), HTTPS (puerto 443) y SSH (puerto 22) están accesibles a través del Servicio Tor Onion configurado en la FreedomBox.
Apps accesibles via TorLas siguientes apps se pueden acceder a través de Tor. Esta lista puede ser incompleta. Calendario y Libreta de direcciones (Radicale) Sincronización de ficheros (Syncthing) Búsqueda Web (Searx) Wiki (MediaWiki) Wiki y Blog (Ikiwiki)
Ejecutar un nodo TorCuando se instala Tor se configura por defecto para ejecutarse como puente a la red (bridge relay). Esta opción se puede deshabilitar en la página de configuración de Tor de FreedomBox. En la parte inferior de página de Tor de FreedomBox hay una lista de puertos que usa el puente a la red Tor. Si tu FreedomBox está detrás de un router necesitarás configurar la redirección de puertos de tu router para que estos puertos sean accesibles desde Internet. Los requisitos para ejecutar un puente a la red se listan en la Tor Relay Guide. En resúmen, se recomienda que un puente tenga disponibles para Tor al menos 16 Mbit/s (Mbps) de ancho de banda para subida y bajada. Mejor más. requiere que a se le permita al puente usar un mínimo de 100 GByte de tráfico mensual de salida y de entrada. recomienda que un nodo sin salida (mero reenrutador) de <40 Mbit/s tenga al menos 512 MB de RAM disponible; Uno más rápido de 40 Mbit/s debería tener al menos 1 GB de RAM.
Usar el puerto Tor SOCKS (avanzado)FreedomBox proporciona un puerto Tor SOCKS al que pueden conectar otras aplicaciones para enrutar su tráfico a través de la red Tor. Este puerto es accesible a cualquier interfaz (de red) configurado en la zona interna del cortafuegos. Para configurar la aplicación apunta el Host SOCKS a la dirección IP interna de la conexión y pon el Puerto SOCKS a 9050.
Exjemplo con FirefoxTu navegador web se puede configurar para emplear la red Tor para toda tu actividad de navegación. Esto permite eludir la censura y oculta tu dirección IP a los sitios web durante la navegación normal. Para anonimato se recomienda usar el Navegador Tor. Configura tu dirección IP local de FreedomBox y el puerto 9050 como un proxy SOCKS en Firefox. Hay extensiones para facilitar la activación y desactivación del proxy. Configuring Firefox with Tor SOCKS proxy Con en proxy SOCKS configurado puedes acceder cualquier URL de tipo onion diréctamente desde Firefox. FreedomBox tiene una dirección onion v3 propia a la que puedes conectarte por la red Tor (guárdala en tus favoritos para usarla en situaciones de emergencia).
Eludiendo la censura de TorSi tu proveedor de Internet (ISP) está tratando de bloquear el tráfico Tor puedes usar puentes (a la red Tor) para conectar (a la red Tor). 1. Obtén la configuración de los puentes de Tor BridgeDB Tor BridgeDB 2. Añade las líneas a la configuración de Tor de tu FreedomBox como se muestra. Tor Configuration Page Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Transmission.raw.xml b/doc/manual/es/Transmission.raw.xml deleted file mode 100644 index 49b5bce05..000000000 --- a/doc/manual/es/Transmission.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Transmission102020-07-19 23:27:13fioddorTranslations header added outside include block92020-07-18 21:24:24fioddorSe alinea con la versión 17 en inglés del 18 de julio de 2020. Pendiente de capturar traducida.82020-05-30 19:45:41SunilMohanAdapaUpdate the title to emphasize app name over its generic name, match with FreedomBox interface72020-05-23 22:58:29fioddorSe alinea con la versión 15 en inglés del 23 de mayo de 202062019-10-28 09:16:06fioddorSe alinea con la versión 14 del 27 de octubre de 201952019-09-04 09:38:37fioddorCorrección menor42019-09-04 09:33:40fioddorEnlace a nueva página traducida.32019-09-04 09:19:10fioddorRecomendación de seguridad.22019-09-04 09:17:24fioddorCorrección menor12019-09-04 06:58:07fioddorSe crea la versión española.Translation(s): English - Español
Transmission (Cliente web de BitTorrent) Transmission icon Disponible desde: versión 0.5
¿Qué es Transmission ?BitTorrent es un protocolo de comunicaciones para compartir ficheros entre pares (P2P = peer-to-peer). No es anónimo; debes asumir que otros puedan ver qué ficheros estás comprtiendo. Hay 2 clientes web para BitTorrent disponibles en FreedomBox: Transmission y Deluge. Tienen funcionalidades similares pero quizá prefieras uno sobre otro. Transmission es un cliente BitTorrent ligero, famoso por su simplicidad y una configuración por defecto que "símplemente funciona".
Captura de pantallaTransmission Web Interface
Usar TransmissionTras instalar Transmission está accesible en https://<tu freedombox>/transmission. Transmission emplea el ingreso único de FreedomBox lo que significa que si has ingresado en tu FreedomBox puedes acceder diréctamente a Transmission sin tener que volver a introducir las credenciales. Si no, se te pedirá que ingreses primero y luego se te redirigirá a la app Transmission.
Consejos
Transferir Descargas desde la FreedomBoxSe puede añadir el directorio de descargas de Transmission como directorio compartido en la app "Compartir" y así acceder a tus descargas en este directorio compartido empleando un navegador web. (Avanzado) Si tienes acceso SSH a tu FreedomBox puedes usar sftp para ver el directorio de descargas usando un gestor de archivos o un navegador apropiados (p.ej. dolphin o Konqueror). Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Upgrades.raw.xml b/doc/manual/es/Upgrades.raw.xml deleted file mode 100644 index 7366fb41d..000000000 --- a/doc/manual/es/Upgrades.raw.xml +++ /dev/null @@ -1,8 +0,0 @@ -
es/FreedomBox/Manual/Upgrades162020-08-18 20:45:45fioddorSe alinea con la versión 11 en inglés del 18 de agosto de 2020152020-05-24 07:53:22fioddorSe alinea con la versión 09 en inglés del 23 de mayo de 2020142020-04-13 16:14:41fioddorSe alinea con la versión 08 en inglés del 12 de abril de 2020132020-04-11 10:28:09fioddorhttps://salsa.debian.org/freedombox-team/plinth/-/issues/1831#note_154258122020-04-04 21:44:54fioddor112020-04-04 21:36:45fioddorSe usan imagen traducida y más actual.102020-04-04 21:32:12fioddor92020-04-04 21:29:18fioddorSe alinean literales con la interfaz gráfica.82019-10-16 15:18:30fioddorEnlace a nueva página traducida.72019-09-06 08:31:27fioddorSe mejoran las referencias a Debian Testing en línea con la nomenclatura de https://www.debian.org/releases/62019-08-22 12:54:06fioddorCorrección menor52019-08-22 12:52:31fioddorCorrección menor42019-08-22 12:51:09fioddorCorrección menor32019-08-22 12:48:59fioddorMejora menor22019-08-22 12:44:27fioddorSe actualiza a la versión inglesa 7 de hoy, 22 de agosto de 2019 03:42h.12019-06-19 07:05:29fioddorSe crea la versión española.Translation(s): English - Español
Actualizaciones de SoftwareFreedomBox puede instalar actualizaciones de seguridad automaticamente. Esta funcionalidad viene activada por defecto y no hace falta ninguna acción manual. Puedes activar las actualizaciones automaticas desde el interfaz web de FreedomBox en la página Actualización de la sección Sistema. Se recomienda encarecidamente que tengas esta opción habilitada para mantener tu FreedomBox segura. Las actualizaciones se efectúan cada noche. Si quieres apagar tu FreedomBox cada día después de usarla, déjala ejecutando una noche a la semana más o menos para permitir que ocurran las actualizaciones automaticas. Otra posibilidad es ejecutar actualizaciones manuales como se describe más adelante. Nota que una vez comiencen las actualizaciones podría llevarles mucho tiempo completarse. Durante el proceso de actualización (ya sea el automático nocturno o el manual), no podrás instalar aplicaciones desde el interfaz web de FreedomBox. upgrades_es_v01.png
¿Cuando obtendré las últimas funcionalidades?Aunque las actualizaciones se efectúan a diario por razones de seguridad, las últimas funcionalidades no se propagan a todos los usuarios. A continuación se explica cómo llegan las novedades a los usuarios de las diferentes versiones de Debian: Usuarios de versiones estables: Esta categoria de usuarios incluye a los usuarios que compraron la FreedomBox Pioneer Edition, a los que instalaron FreedomBox sobre una distribución estable de Debian y a los que descargaron las imágenes estables desde freedombox.org. Como regla general a estos usuarios solo se les proporciona actualizaciones de seguridad de determinados paquetes. Cuando una release obtiene la confianza de los desarrolladores el propio servicio FreedomBox se actualiza, lo que supone una excepción a esta regla. Esto implica que las últimas funcionalidades de FreedomBox estarán disponibles para estos usuarios aunque no tán inmediata- o frecuentemente como para los usuarios de las versiones en pruebas (testing). Si una app sólo está disponible en la distribución en pruebas (testing) pero no en la estable la app aparecerá en el interfaz web pero no será instalable para los usuarios de la distribución estable. Algunas apps se actualizan en excepción a la regla de "solo actualizaciones de seguridad" cuando la app esté seriamente rota por algún motivo. Debian libera cada bienio una entrega (release) con las últimas versiones estables de cada paquete de software y los desarrolladores de FreedomBox intentarán actualizar a estos usuarios a la nueva entrega (release) sin necesidad de intervención manual. Usuarios de versiones en pruebas: Esta categoria de usuarios incluye a los usuarios que instalaron FreedomBox sobre una distribución en pruebas (testing) y a los que descargaron las imágenes en pruebas (testing) desde freedombox.org. Estos usuarios asumen la posibilidad de afrontar disrupciones ocasionales en los servicios e incluso tener que intervenir manualmente para arreglarlas. Como regla general estos usuarios reciben las últimas funcionalidades y actualizaciones de seguridad para todos los paquetes instalados. Cada quincena se libera una nueva versión de FreedomBox con todas las últimas funcionalidades y correcciones. Estas versiones llegan a los usuarios de la distribución en pruebas (testing) aproximadamente 2 o 3 días después de la liberación. Usuarios de versiones inestables: Esta categoria de usuarios incluye a los usuarios que instalaron FreedomBox sobre una distribución inestable y a los que descargaron las imágenes inestables desde freedombox.org. Estos usuarios asumen la probabilidad de afrontar disrupciones en los servicios y tener que intervenir manualmente para arreglarlas. Como regla general estos usuarios reciben las últimas funcionalidades y actualizaciones de seguridad para todos los paquetes instalados. Cada quincena se libera una nueva versión de FreedomBox con todas las últimas funcionalidades y correcciones. Estas versiones llegan a los usuarios de la distribución inestable el mismo día de la liberación. Solo los desarrolladores, probadores y contribuyentes al proyecto FreedomBox debieran emplear la distribution inestable. Se advierte y exhorta a los usuarios finales de que no la usen.
Actualizaciones Manuales desde el TerminalAlgunos paquetes de software podrían requerir intervención manual para actualizarlos, generalmente por razones de configuración. En tales casos FreedomBox se actualiza a sí mismo y solicita información nueva necesaria para la actualización del paquete. Después de autoactualizarse FreedomBox actúa en nombre del usuario y actualiza los paquetes con la información recabada. Estos paquetes no se deben actualizar manualmente hasta que FreedomBox tenga la posibilidad de actualizarlos. La actualización que se dispara manualmente desde el interfaz web ya es consciente de estos paquetes y no los actualiza. En situaciones muy extrañas, FreedomBox podría fallar o quedar a expensas de una intervención manual desde el terminal. Para esto, entra a FreedomBox por un terminal, ya sea físico, web (empleando Cockpit) o mediante SSH (ver sección Shell Segura) y ejecuta los siguientes comandos: -# dpkg --configure -a -# apt update -# apt -f install -# unattended-upgrade --debug -# apt install freedombox -# apt update]]>Si apt-get update te pide confirmación para algo responde que Sí. Si durante la actualización del paquete freedombox te pregunta acerca de los archivos de configuración responde que instale los archivos de configuración nuevos que vienen con la última versión del paquete. Este proceso solo actualizará los paquetes que no necesitan preguntar (excepto el paquete freedombox). Después, deja que FreedomBox se encargue de la actualización de los demás paquetes. Sé paciente mientras se crean nuevas versiones de FreedomBox para tratar los paquetes que necesitan intervención manual. Si quieres ir más allá de la recomendación e instalar todos los paquetes en tu FreedomBox y realmente estás muy seguro de poder tratar los cambios de configuración de paquetes por tí mismo, ejecuta el siguiente comando: Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/Users.raw.xml b/doc/manual/es/Users.raw.xml deleted file mode 100644 index 25c89e71c..000000000 --- a/doc/manual/es/Users.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/Users32020-08-19 09:56:26fioddorSe alinea con la versión 10 en inglés del 19 de agosto de 202022020-05-24 07:54:47fioddorSe alinea con la versión 09 en inglés del 23 de mayo de 202012019-06-18 13:55:35fioddorSe crea la versión española.Translation(s): English - Español
Usuarios y GruposPuedes otorgar acceso a tu FreedomBox a otros usuarios. Proporciona el nombre del usuario y su contraseña y asignale un grupo. Actualmente se soportan los grupos admin wiki El usuario podrá ingresar a los servicios que soporten ingreso único (single-sign-on) mediante LDAP si figuran en el grupo apropriado. Los usuarios del grupo admin podrán ingresar en todos los servicios. También pueden ingresar al sistema por SSH y escalar a privilegios administrativos (sudo). Estas características se pueden cambiar más tarde. Asimismo es posible establecer una clave pública SSH que permitirá al usuario ingresar al sistema de modo seguro sin emplear su contraseña. Pueder dar de alta varias claves, una en cada línea. Las líneas en blanco o que comiencen por # se ignoran. Se pueden desactivar temporalmente las cuentas de usuarios.
Reparos ConocidosActualmente Plinth not distingue entre usuarios y administradores. Todo usuario añadido mediante Plinth tendrá accesso completo al interfaz de Plinth. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/bepasty.raw.xml b/doc/manual/es/bepasty.raw.xml deleted file mode 100644 index 92f1fda10..000000000 --- a/doc/manual/es/bepasty.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/bepasty32020-08-19 09:33:40fioddorSe alinea con la versión 10 en inglés del 19 de agosto de 202022020-08-18 19:54:43fioddorSe alinea con la versión 08 en inglés del 18 de agosto de 202012020-08-18 18:47:54fioddorNueva página parcialmente traducida.Translation(s): English - Español
Bepasty (Compartición de apuntes y archivos) Icono de bepasty Disponible desde: versión 20.14
¿Qué es bepasty?bepasty es una aplicación web que permite cargar y compartir archivos grandes. También se pueden cargar y compartir recortes de texto y código. Los textos, imágenes, audio, video y documentos PDF se pueden previsualizar en el navegador. Se puede asignar una caducidad a los archivos.
Captura de pantallaCaptura de pantalla de bepasty
Contraseñas y permisosbepasty solo usa contraseñas (sin usuarios) para controlar el acceso. El usuario tendrá permisos diferentes dependiendo de la contraseña empleada para ingresar a bepasty. Podría tener cualquier combinación de los siguentes permisos: read: Leer un archivo, si conoce la URL. list: Listar todos los archivos. create: Pegar o cargar un archivo nuevo. delete: Eliminar un archivo. admin: Bloquear y desbloquear archivos. Tras instalar bepasty viene pre-configurado con los siguientes roles: Viewer: puede ver y listar archivos. Editor: puede ver, listar, crear y eliminar archivos. Administrator: tiene todos los permisos Estos roles dan soporte a un caso de uso de compartición de archivos entre usuarios authorizados y conocidos. Si lo necesitas puedes reconfigurar bepasty para otros roles y casos de uso.
Distribuir contraseñasPor omisión, la configuración de Acceso Público está puesta a None, de modo que se requiere contraseña para cada uso de bepasty. Esto implica que necesitarás distribuir las contraseñas a los usuarios mediante cualquier canal de comunicación del que dispongas. Observa que quizá quieras crear múltiples contraseñas con los mismos permisos de modo que puedas distribuir una contraseña única a cada usuario (o grupo de usuarios) y si necesitas revocar acceso a un usuario puedas símplemente borrar su contraseña sin afectar a los demás usuarios.
Usar bepastyTras ingresar a bepasty, si tienes el permiso Create verás una caja grande de texto en la que podrás pegar cualquier texto. Opcionalmente puedes proporcionar un nombre de fichero o tipo de contenido (Content-Type) para los datos. Tras pulsar Submit se crea el fichero. Puedes también arrastrar archivos al area de abajo. Se cargan inmediatamente al soltarlos en este área. También puedes crear una lista para controlar la colección de archivos cargados. En ambos casos puedes establecer una caducidad y cuando expire se eliminará el archivo. Si tienes el permiso List verás un enlace List all Items en la zona superior de la página. Esto mostrará todos los archivos creados o cargados. Si tienes el permiso Delete o Admin verás acciones junto a cada archivo en la página de la lista. Si sólo tienes el permiso Read para leer los archivos necesitarás tento una contraseña como una o más URLs de archivos existentes.
Administrando contraseñasLa página de configuración de bepasty en el interfaz de FreedomBox te permite crear contraseñas nuevas, o eliminar alguna. Al crear una contraseña puedes elegir cualquier combinación de permisos descritos anteriormente. Observa que un administrador típico debiera tener todos los permisos (no solo "Admin"). También puedes establecer un comentario. Se recomienda. Y deberías usarlo para ayudarte a recordar el propósito de la contraseña o quién la va a usar. Puedes configurar también el Acceso Público, que establece los permisos disponibles por omisión incluso sin ingresar con contraseña. Puedes establecer esto para permitir leer archivos por su URL, o leer y listar todos los archivos.
Enlaces externos Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/ejabberd.raw.xml b/doc/manual/es/ejabberd.raw.xml deleted file mode 100644 index 00081d508..000000000 --- a/doc/manual/es/ejabberd.raw.xml +++ /dev/null @@ -1 +0,0 @@ -
es/FreedomBox/Manual/ejabberd122020-07-19 22:51:01fioddorTranslations header added outside include block112020-07-18 22:45:21fioddorSe alinea con la versión 22 en inglés del 18 de julio de 2020.102020-07-18 14:40:08fioddorSe alinea con la versión 21 en inglés del 18 de julio de 2020.92020-07-18 10:47:11fioddortexto alternativo corregido82020-07-18 10:46:01fioddortraducido el texto alternativo a la imagen72020-07-18 09:37:35fioddorSe usa imagen traducida.62020-07-18 00:19:31fioddor52020-07-17 23:46:23fioddorSe alinea con la versión 19 en inglés del 18 de julio de 202042020-05-30 19:33:52SunilMohanAdapaUpdate the title to emphasize app name over its generic name32020-05-24 06:35:01fioddorSe alinea con la versión 14 en inglés del 23 de mayo de 202022019-09-05 12:44:11fioddorCorrección menor12019-09-05 11:59:04fioddorSe crea la versión española.Translation(s): English - Español
Ejabberd (Servidor de Mensajería Instantánea) icono de ejabberd Disponble desde: versión 0.3
¿Qué es XMPP?XMPP es un protocolo cliente-servidor federado para Mensajería Instantánea. Esto significa que los usuarios que tengan cuenta en un servidor XMPP pueden conversar con los usuarios que estén en el mismo u otros servidores XMPP. XMPP se puede usar también para llamadas de voz y vídeo si los clientes las soportan. Actualmente FreedomBox ofrece ambas partes desde su interfaz web: un servidor (ejabberd) y un cliente web (JSXC).
PrivacidadCon XMPP las conversaciones se pueden securizar de 2 maneras: TLS: Esto securiza la conexión entre el cliente y el servidor o entre 2 servidores. Esto está áltamente recomendado y ya debería estar soportado por todos los clientes. Punto a punto: Esto securiza los mensajes enviados entre los clientes de modo que ni siquiera el servidor pueda ver los contenidos. El último protocolo y también el más cómodo se llama OMEMO pero solo lo soportan algunos clientes. Algunos clientes que no soportan OMEMO podrían soportar otro protocolo llamado OTR. Para que funcione ambos clientes tienen que ser compatibles con el mismo protocolo.
Establer un Nombre de DominioPara que funcione XMPP tu FreedomBox necesita tener Nombre de Dominio accesible desde la red. Si sólo necesitas que los usuarios de tu red local (LAN) conversen entre sí, puedes inventarte un nombre de dominio. Pero si quieres que participen usuarios de internet en tus salas necesitas un nombre de dominio público. Puedes leer acerca de la obtención de un Nombre de Dominio en la sección DNS Dinámico de este manual. Una vez tengas ya tu Nombre de Dominio puedes decirle a tu FreedomBox que lo use dándolo de alta en la configuración del sistema. Nota: Tras cambiar tu Nombre de Dominio la página del servidor (XMPP) de mensajería instantánea podría mostrar que el servicio no está funcionando. En un minuto más o menos se actualizará y lo volverá a mostrar operativo. Ten en cuenta que de momento PageKite no soporta el protocolo XMPP.
Habilitar a usuarios para usar XMPPActualmente todos los usuarios creados con FreedomBox podrán ingresar al servidor XMPP. Puedes añadir usuarios nuevos con el módulo de "Usuarios y Grupos del Sistema". Los grupos seleccionados para el usuario nuevo no importan.
Enrutado de PuertosSi tu FreedomBox está detrás de un router tendrás que configurar en él la redirección de puertos. Redirije los siguientes puertos de XMPP: TCP 5222 (cliente-a-servidor) TCP 5269 (servidor-a-servidor) TCP 5280 (?)
Clientes compatiblesFreedomBox proporciona un cliente web: JSXC. Hay clientes XMPP disponibles para varias platformas de escritorio y móviles. Volver a la descripción de Funcionalidades o a las páginas del manual. InformaciónSoporteContribuyeInformesPromueveIntroducción Hardware Ayuda en línea Dónde empezar Traduce Reuniones Charlas Funcionalidades Visión Preguntas y Respuestas Diseño Por hacer Releases Prensa Descargas Manual Codigo Fuente Contribuyentes Blog FreedomBox para Comunidades Manual del Desarrolador de FreedomBox AYUDA y DEBATES: Foro de Debate - Lista de Correo - #freedombox irc.debian.org | CONTACTO Fundación | PARTICIPA Proyecto Next call: Sunday, August 23rd at 17:00 UTC Latest news: Help translate freedombox.org - 2020-08-01 Esta página está sujeta a copyright y sus autores la publican bajo la licencia pública Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). CategoryFreedomBox
\ No newline at end of file diff --git a/doc/manual/es/freedombox-manual.raw.xml b/doc/manual/es/freedombox-manual.raw.xml deleted file mode 100644 index 0597d103b..000000000 --- a/doc/manual/es/freedombox-manual.raw.xml +++ /dev/null @@ -1,14871 +0,0 @@ - - -
- - es/FreedomBox/Manual - - - 83 - 2020-08-19 10:57:06 - fioddor - Nueva marca BEGIN_INCLUDE en es/.../Snapshots - - - 82 - 2020-08-19 10:51:30 - fioddor - Nueva marca BEGIN_INCLUDE en es/.../Storage - - - 81 - 2020-08-19 10:45:13 - fioddor - Nueva marca BEGIN_INCLUDE en es/.../ServiceDiscovery - - - 80 - 2020-08-19 10:40:50 - fioddor - Nueva marca BEGIN_INCLUDE en es/.../Security - - - 79 - 2020-08-19 10:34:58 - fioddor - Nueva marca BEGIN_INCLUDE en es/.../NameServices - - - 78 - 2020-08-19 10:30:20 - fioddor - Nueva marca BEGIN_INCLUDE en es/.../Monkeysphere - - - 77 - 2020-08-19 10:15:39 - fioddor - Nueva marca BEGIN_INCLUDE en es/.../Diagnostics - - - 76 - 2020-08-19 10:07:46 - fioddor - Nueva marca BEGIN_INCLUDE en es/.../DateTime - - - 75 - 2020-08-18 19:58:28 - fioddor - Se alinea con la versión 98 en inglés del 15 agosto de 2020 - - - 74 - 2020-08-01 01:28:08 - JamesValleroy - remove duplicate included Power page - - - 73 - 2020-08-01 01:27:00 - JamesValleroy - add BEGIN_INCLUDE to Power page include - - - 72 - 2020-07-30 08:20:41 - fioddor - Se añade página traducida. - - - 71 - 2020-07-29 23:29:55 - fioddor - Se añade página traducida. - - - 70 - 2020-07-19 19:35:15 - fioddor - Se alinea con la versión 95 en inglés del 19 de julio de 2020. - - - 69 - 2020-07-18 11:19:01 - fioddor - Se alinea con la versión 94 en inglés del 18 de julio de 2020 - - - 68 - 2020-07-18 00:18:25 - fioddor - Incluye a JSXC - - - 67 - 2020-05-30 20:04:07 - SunilMohanAdapa - Sort apps and system items according to their new titles - - - 66 - 2020-05-26 14:06:09 - fioddor - Enlace a nueva página traducida. - - - 65 - 2020-05-24 08:20:24 - fioddor - Se alinea con la versión 88 en inglés del 24 de mayo de 2020 - - - 64 - 2020-05-10 10:11:38 - fioddor - Se alinea con la versión 84 en inglés del 06 de mayo de 2020 - - - 63 - 2020-05-10 00:33:47 - fioddor - Enlace a página traducida. - - - 62 - 2020-05-03 17:17:44 - JamesValleroy - Fix from markers for Contribute and Developer included pages - - - 61 - 2020-04-26 16:48:28 - JamesValleroy - gitweb included twice, remove one instance - - - 60 - 2020-04-04 12:31:29 - fioddor - Enlace a página traducida. - - - 59 - 2020-02-21 15:55:40 - JosephNuthalapati - Add entry for Samba - - - 58 - 2019-12-25 21:08:13 - fioddor - Enlace a página traducida. Se alinea con la versión 80 del 25 de diciembre de 2019. - - - 57 - 2019-12-20 21:18:19 - fioddor - Se alinea con la versión 79 en inglés del 20 de diciembre de 2019 - - - 56 - 2019-12-17 21:17:07 - fioddor - Se alinea con la versión 78 en inglés del 15 de diciembre de 2019 - - - 55 - 2019-10-21 14:05:52 - fioddor - Corrección menor - - - 54 - 2019-10-10 20:52:39 - JosephNuthalapati - Fix possible XML validation error when exported to DocBook format - - - 53 - 2019-09-18 11:07:13 - fioddor - Enlace a nueva página traducida. - - - 52 - 2019-09-18 08:27:29 - fioddor - Enlace a nueva página traducida. - - - 51 - 2019-09-17 14:01:06 - fioddor - Enlace a nueva página traducida. - - - 50 - 2019-09-17 12:10:22 - fioddor - Enlace a nueva página traducida. - - - 49 - 2019-09-17 11:26:58 - fioddor - Enlace a nueva página traducida. - - - 48 - 2019-09-16 12:07:24 - fioddor - Enlace a nueva página traducida. - - - 47 - 2019-09-16 11:37:06 - fioddor - Enlace a nueva página traducida. - - - 46 - 2019-09-16 10:59:12 - fioddor - Enlace a nueva página traducida. - - - 45 - 2019-09-16 09:36:54 - fioddor - Enlace a nueva página traducida. - - - 44 - 2019-09-14 09:45:54 - fioddor - Enlace a nueva página traducida. - - - 43 - 2019-09-14 09:03:46 - fioddor - Enlace a nueva página traducida. - - - 42 - 2019-09-13 17:07:09 - fioddor - Enlace a nueva página traducida. - - - 41 - 2019-09-12 12:19:54 - fioddor - Enlace a nueva página traducida. - - - 40 - 2019-09-12 11:08:26 - fioddor - Enlace a nueva página traducida. - - - 39 - 2019-09-11 15:33:53 - fioddor - Enlace a nueva página traducida. - - - 38 - 2019-09-11 14:54:58 - fioddor - Enlace a nueva página traducida. - - - 37 - 2019-09-11 10:35:33 - fioddor - Enlace a nueva página traducida. - - - 36 - 2019-09-11 09:41:44 - fioddor - Enlace a nueva página traducida. - - - 35 - 2019-09-11 08:07:33 - fioddor - Enlace a nueva página traducida. - - - 34 - 2019-09-05 12:48:18 - fioddor - Enlace a nueva página traducida. - - - 33 - 2019-09-04 13:37:22 - fioddor - Enlace a nueva página traducida. - - - 32 - 2019-09-04 09:51:27 - fioddor - Enlace a nueva página traducida. - - - 31 - 2019-09-04 09:36:09 - fioddor - Enlace a nueva página traducida. - - - 30 - 2019-09-04 06:59:54 - fioddor - Enlace a nueva página traducida. - - - 29 - 2019-09-03 15:19:33 - fioddor - Enlace a nueva página traducida. - - - 28 - 2019-08-29 12:51:22 - fioddor - Enlace a nueva página traducida. - - - 27 - 2019-08-28 07:40:58 - fioddor - traducción de la sección SISTEMA finalizada. - - - 26 - 2019-08-23 13:03:13 - fioddor - Enlace a nueva página semi-traducida. - - - 25 - 2019-08-23 10:48:53 - fioddor - Enlace a nueva página traducida. - - - 24 - 2019-08-20 12:57:11 - fioddor - Enlace a nueva página traducida. - - - 23 - 2019-08-20 12:17:28 - fioddor - Enlace a nueva página traducida. - - - 22 - 2019-08-20 11:09:08 - fioddor - - - 21 - 2019-08-20 11:03:15 - fioddor - Enlace a nueva página traducida. - - - 20 - 2019-08-20 08:34:41 - fioddor - Enlace a nueva página traducida. - - - 19 - 2019-07-01 09:50:34 - fioddor - Enlace a la versión española. - - - 18 - 2019-06-20 15:24:02 - fioddor - Enlace a nueva página traducida. - - - 17 - 2019-06-20 15:14:21 - fioddor - Enlace a nueva página traducida. - - - 16 - 2019-06-20 14:44:02 - fioddor - Enlace a nueva página traducida. - - - 15 - 2019-06-20 14:30:08 - fioddor - Enlace a nueva página traducida. - - - 14 - 2019-06-19 12:37:41 - fioddor - Enlace a nueva página traducida. - - - 13 - 2019-06-19 12:15:59 - fioddor - Enlace a nueva página traducida. - - - 12 - 2019-06-19 10:43:11 - fioddor - Enlace a nueva página traducida. - - - 11 - 2019-06-19 10:28:55 - fioddor - Enlace a nueva página traducida. - - - 10 - 2019-06-19 07:44:50 - fioddor - Enlace a nueva página traducida. - - - 9 - 2019-06-18 15:47:59 - fioddor - Enlace a nueva página traducida. - - - 8 - 2019-06-18 15:28:11 - fioddor - Enlace a nueva página traducida. - - - 7 - 2019-06-18 15:18:23 - fioddor - Enlace a nueva página traducida. - - - 6 - 2019-06-18 13:49:37 - fioddor - Enlace a nueva página traducida. - - - 5 - 2019-06-18 12:40:13 - fioddor - Enlace a nueva página traducida. - - - 4 - 2019-06-18 12:25:15 - fioddor - - - 3 - 2019-06-18 12:23:44 - fioddor - Enlace a nueva página traducida. - - - 2 - 2019-06-18 08:07:20 - fioddor - - - 1 - 2019-06-18 07:52:26 - fioddor - Primera traducción provisional - - - -
- FreedomBox: recupera tu privacidad online - FreedomBox es un servidor personal diseñado tomando en cuenta la privacidad y la propiedad de los datos. Es un subconjunto del sistema operativo universal Debian e incluye solo software libre. Puedes ejecutarlo en casa en un ordenador pequeño, barato y energéticamente eficiente dedicado a tal uso. También se puede instalar en cualquier ordenador que ejecute Debian o en una máquina virtual. - Para reeemplazar servicios de comunicaciones de terceros que están espiando toda tu vida, podrás alojar servicios por ti mismo y usarlos en casa o a través de Internet mediante un navegador o aplicaciones especializadas. Estos servicios incluyen chat y audioconferencias, correo electrónico web, compartición de ficheros y calendario, libreta de direcciones y sincronización de feeds de noticias. Por ejemplo, para comenzar a usar un servicio de chat privado activa el servicio desde el interfaz de administración y agrega a tus amistades como usuarios autorizados del servicio. Podrán conectarse al servicio alojado en tu FreedomBox usando clientes de chat XMPP como Conversations para Android, Pidgin para Windows y Linux, o Messages para Mac OS, y acceder a comunicaciones cifradas. - FreedomBox es un producto que puedes comprar, instalar y queda lista para usar. Una vez instalado el interfaz es fácil de usar, parecido a un teléfono inteligente. - Documentación de usuario: - - - - Aplicaciones de FreedomBox - - - - - Manual - - - - - Ayuda en directo de la comunidad - - - - FreedomBox también puede alojar un punto de acceso Wi-Fi, un proxy para bloquear anuncios y una red privada virtual (VPN). Los usuarios más avanzados pueden reemplazar su router por un FreedomBox. - Configurar FreedomBox en casa sobre un hardware específico o en tu ordenador con Debian podría requerir cierto conocimiento técnico o ayuda de la comunidad. - Documentación técnica relacionada: - - - - Máquinas que soportan FreedomBox - - - - - Desgarga e Instalación - - - - - Manual del Desarrollador de FreedomBox - - - -
- Uso típico: Nube Privada - FreedomBox proporciona servicios a ordenadores y dispositivos móviles en tu hogar, y a tus amistades. Esto incluye mensajería instantánea segura y audioconferencias de alta calidad con poco consumo de banda. FreedomBox te permite publicar tus contenidos en un blog y en un wiki para colaborar con el resto del mundo. Están previstos los servicios de servidor personal de correo electrónico y red social federada usando GNU Social y Diaspora, para proporcionar alternativas a Gmail y Facebook que respeten la privacidad. -
-
- Uso avanzado: Router Casero Inteligente - FreedomBox se ejecuta en un ordenador físico y puede enrutar tu tráfico. Puede reemplazar a tu router inalámbrico de casa dando salida a internet a dispositivos variados como teléfonos móviles, ordenadores portátiles y televisores. Enrutando tráfico FreedomBox puede eliminar anuncios espía y malware web antes incluso de que alcancen tus dispositivos. FreedomBox puede ocultar tu localización y protejer tu anonimato enrutando tu tráfico por la red Tor. FreedomBox proporciona un servidor VPN que puedes emplear cuando estés lejos de casa para mantener secreto tu tráfico en redes inalámbricas públicas en las que no confíes y para acceder con seguridad a tus dispositivos de casa. - También lo puedes llevar contigo y tu portátil y usarlo para conectar a redes públicas en el trabajo, o para habilitar sus servicios en la escuela o en la oficina. - Se podría emplear en una aldea para habilitar comunicaciones digitales por toda la aldea. En el futuro, FreedomBox intentará dar soporte a medios alternativos de conexión a Internet, como redes Mesh. -
-
- Uso avanzado: Para Comunidades - El objetivo principal del diseño de FreedomBox es ser empleado como servidor personal en el hogar para uso por parte de una única familia y sus amistades. No obstante, en esencia es un software servidor que puede ayudar a un usuario no técnico a desplegar y mantener servicios con facilidad. El software se encarga automáticamente de muchas de las decisiones técnicas de administración del sistema, incluída la seguridad, reduciendo la complejidad para un usuario no técnico. Esta naturaleza de FreedomBox le hace apropiado para alojar servicios para comunidades pequeñas como aldeas o pequeñas empresas. Las comunidades pueden alojar sus propios servicios con un esfuerzo minimo usando FreedomBox. Pueden desplegar redes Wi-Fi que cubran toda el área de la comunidad y traer conexiones a Internet desde largas distancias. Los miembros de la comunidad pueden disfrutar conectividad a Internet, cobertura Wi-Fi omnipresente, servicios de VoIP, contenidos educativos y de entretenimiento offline, etc anteriormente no disponibles. También reforzará la privacidad individual de los miembros de la comunidad, reducirá su dependencia de servicios centralizados proporcionados por grandes compañías y les hará resistentes a la censura. - El libro electrónico libre FreedomBox for Communities describe la motivación y proporciona instrucciones detalladas para configurar FreedomBox para este caso de uso. Miembros del proyecto FreedomBox estan involucrados en desplegar redes Wi-Fi con conectividad gratuíta a Internet en la India rural. Este libro electrónico documenta su conocimiento y experiencias. -
-
- Interfaz de FreedomBox -
- Captura de pantalla - - - - - - - FreedomBox front page - - - -
-
- Video de introducción - - Plinth_Introduction.webm - - (36 MB, 13 Min.) -
-
- Más recursos en formato video - La charla Eben Moglen - Freedom in the cloud que impartió Eben Moglen antes del arranque del proyecto FreedomBox expone aspectos de la filosofía que hay detrás FreedomBox. - Primera demostración de FreedomBox en SFLC, Universidad de Columbia por Sunil Mohan Adapa. -
-
-
-
- Guía de Inicio Rápido -
- Lo que necesitas para empezar - La forma fácil es comprar un kit FreedomBox. - Alternativamente podrías optar por montarlo tu mismo reuniendo todas las piezas: - - - Un dispositivo soportado (incluyendo cualquier dispositivo que pueda funcionar con Debian). En el resto de este manual lo llamaremos la FreedomBox. - - - Un cable de alimentación para tu dispositivo. - - - Un cable de red Ethernet. - - - Una tarjeta microSD (o un medio de almacenamiento equivalente para tu dispositivo) preparado según las instrucciones de la página de Descargas. - - -
-
- Cómo empezar - - - Conecta un extremo del cable de red al puerto Ethernet de tu FreedomBox y el otro a tu router. - - - Enciende la FreedomBox. - - - Nota: En la mayoría de computadoras monoplaca no esperes un efecto de salida en un monitor si lo conectas por HDMI porque el núcleo (kernel) del sistema podría no reconocerlo. Mira más abajo para aprender cómo acceder y controlar tu FreedomBox desde la red. - - - - - En el primer arranque FreedomBox ejecutará su configuración inicial (las versiones más antiguas de FreedomBox se reinician tras este paso). Este proceso podría llevar varios minutos en algunas máquinas. Después de darle unos 10 minutos aproximadamente, sigue con el siguiente paso. - - - Nota: Esta espera y reinicio se necesitan a causa de un defecto conocido. - - - - - Después de que tu FreedomBox haya finalizado su configuración inicial puedes acceder a su interfaz web mediante tu navegador web. - - - Si tu ordenador está conectado directamente a tu FreedomBox a través de un segundo puerto Ethernet de la red local, puedes navegar a o a . - - - Si tu ordenador soporta mDNS (GNU/Linux, Mac OSX o Windows con software mDNS instalado), puedes navegar a: (o a ) - - - Si te manejas con el interfaz web de tu router, puedes buscar allí la dirección IP de tu FreedomBox y navegar a ella. - - - Si no están disponibles ninguno de estos métodos necesitarás averiguar la dirección IP de tu FreedomBox. Puedes usar el programa "nmap" de tu ordenador para encontrar su dirección IP: - - En la mayoría de los casos puedes mirar tu dirección IP actual y cambiar los últimos dígitos por 0 para encontrar tu red local, así: XXX.XXX.XXX.0/24 - Tu FreedomBox aparecerá como una dirección IP con un puerto TCP 80 abierto usando el servicio Apache httpd sobre Debian. En el siguiente ejemplo estaría en http://192.168.0.165: - - Si nmap no encuentra nada con el comando anterior puedes probar a remplazar 192.168.0.0/24 por 10.42.0.255/24. - - El informe de escaneo mostrará algo similar a esto: - - En este ejemplo, la FreedomBox está en http://10.42.0.50. (10.42.0.1 es mi ordenador.) - - - - - Al acceder al interfaz web de FreedomBox tu navegador te avisará de que comunica en modo seguro pero que considera invalido el certificado de seguridad. Tienes que aceptarlo porque el certificado es autogenerado en la FreedomBox y "autofirmado" (el navegador podría denominarlo "no confiable", "no privado", "error de privacidad" o "emisor/autoridad desconocida"). Decir a tu navegador que ya lo sabes podría implicar accionar algunos botones como "Entiendo los riesgos", "proceder ... (inseguro)" o "Añadir excepción". Después de la instalación este certificado se puede cambiar a otro normal usando la opción Let's Encrypt. - - - - - - - - - Aviso de certificado autofirmado - - - - - - - - - - - - Añadir excepción de seguridad - - - - - - - - La primera vez que accedes al interfaz web de tu FreedomBox verás una página de bienvenida. Haz clic en el botón "Iniciar configuración" para continuar. - - - - - - - - - Bienvenida - - - - Si has instalado FreedomBox usando un paquete Debian se te pedirá una clave secreta. Esta clave se te habrá proporcionado durante la instalación del paquete Debian. También se puede leer en el archivo /var/lib/plinth/firstboot-wizard-secret. - - - - - La siguiente página te pide un nombre de usuario y contraseña. Rellena el formulario y haz clic en "Crear Cuenta." - - - Nota: El usuario que creas aquí tendrá privilegios de Admin y también podrá entrar por SSH. Por seguridad y para prevenir meteduras de pata no deberías introducir tu cuenta de uso habitual, sino una especial. Luego puedes añadir más usuarios, entre ellos el tuyo de uso habitual. - - - - - - - - - Cuenta - - - - - - - - Tras completar el formulario estarás en el interfaz web de FreedomBox y podrás acceder a las apps y a la configuración mediante el interfaz web. - - - - - - - - - Completado - - - - - - - - Ahora puedes probar cualquier App disponible en FreedomBox. -
-
- Orientándote -
- Página principal - La página principal es la que verás al acceder a la raíz web de tu FreedomBox. También puedes acceder a ella haciendo clic sobre el logo de FreedomBox de la esquina de arriba a la izquierda del interfaz web de FreedomBox. - La página principal tiene accesos directos a las apps instaladas que estén habilitadas. Haciendo clic en los accesos directos de aplicaciones web te llevarán a la página web correspondiente de cada app. Si son otro tipo de servicios hacer clic en los accesos directos te mostrará información acerca de cada servicio. - - - - - - - Página principal - - - - - - - - - - Página principal - - - -
-
- Menú de Aplicaciones - Al Menú de Aplicaciones se accede por el icono de rejilla que está junto al logo de FreedomBox. Esta página lista todas las apps disponibles para instalar en tu FreedomBox. Haz click sobre el nombre de la app para visitar su página, desde la que podrás instalarla y configurarla. - - - - - - - Apps - - - -
-
- Menú de Ayuda - Al Menú de Ayuda se accede por el icono del signo de interrogación de la esquina de arriba a la derecha. Incluye enlaces útiles y el manual de FreedomBox. - - - - - - - Ayuda - - - -
-
- Menú del Sistema - Al Menú del Sistema se accede por el icono del engranaje de la esquina de arriba a la izquierda. Incluye páginas relacionadas con la configuración del sistema. - - - - - - - Sistema - - - -
-
- Menú del Usuario - En la esquina superior derecha se muestra el nombre del usuario actual. Un menú desplegable incluye opciones para editar el perfil del usuario o sacarle del interfaz web. - - - - - - - Usuario - - - -
-
- Menú de Hamburgesa - El interfaz web de FreedomBox's es autoadaptativo. En algún caso podrías echar en falta las opciones del menú en ventanas estrechas. - - - - - - - User - - - - Esto se debe a que las opciones del menú han colapsado en el icono de hamburguesa mostrado en la esquina superior derecha de la ventana. Al hacer clic en él se despliega el menú. - - - - - - - User - - - -
-
-
-
- Obtener Ayuda - - - - Este manual intenta darte la información que necesitas para comenzar a usar tu FreedomBox. No obstante, si después de leerlo tienes cualquier pregunta puedes obtener ayuda de los contribuyentes a la comunidad así: - - - Buscando o preguntando en tu foro de debate (recomendado). - - - Escribiendo a la lista de correo electrónico freedombox-discuss@lists.alioth.debian.org. También puedes apuntarte a recibir copias de cada debate que ocurra en la lista de correo o leer sus archivos. - - - Conversando por chat en #freedombox@irc.oftc.net. - - - Leyendo el wiki. - - - Leyendo el sitio web de la FreedomBox Foundation. - - - Leyendo la Página del Proyecto FreedomBox. - - -
-
- Descarga e Instalación - Bienvenido a la página de descargas de FreedomBox. - - - Nota: Si has comprado un kit FreedomBox esta sección no está pensada para tí, así que puedes simplemente saltártela entera. (A no ser que quieras específicamente compilarte una imagen alternativa del software). - - - Puedes instalar FreedomBox sobre alguno de los baratos dispositivos hardware soportados, sobre cualquier sistema operativo Debian Linux, o sobre una máquina virtual. - Instalar en una máquina que lleve el sistema Debian es fácil porque FreedomBox está disponble como paquete. Recomendamos instalar FreedomBox sobre una placa SBC soportada. La placa estaría dedicada al uso de FreedomBox en el hogar. Esto evitará un montón de riesgos, como configuraciones accidentalmente incorectas por el usuario. En caso de duda decidiendo qué hardware es el más apropiado para tí o durante la instalación, usa por favor la página de soporte o lee la página de Preguntas y Respuestas basada en los archivos de la lista de correo Freedombox-discuss. -
- Descargando en Debian - Si estás instalando sobre un sistema Debian existente no necesitas descargar las imágenes. Lee las instrucciones para configurar FreedomBox en Debian. -
-
- Descargando para placa SBC o Máquina Virtual -
- Preparar tu dispositivo - Lee las instrucciones específicas para tu hardware respecto a como preparar tu dispositivo en la sección Hardware. En la web hay abundante documentación respecto a como configurar tu dispositivo y grabar USB's o tarjetas SD para arrancar tu hardware. -
-
- Descargar Imágenes - Las imágenes recientes para hardware soportado están disponibles aquí: - - - Imágenes Oficiales: - - - Imágenes Oficiales: - - -
-
- Verificar las Imágenes Descargadas - Es importante verificar las imágenes que has descargado para asegurar que el fichero no se ha corrompido durante la transmisión y que efectívamente es la imagen construída por los desarrolladores de FreedomBox. - Nota: Las imágenes de prueba y nocturnas las firma el servidor de integración contínua de FreedomBox automaticamente. - - - Primero abre un terminal e importa las claves publicas de los desarrolladores de FreedomBox que construyeron las imágenes: - - Si este comando muestra un error como new key but contains no user ID - skipped usa un servidor de claves diferente para descargarlas: - - O - - - - A continuación, verifica la huella de las claves públicas: - -sub 4096R/4C1D4B57 2011-11-12 - -$ gpg --fingerprint 7D6ADB750F91085589484BE677C0C75E7B650808 -pub 4096R/7B650808 2015-06-07 [expires: 2020-06-05] - Key fingerprint = 7D6A DB75 0F91 0855 8948 4BE6 77C0 C75E 7B65 0808 -uid James Valleroy -uid James Valleroy -sub 4096R/25D22BF4 2015-06-07 [expires: 2020-06-05] -sub 4096R/DDA11207 2015-07-03 [expires: 2020-07-01] -sub 2048R/2A624357 2015-12-22 - -$ gpg --fingerprint 013D86D8BA32EAB4A6691BF85D4153D6FE188FC8 -pub rsa4096 2018-06-06 [SC] - 013D 86D8 BA32 EAB4 A669 1BF8 5D41 53D6 FE18 8FC8 -uid [ unknown] FreedomBox CI (Continuous Integration server) -sub rsa4096 2018-06-06 [E]]]> - - - Finalmente, verifica tu imágen descargada con su archivo de firma .sig. Por ejemplo: - " -gpg: WARNING: This key is not certified with a trusted signature! -gpg: There is no indication that the signature belongs to the owner. -Primary key fingerprint: BCBE BD57 A11F 70B2 3782 BC57 36C3 6144 0C9B C971]]> - - -
-
- Instalación - Tras la descarga puedes emplear la imágen para arrancar tu hardware (incluyendo máquinas virtuales). Necesitarás copiar la imágen a la tarjeta de memoria o pincho USB así: - - - Averigua en qué dispositivo está tu tarjeta. - - - Desconecta tu tarjeta (Sácala de la ranura). - - - Ejecuta dmesg -w mara mostrar y seguir los mensajes del núcleo (kernel). - - - Conecta tu tarjeta (insértala en su ranura). Verás mensajes como estos: - - - - En este caso, el disco insertado recientemente está disponible en /dev/sdg. Toma nota con mucho cuidado para emplearla en el paso de copia más adelante. - - - - - Descomprime la descarga usando tar: - - El comando de arriba es un ejemplo para la imagen cubietruck construída el 2015/12/13. El nombre de archivo de tu descarga será diferente. - - - Copia la imágen a tu tarjeta. Asegúrate de que NO escribes sobre el almacenamiento principal de tu ordenador (como /dev/sda). Asegúrate - - - también de que NO ejecutas este paso como root para evitar sobreescribir datos en tu disco duro por una identificación errónea del dispositivo o fallos al teclear el comando. No habitual es que los usuarios normales tuvieran acceso de escritura sobre los discos USB y tarjetas SD pinchados en el sistema. Si no tienes permiso para escribir en tu tarjeta SD como usuario normal quizá necesites ejecutar éste comando como root. En tal caso comprueba y recomprueba todo antes de ejecutar el comando. Otra precaución de seguridad es desconectar todos los demás discos externos excepto la tarjeta SD antes de ejecutar el comando. - - - Por ejemplo, si tu tarjeta SD es /dev/sdg, como en el paso anterior, para copiar la imágen, ejecuta: - - - - Un comando alternativo para copiar a la tarjeta SD: - - - /dev/sdg ; sync]]> - - - En MS Windows necesitarás una herramienta como etcher. En MacOS (OSX) puedes usar programas como balenaetcher y rosaimagewriter. - - - El comando anterior es un ejemplo para la imagen cubietruck construída el 2015/12/13. El nombre del archivo de tu imágen será diferente. - Al identificar el dispositivo, usa el destino con letra de unidad como /dev/sdg, NO un destino numerado como /dev/sdg1. El dispositivo sin número refiere al dispositivo completo, mientras que el numerado refiere a una partición concreta. Queremos usar todo el dispositivo. Las imágenes descargadas contienen información completa acerca de cuantas particiones debería haber, sus tamaños y tipos. No necesitas formatear tu tarjeta SD ni crear particiones. Todo el contenido previo de la tarjeta será eliminado durante el proceso de escritura. - - - Usa la imágen insertando la tarjeta SD o disco USB en el dispositivo de destino y arrancándolo. Tu dispositivo también debe estár preparado - (ver la sección Hardware). - - - Lee (el resto de) el Manual para obtener instrucciones acerca de como usar las aplicaciones de FreedomBox. - - -
-
-
- Obtener el Código Fuente - FreedomBox es 100% software libre y puedes obtener el código fuente para estudiarlo, modificarlo y distribuir mejoras. -
- Desde (dentro de) FreedomBox - FreedomBox se compone de diferentes programas de software y puedes obtener el código fuente de cualquiera de ellos. Estas instrucciones son similares a obtener y construír código fuente de Debian ya que FreedomBox es una variante pura de Debian. Usando este procedimiento puedes obtener el código fuente de la misma versión del paquete que estás usando actualmene en FreedomBox. - - - Para ver la lista de paquetes software instalados en tu FreedomBox, ejecuta lo siguiente en un terminal: - - - - Para obtener el código fuente de cualquiera de esos programas ejecuta: - ]]> - Esto requiere que el archivo /etc/apt/sources/list contenga información acerca de los repositorios de código fuente. Esto es así por defecto en todas las imágenes FreedomBox. Pero si has instalado FreedomBox desde Debian necesitas asegurarte de que los repositorios de código fuente figuren en este archivo. - - - Para construir el paquete desde su código fuente, primero instala sus dependencias - ]]> - Cambia al directorio fuente creado con el comando apt source: - ]]> - Y construye el paquete - - - - Instala el paquete: - .deb]]> - - -
-
- Otras Maneras de Obtener el Código Fuente - - - El código fuente de cualquier paquete se puede ver y buscar usando el interfaz web de sources.debian.org. Por ejemplo, mira el paquete plinth. - - - El código fuente y el binario precompilado de cualquier version de un paquete, incluyendo versiones antigüas, se pueden obtener de snapshot.debian.org. Por ejemplo, mira el paquete plinth. - - - También puedes obtener los enlaces a la web del proyecto original, al control de versiones del proyecto original, al control de versiones de Debian, registro de cambios, etc. desde la página de control Debian para el proyecto en tracker.debian.org. Por ejemplo, mira la página de control para el paquete plinth. - - - Puedes compilar e instalar un paquete desde el control de versiones de Debian. Por ejemplo, - - - -
-
- Construyendo Imágenes de disco - También puedes construír imágenes de disco FreedomBox para varias platformas de hardware usando la herramienta freedom-maker. Esta también está disponible como paquete Debian y su código fuente se puede obtener empleando los métodos anteriores. Hay disponibles Instrucciones de Construcción para generar imágenes de disco incluídas en el código fuente del paquete freedom-maker. - Las imágenes de disco de FreedomBox se construyen y suben a los servidores oficiales empleando la infraestructura de integración contínua automatizada. Esta infraestructura está disponible también como código fuente y proporciona información precisa acerca de como se contruyen las imágenes de FreedomBox. -
- Imágenes U-boot sobre Pioneer Edition - Hay una excepción menor en el paquete u-boot que viene con el hardware que se vende como Kits de Servidor Doméstico FreedomBox Pioneer Edition. Contiene un parche pequeño pero importante que no está en el código fuente de Debian. Tanto el repositorio fuente de Debian u-boot como el parche de FreedomBox están disponibles como un repositorio aparte. Esperamos que en algún momento este parche esté integrado en u-boot de serie y este repositorio ya no sea necesario. Este paquete se puede compilar en una máquina Debian armhf como sigue (también se puede hacer compilación cruzada, simplemente sigue las instrucciones para compilación cruzada de paquetes Debian): - - El paquete u-boot Debian estará en u-boot-sunxi*.deb. Este paquete contendrá - -dd if=temp/usr/lib/u-boot/A20-OLinuXino-Lime2/u-boot-sunxi-with-spl.bin of= seek=8 bs=1k conv=notrunc]]> - La imagen resultante tendrá el u-boot modificado. -
-
-
-
-
- Apps - - Add entries here sorted after the level 2 heading inside the page to keep the list alphabetically sorted - Para mantener la lista ordenada alfabéticamente añade estas entradas según el título de nivel 2 de dentro de su página - -
- Bepasty (Compartición de apuntes y archivos) - - - - - - - - - - - - - Icono de bepasty - - - - - - - - - Disponible desde: versión 20.14 -
- ¿Qué es bepasty? - bepasty es una aplicación web que permite cargar y compartir archivos grandes. También se pueden cargar y compartir recortes de texto y código. Los textos, imágenes, audio, video y documentos PDF se pueden previsualizar en el navegador. Se puede asignar una caducidad a los archivos. -
-
- Captura de pantalla - - - - - - - Captura de pantalla de bepasty - - - -
-
- Contraseñas y permisos - bepasty solo usa contraseñas (sin usuarios) para controlar el acceso. El usuario tendrá permisos diferentes dependiendo de la contraseña empleada para ingresar a bepasty. Podría tener cualquier combinación de los siguentes permisos: - - - read: Leer un archivo, si conoce la URL. - - - list: Listar todos los archivos. - - - create: Pegar o cargar un archivo nuevo. - - - delete: Eliminar un archivo. - - - admin: Bloquear y desbloquear archivos. - - - Tras instalar bepasty viene pre-configurado con los siguientes roles: - - - Viewer: puede ver y listar archivos. - - - Editor: puede ver, listar, crear y eliminar archivos. - - - Administrator: tiene todos los permisos - - - Estos roles dan soporte a un caso de uso de compartición de archivos entre usuarios authorizados y conocidos. Si lo necesitas puedes reconfigurar bepasty para otros roles y casos de uso. -
-
- Distribuir contraseñas - Por omisión, la configuración de Acceso Público está puesta a None, de modo que se requiere contraseña para cada uso de bepasty. Esto implica que necesitarás distribuir las contraseñas a los usuarios mediante cualquier canal de comunicación del que dispongas. - Observa que quizá quieras crear múltiples contraseñas con los mismos permisos de modo que puedas distribuir una contraseña única a cada usuario (o grupo de usuarios) y si necesitas revocar acceso a un usuario puedas símplemente borrar su contraseña sin afectar a los demás usuarios. -
-
- Usar bepasty - Tras ingresar a bepasty, si tienes el permiso Create verás una caja grande de texto en la que podrás pegar cualquier texto. Opcionalmente puedes proporcionar un nombre de fichero o tipo de contenido (Content-Type) para los datos. Tras pulsar Submit se crea el fichero. - Puedes también arrastrar archivos al area de abajo. Se cargan inmediatamente al soltarlos en este área. También puedes crear una lista para controlar la colección de archivos cargados. - En ambos casos puedes establecer una caducidad y cuando expire se eliminará el archivo. - Si tienes el permiso List verás un enlace List all Items en la zona superior de la página. Esto mostrará todos los archivos creados o cargados. - Si tienes el permiso Delete o Admin verás acciones junto a cada archivo en la página de la lista. - Si sólo tienes el permiso Read para leer los archivos necesitarás tento una contraseña como una o más URLs de archivos existentes. -
-
- Administrando contraseñas - La página de configuración de bepasty en el interfaz de FreedomBox te permite crear contraseñas nuevas, o eliminar alguna. Al crear una contraseña puedes elegir cualquier combinación de permisos descritos anteriormente. Observa que un administrador típico debiera tener todos los permisos (no solo "Admin"). - También puedes establecer un comentario. Se recomienda. Y deberías usarlo para ayudarte a recordar el propósito de la contraseña o quién la va a usar. - Puedes configurar también el Acceso Público, que establece los permisos disponibles por omisión incluso sin ingresar con contraseña. Puedes establecer esto para permitir leer archivos por su URL, o leer y listar todos los archivos. -
-
- Enlaces externos - - - -
-
-
- Coturn (Asistente para VoIP) - - - - - - - - - - - - - icono de Coturn - - - - - - - - - Disponible desde: versión 20.8 - Coturn es un servidor para facilitar llamadas y conferencias de audio/video proporcionando una implementación de los protocolos TURN y STUN. Los servidores de comunicación por WebRTC, SIP y otros pueden usarlo para establecer una llamada entre partes que de otro modo no podrían conectarse entre si. - No está pensado para que lo usen diréctamente los usuarios. Los servidores como Matrix Synapse necesitan configurarse con los datos proporcionados en la página de app de Coturn. Además de Matrix Synapse, Jitsi, Ejabberd, Nextcloud Talk, etc. pueden usar el servidor Coturn para llamadas y conferencias de audio/video. No hace falta que los servidores se ejecuten en la misma máquina que FreedomBox. Los servidores externos pueden usar un Coturn ejecutado en FreedomBox. - Coturn está configurada en FreedomBox como app avanzada. Esto implica que para ver el icono de Coturn en la sección "Apps" necesitas marcar en "Mostrar apps y funcionalidades avanzadas" en "Configuración General". -
- Cómo funciona - Al hacer una llamada de audio/video lo mejor es enrutar los flujos multimedia directamente entre los pares porque minimiza la latencia (mejor calidad de señal) y evita depender de un servidor centralizado (privacidad). Esto escala bien porque un servidor de chat simple puede albergar miles de llamadas sin involucrarse de ningún otro modo que para establecer la llamada. Sin embargo este enfoque no suele funcionar la mayoría de las veces por cómo se configuran las redes. La mayoría de los pares de la red carecen de una dirección IP propia reservada para ellos y suelen operar detrás de un dispositivo de red que les traduce las direcciones de red (NAT: "Network Address Translation"). Esto significa que en realidad estos pares no tienen modo de alcanzarse entre sí directamente. - Para abordar este problema se introdujo una técnica simple conocida como STUN. Con ayuda de un servidor STUN los pares pueden prescindir de los dispositivos NAT para transmitir entre ellos. Desafortunadamente este truco solo funciona un 80% de las ocasiones. Así que si STUN falla, los pares no tienen más opción que enrutar su comunicación a través de un intermediario llamado servidor TURN. Todo el mecanismo de intentar primero con STUN y recaer en TURN se describe en un protocolo llamado ICE. - En FreedomBox, Coturn proporciona servidores STUN y TURN. Ambos servicios se proporcionan tanto sobre TCP como sobre UDP y tanto en canales cifrados (que tienen mayor probabilidad de éxito) como sin cifrar. Como los servidores STUN son baratos y no consumen muchos recursos no se necesita autenticación para usarlos. Por otra parte los servidores TURN sí la necesitan. Esta autenticación está altamente simplificada y no requiere mantener una base de datos de usuarios. Un servidor como matrix-synapse que vaya a establecer una llamada de audio/video entre dos pares generará un nombre de usuario y contraseña empleando un secreto compartido. Cuando los pares usen el servidor TURN se les validará usando estas credenciales porque el servidor TURN conoce este secreto. - En resumen, un servidor de comunicaciones necesita saber las URLs de los servidores STUN/TURN junto con el secreto de autenticación para TURN. Después, durante el establecimiento de la llamada de audio/video guiarán a los pares a usar los servidores STUN/TURN. La app Coturn de FreedomBox proporciona exactamente ésta información, que se puede usar para configurar un servidor de comunicaciones independientemente de que se ejecute en la misma máquina que FreedomBox o en otro servidor. -
-
- Configurar Matrix Synapse - El servidor de Matrix Synapse de FreedomBox se puede configurar para que use el servidor de TURN/STUN Coturn. En el futuro, cuando instales Matrix Synapse FreedomBox instalará Coturn automáticamente y configurará sus parámetros en Matrix Synapse. Para configurar Matrix Synapse, edita el fichero /etc/matrix-synapse/homeserver.yaml con las siguientes líneas: - - Y luego reinicia el servidor matrix-synapse deshabilitando y rehabilitando la app de matrix-synapse. -
-
-
- Deluge (Cliente web de BitTorrent) - - - - - - - - - - - - - icono de Deluge - - - - - - - - - Disponible desde: versión 0.5 -
- ¿Qué es Deluge? - BitTorrent es un protocolo de comunicaciones para compartir ficheros entre pares (P2P = peer-to-peer). No es anónimo; debes asumir que otros puedan ver qué ficheros estás comprtiendo. Hay 2 clientes web para BitTorrent disponibles en FreedomBox: Transmission y Deluge. Tienen funcionalidades similares pero quizá prefieras uno sobre otro. - Deluge es un cliente BitTorrent altamente configurable. Se puede añadir funcionalidad adicional instalando extensiones (plugins). -
-
- Captura de pantalla - - - - - - - Deluge Web UI - - - -
-
- Configuración Inicial - Tras instalar Deluge se puede acceder apuntando tu navegador a https://<tu freedombox>/deluge. Necesitarás introducir una contraseña para ingresar: - - - - - - - Deluge Login - - - - La contraseña inicial es deluge. La primera vez que ingreses Deluge te preguntará si quieres cambiarla. Debes cambiarla por algo más dificil de adivinar. - A continuación se te mostrará el administrador de conexiones. Haz clic sobre la primera entrada (Offline - 127.0.0.1:58846). Luego pulsa "Arrancar el Demonio" para que arranque el servicio Deluge service que se ejecutará en segundo plano. - - - - - - - Deluge Connection Manager (Offline) - - - - Ahora debería poner "Online". Haz clic en "Conectar" para completar la configuración. - - - - - - - Deluge Connection Manager (Online) - - - - En este punto ya estás usando Deluge. Puedes hacer más cambios en las Preferencias o añadir un fichero o una URL de torrent. -
-
-
- Ejabberd (Servidor de Mensajería Instantánea) - - - - - - - - - - - - - icono de ejabberd - - - - - - - - - Disponble desde: versión 0.3 -
- ¿Qué es XMPP? - XMPP es un protocolo cliente-servidor federado para Mensajería Instantánea. Esto significa que los usuarios que tengan cuenta en un servidor XMPP pueden conversar con los usuarios que estén en el mismo u otros servidores XMPP. - XMPP se puede usar también para llamadas de voz y vídeo si los clientes las soportan. - Actualmente FreedomBox ofrece ambas partes desde su interfaz web: un servidor (ejabberd) y un cliente web (JSXC). -
-
- Privacidad - Con XMPP las conversaciones se pueden securizar de 2 maneras: - - - TLS: Esto securiza la conexión entre el cliente y el servidor o entre 2 servidores. Esto está áltamente recomendado y ya debería estar soportado por todos los clientes. - - - Punto a punto: Esto securiza los mensajes enviados entre los clientes de modo que ni siquiera el servidor pueda ver los contenidos. El último protocolo y también el más cómodo se llama OMEMO pero solo lo soportan algunos clientes. Algunos clientes que no soportan OMEMO podrían soportar otro protocolo llamado OTR. Para que funcione ambos clientes tienen que ser compatibles con el mismo protocolo. - - -
-
- Establer un Nombre de Dominio - Para que funcione XMPP tu FreedomBox necesita tener Nombre de Dominio accesible desde la red. - Si sólo necesitas que los usuarios de tu red local (LAN) conversen entre sí, puedes inventarte un nombre de dominio. Pero si quieres que participen usuarios de internet en tus salas necesitas un nombre de dominio público. Puedes leer acerca de la obtención de un Nombre de Dominio en la sección DNS Dinámico de este manual. - Una vez tengas ya tu Nombre de Dominio puedes decirle a tu FreedomBox que lo use dándolo de alta en la configuración del sistema. - Nota: Tras cambiar tu Nombre de Dominio la página del servidor (XMPP) de mensajería instantánea podría mostrar que el servicio no está funcionando. En un minuto más o menos se actualizará y lo volverá a mostrar operativo. - Ten en cuenta que de momento PageKite no soporta el protocolo XMPP. -
-
- Habilitar a usuarios para usar XMPP - Actualmente todos los usuarios creados con FreedomBox podrán ingresar al servidor XMPP. Puedes añadir usuarios nuevos con el módulo de "Usuarios y Grupos del Sistema". Los grupos seleccionados para el usuario nuevo no importan. -
-
- Enrutado de Puertos - Si tu FreedomBox está detrás de un router tendrás que configurar en él la redirección de puertos. Redirije los siguientes puertos de XMPP: - - - TCP 5222 (cliente-a-servidor) - - - TCP 5269 (servidor-a-servidor) - - - TCP 5280 (?) - - -
-
- Clientes compatibles - - - FreedomBox proporciona un cliente web: JSXC. - - - Hay clientes XMPP disponibles para varias platformas de escritorio y móviles. - - -
-
-
- GitWeb (Alojamiento simple para Git) - - - - - - - - - - - - - icono de Gitweb - - - - - - - - - Disponible desde versión: 19.19 - GitWeb proporciona alojamiento Git en FreedomBox. Proporciona un interfaz web para realizar acciones comunes sobre repositorios Git como ver archivos, diferencias, descripciones de cambio, etc. Git es un sistema de control de versiones distribuído para trazar cambios en código fuente durante el desarrollo de software. Con GitWeb puedes hojear la historia y el contenido del código fuente, y usar la búsqueda para encontrar cambios y código específicos. También puedes clonar repositorios y subir cambios al código con un cliente Git de línea de órdenes o con múltiples clientes gráficos que hay disponibles. Y puedes compartir tu código con gente de todo el mundo. - Para aprender a usar Git visita su tutorial. -
- Administrar los repositorios - Tras instalar GitWeb se puede crear un nuevo repositorio. Se puede marcar como privado para limitar el acceso. -
-
- Acceso - Tras instalar GitWeb se puede acceder a GitWeb mediante el cliente web (p.ej) en https://<mi_freedombox>/gitweb. -
-
- Autenticación básica HTTP - Actualmente el GitWeb de FreedomBox solo soporta remotos HTTP. Para evitar tener que introducir la contraseña cada vez que haces pull/push al repositorio puedes editar tu remoto para incluír credenciales. - - Ejemplo: - - - Tu nombre de usuario y contraseña se cifrarán. Quien monitorize el tráfico de la red solo apreciará el nombre de dominio. - Nota: Al usar este método tu contraseña se almacenará en claro en el fichero .git/config del repositorio local. Por este motivo debes crear un usuario FreedomBox que solo tenga acceso a gitweb y no usar nunca una cuenta de administrador. -
-
- Réplicas Espejo - Aunque tus repositorios se albergan principalmente en tu propia FreedomBox puedes configurar un repositorio en otro servicio de alojamiento Git como GitLab a modo de copia espejo. -
-
-
- I2P (Red anónima) - - - - - - - - - - - - - I2P icon - - - - - - - - -
- Acerca de I2P - El Proyecto Internet Invisible (I2P) es una capa anonimizadora de red concebida para protejer las comunicaciones de la censura y la vigilancia. I2P proporciona anonimato enviando tráfico cifrado a través de una red distribuída alrededor del mundo gestionada por voluntarios. - Más información acerca de I2P en la página principal del proyecto. -
-
- Servicios Ofrecidos - Los siguientes servicios se ofrecen en FreedomBox a través de I2P de serie. Se pueden habilitar más servicios desde la consola de enrutado I2P que se puede abrir desde el interfaz web de FreedomBox. - - - Navegación web anónima: I2P se puede usar para navegar por la web de forma anónima. Para ello configura tu navegador (preferíblemente un navegador Tor) para conectar al proxy I2P. Esto se puede hacer estableciendo los proxies HTTP y HTTPS a freedombox.local (o la IP local de tu FreedomBox) con sus respectivos puertos a 4444 y 4445. Este servicio está disponible sólo cuando accedes a la FreedomBox usando la red local (redes de la zona interna del cortaguegos) y no cuando llegas a la FreedomBox desde Internet. Una excepción a esto es cuando te conectas al servicio VPN de la FreedomBox desde Internet, en cuyo caso sí puedes usar el servicio de navegación web anónima a través de I2P. - - - Acceso a eepsites: La red I2P puede albergar sitios web anónimos llamados eepsites cuyo nombre de dominio acaba en .i2p. Por ejemplo, http://i2p-projekt.i2p/ es el sitio web del proyecto I2P en la red I2P. Los eepsites son inaccesibles a un navegador normal a través de una conexión Internet normal. Para navegar a los eepsites tu navegador necesita configurarse para usar los proxies HTTP y HTTPS como se describió antes. Este servicio solo está disponible cuando accedes a la FreedomBox usando la red local (redes de la zona interna del cortaguegos) y no cuando llegas a la FreedomBox desde Internet. Una excepción a esto es cuando te conectas al servicio VPN de la FreedomBox desde Internet, en cuyo caso sí puedes usar el servicio de acceso a eepsites a través de I2P. - - - Descargas anónima de torrentes: I2PSnark, una aplicación para descargar y compartir archivos anónimamente mediante la red BitTorrent está disponible y habilitada por defecto en FreedomBox. Esta aplicación se controla mediante un interfaz web que se puede abrir desde la sección Torrentes Anonimos de la app I2P en el interfaz web de FreedomBox o de la consola de enrutado I2P. Solo los usuarios ingresados pertenecientes al grupo Manage I2P application pueden usar este servicio. - - - Red IRC: La red I2P contiene una red IRC llamada Irc2P. Esta red alberga el canal IRC oficial del proyecto I2P, entre otros. Este servicio viene habilitdo de serie en FreedomBox. Para usarlo abre tu cliente IRC favorito y configuralo para conectar con freedombox.local (o la IP local de tu FreedomBox) en el puerto 6668. Este servicio solo está disponible cuando accedes a la FreedomBox usando la red local (redes de la zona interna del cortaguegos) y no cuando llegas a la FreedomBox desde Internet. Una excepción a esto es cuando te conectas al servicio VPN de la FreedomBox desde Internet, en cuyo caso sí puedes usar el servicio de IRC a través de I2P. - - - Consola de enrutado I2P: Este es el interfaz central de administración de I2P. Muestra el estado actual de I2P, estadísticas de ancho de banda y permite modificar varias preferencias de configuración. Puedes adecuar tu participación en la red I2P y usar/editar una lista con tus sitios I2P (eepsites) favoritos. Solo los usuarios ingresados pertenecientes al grupo Manage I2P application pueden usar este servicio. - - -
-
-
- Ikiwiki (Wiki y Blog) - - - - - - - - - - - - - icono de Ikiwiki - - - - - - - - -
- ¿Qué es Ikiwiki? - Ikiwiki convierte páginas wiki a páginas HTML listas para publicar en un sitio web. En particular, proporciona blogs, podcasts, calendarios y una amplia selección de extensiones (plugins). -
-
- Inicio rápido - Tras instalar la app en el interfaz de administración de tu FreedomBox: - - - Ve a la sección Crear y crea un wiki o un blog. - - - Vuelve a la sección Configurar y haz clic en el enlace /ikiwiki. - - - Haz clic en el nombre de tu nuevo wiki o blog bajo Directorio Padre. - - - Disfruta de tu nueva página de publicación. - - -
-
- Crear un wiki o blog - Puedes crear un wiki o blog para albergarlo en tu FreedomBox mediante la página Wiki y Blog (Ikiwiki). La primera vez que visites esta página te pedirá instalar paquetes requiridos por Ikiwiki. - Tras completar la instalación de paquetes selecciona la solapa Crear. Puedes elegir el tipo: Wiki o Blog. Teclea también un nombre para el wiki o blog, y el usuario y contraseña para su cuenta de administrador. Al hacer clic en Actualizar configuración verás el wiki/blog añadido a tu lista. Observa que cada wiki/blog tiene su propia cuenta de administrador. - - - - - - - ikiwiki: Create - - - -
-
- Acceder a tu wiki o blog - Desde la página de Wiki y Blog (Ikiwiki) selecciona la solapa Administrar y verás una lista de tus wikis y blogs. Haz clic en un nombre para navegar a ese wiki o blog. - - - - - - - ikiwiki: Manage - - - - Desde aquí, si le das a Editar o a Preferencias se te llevará a una página de ingreso. Para ingresar con la cuenta de administrador que creaste antes selecciona la solapa Otros, introduce el usuario y la contraseña y haz clic en Ingresar. -
-
- Ingreso único de usuarios (SSO) - Se puede dar permiso para editar a otros usuarios de FreedomBox además de al administrador del wiki/blog. Sin embargo no tendrán todos los permisos del administrador. Podrán añadir o editar páginas pero no podrán cambiar la configuración del wiki. - Para añadir a un usuario al wiki ve a la página Usuarios y Grupos de FreedomBox (bajo Configuración del Sistema, el icono del engranaje de la esquina superior derecha de la página). Crea o modifica un usuario y añádele al grupo wiki. (Los usuarios del grupo admin tendrán también acceso al wiki.) - Para ingresar como usuario FreedomBox ve a la página de ingreso del wiki/blog y selecciona la solapa Otros. Luego haz clic en el botón Ingresar con autenticación HTTP. El navegador mostrá un diálogo emergente en el que podrás introducir el usuario y la contraseña del usuario de FreedomBox. -
-
- Añadir usuarios FreedomBox como admnistradores de wiki - - - Ingresa al wiki con su cuenta de administrador. - - - Haz clic en Preferencias y luego en Configurar. - - - Debajo de Principal, en usuarios administradores de algún wiki, añade el nombre de un usuario de FreedomBox. - - - (Opcional) Desmarca la opción habilitar autenticación mediante contraseña de extensión de autenticación: autenticación mediante contraseña. (Nota: Esto deshabilitará el ingreso con la cuenta de administrador anterior. Solo se podrá ingresar mediante ingreso único usando autenticación HTTP.) - - - Haz clic en Grabar Configuración. - - - Pulsa Preferencias y a continuación Salir. - - - Ingresa como el nuevo usuario administrador usando Ingresar con autenticación HTTP. - - -
-
-
- Infinoted (Servidor Gobby) - - - - - - - - - - - - - icono de Infinoted - - - - - - - - - Disponible desde: versión 0.5 - Infinoted es un servidor de edición colaborativa de textos para Gobby. - Para usarlo descarga el cliente Gobby para escritorio e instalalo. Inicialo, selecciona "Conectar a un Servidor" e introduce el nombre de dominio de tu FreedomBox. -
- Redirección de Puertos - Si tu FreedomBox está detras de un router necesitarás configurar la redirección de puertos en tu router. Redirije los siguientes puertos de infinoted: - - - TCP 6523 - - -
-
-
- JSXC (Cliente Web de Mensajería Instantánea) - - - - - - - - - - - - - icono de JSXC - - - - - - - - - Disponible desde: versión 0.11.0 - JSXC is un cliente web de mensajería instantánea. Sirve para conectar con servidores de mensajería instantánea compatibles. - FreedomBox ofrece ambas partes desde su interfaz web: un servidor (ejabberd) y un cliente web (JSXC). -
- Especificaciones técnicas - JSXC está hecho con HTML5 e implementa el protocolo XMPP sobre BOSH. - XMPP es un protocolo cliente-servidor para Mensajería Instantánea federado. Esto significa que los usuarios con cuenta en un servidor pueden conversar con usuarios de otro servidor. - Se puede usar XMPP también para llamadas de voz y/o vídeo, si los clientes las soportan. -
-
- Instalación - Puedes instalar JSXC mediante su icono de la sección Apps de la interfaz web de FreedomBox. El icono de ejabberd (servidor XMPP) también ofrece lanzar el cliente web (instalando JSXC de paso si fuera preciso). -
-
- Uso - Tras completar la instalación del módulo JSXC, queda accesible mediante su icono en la sección Apps de la interfaz web de FreedomBox. El icono de ejabberd (servidor XMPP) también ofrece lanzar el cliente web. Ambos te redirigirán a https://<tu_freedombox>/plinth/apps/xmpp/jsxc/. - Para usarlo necesitas introducir el nombre de dominio del servidor al que quieres conectarte. Automáticamente comprueba la conexión al servidor BOSH cuando tecléas el nombre de dominio. - - - - - - - - - - - - - - JSXC sin conexión - - - - - - - - - - - - JSXC con conexión - - - - - - - - - Más detalles en . - JSXC ofrece funcionalidades de videoconferencia y transferencia de ficheros pero no parecen funcionar aún en FreedomBox. -
-
- Redirección de puertos - Si tu FreedomBox está detrás de un router y quieres conectarte a otros servidores, necesitarás configurar la redirección de puertos de tu router. Para XMPP deberás redirigir los siguientes puertos: - - - TCP 5222 (cliente-a-servidor) - - -
-
-
- Matrix Synapse (Servidor de Mensajería Instantánea) - - - - - - - - - - - - - icono de Matrix Synapse - - - - - - - - - Disponible desde: versión 0.14.0 -
- ¿Qué es Matrix? - Matrix es un estándar abierto para comunicaciones sobre IP en tiempo real interoperables y descentralizadas. Synapse es la implementación de referencia de un servidor Matrix. Se puede usar para montar mensajería instantánea sobre FreedomBox para albergar grandes salones de chat, comunicaciones cifradas punto a punto y llamadas de audio/vídeo. Matrix Synapse es una aplicación federada en la que puede haber salas de chat en un servidor y los usuarios de cualquier otro servidor de la red federada pueden unirse a ellas. Más información acerca de Matrix. -
-
- ¿Cómo acceder a tu servidor Matrix Synapse? - Para acceder al servidor Matrix Synapse recomendamos el cliente Riot. Puedes descargar Riot para escritorio. Las aplicaciones para Android e iOS están disponibles en sus tiendas (app stores) respectivas. -
-
- Configurar Matrix Synapse en tu FreedomBox - Para habilitar Matrix, primero navega a la página de tu servidor de chat (Matrix Synapse) e instálalo. Matrix necesita un nombre de dominio válido configurado. Tras la instalación, se te pedirá que lo configures seleccionandolo de entre un menú desplegable con dominios disponibles. Los dominios se configuran en la página Sistema -> Configuración y actualmente no podrás cambiar el dominio una vez esté configurado. Tras configurar un dominio verás que el servicio se está ejecutando. El servicio estará accesible en el dominio de FreedomBox configurado. - Tendrás que configurar tu router para que reenvíe el puerto 8448 a tu FreedomBox. - Todos los usuarios registrados en tu FreedomBox tendrán sus IDs Matrix @usuario:dominio. Si está habilitado el registro público tu cliente se puede usar también para registrar una cuenta de usuario nueva. -
-
- Federarse con otras instancias Matrix - Podrás interactuar con cualquier otra persona que ejecute otra instancia de Matrix. Esto se hace simplemente iniciando una conversación con ellos usando su matrix ID que seguirá el formato @su-usuario:su-dominio. También podrás unirte a salas de otros servidores y tener llamadas de audio/video con contactos de otros servidores. -
-
- Uso de Memoria - El servidor de referencia Synapse implementado en Python es conocido por consumir mucha RAM, especialmente al cargar salones grandes con miles de participantes como #matrix:matrix.org. Se recomienda evitar unirse a estos salones si tu dispositivo FreedomBox solo tiene 1 GiB RAM o menos. Debería ser seguro unirse a salas con hasta 100 participantes. El equipo de Matrix está trabajando en una implementación de servidor Matrix escrita en Go llamada Dendrite que debería tener mejor rendimiento en entornos con poca memoria. - Algunos salones públicos muy grandes de la red Matrix están también disponibles como canales IRC (p.ej. #freedombox:matrix.org está disponible también como #freedombox en irc.debian.org). Es mejor usar IRC en vez de Matrix para estos salones tán grandes. Puedes unirte a los canales de IRC usando Quassel. -
-
- Uso Avanzado - - - Si quieres crear una gran cantidad de usuarios en tu servidor de Matrix Synapse usa los siguientes comandos en una shell remota como usuario root: - - - /etc/matrix-synapse/conf.d/registration_shared_secret.yaml -chmod 600 /etc/matrix-synapse/conf.d/registration_shared_secret.yaml -chown matrix-synapse:nogroup /etc/matrix-synapse/conf.d/registration_shared_secret.yaml -systemctl restart matrix-synapse -register_new_matrix_user -c /etc/matrix-synapse/conf.d/registration_shared_secret.yaml]]> - - - - - Si quieres ver la lista de usuarios registrados en Matrix Syanpse haz lo siguiente como usuario root: - - - - - - - - Para crear una comunidad en Matrix Synapse se necesita un usuario Matrix con privilegios de admin en el servidor. Para dárselos a miusuario ejecuta los siguientes comandos como usuario root: - - - - - - - -
-
-
- MediaWiki (Wiki) - - - - - - - - - - - - - icono de MediaWiki - - - - - - - - - Disponible desde: versión 0.20.0 -
- Acerca de MediaWiki - MediaWiki es el software de base de la gama de wikis Wikimedia. - Lee más acerca de MediaWiki en Wikipedia -
-
- MediaWiki en FreedomBox - MediaWiki viene configurado en FreedomBox para ser públicamente legible y editable en privado. Sólo los usuarios ingresados pueden editar el wiki. Esta configuración evita publicidad indeseada (spam) y otros vandalismos en tu wiki. -
- Administración de Usuarios - Solo el administrador de MediaWiki (usuario "admin") puede crear los usuarios. El usuario "admin" puede usarse también para restablecer contraseñas de usuarios MediaWiki. Si se olvida la contraseña del administrador se puede restablecer desde la página de MediaWiki del interfaz web de FreedomBox. -
-
- Casos de uso - MediaWiki es muy versátil y se puede emplear para muchos usos creativos. También es áltamente adaptable y viene con un montón de extensiones (plugins) y estilos estéticos. -
- Repositorio Personal de Conocimiento - El MediaWiki de FreedomBox puede ser tu propio repositorio de conocimiento personal. Como MediaWiki tiene buen soporte multimedia puedes escribir notas, almacenar imágenes, crear listas de comprobación, guardar referencias y enlaces, etc. de manera organizada. Puedes almacenar el conocimiento de una vida en tu instancia de MediaWiki. -
-
- Wiki Comunitario - Una comunidad de usuarios podría usar MediaWiki como su repositorio común de conocimiento y material de referencia. Se puede emplear como un tablón de anunciós de universidad, como un servidor de documentación para una pequeña empresa, como un bloc de notas para grupos de estudio o como un wiki de fans al estilo de wikia. -
-
- Sitio Web Personal implementado mediante un Wiki - Varios sitios web de internet son sólo instancias de MediaWiki. El MediaWiki de FreedomBox es de solo lectura para visitantes. Se puede por tanto adaptar para servir como tu sitio web y/o blog personal. El contenido de MediaWiki es fácil de exportar y puede moverse después a otro motor de blogs. -
-
-
- Editar Contenido del Wiki - FreedomBox monta MediaWiki con un editor básico con una barra de herramientas con opciones de uso habitual como negrita, cursiva etc. Haz clic en la sección Avanzadas para acceder a más opciones como cabaceras, listas con viñetas, etc. - - - - - - - mediawiki-toolbar.png - - - -
- Editor Visual - Como su nombre indica, el nuevo Editor Visual de MediaWiki ofrece un interfaz de usuario visual (WYSIWYG) para crear páginas del wiki. Pero esta funcionalidad está todavía en pruebas y MediaWiki no la trae de serie. Una solución temporal posible sería escribir tu contenido con el Editor Visual del borrador de Wikipedia, cambiar el modo de edición a texto y copiarlo a tu wiki. -
-
- Otros Formatos - No es imprescindible que aprendas el lenguaje de formateo de MediaWiki. Puedes escribir en tu formato favorito (Markdown, Org-mode, LaTeX etc.) y convertirlo al formato de MediaWiki usando Pandoc. -
-
- Cargar Imágenes - Se puede habilitar la carga de imágenes desde FreedomBox versión 0.36.0. También puedes usar directamente imágenes de Wikimedia Commons mediante una funcionalidad llamada Instant Commons. -
-
-
- Personalización -
- Temas de estilo - El tema por defecto de MediaWiki suele ser Vector. El de FreedomBox es Timeless. - Vector es un tema optimizado para visualizarlo en pantallas grandes pero no se adecúa bien a los tamaños de pantalla de los móviles. Wikimedia usa otro sitio específico para móviles. Para instalaciones pequeñas como las de FreedomBox no merece la pena un segundo sitio dedicado. Usar un tema de estilo más polivalente como Timeless es una solución más eficiente al problema. - Los administradores pueden elegir el tema por defecto desde la configuración de la app. Los usuarios del sitio tienen también la opción de visualizarlo con temas diferentes. -
-
-
-
-
- Minetest (Sandbox de bloques) - - - - - - - - - - - - - icono de Minetest - - - - - - - - - Disponible desde: versión 0.9 - Minetest es un Block Sandbox multijugador para mundos infinitos. Este módulo permite ejecutar el servidor Minetest en esta FreedomBox, en su puerto por defecto (30000). Para conectar al servidor se necesita un cliente de Minetest. -
- Enrutado de Puertos - Si tu FreedomBox está detrás de un router necesitarás configurar la redirección de puertos en tu router para los siguientes puertos de Minetest: - - - UDP 30000 - - -
-
-
- MiniDLNA (Servidor multimedia básico) - - - - - - - - - - - - - icono de MiniDLNA - - - - - - - - - Disponible desde: versión 19.23 - MiniDLNA es un servidor multimedia que intenta ser compatible con clientes DLNA/UPnP. - Nota: Este servicio solo está disponible en redes configuradas como zona "interna". Tampoco está disponble a través de OpenVPN (es incompatible). -
- ¿Qué es UPnP/DLNA? - UPnP (Universal plug & play) es un conjunto de protocolos de red que permite a los dispositivos de una red, como PCs, TVs, impresoras etc, reconocerse entre sí y establecer comunicación para compartir datos. Es un protocolo con cero configuración y require solo un servidor multimedia y un reproductor multimedia compatibles con el protocolo. - DLNA se deriva de UPnP como una forma de estandarizar interoperabilidad entre medios. Conforma un estándar/certificación que cumplen muchos dispositivos electrónicos de consumo. -
-
- Desplegando MiniDLNA en tu FreedomBox. - Para instalar/habilitar el servidor multimedia necesitas navegar a la página MiniDLNA y habilitarlo. Se intenta que la aplicación esté disponible en la red interna y por ello requiere asignarle un interfaz de red configurado para tráfico interno. - Tras la instalación queda disponible una página web en . Incluye información de cuántos ficheros detecta el servidor, cuántas conexiones existen etc. Esto resulta muy útil cuando conectas discos externos con contenido para para verificar que detecta los nuevos archivos como debe. Si no ocurre así, desconectar y activar el servidor lo arreglará. -
-
- Usar MiniDLNA para reproducir contenidos multimedia en tus dispositivos - Cualquier dispositivo compatible con DLNA debiera ser capaz de detectar, hojear y reproducir automáticamente contenido multimedia de MiniDLNA en FreedomBox. Los siguientes dispositivos y reproductores se han probado: - - - GNOME Videos: Videos es el reproductor multimedia por defecto en el popular entorno de escritorio GNU/Linux GNOME. Abre Videos, cambia a 'Canales'. Deberías ver un canal denominado 'freedombox: minidlna'. Deberías poder hojear y reproducir su contenido. - - - VLC media player: VLC es un reproductor multimedia para GNU/Linux, Android, Windows y macOS muy popular. Abre VLC y haz clic en 'Ver -> Lista de reproducción'. En la barra lateral de la lista de reproducción que aparece selecciona 'Universal Plug'n'Play'. Deberías ver un elemento denominado 'freedombox: minidlna'. Deberías poder hojear y reproducir su contenido. - - - Kodi: Kodi es un software popular de centro multimedia con un interfaz de usuario diseñado para televisores. Abre Kodi, ve a 'Sistema -> Configuración del Servicio -> UPnP/DLNA' y 'Habilitar soporte UPnP'. Visita entonces 'Home -> Videos -> Archivos -> Añadir videos... -> Navegar -> dispositivos UPnP'. Deberías ver 'freedombox: minidlna'. Selecciónalo y elige 'OK'. Entonces, elige 'OK en el diálogo 'Anadir entrada de video'. A partir de ahora , deberías ver 'freedombox: minidlna' en la sección 'Videos -> Archivos'. Deberías poder hojear y reproducir su contenido. Para más información mira la documentación de Kodi. - - - Roku: Roku es un aparato conectado a una TV para reproducir contenido de servicios de retransmisión por Internet. También hay muchas TVs que llevan a Roku integrado. Encuentra en el interfaz de Roku un canal denominado 'Roku Media Player' y ábrelo. Deberías ver un elemento denominado 'freedombox: minidlna'. Deberías poder hojear y reproducir su contenido. - - - Rhythmbox: Rhythmbox es el reproductor de sonido por defecto en el popular entorno de escritorio GNU/Linux GNOME. Abre Rhythmbox y asegura que el panel lateral esté abierto pulsando en 'Menú de Aplicación -> Ver -> Panel Lateral'. En el panel lateral deberías ver 'freedombox:minidlna' bajo la sección 'Compartidos'. Deberías poder hojear y reproducir sus archivos de sonido. Los archivos de video no aparecerán. - - -
-
- Formatos multimedia soportados - MiniDLNA soporta una amplia variedad de formatos de archivo de video y sonido. - - - Video: Archivos terminados en .avi, .mp4, .mkv, .mpg, .mpeg, .wmv, .m4v, .flv, .mov, .3gp, etc. - - - Sonido: Archivos terminados en .mp3, .ogg, .flac, .wav, .pcm, .wma, .fla, .aac, etc. - - - Imágen: Archivos terminados en .jpg, .jpeg - - - Listas de Reproducción: Archivos terminados enh .m3u, .pls - - - Subtítulos: Archivos terminados en .srt, .smi - - - Obsérvese que no soporta archivos con las siguientes extensiones. Parece que renombrar el archivo a una extensión reconocida funciona el la mayoría de casos. - - - Video: Archivos terminados en .webm - - - Además del soporte al formato de archivo por parte de MiniDLNA, tu dispositivo o reproductor de medios necesita soportar el codec de sonido/video con el que se haya codificado tu contenido. MiniDLNA carece de la habilidad de traducir archivos a un codec compatible con el reproductor. Si te topas con problemas en la reproducción de contenido, usa VLC para identificar el codec empleado en el contenido y comprueba en la documentación de tu dispositivo o reproductor de medios si lo soporta. -
-
- Sistemas de archivo para discos externos. - Al usar un disco externo que se usa también desde sistemas Windows el mejor formato para el sistema de archivos es NTFS. NTFS conservará los permisos de acceso de Linux y la codificación UTF-8 para los nombres de fichero. Esto es útil si los nombres de archivos tienen tildes, eñes u otros signos raros. -
-
- Enlaces externos - - - (en) - - - - - - - -
-
-
- MLDonkey (Compartir archivos entre pares) - - - - - - - - - - - - - icono de MLDonkey - - - - - - - - - Disponible desde: versión 0.48.0 -
- ¿Qué es MLDonkey? - MLDonkey es una aplicación libre y multiprotocolo para compartir archivos entre pares (P2P) que ejecuta un servidor back-end sobre muchas plataformas. Se puede controlar mediante algún interfaz front-end, ya sea web, telnet o cualquier otro de entre una docena de programas cliente nativos. - Originalmente era un cliente Linux para el protocolo eDonkey pero ahora se ejecuta en multiples sabores de Unix y derivados, OS X, Microsoft Windows y MorphOS. Y soporta muchos protocolos P2P, incluyendo ED2K (y Kademlia sobre Overnet), BitTorrent, DC++ y más. - Más información acerca de MLDonkey en el Wiki del Proyecto MLDonkey -
-
- Captura de Pantalla - - - - - - - MLDonkey Web Interface - - - -
-
- Usar el Interfaz Web MLDonkey - Tras instalar MLDonkey su interfaz web está accesible a los usuarios de los grupos ed2k y admin en https://<tu_freedombox>/mldonkey. -
-
- Usar el Interfaz para Escritorio/Móvil - Se pueden usar muchas aplicaciones de escritorio y móviles para controlar a MLDonkey. El servidor MLDonkey estará ejecutándose siempre en la FreedomBox y (cargará o) descargará archivos y los mantendrá almacenados incluso cuando tu máquina local esté apagada o desconectada del MLDonkey de FreedomBox. Por restricciones de acceso via SSH a la FreedomBox solo los usuarios del grupo admin pueden acceder a su MLDonkey. - - - Crea un usuario nuevo en el grupo admin o usa uno que ya esté allí. - - - En tu máquina de escritorio abre una terminal y ejecuta el siguiente comando. Para este paso se recomienda que configures y uses claves SSH en vez de contraseñas. - - - - Arranca la aplicación gráfica y conéctala a MLDonkey como si MLDonkey se estuviera ejecutando en la máquina local de escritorio. Cuando hayas terminado mata el proceso SSH pulsando Control-C. - - - Para más información lee acerca de los túneles SSH en la documentación MLDonkey. -
-
-
- Servidor Mumble (Chat de voz) - - - - - - - - - - - - - Mumble icon - - - - - - - - - Disponible desde: versión 0.5 -
- ¿Qué es Mumble? - Mumble es un software de conversaciones de voz. Principalmente diseñado para uso con juegos multijugador por red, sirve para hablar con alta calidad de audio, cancelación de ruido, comunicación cifrada, autenticación de interlocutores por defecto mediante par de claves pública/privada, y "asistentes" para configurar tu micrófono, por ejemplo. Se puede marcar a un usuario dentro de un canal como "interlocutor prioritario". -
-
- Usar Mumble - FreedomBox incluye el servidor Mumble. Para conectar con el servidor los usuarios pueden descargar algún cliente de entre los disponibles para plataformas de escritorio y móviles. -
-
- Redirección de Puertos - Si tu FreedomBox está detrás de un router necesitarás configurar la redirección de puertos de tu router. Deberías redirigir los siguientes puertos para Mumble: - - - TCP 64738 - - - UDP 64738 - - -
-
- Administrar Permisos - En Mumble un superusuario puede crear cuentas de administrador que a su vez pueden administrar permisos a grupos y canales. Esto se puede hacer tras ingresar con el usuario "SuperUser" y la contraseña de superusuario. Ver la Guía de Mumble para obtener información respecto a cómo hacer esto. Actualmente FreedomBox no ofrece una interfaz gráfica para obtener o establecer la contraseña de superusuario en Mumble. Se genera una contraseña de superusuario automáticamente durante la instalación de Mumble. Para obtenerla ingresa en el terminal como admin usando Cockpit , la Shell Segura o la consola. Y ejecuta el siguiente comando: - - Deberás ver una salida como esta: - 2019-11-06 02:47:41.313 1 => Password for 'SuperUser' set to 'noo8Dahwiesh']]> - O puedes establecer una contraseña nueva así: - -
-
-
- OpenVPN (Red Privada Virtual) - - - - - - - - - - - - - icono de OpenVPN - - - - - - - - - Disponible desde: versión 0.7 -
- ¿Qué es OpenVPN? - OpenVPN proporciona un servicio de red privada virtual a tu FreedomBox. Puedes usar este software para acceso remoto, VPNs punto-a-punto y seguridad Wi-Fi. OpenVPN incluye soporte para direcciones IP dinámicas y NAT. -
-
- Redirección de puertos - Si tu FreedomBox está detrás de un router necesitarás configurar la redirección de puertos en tu router. Debes redirigir los siguientes puertos para OpenVPN: - - - UDP 1194 - - -
-
- Configurar - - - En el menú de apps de FreedomBox selecciona Red Privada Virtual (OpenVPN) y haz clic en Instalar. - - - Tras instalar el módulo todavía queda un paso de configuración que puede llevar largo tiempo completar. Haz clic en "Iniciar configuración" para empezar. - - - - - - - OpenVPN service page - - - - - - Espera a que termine la configuración. Puede tardar un rato. - - - Una vez completada la configuración del servidor OpenVPN puedes descargar tu perfil. Esto descargará un archivo llamado <usuario>.ovpn, siendo <usuario> un usuario de FreedomBox. Todos los usuarios de FreedomBox podrán descargar un perfil propio y diferente. Los usuarios que no sean administradores pueden descargar el perfil desde la portada después de ingresar. - - - El archivo ovpn contiene toda la información que necesita un cliente vpn para conectar con un servidor. - - - El perfil descargado contiene el nombre de dominio de FreedomBox al que debe conectarse el cliente. Este se obtiene del dominio configurado en la sección 'Configuración' de la página de 'Sistema'. En caso de que tu dominio no esté configurado adecuadamente quizá necesites cambiar este valor después de descargar el perfil. Si tu cliente OpenVPN lo permite puedes hacer esto después de importar el perfil OpenVPN. De lo contrario puedes editar el perfil .ovpn con un editor de texto y cambiar la línea 'remote' para que contenga la dirección IP WAN o el hostname de tu FreedomBox como se indica aquí. - - - -
-
- Navegar por Internet tras conectar a una VPN - Tras conectar a la VPN el dispositivo cliente podrá navegar por Internet sin más configuración adicional. No obstante una pre-condición para que esto funcione es que necesitas tener al menos 1 interfaz (tarjeta) de red conectado a Internet en la zona Externa del cortafuegos. Usa la página de configuración de redes para editar la zona del cortafuegos con los interfaces (tarjetas) de red del dispositivo. -
-
- Uso -
- En Android/LineageOS - - - Visita la página principal de FreedomBox. Ingresa con tu cuenta de usuario. Desde la página principal descarga el perfil OpenVPN. El archivo se llamará <usuario>.ovpn. - - - - - - - - - OpenVPN Download Profile - - - - - - - - Descarga un cliente OpenVPN como OpenVPN for Android. Se recomienda el repositorio F-Droid. En la app, selecciona Importar perfil. - - - - - - - - - OpenVPN App - - - - - - - - En el diálogo Seleccionar perfil elige el archivo <usuario>.opvn que acabas de descargar. Pon un nombre a la conexión y graba el perfil. - - - - - - - - - OpenVPN import profile - - - - - - - - El perfil recién creado aparecera. Si hace falta edita el perfil y pon el nombre de dominio de tu FreedomBox como dirección de servidor. - - - - - - - - - OpenVPN profile created - - - - - - - - - - OpenVPN edit domain name - - - - - - - - Conecta haciendo clic sobre el perfil. - - - - - - - - - OpenVPN connect - - - - - - - - - - OpenVPN connected - - - - - - - - Cuando esté desconecta haciendo clic sobre el perfil. - - - - - - - - - OpenVPN disconnect - - - - - - - -
-
- En Debian - Instala un cliente OpenVPN para tu sistema - - Abre el archivo ovpn con el cliente OpenVPN. - .ovpn]]> - Si te sale un error como configuration error: invalid 1th argument to “proto” (line 5) edita el fichero .ovpn y elimina la línea proto udp6. -
-
-
- Comprobar si estás conectado -
- En Debian - - - Trata de hacer ping a tu FreedomBox u otros dispositivos de tu red. - - - El comando ip addr debe mostrar una conexión tun0. - - - El comando traceroute freedombox.org debiera mostrar la dirección IP del servidor VPN como primer salto. - - - Si usas Network Manager puedes crear una conexión nueva importando el fichero: - .ovpn]]> -
-
-
- Acceso a servicios internos - Tras conectar por OpenVPN, podrás acceder a algunos servicios FreedomBox restringidos a acceso interno, además de a los de acceso externo. Esto se puede hacer usando la dirección IP 10.91.0.1 como hostname para esos servicios. - Los siguientes servicios funcionan con OpenVPN: - - - Privoxy, - - - Tor Socks, - - - Shadowsocks, - - - I2P Proxy and - - - Samba. - - - Algunos servicios no funcionan aún con OpenVPN: - - - Avahi, - - - bind and - - - MiniDLNA. - - -
-
- Enlaces Externos - - - -
-
-
- Privoxy (Proxy Web) - - - - - - - - - - - - - icono de Privoxy - - - - - - - - - Disponible desde: versión 0.1 - Un proxy web actúa como filtro para tráfico web entrante y saliente. Por tanto, puedes ofrecer a los ordenadores de tu red pasar su tráfico internet a través del proxy para eliminar anuncios y mecanismos de rastreo indeseados. - Privoxy es un software para la seguridad, privacidad, y control certero sobre la web. Proporciona una navegación web mucho más controlada (y anónima) que la que te puede ofrecer tu navegador. Privoxy "es un proxy enfocado principalmente al aumento de la privacidad, eliminación de anuncios y morralla, y a liberar al usuario de las restricciones impuestas sobre sus propias actividades" (fuente: Preguntas frecuentes acerca de Privoxy). -
- Vídeo - Mira el vídeo acerca de como configurar y usar Privoxy en FreedomBox. -
-
- Configurar - - - Instala Proxy Web (Privoxy) desde FreedomBox - - - - - - - Privoxy Installation - - - - - - Adapta las preferencias de proxy de tu navegador al hostname (o dirección IP) de tu FreedomBox con el puerto 8118. Observa por favor que Privoxy sólo puede tratar tráfico HTTP y HTTPS. No funciona con FTP u otros protocolos. - - - - - - - Privoxy Browser Settings - - - - - - Vé a la página o . Si Privoxy está instalado adecuadamente podrás configurarlo en detalle y si no verás un mensaje de fallo. - - - Si usas un portátil que tenga a veces que conectarse con FreedomBox y Privoxy pasando por routers de terceros quizá quieras instalar una extensión proxy switch que te permite activar y desactivar el proxy más fácilmente. - - -
-
- Usuarios Avanzados - - - La instalación de serie debería proporcionar un punto de partida razonable para la mayoría de los usuarios. Indudablemente habrá ocasiones en las que quieras ajustar la configuración. Eso se puede afrontar cuando surja la necesidad. - - - Con Privoxy activado puedes ver su documentación y los detalles de su configuración en http://config.privoxy.org/ o en http://p.p. - - - Para habilitar los cambios en estas configuraciones primero tienes que cambiar el valor de habilitar-acciones-de-edición en /etc/privoxy/config a 1. Antes de hacerlo lee el manual con atención, especialmente: - - - - No se puede controlar por separado el accesso al editor por "ACLs" o authenticación HTTP, así que cualquiera con acceso a Privoxy puede modificar la configuración de todos los usuarios. Esta opción no se recomienda para entornos con usuarios no confiables. Nota que un código de cliente malicioso (p.ej. Java) también puede usar el editor de acciones y no deberías habilitar estas opciones a no ser que entiendas las consecuencias y estés seguro de que los navegadores están correctamente configurados. - - - - - - Ahora encontrarás un botón EDITAR en la pantalla de configuración de http://config.privoxy.org/. - - - La Guía rápida es un buen punto de partida para leer acerca de cómo definir reglas de bloqueo y filtrado propias. - - -
-
-
- Quassel (Cliente IRC) - - - - - - - - - - - - - icono de Quassel - - - - - - - - - Disponible desde: versión 0.8 - Quassel es una aplicación IRC separada en 2 partes: un "núcleo" y un "cliente". Esto permite que el núcleo permanezca conectado a los servidores IRC recibiendo mensajes aunque el cliente esté desconectado. Ejecutando el servicio nucleo de Quassel FreedomBox puede mantenerte siempre en línea. Se pueden usar uno o varios clentes Quassel para conectarse intermitentemente desde escritorios o dispositivos móviles. -
- ¿Para qué ejecutar Quassel? - Muchos debates acerca de FreedomBox tienen lugar en el canal IRC irc://irc.debian.org/freedombox. Si tu FreedomBox ejecuta Quassel recolectará todos ellos mientras estás ausente, capturando las respuestas a tus preguntas. Recuerda que el proyecto FreedomBox es mundial y participa gente de casi todos los husos horarios. Usarás tu cliente para conectar al núcleo de Quassel y leer y/o responder cuando tengas tiempo y disponibilidad. -
-
- ¿Cómo activar Quassel? - - - En el interfaz web de FreedomBox - - - selecciona Aplicaciones - - - ve a Cliente IRC (Quassel) e - - - instala la aplicación y asegúrate de que está habilitada - - - - - - - Quassel Installation - - - - - - tu núcleo de Quassel se está ejecutando - - - - -
-
- Redirección de Puertos - Si tu FreedomBox está detras de un router necesitarás configurar la redirección de puertos en tu router. Redirije los siguientes puertos de Quassel: - - - TCP 4242 - - - Ejemplo de configuración en el router: - - - - - - - - - Quassel_PortForwarding_es_v01.png - - - - - - - -
-
- Clientes - Hay disponibles clientes para escritorio y dispositivos móviles para conectar a Quassel. -
- Escritorio - En un sistema Debian puedes, p. ej. usar quassel-client. Los siguientes pasos describen cómo conectar el Cliente Quassel con el Núcleo de Quassel de tu FreedomBox. La primera vez que te conectes el Núcleo de Quassel se inicializará también. - - - Abre el Cliente Quassel. Te guiará paso a paso para Conectarse al núcleo. - - - - - - - - - Connect to Core - - - - - - - - Haz clic en el botón Añadir para abrir el diálogo Añadir cuenta de núcleo. - - - - - - - - - Add Core Account - - - - - - - - Rellena cualquier cosa en el campo Nombre de la cuenta. Introduce el hostname DNS de tu FreedomBox en el campo Servidor. El campo Puerto debe tener el valor 4242. Pon el usuario y la contraseña de la cuenta que quieres crear para conectar con el Núcleo de Quassel en los campos Usuario y Contraseña. Si no quieres que se te pida la contraseña cada vez que arranques el cliente de Quassel marca la opción Recordar. - - - Tras pulsar OK en el diálogo Añadir cuenta de núcleo deberías ver la cuenta en el diálogo Conectarse al núcleo. - - - - - - - - - Connect to Core - - - - - - - - Selecciona la cuenta del núcleo recién creada y dale a OK para conectar con él. - - - Si es la primera vez que te conectas a este núcleo verás un aviso de Certificado de seguridad no confiable y necesitarás aceptar el certificado del servidor. - - - - - - - - - Untrusted Security Certificate - - - - - - - - Selecciona Continuar. Se te preguntará si quieres aceptar el certificado permanentemente. Selecciona Para siempre. - - - - - - - - - Untrusted Security Certificate - - - - - - - - Si nadie se ha conectado nunca antes a este Núcleo Quassel antes verás un diálogo por pasos Asistente de configuración del núcleo. Selecciona Siguiente. - - - - - - - - - Core Configuration Wizard - - - - - - - - En la página Crear usuario administrador introduce el usuario y la contraseña que has usado antes para crear la conexión al núcleo. Selecciona Recordar la contraseña para que recuerde la contraseña para futuras sesiones. Haz clic en Siguiente. - - - - - - - - - Create Admin User Page - - - - - - - - En la página Seleccionar un motor de almacenamiento selecciona SQLite y haz clic en Enviar. - - - - - - - - - Select Storage Backend - - - - - - - - La configuración del núcleo está completa y verás un asistente Quassel IRC para configurar tus conexiones IRC. Haz clic en Siguiente. - - - - - - - - - Welcome Wizard - - - - - - - - A continuación en la página de Configurar identidad pon un nombre y múltiples pseudónimos. Te presentarás con estos a otros usuarios de IRC. No es necesario dar tu nombre real. Los pseudónimos múltipes son útiles como suplentes cuando el primero no se pueda usar por cualquier motivo. Tras aportar la información haz clic en Siguiente. - - - - - - - - - Setup Identity - - - - - - - - A continuación en la página de Configurar conexión de red pon el nombre de red que quieras y una lista de servidores a los que se deba conectar el Núcleo de Quassel para unirte a esa red IRC (por ejemplo irc.debian.org:6667). - - - - - - - - - Setup Network Connection - - - - - - - - Selecciona un servidor de la lista y dale a Editar. En el diálogo Información del servidor pon el puerto 6697 (consulta la lista real de servidores y sus puertos seguros en la documentación de tu red) y haz clic en Usar conexión cifrada. Clic en OK. Esto es para asegurar que la comunicación entre tu FreedomBox y el servidor de la red IRC va cifrada. - - - - - - - - - Server Info - - - - - - - - Server Info SSL - - - - - - - - Ya de vuelta en el diálogo Configuración de Conexión de Red proporciona una lista de canales IRC (como #freedombox) a los que unirte al conectarte a la red. Dale a Grabar y Conectar. - - - - - - - - - Setup Network Connection - - - - - - - - Deberías conectar con la red y ver la lista de canales a los que te has unido en el panel Todas las conversaciones de la izquierda de la ventana principal del Cliente Quassel. - - - - - - - - - Quassel Main Window - - - - - - - - Selecciona un canal y empieza a recibir mensajes de otros participantes del canal y a enviar los tuyos. - - -
-
- Android - Para dispositivos Android puedes usar p.ej. Quasseldroid obtenido desde F-Droid - - - introduce el núcleo, usuario, etc. - - - - - - - - - Quasseldroid.png - - - - - - - - Por cierto el verbo alemán quasseln significa hablar mucho, rajar. -
-
-
-
- Radicale (Calendario y Contactos) - - - - - - - - - - - - - icono de Radicale - - - - - - - - - Disponible desde: versión 0.9 - Con Radicale puedes sincronizar tus calendarios, listas de tareas y agendas de contactos personales entre varios ordendores, tabletas, y/o teléfonos inteligentes y compartirlos con tus amistades. Todo sin tener que permitir a terceros que accedan a tu información privada. -
- ¿Porque debería usar Radicale? - Usando Radicale puedes evitar servicios centralizados como Google Calendar o Apple Calendar (iCloud) que explotan los datos de tus eventos y conexiones sociales. -
-
- ¿Cómo configurar Radicale? - Primero el servidor Radicale necesita estar activado en tu FreedomBox. - - - En el servicio FreedomBox - - - selecciona Apps - - - ve a Radicale (Calendario y Libreta de contactos) e - - - instala la aplicación. Tras completar la instalación asegúrate de que la aplicación está marcada como "habilitada" en el interfaz de FreedomBox. Habilitar la aplicación arranca el servidor CalDAV/CardDAV Radicale. - - - define los permisos de acceso: - - - Solo el dueño de un calendario/libreta de contactos puede ver o hacer cambios - - - Cualquier usuario puede ver cualquier calendario/libreta de contactos pero solo el dueño puede hacer cambios - - - Cualquier usuario puede ver o hacer cambios en cualquier calendario/libreta - - - - - - - Nota: Solo los usuarios dados de alta en FreedomBox pueden acceder a Radicale. - - - - - - - Radicale-Plinth.png - - - - Si quieres compartir un calendario solo con algunos usuarios determinados la manera más simple es crear un nuevo usuario común para ellos y compartir con ellos el nombre del usuario común y su contraseña. - Radicale proporciona un interfaz web básico que solo soporta crear calendarios y libretas nuevos. Para añadir eventos o contactos se necesita una aplicación cliente soportada externa. - - - - - - - radicale_web.png - - - - - - Crear calendarios y/o libretas usando el interfaz web - - - Visita https://<dirección_IP_o_dominio_de_tu_servidor>/radicale/ - - - Ingresa con tu cuenta de FreedomBox - - - Selecciona "Crear nuevo calendario o libreta" - - - Proporciona un título y selecciona el tipo - - - Opcionalmente, proporciona una descripción o selecciona un color - - - Haz clic en "Crear" - - - La página mostrará la URL de tu created nuevo calendario o libreta - - - - - Ahora abre tu aplicación cliente para crear calendarios y/o libretas nuevos que usarán tu FreedomBox y servidor Radicale. El sitio web de Radicale proporciona una lista de clientes soportados pero no uses las URLs que se mencionan allí; sigue este manual porque FreedomBox usa otra configuración. A continuación se muestran los pasos para 2 ejemplos: - - - Ejemplo de configuración con el cliente Evolution: - - - Calendario - - - Crea un calendario nuevo - - - Selecciona el "Tipo" "CalDAV" - - - Con "CalDAV" seleccionado aparecerán más opciones en el cuadro de diálogo. - - - URL: https://<dirección_IP_o_dominio_de_tu_servidor>/radicale/<usuario>/<nombre_del_calendario>.ics/ cambiando los elementos marcados entre <> de acuerdo a tu configuración. - - - nota: la / inicial de la ruta es importante. - - - - - Habilita "Usar una conexión segura." - - - Nombre del calendario - - - - - - - Radicale-Evolution-Docu.png - - - - - - - - Lista de tareas: Añadir una lista de tareas es prácticamente igual que con un calendario. - - - Contactos - - - Sigue los mismos pasos anteriores reemplazando CalDAV por WebDAV y la extensión de la libreta por .vcf. - - - - - - -
-
- Sincronizar via Tor - Configurar un calendario en FreedomBox con Radicale sobre Tor es lo mismo que sobre la red en claro, en resumen: - - - Cuando hayas ingresado al interfaz web de FreedomBox desde Tor haz clic en Radicale e introduce un usuario de tu FreedomBox y su contraseña. - - - Ingresa en el interfaz web de Radicale usando el usuario de tu FreedomBox y su contraseña. - - - Haz clic en "Crear libreta o calendario nuevo", proporciona un título, selecciona un tipo y haz clic en "Crear". - - - Anota la URL, p.ej. https://<direccion_onion_de_tu_servidor>.onion/radicale/<usuario>/<código_del_calendario>/ cambiando los elementos marcados entre <> de acuerdo a tu configuración. - - - Estas instrucciones son para Thunderbird/Lightning. Nota: necesitarás estar conectado a Tor con el Tor Browser Bundle. - - - Abre Thunderbird, la extensión (add-on) Torbirdy y reinicia Thunderbird. (Quizá no haga falta.) - - - En el interfaz Lightning, en el panel izquierdo bajo Calendario haz clic con el botón derecho del ratón y selecciona "Nuevo calendario". - - - Selecciona "En la red" como localización de tu calendario. - - - Selecciona "CalDAV" copia la URL, p.ej., https://<direccion_onion_de_tu_servidor>.onion/radicale/<usuario>/<código_del_calendario>/. como localización cambiando los elementos marcados entre <> de acuerdo a tu configuración. - - - Proporciona un nombre, etc. Haz clic en "Siguiente". Tu calendario está ahora sincronizando con tu FreedomBox a través de Tor. - - - Si no has generado un certificado con "Let's Encrypt" para tu FreedomBox quizá necesites seleccionar "Confirmar Excepción de Seguridad" cuando se te indique. - - -
-
- Sincronizar con tu teléfono Android - Hay varias Apps que admiten integración con el servidor Radicale. Este ejemplo usa DAVx5, que está disponible p.ej. en F-Droid. Si también quieres usar listas de tareas hay que instalar primero la app compatible OpenTasks. - Sigue estos pasos para configurar tu cuanta con el servidor Radicale de tu FreedomBox. - - - Instala DAVx5. - - - Crea una cuenta nueva en DAVx5 haciendo clic en el botón flotante [+]. - - - Selecciona la 2ª opción como se muestra en la primera imagen más abajo e introduce la URL base (no olvides la / del final). DAVx5 averiguará las cuentas CalDAV y WebDAV del usuario. - - - Sigue este video del FAQ de DAVx5 para aprender cómo importar tus contactos existentes a Radicale. - - - - Sincronizar contactos - - - - Haz clic en los menús de hamburguesa de CalDAV y CardDAV y selecciona "Refrescar ..." en caso de cuentas existentes o "Crear ..." en caso de cuentas nuevas (ver la 2ª captura de pantalla más abajo). - - - Marca las cajas de las libretas y/o contactos que quieras sincronizar y haz clic en el botón de sincronización de la cabecera. (ver la 3ª captura de pantalla más abajo) - - - - - - - - - DAVx5 account setup - - - - - - - - DAVx5 refresh - - - - - - - - DAVx5 account sync - - - -
-
- Usuarios Avanzados -
- Compartir recursos - Arriba se mostrá una manera fácil de crear un recurso para un grupo de gente creando una cuenta dedicada común. Aquí de describe un método alternativo con el que se otorga acceso a un calendario a 2 usuarios Usuario1 y Usuario2. Esto requiere acceso por SSH a la FreedomBox. - - - crea un archivo /etc/radicale/rights - - - - - - [calendario_de_mis_amigos] es solo un identificador, puede ser cualquier nombre. - - - La sección [owner-write] asegura que los dueños tengan acceso a sus propios archivos. - - - - - Edita el archivo /etc/radicale/config y haz los siguientes cambios en la sección [rights] - - - - - - - - Reinicia el servidor Radicale o la FreedomBox - - -
-
- Importar archivos - Si estás usando un archivo de contactos exportado desde otro servicio o aplicación hay que copiarlo a: /var/lib/radicale/collections/<usuario>/<nombre_del_archivo_de_contactos>'.vcf. -
-
-
- Migrar desde Radicale versión 1.x a versión 2.x - En Febrero de 2019 se actualizó Radicale en las versiones "en pruebas" (testing) de Debian desde la versión 1.x a la 2.x. La versión 2.x es mejor pero incompatible con los datos y la configuración empleados en la 1.x. El mecanismo automático de actualización de FreedomBox que emplean las actualizaciones desatendidas no actualiza automaticamente la version 2.x de Radicale debido a cambios en los archivos de configuración. No obstante la version 19.1 de FreedomBox, disponible en en las versiones "en pruebas" (testing) desde el 23 de Febrero de 2019, realizará la migración de los datos y la configuración a la versión 2.x de Radicale. No se requiere ninguna acción por parte de los usuarios típicos. Ocurrirá automáticamente. - Si por algún motivo necesitas ejecutar a mano apt dist-upgrade en tu máquina Radicale se actualizará a 2.x y entonces tu FreedomBox no podrá ejecutar esta actualización (ya que el proyecto de origen decidió eliminar las herramientas de migración de la versión 2.x de Radicale). Para evitar esta situación se recomienda el siguiente procedimiento para actualizar. - - En cualquier caso, si ya has actualizado a Radicale 2.x sin ayuda de FreedomBox necesitas realizar la migración de los datos y la configuración por tí mismo. Sigue este procedimiento: - - Notas: - - - python-radicale es un paquete antigüo de la versión 1.x de Radicale que sigue disponible en las versiones "en pruebas" (testing) de Debian. Esto es un hack alternativo para emplear la funcionalidad --export-storage que es responsable de la migración de datos. Por desgracia esta funcionalidad ya no está disponible en Radicale 2.x. - - - Los ficheros que acaban en .dpkg-dist solo existirán si has elegido "Conservar tu versión actualmente instalada" cuando se te preguntó durante la actualización a Radicale 2.x. El procedimiento anterior sobrescribirá la configuración antigüa con una nueva. No se necesitan cambios a los 2 ficheros de configuración salvo que hayas cambiado la preferencia de compartición de calendario. - - - Nota: Durante la migración tus datos permanecen a salvo en el directorio /var/lib/radicale/collections. Los datos nuevos se crearán y usarán en el directorio /var/lib/radicale/collections/collections-root/. - - - El comando tar hace una copia de seguridad de tu configuración y tus datos en /root/radicale_backup.tgz por si haces o algo va mal y quieres deshacer los cambios. - - -
-
- Resolución de Problemas - 1. Si estás usando FreedomBox Pioneer Edition o instalando FreedomBox sobre Debian Buster Radicale podría no estar operativo inmediatamente después de la instalación. Esto se debe a un defecto ya corregido posteriormente. Para superar el problema actualiza FreedomBox haciendo clic en 'Actualización Manual' desde la app 'Actualizaciones'. Otra opción es simplemente esperar un par de días y dejar que FreedomBox se actualice solo. Después instala Radicale. Si Radicale ya está instalado deshabilitalo y rehabilitalo después de que se complete la actualización. Esto arreglará el problema y dejará a Radicale trabajando correctamente. -
-
-
- Repro (Servidor SIP) - - - App eliminada - - Repro ha sido eliminada de Debian 10 (Buster) y por tanto ya no está disponible en FreedomBox. - -
-
- Roundcube (Cliente de Correo Electrónico (Email)) - - - - - - - - - - - - - icono de Roundcube - - - - - - - - - Disponible desde: versión 0.5 -
- ¿Qué es Roundcube? - Roundcube es un cliente de correo electrónico (email) para navegador con un interfaz de usuario parecido a una aplicación de escritorio. Admite varios lenguajes. Roundcube usa el protocolo de acceso a mensajes de Internet (IMAP = Internet Message Access Protocol) para acceder a los correos en un servidor remoto. Soporta MIME para enviar archivos adjuntos y en particular proporciona libreta de contactos, gestión de carpetas, búsquedas de mensajes y verificación ortográfica. -
-
- Usar Roundcube - Tras instalar Roundcube se puede acceder a él en https://<tu_freedombox>/roundcube. Introduce tu usuario y contraseña. El usuario de muchos servicios de correo electrónico suele ser la propia dirección completa, como usuario_de_ejemplo@servicio_de_ejemplo.org, no solo el usuario usuario_de_ejemplo. Introduce la dirección del servidor IMAP de tu servicio de correo electrónico en el campo Servidor. Puedes probar a poner aquí tu nombre de dominio como servicio_de_ejemplo.org si la dirección es usuario_de_ejemplo@servicio_de_ejemplo.org y si esto no funciona consulta la dirección del servidor IMAP en la documentación de tu proveedor de correo electrónico. Se recomienda encarecidamente usar una conexión cifrada a tu servidor IMAP. Para ello inserta el prefijo "imaps://" al principio de la dirección del servidor IMAP. Por ejemplo, imaps://imap.servicio_de_ejemplo.org. - - - - - - - Logging into your IMAP server - - - -
-
- Usar Gmail con Roundcube - Si quieres usar Roundcube con tu cuenta Gmail necesitas habilitar primero el ingreso con contraseña en las preferencias de tu cuenta Google porque Gmail no va a permitir por defecto que ingresen aplicaciones mediante contraseña. Para hacerlo visita las preferencias de la Cuenta Google y habilita Apps Menos seguras. A continuación ingresa en Roundcube introduciendo tu dirección de Gmail como Usuario y tu contraseña. En el campo servidor pon imaps://imap.gmail.com. - - - - - - - Logging into Gmail - - - -
-
-
- Samba (Almacenamiento de Ficheros en Red) - - - - - - - - - - - - - icono de Samba - - - - - - - - - Disponible desde: versión 19.22 - Samba te permite tener una carpeta compartida en la red local que se puede usar desde multiples ordenadores con sistemas operativos diferentes. De ahora en adelante nos referiremos a estas carpetas como "shares". Puedes tener una carpeta personal compartida por tus propios dispositivos (share casero), una compartida con un grupo de confianza (share de grupo) o una compartida con todo dispositivo de la red (share abierto). - Samba te permite tratar un share como si fueran carpetas locales de tu ordenador. No obstante los shares solo están disponibles en la red local. - Para aprender más acerca de Samba, mira la documentación de usuario de su wiki. -
- Usar Samba - Tras la instalación, puedes elegir qué discos compartir. Los shares habilitados están accesibles en el administrador de archivos de tu ordenador en la ruta \\freedombox (en Windows) o smb://freedombox.local (en Linux y Mac). Hay 3 tipos de share para elegir: - - - Share abierto - accesible a cualquiera en tu red local. - - - Share de grupo - accesible solo a usuarios FreedomBox que estén en el grupo freedombox-share. - - - Share casero - cada usuario del grupo freedombox-share puede tener su propio espacio privado. - - -
- En Android - Para acceder a shares Samba desde un dispositivo Android instala el "Cliente Samba para Android" desde F-Droid o Google Play. Introduce smb://freedombox.local/<disco> como ruta del share en la app. Tus carpetas compartidas deberían estar visibles en la app de administración de archivos. También VLC para Android puede detectar automáticamente y usar los shares Samba. -
-
-
- Integración con otras apps - La app Transmission de FreedomBox proporciona una configuración para permitir que las descargas se graben directamente en un share Samba. - Si quieres dejar disponibles en Samba ficheros sincronizados con Syncthing tienes que asegurarte de sincronizar en la carpeta compartida de Samba. Además, para dejar las carpetas de Syncthing disponibles en carpetas abiertas o de grupo de Samba necesitas asegurarte de pulsar el botón "Permisos > Ignorar" bajo la pestaña "Avanzado" de la carpeta en el interfaz web de usuario de Syncthing. Esto permitirá escribir los ficheros mediante Samba. -
-
- Comparación con otras apps -
- Syncthing - Syncthing mantiene una copia de la carpeta compartida en cada dispositivo con el que se comparte. Samba mantiene solo una copy en tu dispositivo FreedomBox. - Syncthing puede sincronizar tus carpetas compartidas entre dispositivos por Internet. Los shares Samba solo están disponibles en tu red local. - Como Syncthing es primordialmente una solución de sincronización, tiene funcionalidades como resolución de conflictos y versionado. Samba solo tiene una copia del fichero, así que no necesita tales funcionalidades. Por ejemplo, si dos personas están editando una hoja de cálculo almacenada en un share Samba el último que grabe el fichero gana. -
-
-
-
- Searx (Búsqueda Web) - - - - - - - - - - - - - icono de Searx - - - - - - - - - Disponible desde: versión 0.24.0 -
- Acerca de Searx - Searx es un metabuscador. Un metabuscador agrega los resultados de varios buscadores y los presenta en un interfaz unificado. - Lee más acerca de Searx en su sitio web oficial. -
-
- Captura de pantalla - - - - - - - Searx Screenshot - - - -
-
- Vídeo - Searx installation and first steps (14 MB) -
-
- ¿Por qué usar Searx? -
- Personalización y Burbujas por Filtrado - Los buscadores tienen la capacidad de perfilar a sus usuarios y les sirven los resultados más relevantes para ellos, encerrandoles en burbujas por filtrado y distorsionando la visión que la gente tiene del mundo. Los buscadores tienen un incentivo financiero para servir publicidad interesante a sus usuarios, ya que incrementa la probabilidad de que hagan clic en los anuncios. - Un metabuscador es una solución posible a este problema, ya que agrega resultados de multiples buscadores puenteando así los intentos de personalización de los buscadores. - Searx evita almacenar cookies de buscadores para eludir traceos y perfilados de buscadores. -
-
- Filtrado de publicidad - Searx filtra anuncios de los resultados de búsqueda antes de servirlos al usuario, con lo que mejora la relevancia de tus resultados y te evita distracciones. -
-
- Privacidad - Searx usa por defecto HTTP POST en vez de GET para enviar tus consultas de búsqueda a los buscadores, así que si alguien espía tu tráfico no podrá leerlas. Tampoco se almacenarán las consultas en el histórico de tu navegador. - Nota: Searx usado desde la barra (omnibar) del navegador Chrome hará peticiones GET en vez de POST. -
-
-
- Searx en FreedomBox - - - En FreedomBox Searx usa las credenciales únicas de Single Sign On. Esto implica que tienes que haber ingresado en tu FreedomBox con el navegador en el que estás usando Searx. - - - Se puede acceder fácilmente a SearX a través de Tor. - - - Se puede añadir a Searx a la barra de buscadores del navegador Firefox. Mira la Ayuda de Firefox acerca de este asunto. Una vez esté Searx añadido también podrás establecerlo como tu buscador por defecto. - - - Searx también ofrece resultados de búsqueda en formatos csv, json y rss, que se pueden usar desde scripts para automatizar algunas tareas. - - -
-
-
- Shadowsocks (Proxy SOCKS5) - - - - - - - - - - - - - icono de Shadowsocks - - - - - - - - - Disponible desde: versión 0.18.0 -
- ¿Qué es Shadowsocks? - Shadowsocks es un proxy SOCKS5 ligero y seguro, diseñado para proteger tu tráfico Internet. Se puede usar para eludir la censura y los filtros de Internet. Tu FreedomBox puede ejecutar un cliente Shadowsocks que puede conectar con un servidor Shadowsocks. También ejecutará un proxy SOCKS5. Los dispositivos locales pueden conectar con este proxy y sus datos serán cifrados y retransmitidos a través del sevidor Shadowsocks. - Nota: Shadowsocks está disponible en FreedomBox a partir de la versión 0.18. -
-
- Usar el cliente Shadowsocks - La implementación actual de Shadowsocks en FreedomBox solo soporta configurar FreedomBox como cliente Shadowsocks. Este caso de uso sería así: - - - El client de Shadowsocks (FreedomBox) está en una región en la que partes de Internet están bloqueadas o censuradas. - - - El servidor de Shadowsocks está en una región diferente que no tiene esos bloqueos. - - - FreedomBox proporciona un servicio de proxy SOCKS en la red local para que otros dispositivos hagan uso de la conexión Shadowsocks. - - - En el futuro será posible configurar FreedomBox como servidor Shadowsocks. -
-
- Configurar tu FreedomBox para el cliente Shadowsocks - Para habilitar Shadowsocks primero navega a la página Proxy Socks5 (Shadowsocks) e instalalo. - Servidor: el servidor Shadowsocks no es la IP o la URL de FreedomBox, sino que será otro servidor o VPS configurado como tal (servidor Shadowsocks). También hay algunos servidores Shadowsocks públicos listados en la web, pero sé consciente de que quienquiera que opere el servidor puede ver a dónde van las peticiones y cualquier dato no cifrado que se transmita. - Para usar Shadowsocks una vez instalado configura la URL del proxy SOCKS5 en tu dispositivo, navegador o aplicación como http://<tu_freedombox>:1080/. -
-
-
- Sharing (Publicación de Archivos) - - - - - - - - - - - - - Sharing icon - - - - - - - - - Disponible desde: versión 0.25 -
- ¿Qué es la app Sharing? - Sharing es una aplicación que te permite compartir contenido via web. El contenido compartido pueden ser archivos individuales o directorios completos. - El contenido se puede compartir públicamente o restringido a usuarios de una lista de grupos autorizados. Los usuarios autorizados podrán acceder al contenido compartido desde su navegador web en https://tu_freedombox/share/nombre_del_contenido. Los usuarios que no pertenezcan a ninguno de los grupos autorizados no verán ni accederán al contenido mediante este mecanismo. -
-
- Editando comparticiones - Para que los usuarios accedan al contenido mediante su navegador debe existir y tener una compartición. Una compartición es una entrada en la aplicación Sharing que relaciona: - - - El Nombre (y por tanto la URL) que usarán los usuarios para solicitar el contenido, - - - el Ruta de acceso al contenido a servir y - - - el modo de compartición. Si es restringido, también contendrá la lista de grupos autorizados. - - - En el mismo servidor pueden coexistir múltiples comparticiones. - Sólo los administradores pueden crear, editar o eliminar comparticiones. Encontrarán la aplicación Sharing en la sección Aplicacions del interfaz web de FreedomBox. La aplicación Sharing es una aplicación web fácil de usar y con un interfaz evidente. - Cada compartición tiene su priopio ajuste de modo de compartición (pública o restrigida). Sólo los grupos que reconoce el servicio FreedomBox se pueden combinar en la lista de grupos autorizados. La aplicación Sharing no ofrecerá los grupos creados en el interfaz de línea de órdenes. -
-
- Provisionar/actualizar el contenido - El contenido se puede crear antes o después de crear la compartición y se pueden actualizar independientemente. - No hay que ser administrador para provisionar el contenido. Cualquier usuario con acceso de escritura en la ruta de acceso a la compartición puede crearlo o actualizarlo. - Varias comparticiones podrían apuntar al mismo contenido. - Si eres usuario de FreedomBox y tu administrador se niega a crearte comparticiones, y no necesitas restringir el acceso a tu contenido, todavía puedes recurrir al mecanismo de Sitios web de Usuario o a las redes entre pares (P2P) (Deluge o Transmission para Torrent, o MLDonkey) para publicar tus archivos. -
-
- Tecnicismos - Sharing compartirá el contenido usando el servidor web Apache que viene de serie. -
-
-
- Syncthing (Sincronización de Archivos) - - - - - - - - - - - - - icono de Syncthing - - - - - - - - - Disponible desde: versión 0.14.0 - Con Syncthing instalado en tu FreedomBox puedes sincronizar contenido desde otros dispositivos a tu FreedomBox y vice-versa. Por ejemplo puedes mantener sincronizadas las fotos tomadas desde tu teléfono móvil con tu FreedomBox. - Syncthing es una solución de sincronización entre pares, no una de tipo cliente-servidor. Esto implica que FreedomBox no es realmente el servidor y tus otros dispositivos no son sus clientes. Desde la perspectiva de Syncthing todos son dispositivos equivalentes. Puedes emplear Syncthing para sincronizar tus archivos entre cualquiera de tus dispositivos. La ventaja que aporta FreedomBox consiste en que como es un servidor está encendida (casi) siempre. Supón que quieres sincronizar las fotos de tu teléfono con tu portátil. Si sincronizas tu teléfono con FreedomBox el portátil podrá obtenerlas desde la FreedomBox cuando vuelva a conectarse. No necesitas preocuparte de cuando se conectan los otros dispositivos. Si tu FreedomBox es uno de los dispositivos configurados con la carpeta compartida de Syncthing puedes estár tranquilo que tus otros dispositivos se sincronizarán en cuanto se conecten. - Tras instalarlo sigue estas instrucciones del proyecto Syncthing: Arrancando. - Syncthing permite compartir selectivamente carpetas individuales. Antes de compartir los dispositivos tienen que estar emparejados leyendo códigos QR o introduciendo manualmente identificadores de dispositivo. Syncthing tiene un servicio de autodescubrimiento para identicar fácilmente a los otros dispositivos de la misma subred que tengan Syncthing instalado. - Para acceder al cliente web de la instancia Syncthing que se ejecuta en tu FreedomBox, usa la ruta /syncthing. Actualmente este cliente web está accesible solo a los usuarios de FreedomBox que tengan privilegios de administrador aunque en alguna futura versión podría estarlo a todos los usuarios de FreedomBox. - - - - - - - Syncthing web interface - - - - Syncthing tiene apps Android disponibles en F-Droid y Google Play. También hay disponibles aplicaciones de escritorio multiplataforma. - Para más información acerca de Syncthing visita su sitio web oficial y su documentación. -
- Sincronizar via Tor - Syncthing debe sincronizar automáticamente con tu FreedomBox incluso cuando esta solo sea accesible como servicio Tor Onion. - Si quieres enrutar tu cliente Syncthing via Tor configura la variable de entorno all_proxy: - - Para más información mira la documentación de Syncthing acerca de el uso de proxies. -
-
- Evitar repetidores de Syncthing - Syncthing emplea por defecto conexiones dinámicas para conectar con otros pares. Esto significa que si estás sincronizando a través de Internet, los datos quizá tengan que atravesar repetidores de Syncthing públicos para alcanzar tus dispositivos. Esto desaprovecha que tu FreedomBox tenga una dirección IP pública. - Al añadir tu FreedomBox como dispositivo en otros clientes de Syncthing establece tu dirección como "tcp://<mi.dominio.freedombox>" en vez de "dinámica". Esto permite a tus pares Syncthing conectarse diréctamente a tu FreedomBox eludiendo la necesidad de repetidores. También permite sincronización rápida bajo demanda si no quieres mantener a Syncthing ejecuándose todo el tiempo en tus dispositivos móviles. -
-
- Usar Syncthing con otras aplicaciones -
- Administrador de contraseñas - Los administradores de contraseñas que almacenan sus bases de datos en ficheros son susceptibles de sincronizarse usando Syncthing. El siguiente ejemplo describe el uso de un administrador de contraseñas libre llamado KeePassXC en combinación con Syncthing para servir como remplazo para administradores de contraseñas privativos que almacenan tus contraseñas en la nube. - KeePassXC almacena usuarios, contraseñas, etc en ficheros con la extensión .kdbx. Estos ficheros .kdbx se pueden almacenar en una carpeta compartida Syncthing para mantenerlos sincronizados en multiples máquinas. Hay disponibles, tanto para escritorio como para dispositivos móviles, aplicaciones de software libre que pueden leer este formato de fichero. Habitualmente sólo tienes que apuntar la aplicación al fichero .kdbx e introducir la contraseña maestra para acceder a tus credenciales almacenadas. Por ejemplo, el mismo fichero .kdbx se puede consultar empleando KeePassXC en el escritorio y KeePassDX en Android. Instalando una extensión se puede usar también KeePassXC para rellenar credenciales en los campos de ingreso (login) en el navegador. -
-
-
-
- Tiny Tiny RSS (Lector de Feeds de Noticias) - - - - - - - - - - - - - Tiny Tiny RSS icon - - - - - - - - - Disponible desde: versión 0.9 - Tiny Tiny RSS es un lector y agregador de feeds de noticias (RSS/Atom) diseñado para leer noticias desde cualquier lugar con una experiencia lo más parecida posible a una aplicación de escritorio. - Cualquier usuario creado mediante el interfaz web de FreedomBox podrá ingresar y usar esta app. Cada usuario tiene sus propios feeds, estado y preferencias. -
- Usar el interfaz web - Cuando esté habilitado Tiny Tiny RSS estará disponible en la ruta /tt-rss del servidor web. Cualquier usuario creado mediante FreedomBox podrá ingresar y usar esta app. - - - - - - - Tiny Tiny RSS - - - -
- Añadir un nuevo feed - 1. Ve a la página cuyo feed quieras y copia su enlace RSS/Atom feed. - - - - - - - Selecting feeds - - - - 2. Selecciona "Subscribirse al feed.." en el desplegable Acciones. - - - - - - - Subscribe to feed - - - - 3. Pega la URL que has copiado en el diálogo que aparece y pulsa el botón Subscribirse. - - - - - - - Subscription dialog box - - - - Dale un minuto a la aplicación para obtener los feeds. - En algunos sitios web el botón de feeds RSS no está claramente visible. En tal caso simplemente pega la URL del sitio web en el diálogo Subscribirse y deja que TT-RSS detecte automáticamente los feeds RSS que haya en la página. - Puedes probarlo ahora con la página principal de WikiNews - Como puedes ver en la imagen seguiente TT-RSS ha detectado y añadido el feed Atom de WikiNews a nuestra lista de feeds. - - - - - - - WikiNews feed added - - - - Si no quieres conservar este feed haz clic con el botón derecho del ratón en el feed de la imagen anterior, selecciona Editar feed y dale a Desubscribir en el diálogo que aparece. - - - - - - - Unsubscribe from a feed - - - -
-
- Importar tus feeds desde otro lector - Encuentra en tu lector de feeds previo una opción para Exportar tus feeds a un fichero. Si tiene que elegir entre varios formatos elige OPML. Pongamos que tu fichero de feeds exportados se llama Subscriptions.opml - Haz click en la esquina superior izquierda el menú Acciones y selecciona Preferencias. Se te llevará a otra página. - En la cabecera superior selecciona la 2ª solapa llamada Feeds. Tiene varias secciones y la 2ª se llama OPML. Selecciónala. - - - - - - - OPML feeds page - - - - Para importar tu fichero Subscriptions.opml a TT-RSS, - - - Haz clic en Examinar... y selecciona el fichero en tu sistema de archivos. - - - Haz clic en Importar mi OPML - - - Tras importar se te llevará a la sección Feeds que está en la página encima de la de OPML. Puedes ver que los feeds del lector previo figuran ahora importados en Tiny Tiny RSS. Ahora puedes empezar a usar Tiny Tiny RSS como tu lector principal. -
-
-
- Usar la app móvil - La app oficial para Android del proyecto Tiny Tiny RSS funciona con el servidor Tiny Tiny RSS de FreedomBox. Se sabe que la aplicación anterior TTRSS-Reader no funciona. - Desafortunadamente la app oficial para Android solo está disponible en la Play Store de Google y no en F-Droid. Todavía puedes obtener el código fuente y compilar el fichero apk por tu cuenta. - Para configurarla, primero instálala y entonces en la página de configuración pon como URL. Pon tu usuario y contraseña en los detalles del Login así como los detalles de Autenticación HTTP. Si tu FreedomBox no tiene un certificado HTTPS válido configuralo para que admita cualquier certificado SSL y cualquier servidor. - - - - - - - Tiny Tiny RSS - - - - - - - - Tiny Tiny RSS - - - - - - - - Tiny Tiny RSS - - - - - - - - Tiny Tiny RSS - - - - - - - - Tiny Tiny RSS - - - -
-
-
- Tor (Red para el anonimato) - - - - - - - - - - - - - icono de Tor - - - - - - - - - Disponible desde: versión 0.3 -
- ¿Qué es Tor? - Tor es una red de servidores operada por voluntarios. Permite a los usuarios de esos servidores mejorar su privacidad y seguridad cuando navegan por Internet. Tu y tus amigos podéis acceder a tu FreedomBox a través de la red Tor sin revelar su dirección IP. Activando la aplicación Tor en tu FreedomBox podrás ofrecer servicios remotos (chat, wiki, file sharing, etc...) sin mostrar tu localización. Esta aplicación te dará una protección mejor que un servidor web público porque estarás menos expuesto a gente intrusiva. -
-
- Usar Tor para navegación anónima - Tor Browser es la manera recomendada para navegar la web a través de Tor. Puedes descargar Tor Browser desde y seguir sus instrucciones para instalarlo y ejecutarlo. -
-
- Usar Servicio Tor Onion para acceder a tu FreedomBox - El Servicio Tor Onion proporciona una manera de acceder a tu FreedomBox incluso aunque esté detrás de un router, cortafuegos, o redirector NAT (p.ej. si tu proveedor de Internet no proporciona una dirección pública IPv4 para tu router). Para habilitar el Servicio Tor Onion primero navega a la página Red para el anónimato (Tor). (Si no la ves haz clic en el logo de FreedomBox de arriba a la izquierda de la página y ve a la página principal de Apps.) En la página Red para el anónimato (Tor), bajo Configuración, habilita la caja Habilitar los Servicios Tor Onion y pulsa el botón de Actualizar configuración. Tor se reconfigurará y se reiniciará. - Transcurrido un rato la página se refrescará bajo Estado verás la tabla que lista la dirección .onion del servicio. Copia toda la dirección (que termina en .onion) y pégala en el campo dirección de Tor Browser. Deberías poder acceder a tu FreedomBox. (Quizá veas un aviso de certificado porque FreedomBox tiene un certificado autofirmado.) - - - - - - - Tor Configuration - FreedomBox - - - - - - Onion - - - Actualmente solo HTTP (puerto 80), HTTPS (puerto 443) y SSH (puerto 22) están accesibles a través del Servicio Tor Onion configurado en la FreedomBox. -
-
- Apps accesibles via Tor - Las siguientes apps se pueden acceder a través de Tor. Esta lista puede ser incompleta. - - - Calendario y Libreta de direcciones (Radicale) - - - Sincronización de ficheros (Syncthing) - - - Búsqueda Web (Searx) - - - Wiki (MediaWiki) - - - Wiki y Blog (Ikiwiki) - - -
-
- Ejecutar un nodo Tor - Cuando se instala Tor se configura por defecto para ejecutarse como puente a la red (bridge relay). Esta opción se puede deshabilitar en la página de configuración de Tor de FreedomBox. - En la parte inferior de página de Tor de FreedomBox hay una lista de puertos que usa el puente a la red Tor. Si tu FreedomBox está detrás de un router necesitarás configurar la redirección de puertos de tu router para que estos puertos sean accesibles desde Internet. - Los requisitos para ejecutar un puente a la red se listan en la Tor Relay Guide. En resúmen, se - - - recomienda que un puente tenga disponibles para Tor al menos 16 Mbit/s (Mbps) de ancho de banda para subida y bajada. Mejor más. - - - requiere que a se le permita al puente usar un mínimo de 100 GByte de tráfico mensual de salida y de entrada. - - - recomienda que un nodo sin salida (mero reenrutador) de <40 Mbit/s tenga al menos 512 MB de RAM disponible; Uno más rápido de 40 Mbit/s debería tener al menos 1 GB de RAM. - - -
-
- Usar el puerto Tor SOCKS (avanzado) - FreedomBox proporciona un puerto Tor SOCKS al que pueden conectar otras aplicaciones para enrutar su tráfico a través de la red Tor. Este puerto es accesible a cualquier interfaz (de red) configurado en la zona interna del cortafuegos. Para configurar la aplicación apunta el Host SOCKS a la dirección IP interna de la conexión y pon el Puerto SOCKS a 9050. -
- Exjemplo con Firefox - Tu navegador web se puede configurar para emplear la red Tor para toda tu actividad de navegación. Esto permite eludir la censura y oculta tu dirección IP a los sitios web durante la navegación normal. Para anonimato se recomienda usar el Navegador Tor. - Configura tu dirección IP local de FreedomBox y el puerto 9050 como un proxy SOCKS en Firefox. Hay extensiones para facilitar la activación y desactivación del proxy. - - - - - - - Configuring Firefox with Tor SOCKS proxy - - - - Con en proxy SOCKS configurado puedes acceder cualquier URL de tipo onion diréctamente desde Firefox. FreedomBox tiene una dirección onion v3 propia a la que puedes conectarte por la red Tor (guárdala en tus favoritos para usarla en situaciones de emergencia). -
-
-
- Eludiendo la censura de Tor - Si tu proveedor de Internet (ISP) está tratando de bloquear el tráfico Tor puedes usar puentes (a la red Tor) para conectar (a la red Tor). - 1. Obtén la configuración de los puentes de Tor BridgeDB - - - - - - - Tor BridgeDB - - - - 2. Añade las líneas a la configuración de Tor de tu FreedomBox como se muestra. - - - - - - - Tor Configuration Page - - - -
-
-
- Transmission (Cliente web de BitTorrent) - - - - - - - - - - - - - Transmission icon - - - - - - - - - Disponible desde: versión 0.5 -
- ¿Qué es Transmission ? - BitTorrent es un protocolo de comunicaciones para compartir ficheros entre pares (P2P = peer-to-peer). No es anónimo; debes asumir que otros puedan ver qué ficheros estás comprtiendo. Hay 2 clientes web para BitTorrent disponibles en FreedomBox: Transmission y Deluge. Tienen funcionalidades similares pero quizá prefieras uno sobre otro. - Transmission es un cliente BitTorrent ligero, famoso por su simplicidad y una configuración por defecto que "símplemente funciona". -
-
- Captura de pantalla - - - - - - - Transmission Web Interface - - - -
-
- Usar Transmission - Tras instalar Transmission está accesible en https://<tu freedombox>/transmission. Transmission emplea el ingreso único de FreedomBox lo que significa que si has ingresado en tu FreedomBox puedes acceder diréctamente a Transmission sin tener que volver a introducir las credenciales. Si no, se te pedirá que ingreses primero y luego se te redirigirá a la app Transmission. -
-
- Consejos -
- Transferir Descargas desde la FreedomBox - - - Se puede añadir el directorio de descargas de Transmission como directorio compartido en la app "Compartir" y así acceder a tus descargas en este directorio compartido empleando un navegador web. - - - (Avanzado) Si tienes acceso SSH a tu FreedomBox puedes usar sftp para ver el directorio de descargas usando un gestor de archivos o un navegador apropiados (p.ej. dolphin o Konqueror). - - -
-
-
-
- Sitios Web de Usuario (User websites) -
- ¿Qué es User websites? - User websites es un módulo del servidor web Apache habilitado para permitir a los usuarios definidos en el sistema FreedomBox exponer un conjunto de archivos del sistema de ficheros de FreedomBox como sitio web a la red local y/o a internet de acuerdo a la configuración de la red y el cortafuegos. - - - - - - - - - Datos básicos de la aplicación - - - - - - Categoría - - - Compartición de archivos - - - - - Disponible desde la versión - - - 0.9.4 - - - - - Sitio web del proyecto original - - - - - - - - - - Documentación original de usuario - - - - - - - - - - -
-
- Captura de pantalla - - Añadir cuando/si se crea un interfaz para FreedomBox - -
-
- Usar User websites - El módulo está siempre activado y el interfaz web de FreedomBox no ofrece configuración ni página de estado para este módulo. Para servir documentos con el módulo solo se necesita poner los documentos en un subdirectorio designado /home/<un_usuario_de_plinth>/public_html. - User websites servirá los archivos que haya en este directorio cuando se reciban peticiones con la URI ~<un_usuario_de_freedombox>. Por tanto para un dominio ejemplo.org con un usuario pepe una petición ejemplo.org/~pepe/index.html transferirá el fichero /home/pepe/public_html/index.html. -
-
- Usar SFTP para crear public_html y subir archivos - - Pendiente de redactar - -
-
-
-
- Sistema -
- Actualizaciones de Software - FreedomBox puede instalar actualizaciones de seguridad automaticamente. Esta funcionalidad viene activada por defecto y no hace falta ninguna acción manual. Puedes activar las actualizaciones automaticas desde el interfaz web de FreedomBox en la página Actualización de la sección Sistema. Se recomienda encarecidamente que tengas esta opción habilitada para mantener tu FreedomBox segura. - Las actualizaciones se efectúan cada noche. Si quieres apagar tu FreedomBox cada día después de usarla, déjala ejecutando una noche a la semana más o menos para permitir que ocurran las actualizaciones automaticas. Otra posibilidad es ejecutar actualizaciones manuales como se describe más adelante. - Nota que una vez comiencen las actualizaciones podría llevarles mucho tiempo completarse. Durante el proceso de actualización (ya sea el automático nocturno o el manual), no podrás instalar aplicaciones desde el interfaz web de FreedomBox. - - - - - - - upgrades_es_v01.png - - - -
- ¿Cuando obtendré las últimas funcionalidades? - Aunque las actualizaciones se efectúan a diario por razones de seguridad, las últimas funcionalidades no se propagan a todos los usuarios. A continuación se explica cómo llegan las novedades a los usuarios de las diferentes versiones de Debian: - - - Usuarios de versiones estables: Esta categoria de usuarios incluye a los usuarios que compraron la FreedomBox Pioneer Edition, a los que instalaron FreedomBox sobre una distribución estable de Debian y a los que descargaron las imágenes estables desde freedombox.org. Como regla general a estos usuarios solo se les proporciona actualizaciones de seguridad de determinados paquetes. Cuando una release obtiene la confianza de los desarrolladores el propio servicio FreedomBox se actualiza, lo que supone una excepción a esta regla. Esto implica que las últimas funcionalidades de FreedomBox estarán disponibles para estos usuarios aunque no tán inmediata- o frecuentemente como para los usuarios de las versiones en pruebas (testing). Si una app sólo está disponible en la distribución en pruebas (testing) pero no en la estable la app aparecerá en el interfaz web pero no será instalable para los usuarios de la distribución estable. Algunas apps se actualizan en excepción a la regla de "solo actualizaciones de seguridad" cuando la app esté seriamente rota por algún motivo. Debian libera cada bienio una entrega (release) con las últimas versiones estables de cada paquete de software y los desarrolladores de FreedomBox intentarán actualizar a estos usuarios a la nueva entrega (release) sin necesidad de intervención manual. - - - Usuarios de versiones en pruebas: Esta categoria de usuarios incluye a los usuarios que instalaron FreedomBox sobre una distribución en pruebas (testing) y a los que descargaron las imágenes en pruebas (testing) desde freedombox.org. Estos usuarios asumen la posibilidad de afrontar disrupciones ocasionales en los servicios e incluso tener que intervenir manualmente para arreglarlas. Como regla general estos usuarios reciben las últimas funcionalidades y actualizaciones de seguridad para todos los paquetes instalados. Cada quincena se libera una nueva versión de FreedomBox con todas las últimas funcionalidades y correcciones. Estas versiones llegan a los usuarios de la distribución en pruebas (testing) aproximadamente 2 o 3 días después de la liberación. - - - Usuarios de versiones inestables: Esta categoria de usuarios incluye a los usuarios que instalaron FreedomBox sobre una distribución inestable y a los que descargaron las imágenes inestables desde freedombox.org. Estos usuarios asumen la probabilidad de afrontar disrupciones en los servicios y tener que intervenir manualmente para arreglarlas. Como regla general estos usuarios reciben las últimas funcionalidades y actualizaciones de seguridad para todos los paquetes instalados. Cada quincena se libera una nueva versión de FreedomBox con todas las últimas funcionalidades y correcciones. Estas versiones llegan a los usuarios de la distribución inestable el mismo día de la liberación. Solo los desarrolladores, probadores y contribuyentes al proyecto FreedomBox debieran emplear la distribution inestable. Se advierte y exhorta a los usuarios finales de que no la usen. - - -
-
- Actualizaciones Manuales desde el Terminal - Algunos paquetes de software podrían requerir intervención manual para actualizarlos, generalmente por razones de configuración. En tales casos FreedomBox se actualiza a sí mismo y solicita información nueva necesaria para la actualización del paquete. Después de autoactualizarse FreedomBox actúa en nombre del usuario y actualiza los paquetes con la información recabada. Estos paquetes no se deben actualizar manualmente hasta que FreedomBox tenga la posibilidad de actualizarlos. La actualización que se dispara manualmente desde el interfaz web ya es consciente de estos paquetes y no los actualiza. - En situaciones muy extrañas, FreedomBox podría fallar o quedar a expensas de una intervención manual desde el terminal. Para esto, entra a FreedomBox por un terminal, ya sea físico, web (empleando Cockpit) o mediante SSH (ver sección Shell Segura) y ejecuta los siguientes comandos: - -# dpkg --configure -a -# apt update -# apt -f install -# unattended-upgrade --debug -# apt install freedombox -# apt update]]> - Si apt-get update te pide confirmación para algo responde que Sí. Si durante la actualización del paquete freedombox te pregunta acerca de los archivos de configuración responde que instale los archivos de configuración nuevos que vienen con la última versión del paquete. Este proceso solo actualizará los paquetes que no necesitan preguntar (excepto el paquete freedombox). Después, deja que FreedomBox se encargue de la actualización de los demás paquetes. Sé paciente mientras se crean nuevas versiones de FreedomBox para tratar los paquetes que necesitan intervención manual. - Si quieres ir más allá de la recomendación e instalar todos los paquetes en tu FreedomBox y realmente estás muy seguro de poder tratar los cambios de configuración de paquetes por tí mismo, ejecuta el siguiente comando: - -
-
-
- Almacenamiento - Almacenamiento te permite ver los dispositivos de almacenamiento conectados a tu FreedomBox y el uso de su espacio. - FreedomBox puede detectar y montar automáticamente medios extraíbles como unidades flash USB. Se muestran listados bajo la sección Dispositivos extraíbles junto con una opción para expulsarlos. - Si queda espacio libre detrás de la partición de root, se mostrará también la opción para expandirla. Normalmente no se muestra ya que en el primer arranque de la FreedomBox se produce automáticamente una expansión total de la partición de root. - - - - - - - Storage.png - - - -
- Operación de almacenamiento avanzada - Cockpit proporciona muchas funcionalidades de almacenamiento más avanzadas que las de FreedomBox. Ambos, FreedomBox y Cockpit, operan sobre el demonio de almacenamiento Udisks2 y son por ello compatibles entre sí. Entre las funciones proporcionadas por Cockpit se incluyen: - - - Formatear un disco o partición con un nuevo sistema de ficheros. - - - Añadir, eliminar particiones o borrar la tabla de particiones. - - - Crear y desbloquear sistemas de ficheros cifrados. - - - Crear y administrar dispositivos RAID. - - - - - - - - - storage-cockpit.png - - - -
-
-
- Almacén de instantáneas - Las Instantáneas te permiten crear instantáneas del sistema de archivos y devolver al sistema a un estado anterior. - - - Nota: Esta funcionalidad requiere un sistema de archivos Btrfs. Todas las imágenes de disco de FreedomBox estables usan Btrfs. - - - - - - - - - Instantáneas - - - -
-
- Apagado - Power proporciona un modo fácil de reiniciar o apagar tu FreedomBox. Después de seleccionar "Reiniciar" o "Apagar", se te pedirá confirmación. - Se puede llegar también a las opciones "Reiniciar" y "Apagar" desde el menú desplegable del usuario en la esquina superior derecha. -
-
- BIND (Servidor de Nombre de Dominio) - BIND te permite publicar en Internet tu información de Sistema de Nombre de Dominio (DNS) y resolver consultas DNS de los dispositivos de usuario en tu red. - Actualmente en FreedomBox BIND solo se usa para resolver consultas DNS de otras máquinas en tu red local. También es incompatible con compartir conexiones a Internet de tu FreedomBox. - Nota: Este servicio solo está disponible en redes configuradas como zona "interna". Tampoco está disponble a través de OpenVPN (es incompatible). -
-
- Cliente de DNS Dinamico -
- ¿Qué es DNS Dinamico? - Para que se pueda llegar a un servidor desde Internet este necesita tener una dirección pública permanente, también conocida como dirección IP estática o fija. Muchos proveedores de servicio de Internet no otorgan IP fija a sus usuarios normales o la cobran. En su lugar les otorgan una IP temporal diferente cada vez que el usuario se conecta a internet. O una que cambia de vez en cuando. Si es tu caso los clientes que quieran contactar con tu servidor tendrán dificultades. - Los proveedores de servicio de DNS Dinamico ayudan a solventar este problema. Primero te dan un nombre de dominio, como 'miservidor.ejemplo.org' y te permiten asociar tu dirección IP temporal a este nombre de dominio cada vez que esta cambia. De este modo quien quiera llegar a tu servidor empleará el nombre de dominio 'miservidor.ejemplo.org' que siempre apuntará a la última dirección IP de tu servidor. - Para que esto funcione cada vez que te conectes a Internet tendrás que decirle a tu proveedor de servicio de DNS Dinamico cual es tu dirección IP provisional actual. Por esto necesitas tener un software especial en tu servidor que haga esto. La funcionalidad DNS Dinamico de tu FreedomBox permite a los usuarios sin dirección IP pública fija mantener su dirección IP pública temporal actualizada en el servicio de DNS Dinamico. Esto te permite exponer servicios de tu FreedomBox, como ownCloud, a Internet. -
-
- GnuDIP vs. Update URL - Eisten 2 mecanismos principales para notificar al the servicio de DNS Dinamico cual es tu dirección IP provisional actual: empleando el protocolo GnuDIP o empleando el mecanismo URL de actualización. - Si un servicio expuesto usando URL de actualización no se securiza apropiadamente mediante HTTPS, tus credenciales podrían quedar expuestas. Una vez que un atacante accede a tus credenciales podrá reproducir tus comunicaciones con el servicio de DNS Dinamico y suplantar tu dominio. - Por otra parte el protocolo GnuDIP solo transportará un valor MD5 salpimentado de tu contraseña de tal forma que es seguro contra ataques de este tipo. -
-
- Emplear el protocolo GnuDIP - - - Registra una cuenta en cualquier proveedor de servicio de DNS Dinamico. Hay un servicio gratuito provisto por la comunidad FreedomBox disponible en . - - - Habilita el Servicio de DNS Dinamico en el interfaz de usuario de FreedomBox. - - - Selecciona GnuDIP como tipo de servicio, introduce la dirección de tu proveedor de servicio de DNS Dinamico (por ejemplo, gnudip.datasystems24.net) en el campo Dirección del servidor GnuDIP. - - - - - - - Dynamic DNS Settings - - - - - - Completa la información que te ha dado tu proveedor en los campos correspondientes Nombre de Dominio, Usuario y Contraseña. - - -
-
- Emplear URL de actualización - Se implementa esta funcionalidad porque los proveedores de servicio de DNS Dinamico más populares están empleando el mecanismo URL de actualización. - - - Registra una cuenta en el proveedor de servicio de DNS Dinamico que emplea el mecanismo Update URL. Se listan algunos proveedores de ejemplo en la propia página de configuración. - - - Habilita el Servicio de DNS Dinamico en el interfaz de usuario de FreedomBox. - - - Selecciona URL de actualización como tipo de servicio, introduce la URL de actualización que te ha dado tu proveedor de servicio de DNS Dinamico en el campo URL de actualización. - - - Si vas a la URL de actualización con tu navegador de Internet y te muestra un aviso acerca de un certificado no confiable, activa aceptar todos los certificados SSL. AVISO: ¡Tus credenciales podrían quedar expuestas en este punto a un ataque MIM (man-in-the-middle)! Valora la posibilidad de elegir otro proveedor de servicio mejor. - - - Si vas a la URL de actualización con tu navegador de Internet y te muestra la caja de usuario/contraseña, selecciona usar autenticación HTTP basica e introduce el usuario y la contraseña. - - - Si la URL de actualización contiene tu dirección IP temporal actual reemplaza la dirección IP por la cadena de texto <Ip>. - - -
-
- Comprobar si funciona - - - Asegúrate de que los servicios externos que has habilitado como /jwchat, /roundcube o /ikiwiki están disponibles en tu dirección de dominio. - - - Ve a la página Estado y asegúrate de que el tipo de NAT se detecta correctamente. Si tu FreedomBox está detrás de un dispositivo NAT debería detectarse en este punto (Texto: Detrás de NAT). Si tu FreedomBox tiene una dirección IP pública asignada el texto debería ser "Conexión directa a Internet". - - - Comprueba que el último estado de actualización no sea fallida. - - -
-
- 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 immediately) - - -
-
-
- Cockpit (Administración de Servidor) - Cockpit es una aplicación que facilita administrar servidores GNU/Linux desde el navegador web. En una FreedomBox, hay disponibles controles para muchas funciones avanzadas que normalmente no se necesitan. También hay disponible un terminal web para operaciones de consola. - Cualquier usuario del grupo de administradores de to FreedomBox puede acceder a Cockpit. Cockpit solo se puede usar si tienes una configuración de nombre de dominio apropiada para tu FreedomBox y usas ese nombre de dominio para acceder a Cockpit. Para más información mira la sección de Resolución de Problemas. - - Usa cockpit sólo si eres un administrador de sistemas GNU/Linux con habilidades avanzadas. FreedomBox intenta coexistir con los cambios al sistema que efectúan los administradores y sus herramientas, como Cockpit. Sin embargo, los cambios al sistema inadecuados pueden causar fallos en las funciones de FreedomBox. - -
- Usar Cockpit - Instala Cockpit como cualquier otra aplicación de FreedomBox. Y a continuación asegúrate de que Cockpit está habilitado. - - - - - - - cockpit-enable.png - - - - Asegúrate de que la cuenta de usuario de FreedomBox que se empleará con Cockpit es parte del grupo de administradores. - - - - - - - cockpit-admin-user.png - - - - Arranca el interfaz web de Cockpit. Ingresa con la cuenta de usuario configurada. - - - - - - - cockpit-login.png - - - - Empieza a usar cockpit. - - - - - - - cockpit-system.png - - - - Cockpit también funciona con interfaces mobiles. - - - - - - - cockpit-mobile.png - - - -
-
- Funcionalidades - Las siguientes funcionalidades de Cockpit pueden ser útiles para usuarios avanzados de FreedomBox. -
- Cuadro de Mando del Sistema - Cockpit tiene un cuadro de mando del sistema que - - - Muestra información detallada del hardware. - - - Muestra métricas básicas de rendimiento del sistema. - - - Permite cambiar la hora y el huso del sistema. - - - Permite cambiar el hostname. Por favor usa el interfaz de usuario de FreedomBox UI para hacer esto. - - - Muestra las huellas del servidor SSH. - - - - - - - - - cockpit-system.png - - - -
-
- Visualización de los Registros de Ejecución (logs) del Sistema - Cockpit permite consultar los registros de ejecución (logs) del sistema y examinarlos a todo detalle. - - - - - - - cockpit-logs.png - - - -
-
- Administración de Almacenamiento - Cockpit permite las siguientes funciones avanzadas de almacenamiento: - - - Visualización de llenado de discos. - - - Edición de particiones de disco. - - - Administración de RAID. - - - - - - - - - cockpit-storage1.png - - - - - - - - - - cockpit-storage2.png - - - -
-
- Redes - Tanto Cockpit como FreedomBox se apoyan en NetworkManager para configurar la red. No obstante, Cockpit ofrece alguna configuración avanzada no disponible en FreedomBox: - - - Configuración de rutas. - - - Configuración de enlaces, puentes y VLANs. - - - - - - - - - cockpit-network1.png - - - - - - - - - - cockpit-network2.png - - - - - - - - - - cockpit-network3.png - - - -
-
- Servicios - Cockpit permite agendar servicios y tareas periódicas (como cron). - - - - - - - cockpit-services1.png - - - - - - - - - - cockpit-services2.png - - - -
-
- Terminal Web - Cockpit ofrece un terminal web que se puede usar para ejecutar tareas manuales de administración del sistema. - - - - - - - cockpit-terminal.png - - - -
-
-
- Resolución de Problemas - Cockpit require un nombre de dominio adecuadamente configurado en tu FreedomBox y solo funcionará cuando accedas a él mediante una URL con ese nombre de dominio. Cockpit no funcionará con una dirección IP en la URL. Tampoco con freedombox.local como nombre de dominio. Por ejemplo, las URLs siguientes no funcionarán: - - A partir de la versión 19.15 funciona el dominio .local. Puedes acceder a Cockpit mediante la URL . El dominio .local se basa en tu hostname. Si tu hostname es mifb tu nombre de dominio .local será mifb.local y la URL de Cockpit será . - Para acceder apropiadamente a Cockpit, usa el nombre de dominio configurado en tu FreedomBox. Cockpit también funcionará cuando se use un Servicio Tor Onion. Las siguientes URLs funcionarán: - - La razón para este comportamiento es que Cockpit emplea WebSockets para conectar con el servidor de backend. Por seguridad se deben evitar las peticiones a WebSockets con servidores cruzados. Para implementar esto Cockpit maintiene una lista de todos los dominios desde los que se admiten peticiones. FreedomBox configura automaticamente esta lista cuando añades o borras un dominio. Sin embargo, como no podemos fiarnos de las direcciones IP, FreedomBox no las añade a esta lista. Puedes mirar la lista actual de dominios aceptados administrada por FreedomBox en /etc/cockpit/cockpit.conf. Puedes editarla pero hazlo solo si comprendes sus consecuencias para la seguridad web. -
-
-
- Configurar - Configurar tiene algunas opciones generales de configuración: -
- Hostname - - - Hostname es el nombre local por el que otros dispositivos pueden alcanzar tu FreedomBox desde la red local. El hostname por defecto es freedombox. - - -
-
- Nombre de Dominio - - - El Nombre de Dominio es el nombre global por el que otros dispositivos pueden alcanzar tu FreedomBox desde la Internet. El valor que se asigne aquí es el que usarán Chat Server (XMPP), Matrix Synapse, Certificates (Let's Encrypt), y Monkeysphere. - - -
-
- Página Principal (home) del Servidor Web - - - Esta es una opción avanzada que te permite establecer como home algo diferente al servicio FreedomBox para que se sirva a quien acceda con el navegador al nombre de dominio de FreedomBox. Por ejemplo, si el nombre de dominio de tu FreedomBox es y estableces a MediaWiki como home, al visitar te llevará a en vez de a . Puedes asignar la home a cualquier aplicación web, los wikis y blogs de Ikiwiki o la página index.html por defecto de Apache. - - - - Una vez asignada como home otra aplicación, ya solo puedes navegar al servicio FreedomBox tecleando en el navegador . - /freedombox también se puede usar como alias para /plinth - - - - Consejo: Guarda la URL del servicio FreedomBox antes de asignar la home a otra app. - - -
-
-
- Copias de respaldo (backups) - FreedomBox incluye la posibilidad de copiar y restaurar datos, preferencias, configuración y secretos de la mayoría de las aplicaciones. La funcionalidad de Backups se resuelve con el software de backup Borg. Borg es un programa de backup con deduplicación y compresión. Está diseñado para hacer backups eficientes y seguros. Esta funcionalidad de backups se puede emplear para respaldar y recuperar datos aplicación por aplicación. Las copias de respaldado se pueden almacenar en la propia máquina FreedomBox o en un servidor remoto. Cualquier servidor remoto con acceso por SSH se puede emplear como almacenamiento para los backups de la FreedomBox. Las copias remotas se pueden cifrar para que el servidor remoto no pueda leer los datos que alberga. -
- Estados de la Funcionalidad de Backups - - - - - - - - - - App/Funcionalidad - - - - - Soporte en Versión - - - - - Notas - - - - - - Avahi - - - - - - - no precisa backup - - - - - Backups - - - - - - - no precisa backup - - - - - Bind - - - 0.41 - - - - - - Cockpit - - - - - - - no precisa backup - - - - - Coquelicot - - - 0.40 - - - incluye ficheros subidos - - - - - Datetime - - - 0.41 - - - - - - Deluge - - - 0.41 - - - no incluye archivos descargados ni semillas - - - - - Diagnostics - - - - - - - no precisa backup - - - - - Dynamic DNS - - - 0.39 - - - - - - ejabberd - - - 0.39 - - - incluye todos los datos y configuración - - - - - Firewall - - - - - - - no precisa backup - - - - - ikiwiki - - - 0.39 - - - incluye todos los wikis/blogs y sus contenidos - - - - - infinoted - - - 0.39 - - - incluye todos los datos y claves - - - - - JSXC - - - - - - - no precisa backup - - - - - Let's Encrypt - - - 0.42 - - - - - - Matrix Synapse - - - 0.39 - - - incluye media y cargas - - - - - MediaWiki - - - 0.39 - - - incluye páginas de wiki y archivos adjuntos - - - - - Minetest - - - 0.39 - - - - - - MLDonkey - - - 19.0 - - - - - - Monkeysphere - - - 0.42 - - - - - - Mumble - - - 0.40 - - - - - - Names - - - - - - - no precisa backup - - - - - Networks - - - No - - - sin planes para implementar backup, de momento - - - - - OpenVPN - - - 0.48 - - - incluye a todos los usuarios y claves de servidor - - - - - Pagekite - - - 0.40 - - - - - - Power - - - - - - - no precisa backup - - - - - Privoxy - - - - - - - no precisa backup - - - - - Quassel - - - 0.40 - - - incluye usuarios y registros de ejeución (logs) - - - - - Radicale - - - 0.39 - - - incluye calendario y datos de tarjetas de todos los usuarios - - - - - repro - - - 0.39 - - - incluye a todos los usuarios, datos y claves - - - - - Roundcube - - - - - - - no precisa backup - - - - - SearX - - - - - - - no precisa backup - - - - - Secure Shell (SSH) Server - - - 0.41 - - - incluye las claves del servidor - - - - - Security - - - 0.41 - - - - - - Shadowsocks - - - 0.40 - - - solo secretos - - - - - Sharing - - - 0.40 - - - no incluye datos de las carpetas compartidas - - - - - Snapshot - - - 0.41 - - - solo configuración, no incluye datos de capturas (snapshots) - - - - - Storage - - - - - - - no precisa backup - - - - - Syncthing - - - 0.48 - - - no incluye datos de las carpetas compartidas - - - - - Tahoe-LAFS - - - 0.42 - - - incluye todos los datos y configuración - - - - - Tiny Tiny RSS - - - 19.2 - - - incluye base de datos con feeds, historias, etc. - - - - - Tor - - - 0.42 - - - includes configuración y secretos como las claves de servicios Tor Onion - - - - - Transmission - - - 0.40 - - - no incluye archivos descargados ni semillas - - - - - Upgrades - - - 0.42 - - - - - - Users - - - No - - - sin planes para implementar backup, de momento - - - - - -
-
- Cómo instalar y usar Backups - - Paso 1: Ir a la página de Copias de Seguridad - - - - - - - - Backups: Paso 1 - - - - - Paso 2: Pulsar el botón Instalar - - - - - - - - Backups: Paso 2 - - - - - Paso 3: Esperar a que se instalen todos los componentes de la aplicación - - - - - - - - Backups: Paso 3 - - - - - Paso 4: Pulsar el botón de Crear Copia de Seguridad - - - - - - - - Backups: Paso 4 - - - - - Paso 5: Seleccionar las aplicaciones a respaldar y pulsar Enviar - - - - - - - - Backups: Paso 5 - - - - - Paso 6: Pulsar en el botón Descargar - - - - - - - - Backups: Paso 6 - - - -
-
-
- Cortafuegos - Un cortafuegos es un sistema de seguridad de red que controla el tráfico de entrada y salida desde/a la red. Mantener un cortafuegos habilitado y apropiadamente configurado reduce el riesgo de amenazas a la seguridad desde Internet. - La operación del cortafuegos desde el interfaz web de FreedomBox es automática. Cuando habilitas un servicio se le abre automáticamente el cortafuegos y cuando lo deshabilitas se le cierra también automáticamente. Para servicios habilitados por defecto en FreedomBox los puertos se abren en el cortafuegos por defecto durante el proceso de la primera ejecución. - - - - - - - Firewall - - - - La administración del cortafuegos en FreedomBox se hace empleando FirewallD. -
- Interfaces - Cada interfaz de red necesita asignarse a 1 (y sólo 1) zona. Si no se le establece zona, automáticamente se le asigna la zona externa. Las reglas que tenga activas la zona se aplicarán al interfaz. Por ejemplo, si se permite el trafico HTTP en una zona en particular las peticiones web se acceptarán en todas las direcciones configuradas para todos los interfaces asignados a esa zona. - Principalmente se emplean 2 zonas de cortafuegos. La zona interna está pensada para servicios ofrecidos a todas las máquinas de la red local. Esto podría incluir servicios como streaming multimedia o compartición simple de archivos. La zona externa está pensada para servicios públicamente expuestos a Internet. Esto podría incluir servicios como blog, sitio web, cliente web de correo electrónico etc. - Para más detalles acerca de como se configuran por defecto los interfaces de red mira la sección Redes. -
-
- Abrir Puertos Propios - Cockpit proporciona administración avanzada de cortafuegos. Ambos, FreedomBox y Cockpit operan sobre firewalld y son por tanto compatibles entre sí. En particular, Cockpit se puede usar en FreedomBox para abrir servicios o puertos. Esto resulta útil si además de los servicios proporcionados por FreedomBox estás ejecutando manualmente tus propios servicios en la misma máquina. - - - - - - - firewalld-cockpit.png - - - -
-
- Puertos/Servicios de FreedomBox - La siguiente tabla trata de documentar los puertos, servicios y sus estados por defecto en FreedomBox. Si encuentras esta página desactualizada mira la página de estado del cortafuegos en el interfaz web de FreedomBox. - - - - - - - - - - - - - Servicio - - - - - Puerto - - - - - Externo - - - - - Habilitado por defecto - - - - - Estado mostrado en FreedomBox - - - - - Administrado por FreedomBox - - - - - - Minetest - - - 30000/udp - - - - - - - - - {*} - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - XMPP Client - - - 5222/tcp - - - - - - - - - {*} - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - XMPP Server - - - 5269/tcp - - - - - - - - - {*} - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - XMPP Bosh - - - 5280/tcp - - - - - - - - - {*} - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - NTP - - - 123/udp - - - - - - - - - {o} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - Interfaz web de FreedomBox - - - 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/udp - - - - - - - - - {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} - - - - - - - - -
-
- Operación Manual - Para completar información acerca de los conceptos basicos o más allá, mira la documentación de FirewallD. -
- Habilitar/deshabilitar el cortafuegos - Para deshabilitar el cortafuegos - - o con systemd - - Para vover a habilitar el cortafuegos - - o con systemd - -
-
- Modificar servicios/puertos - Puedes añadir o eliminar un servicio de una zona manualmente. - Para ver la lista de servicios habilitados: - --list-services]]> - Ejemplo: - - Para ver la lista de puertos habilitados: - --list-ports]]> - Ejemplo: - - Para eliminar un servicio de una zona: - --remove-service= -firewall-cmd --permanent --zone= --remove-service=]]> - Ejemplo: - - Para eliminar un puerto de una zona: - / -firewall-cmd --permanent --zone=internal --remove-port=/]]> - Ejemplo: - - Para añadir un servicio a una zona: - --add-service= -firewall-cmd --permanent --zone= --add-service=]]> - Ejemplo: - - Para añadir un puerto a una zona: - / -firewall-cmd --permanent --zone=internal --add-port=/]]> - Ejemplo: - -
-
- Modificar la zona de los interfaces - Puedes cambiar la asignación de zona de cada interfaz de red manualmente tras la asignación automática del proceso de primer arranque. - Para ver la asignación actual de interfaces de red a las zonas. - - Para eliminar un interfaz de una zona: - --remove-interface= -firewall-cmd --permanent --zone= --remove-interface=]]> - Ejemplo: - - Para añadir un interfaz a una zona: - --add-interface= -firewall-cmd --permanent --zone= --add-interface=]]> - Ejemplo: - -
-
-
-
- Detección de Servicios - La Detección de Servicios permite a otros dispositivos de la red detectar a tu FreedomBox y a los servicios que expone. Si un cliente de la red local soporta mDNS, puede encontrar tu FreedomBox en <hostname>.local (por ejemplo: freedombox.local). - También permite a FreedomBox detectar otros dispositivos y servicios que están funcionando en tu red local. - La Detección de Servicios no es esencial y solo funciona en redes internas. Se puede deshabilitar para mejorar la seguridad especialmente cuando la conectas a una red local hostil. -
-
- Diagnósticos - La prueba de diagnóstico del sistema ejecutará varias verificaciones sobre tu sistema para confirmar que las aplicaciones y servicios están funcionando como se espera. - Sólo haz clic Ejecutar Diagnósticos. Esto puede llevar varios minutos. -
-
- Fecha y hora - Este servidor de hora de red es un programa que mantiene el tiempo del sistema sincronizado con servidores de Internet. - Puedes seleccionar el huso horario - - - escogiendo una capital cercana (están ordenadas por Continente/Ciudad) o - - - seleccionando directamente el huso en relación a GMT (Greenwich Mean Time). - - - - - - - - - DateTime_es_v01.png - - - -
-
- Let's Encrypt (Certificados) - Un certificado digital permite a los usuarios de un servicio web verificar la identidad del servicio y comunicar con él de modo seguro. FreedomBox puede obtener y configurar automaticamente certificados digitales para cada dominio disponible. Lo hace probando a Let's Encrypt, una authoridad de certificación (CA) ser el dueño de un dominio. - Let's Encrypt es una autoridad de certificación abierta, automatizada, libre y gratuita administrada para beneficio público por el Internet Security Research Group (ISRG). Por favor, lee y acepta los términos del Acuerdo de Suscripción de Let's Encrypt antes de usar este servicio. -
- Por Qué Usar Certificados - La comunicación con tu FreedomBox se puede asegurar de modo que se imposibilite interceptar los contenidos que tus servicios intercambian con sus usuarios. -
-
- Cómo configurar - - - Si tu FreedomBox está detrás de un router, necesitarás configurar la redirección de puertos en tu router. Debes redirigir los siguientes puertos: - - - TCP 80 (http) - - - TCP 443 (https) - - - - - Publica tu nombre de dominio: - - - En Configurar inserta tu nombre de dominio, p.ej. MiWeb.com Let's Encrypt - - - - - Verifica que se aceptó tu nombre de dominio - - - Comprueba que está habilitado en Servicio de Nombres - - - - - - - Let's Encrypt Name Services - - - - - - - - Ve a la página de los Certificados (Let's Encrypt) y completa la instalación del modulo si hace falta. Entonces haz clic en el botón "Obtain" de tu nombre de dominio. - - - Tras algunos minutos estará disponible un certificado válido - - - - - - - Let's Encrypt - - - - - - - - Verifica en tu navegador comprobando https://MiWeb.com - - - - - - - - - Let's Encrypt Certificate - - - - - - - - Screencast: Let's Encrypt -
-
- Usar - El certificado es válido por 3 meses. Se renueva automáticamente y también se puede volcer a obtener o revocar manualmente. - Ejecutando diagnostics se puede también verificar el certificado. -
-
-
- Monkeysphere - Con Monkeysphere se puede generar una clave OpenPGP para cada dominio configurado para servir SSH. La clave pública OpenPGP se puede subir entonces a los servidores de claves OpenPGP. Los usuarios que se conecten mediante SSH podrán verificar que se están conectando a la máquina correcta. Para que los usuarios puedan confiar en la clave alguien (generalmente el dueño de la máquina) tiene que firmarla siguiendo el proceso normal de firmado de claves OpenPGP. Para más detalles, ver la documentación de Monkeysphere SSH. - Monkeysphere también puede generar una clave OpenPGP para cada certificado de servidor web seguro (HTTPS) instalado en esta máquina. La clave pública OpenPGP se puede subir entonces a los servidores de claves OpenPGP. Los usuarios que se conecten mediante HTTPS podrán verificar que se están conectando a la máquina correcta. Para validar el certificado el usuario deberá instalar cierto software disponible en el sitio web de Monkeysphere. -
-
- PageKite (Visibilidad Publica) -
- ¿Qué es PageKite? - PageKite hace inmediata y públicamente accesibles desde internet a los sitios web y servicios locales sin tener que crear tu mismo una dirección IP pública. Lo hace tunelando protocolos como HTTPS o SSH a través de cortafuegos y NAT. Usar PageKite require ana cuenta en un servicio de repetidor de PageKite. es uno de de estos servicios. - Un servicio de repetidor de PageKite te permitirá crear cometas (kites). Las cometas son similares a los nombres de dominio pero con ventajas y desventajas diferentes. Una cometa puede tener varios servicios configurados. Se sabe que PageKite funciona con HTTP, HTTPS, y SSH, y muchas funcionan con otros servicios, pero no todas. -
-
- Usar PageKite - - - Créate una cuenta en un servicio de repetidor de PageKite. - - - Añade una cometa a tu cuenta. Anota el nombre y el secreto de tu cometa. - - - En FreedomBox, vé a la solapa "Configurar PageKite" de la página Visibilidad Publica (PageKite). - - - Marca la caja "Habilitar PageKite" e introduce el nombre y el secreto de tu cometa. Haz clic en "Grabar propiedades". - - - En la solapa "Servicios Estándar" puedes habilitar HTTP y HTTPS (recomendado) y SSH (opcional). - - - HTTP se necesita para obtener el certificado Let's Encrypt. Puedes deshabilitarlo (HTTPS) más tarde. - - - - - En la página Certificados (Let's Encrypt) puedes obtener un certificado Let's Encrypt para el nombre de tu cometa. - - -
-
-
- Performance (Monitorización del sistema) - Disponible desde: versión 20.9 - La app Performance permite recabar, almacenar y ver información acerca de la utilización del hardware. Esto proporciona visibilidad acerca de patrones de uso y si el hardware está sobrecargado por usuarios y/o servicios. - Las métricas de Performance las recaba Performance Co-Pilot se pueden ver mediante la app Cockpit. Cuando se instala y habilita esta app del sistema, los gráficos de Cockpit muestran el pasado (hasta un año atrás). - - - - - - - FreedomBox/Manual/Performance/performance-one-week.png - - - -
-
- Protección - Cuando se habilita esta opción sólo los usuarios del grupo "admin" podrán entrar a la consola o mediante SSH. Los usuarios de consola podrán acceder a algunos servicios sin más autorización. - La sección Usuarios explica cómo definir grupos de usuarios. - Cuando la opción Acceso a consola restringido está habilitada, sólo los usuarios del grupo admin podrán ingresar via consola, shell segura (SSH) o interfaz gráfico. Al desactivar esta funcionalidad cualquier usuario con cuenta en FreedomBox podrá ingresar y quizá tener acceso a ciertos servicios sin más autorización. Esta opción solo debería desactivarse si se confía plenamente en todos los usuarios del sistema. Si quieres usar tu máquina FreedomBox también como escritorio y admitir que usuarios no-admin ingresen mediante interfáz gráfica esta opción debe estar desactivada. Puedes determinar la lista de usuarios admin en la sección Users. - - - - - - - Security_es_v01.png - - - -
-
- Redes - Esta sección describe como se configura por defecto la red en FreedomBox y como se puede adaptar. Ver también la sección Cortafuegos para más información acerca de cómo funciona éste. -
- Configuración por defecto - En una imágen fresca de FreedomBox la red no está configurada. La configuración se realiza cuando la imágen se graba en una tarjeta SD y el dispositivo arranca. Durante el primer arranque el paquete FreedomBox setup detecta los interfaces (tarjetas) de red e intenta configurarlos automáticamente de modo que la FreedomBox quede disponible para seguir configurandola a través del interfaz web desde otra máquina, sin necesidad de conectar un monitor a la FreedomBox. La configuración automática también procura dejar la FreedomBox operativa para sus escenarios de uso más importantes. - Trata 2 escenarios: - - - cuando hay 1 único interfaz (tarjeta) ethernet - - - cuando hay múltiples interfaces (tarjetas) ethernet - - -
- Interfaz (tarjeta) ethernet único - Cuando el dispositivo hardware solo tiene 1 único interfaz (tarjeta) ethernet hay poco margen para que haga de router. En tal caso se asume que el dispositivo es solo una máquina más en la red. En consecuencia el único interfaz (tarjeta) disponible se configura para ser un interfaz interno en modo de configuración automática. Esto significa que se conecta a Internet empleando la configuración provista por un router de la red y que hace todos sus servicios (internos y externos) accesibles a todos los clientes que haya en esta red. - - - - - - - network_single.png - - - -
-
- Múltiples interfaces (tarjetas) ethernet - Cuando el dispositivo hardware tiene múltiples interfaces (tarjetas) ethernet el dispositivo puede actuar como router. Entonces los interfaces se configuran para ejecutar esta función. - - - El primer interfaz (tarjeta) de red se configura para ser una WAN o interfaz externo en modo de configuración automático. Esto significa que se conecta a Internet empleando la configuración provista por el proveedor de servicio de internet (ISP). En este interfaz solo se expondrán los servicios concebidos para consumo desde Internet (servicios externos). Tu conexión a Internet tiene que llegar por el puerto de este interfaz (tarjeta) ethernet. Si quieres que tu router de siempre siga administrando tu conexión por tí conecta un cable desde tu router al puerto de este interfaz. - - - Los demás interfaces de red se configuran como clientes de router, como LAN o interfaces internos en modo de configuración compartido. Esto significa que todos sus servicios (internos y externos) se exponen a todos los clientes que entren desde esta red. Compartido implica además que los clientes podrán recibir detalles para conexión automática a la red. En concreto, la configuración DHCP y los servidores DNS se exponen en este interfaz. La conexión a Internet disponible para el dispositivo a través del primer interfaz se compartirá con los clientes que usen este interfaz. Todo esto implica que puedes conectar tus ordenadores a esta interfaz (tarjeta) de red y se configurarán automáticamente pudiendo acceder a Internet a través de tu FreedomBox. - - - Aunque el proceso de asignación es determinista actualmente no está muy claro qué interfaz será WAN (los demás serán LAN). Así que averiguar cual es cual conllevará un poco de prueba y error. En el futuro esto estará bien documentado para cada dispositivo. -
-
- Configuración de la Wi-Fi - Todos los interfaces Wi-Fi se configuran para ser LAN o interfaces internos en modo de configuración compartido. También se configuran para ser puntos de acceso Wi-Fi con los siguientes datos: - - - El nombre de cada punto de acceso será FreedomBox más el nombre del interfaz (para tratar el caso de que haya varios). - - - La contraseña para conectar a los interfaces será freedombox123. - - -
-
-
- Compartición de la Conexión a Internet - Aunque la principal obligación de FreedomBox es proporcionar servicios descentralizados también puede ejercer como router casero. Por tanto en la mayoría de los casos FreedomBox se conecta a Internet y proporciona a otras máquinas de la red la posibilidad de usar esa conexión a Internet. FreedomBox puede hacer esto de 2 formas: usando un modo de conexión compartido o empleando una conexión interna. - Cuando se configura un interfaz en modo compartido puedes conectarle tu máquina directamente, sea por cable desde este interfaz a tu máquina o conectando a través del punto de acceso Wi-Fi. Este caso es el más facil de usar porque FreedomBox automáticamente proporciona a tu máquina la configuración de red necesaria. Tu máquina conectará automáticamente a la red proporcionada por FreedomBox y podrá conectar a Internet ya que FreedomBox puede a su vez conectarse a Internet. - En ocasiones la configuración anterior podría no ser posible porque el dispositivo hardware tenga un único interfaz de red o por otros motivos. Incluso en este caso tu máquina puede todavía conectarse a Internet a través de la FreedomBox. Para que esto funcione asegúrate de que el interfaz de red al que se está conectando tu máquina esté en modo interno. Entonces conecta tu máquina a la red en la que está la FreedomBox. Después de esto configura la red de tu máquina indicando como puerta de enlace la dirección IP de la FreedomBox. FreedomBox aceptará entonces el tráfico de red de tu maquina y lo enviará a Internet. Esto funciona porque los interfaces de red en modo interno están configurados para enmascarar hacia Internet los paquetes que lleguen desde máquinas locales, así como para recibir paquetes desde Internet y reenviarlos hacia las máquinas locales. -
-
- Adaptaciones - La configuración por defecto anterior podría no servir para tu caso. Puedes adecuar la configuración para ajustarla a tus necesidades desde el área Redes de la sección Configuración del interfaz web de tu FreedomBox. -
- Conexiones PPPoE - Si tu ISP no proporciona configuración de red automática via DHCP y te obliga a conectar por PPPoE, para configurarlo elimina toda conexión de red existente en el interfaz y añade una de tipo PPPoE. Aquí, si procede, indica el usuario y la contraseña que te ha dado tu ISP y activa la conexión. -
-
- Conectar a Internet mediante Wi-Fi - Por defecto durante el primer arranque los dispositivos Wi-Fi se configurarán como puntos de acceso. Sin embargo se pueden reconfigurar como dispositivos Wi-Fi normales para conectar a la red local o a un router WiFi existente. Para hacer esto haz clic en la conexión Wi-Fi para editarla. Cambia el modo a Infraestructura en vez de Punto de Acceso y Método de direccionamiento IPv4 a Automático (DHCP) en vez de Modo compartido. SSID proporcionado significa el nombre de la red Wi-Fi a la que quieres conectar. Rellena la frase clave. -
- Problemas con la Funcionalidad de Privacidad - El gestor de red que emplea FreedomBox para conectar con las redes Wi-Fi tienen una funcionalidad de privacidad que usa una identidad para buscar redes diferente de la que emplea para conectar con el punto de acceso Wi-Fi. Desafortunadamente esto causa problemas con algunos routers que rechazan estas conexiones. Tu conexión no se activará con éxito y se desconectará. Si tienes control sobre el comportamiento del router puedes desactivar esta funcionalidad. Si no la solución es desactivar la funcionalidad de privacidad: - Entra a la FreedomBox por SSH o Cockpit. - Edita el fichero /etc/NetworkManager/NetworkManager.conf: - - Añade la linea wifi.scan-rand-mac-address=no en la sección [device]: - - Luego reinicia la FreedomBox. -
-
-
- Añadir un nuevo dispositivo de red - Al añadir un nuevo dispositivo de red network manager lo configurará automáticamente. En la mayoría de los casos esto no funcionará. Borra la configuración creada automáticamente en el interfaz y crea una conexión de red nueva. Selecciona tu interfaz recién creado en la página "añadir conexión". - - - Configura la zona del cortafuegos como corresponda. - - - Puedes configurar los interfaces para conectar a la red o proporcionar configuración de red a cualquier máquina que se le conecte. - - - De modo similar, si es un interfaz Wi-Fi puedes configurarlo para ser un punto de acceso Wi-FI o para conectarse a puntos de acceso existentes en la red. - - -
-
- Configurar una red Mesh - FreedomBox tiene un soporte rudimentario para participar en redes mesh basadas en BATMAN-Adv. Es posible unirse a una red existe en tu zona o crear una red mesh nueva y compartir tu conexión a Internet con el resto de nodos que se unan a tu red. Tanto para unirte a una red mesh como para crear otra, actualmente hay que crear 2 conexiones y activarlas manualmente. -
- Unirse a una red Mesh - Para unirse a una red mesh existente en tu zona primero consulta a sus organizadores y obtén información acerca de la red. - - - Crea una conexión nueva y selecciona el tipo de conexión Wi-Fi. En el siguiente diálogo rellena los valores como se indica: - - - - - - - - - - Nombre del campo - - - - - Valor de ejemplo - - - - - Explicación - - - - - - - Nombre de la Conexión - - - - Mesh Join - BATMAN - - - El nombre tiene que acabar en BATMAN (con mayúsculas). - - - - - - Interfaz físico - - - - wlan0 - - - El dispositivo Wi-Fi que quieres usar para conectar a la red mesh. - - - - - - Zona del cortafuegos - - - - Externa - - - Ya que no quieres que los participantes en la red mesh usen dispositivos internos de tu FreedomBox. - - - - - - SSID - - - - ch1.freifunk.net - - - Tal como te lo hayan dado los operadores de la red mesh. Esta red debería mostrarse en Redes Wi-Fi accesibles. - - - - - - Modo - - - - Ad-hoc - - - Porque esta red es una red de pares (peer-to-peer). - - - - - - Banda de Frecuencia - - - - 2.4Ghz - - - Tal como te lo hayan dado los operadores de la red mesh. - - - - - - Canal - - - - 1 - - - Tal como te lo hayan dado los operadores de la red mesh. - - - - - - BSSID - - - - 12:CA:FF:EE:BA:BE - - - Tal como te lo hayan dado los operadores de la red mesh. - - - - - - Autenticación - - - - Abierta - - - Déjala abierta salvo que sepas que tu red mesh necesite otro valor. - - - - - - Contraseña - - - - - Déjala en blanco salvo que sepas el valor que necesite tu red mesh. - - - - - - Método de direccionamiento IPv4 - - - - Deshabilitado - - - Todavía no queremos pedir una configuración IP. - - - - - - Graba la conexión y únete a la red mesh activándola. - - - Crea una segunda conexión nueva y selecciona el tipo Genérica. En el siguiente diálogo rellena los valores como se indica: - - - - - - - - - - Nombre del campo - - - - - Valor de ejemplo - - - - - Explicación - - - - - - - Nombre de la Conexión - - - - Mesh Connect - - - Cualquier nombre para identificar ésta conexión. - - - - - - Interfaz físico - - - - bat0 - - - Este interfaz solo aparecerá tras activar con éxito la conexión del paso anterior. - - - - - - Zona del cortafuegos - - - - Externa - - - Ya que no quieres que los participantes en la red mesh usen dispositivos internos de tu FreedomBox. - - - - - - Método de direccionamiento IPv4 - - - - Auto - - - Generalmente las redes mesh tienen un servidor DHCP en algún sitio que le proporciona una configuración IP a tu máquina. Si no, consulta al operador y configura la dirección IP como te diga por el método manual. - - - - - - Graba la conexión. Configura tu maquina para participar en la red activando esta conexión. Actualmente hay que activarla manualmente cada vez que quieras unirte a la red. En el futuro FreedomBox lo hará automáticamente. - - - Ahora debieras poder llegar a otros nodos de la red. También podrás conectar a Internet a través de la red mesh si los operadores han instalado algúna puerta de enlace. -
-
- Crear una red Mesh - Para crear tu propia red mesh y compartir tu conexión a Internet con el resto de los nodos de la red: - - - Sigue las instrucciones del paso 1 de Unirse a una red Mesh empleando los valores válidos para tu red en SSID (un nombre para tu red Mesh), Banda de Frecuencia (generalmente 2.4Ghz), Canal (entre 1 y 11 para la banda de 2.4Ghz) y BSSID (una secuencia hexadecimal como 12:CA:DE:AD:BE:EF). Crea esta conexión y actívala. - - - Sigue las instrucciones del paso 2 de Unirse a una red Mesh seleccionando Compartido para Método de direccionamiento IPv4d. Esto proporcionará automáticamente una configuración IP a otros nodos de la red y compartirá la conexión a Internet de tu maquina (ya sea mediante un segudo interfaz Wi-Fi, Ethernet, etc.) con el otros nodos de la red mesh. - - - Corre la voz entre tus vecinos acerca de tu red mesh y pásales los parámetros que has empleado al crearla. Cuando otros nodos se conecten a esta red mesh tendrán que seguir las instrucciones del paso 1 de Unirse a una red Mesh empleando en SSID, Banda de Frecuencia y Canal los valores que has elegido para tu red mesh al crearla. -
-
-
-
- Operación avanzada de Red - Cockpit proporciona muchas funcionalidades de red más avanzadas que las de FreedomBox. Ambos, FreedomBox y Cockpit, operan sobre Network Manager y son por ello compatibles entre sí. Entre las funciones de Cockpit se incluyen: - - - Establer de la unidad máxima de transmisión (MTU) para una conexión de red. - - - Cambiar de la dirección hardware (MAC) de un interfaz de red. - - - Añadir más servidores DNS y configurar el enrutado de una conexión de red. - - - Crear dispositivos coordinados para interfaces de red de alta disponibilidad. - - - Crear dispositivos en puente para agregar redes diferentes en un mismo interfaz de red. - - - Administrar VLAN para crear particiones virtuales en la red física. - - - - - - - - - networks-cockpit.png - - - -
-
- Operación manual de Red - FreedomBox configura redes automáticamente por defecto y proporciona un interfaz simplificado para personalizar la configuración a necesidades específicas. En la mayoría de los casos la operación manual no es necesaria. Los siguientes pasos describen cómo operar la configuración de red a mano en caso de que el interfaz de FreedomBox le resulte insuficiente a un usuario para realizar una tarea o para diagnosticar un problema que FreedomBox no identifique. - En el interfaz de línea de comandos: - Para acceder a un interfaz de configuración de conexiones de red basado en texto: - - Para ver la lista de dispositivos de red disponibles: - - Para ver la lista de conexiones configuradas: - - Para ver el estado actual de una conexión: - ']]> - Para ver la zona asignada actualmente en el cortafuegos a un interfaz de red: - ' | grep zone]]> - o - - Para crear una conexión nueva: - " ifname "" type ethernet -nmcli con modify "" connection.autoconnect TRUE -nmcli con modify "" connection.zone internal]]> - Para cambiarle la zona a una conexión en el cortafuegos: - " connection.zone ""]]> - Para más información acerca del uso del comando nmcli mira su página man. Para obtener una lista completa de configuraciones y tipos de conexión que acepta Network Manager mira: - - - - Para ver el estado actual del cortafuegos y operarlo manualmente lee la sección Cortafuegos. -
-
-
- Servicios de Nombre - Los Servicios de Nombre proporcionan una vista general a las formas de acceder desde la Internet pública a tu !Freedombox: nombre de dominio, servicio Tor Onion y cometa (Pagekite). Para cada tipo de nombre se indica si los servicios HTTP, HTTPS, y SSH están habilitados o deshabilitados para conexiones entrantes. -
-
- Shell Segura -
- ¿Qué es Shell Segura? - FreedomBox ejecuta el servidor openssh-server por defecto permitiendo así accesos remotos desde todos los interfaces. Si tu dispositivo hardware está conectado a un monitor y un teclado, también puedes ingresar directamente. Para la operación habitual de FreedomBox no necesitas usar la shell. No obstante, algunas tareas o identificación de algún problema podrían requerirlo. -
-
- Configurando una Cuenta de Usuario -
- Primer ingreso a FreedomBox: Cuenta de Admin - Al crear una cuenta en FreedomBox por primera vez, el usuario tendrá automaticamente privilegios de administrador. Los usuarios Admin pueden ingresar mediante ssh (abajo se explica cómo) y escalar sus privilegios a superusuario mediante sudo. -
-
- Cuenta de Usuario por Defecto - - - Nota: Si puedes acceder al interfaz web de FreedomBox es que no necesitas hacer esto. Puedes usar la cuenta de usuario del interfaz web de FreedomBox para conectar por SSH. - - - Las imagenes precompiladas FreedomBox tienen una cuenta de usuario llamada fbx pero no tiene contraseña establecida, así que no se puede ingresar con esta cuenta. - Hay un script incluído en el programa freedom-maker que permite establecer la contraseña de esta cuenta si fuera necesario: - - - Descomprime la imagen. - - - Obtén una copia de freedom-maker en . - - - Ejecuta sudo ./bin/passwd-in-image <archivo_de_imagen> fbx. - - - Copia el archivo de la imagen a la tarjeta SD e inicia el dispositivo. - - - El usuario "fbx" también tiene privilegios de superusuario mediante sudo. -
-
-
- Ingresando -
- Local - Para ingresar mediante SSH a tu FreedomBox: - - Reemplaza fbx por el usuario con el que quieres ingresar. Hay que reemplazar freedombox por el hostname o dirección IP de tu dispositivo FreedomBox como se indica en el proceso de Inicio rápido. - fbx es el usuario de FreedomBox con privilegios de superusuario por defecto. Cualquier otro usuario creado con FreedomBox que pertenezca al grupo admin podrá ingresar. La cuenta root no tiene contraseña configurada y no podrá ingresar. A todos los demás usuarios se les denegará el acceso. - fbx y los otros usuarios del grupo admin podrán ingresar directamente por el terminal. A todos los demás usuarios se les denegará el acceso. - Si fallas repetidamente intentando ingresar se te bloqueará el acceso por algún tiempo. Esto se debe al paquete libpam-abl que FreedomBox instala por defecto. Para controlar este comportamiento consulta la documentación de libpam-abl. -
-
- SSH via Tor - Si tienes habilitados en FreedomBox los servicios Tor Onion puedes acceder a tu FreedomBox mediante ssh sobre Tor. Instala netcat-openbsd. - - Edita ~/.ssh/config para habilitar conexiones sobre Tor. - - Añade lo siguiente: - - Reemplaza USUARIO por un usuario del grupo admin (ver arriba). - En algunos casos podrías necesitar reemplazar 9050 por 9150. - Ahora, para conectar a la FreedomBox abre un terminal y teclea: - - Reemplaza USUARIO por un usuario del grupo admin y DIRECCION por la dirección del servicio Tor Onion para SSH de tu FreedomBox. -
-
-
- Escalar a Superusuario - Si después de ingresar quieres volverte superusuario para realizar actividades administrativas: - - Habitúate a ingresar como root solo cuando sea estrictamente necesario. Si no ingresas como root no puedes romperlo todo accidentalmente. - - - -
-
- Cambiar Contraseñas - Para cambiar la contraseña de un usuario administrado en el interfaz web de FreedomBox usa la página Cambiar clave de acceso. El usuario por debecto fbx no se administra en el interfaz web de FreedomBox y su contraseña no se puede cambiar desde él. - Para cambiar la contraseña en el terminal ingresa a tu FreedomBox con el usuario cuya contraseña quieres cambiar y ejecuta el siguiente comando: - - Esto te preguntará tu contraseña actual antes de darte la oportunidad de establecer la nueva. -
-
-
- Usuarios y Grupos - Puedes otorgar acceso a tu FreedomBox a otros usuarios. Proporciona el nombre del usuario y su contraseña y asignale un grupo. Actualmente se soportan los grupos - - - admin - - - wiki - - - El usuario podrá ingresar a los servicios que soporten ingreso único (single-sign-on) mediante LDAP si figuran en el grupo apropriado. - Los usuarios del grupo admin podrán ingresar en todos los servicios. También pueden ingresar al sistema por SSH y escalar a privilegios administrativos (sudo). - Estas características se pueden cambiar más tarde. - Asimismo es posible establecer una clave pública SSH que permitirá al usuario ingresar al sistema de modo seguro sin emplear su contraseña. Pueder dar de alta varias claves, una en cada línea. Las líneas en blanco o que comiencen por # se ignoran. - Se pueden desactivar temporalmente las cuentas de usuarios. -
- Reparos Conocidos - - - Actualmente Plinth not distingue entre usuarios y administradores. Todo usuario añadido mediante Plinth tendrá accesso completo al interfaz de Plinth. - - -
-
-
-
- Hardware - FreedomBox está diseñado para ser el software de un dispositivo electrónico de consumo que sea fácil de configurar, mantener y usar. El proyecto no pretende crear un dispositivo hardware propio, sino asociarse con fabricantes de hardware para construir dispositivos FreedomBox y también soportar hardware existente. - Además de soportar varios SBC's (single board computers) y otros dispositivos, FreedomBox también contempla ser instalado en una máquina virtual. Y cualquier máquina Debian se puede convertir en FreedomBox instalando el paquete freedombox. Para más detalles acerca de la instalación sobre Debian, ver el manual. -
- Hardware Recomendado - El 22 de Abril de 2019, la FreedomBox Foundation anunció que los kits Pioneer Edition FreedomBox Home Server salían a la venta. Este es el hardware preinstalado recomendado para todos los usuarios que no quieran construirse su propia (máquina) FreedomBox eligiendo los componentes adecuados, descargando la imagen y preparando una tarjeta SD con (el software) FreedomBox. - El kit incluye todo el hardware necesario para arrancar un servidor casero FreedomBox sobre una placa Olimex A20-OLinuXino-LIME2. Este producto proporciona la combinación perfecta de hardware de fuentes abiertas y software libre. Al comprar este producto, soportas también los esfuerzos de la FreedomBox Foundation para crear y promover su software de servidor libre. - - - - - - - - - - - - - - Kits de Servidor Casero FreedomBox Pioneer Edition - - - - - - Kits de Servidor Casero FreedomBox Pioneer Edition - - - - - - -
-
- Hardware Soportado - Usa este hardware si quieres y eres capaz de descargar imágenes FreedomBox y preparar una tarjeta SD siguiendo el manual. Si quieres un proceso más simple de configuración compra por favor los kits FreedomBox con el hardware recomendado. Si usas una placa con tarjetas SD te recomendamos que al grabar la imagen de FreedomBox en tu tarjeta, ésta tenga al menos una capacidad de 8GB. - - - - - - - - - - - - - - - - A20 OLinuXino Lime2 - - - - - - A20 OLinuXino Lime2 - - - - - - - - - - - A20 OLinuXino MICRO - - - - - - A20 OLinuXino MICRO - - - - - - - - - - - PC Engines APU - - - - - - PC Engines APU - - - - - - - - - - - - - Cubietruck - - - - - - Cubietruck - - - - - - - - - - - Cubieboard 2 - - - - - - Cubieboard2 - - - - - - - - - - - BeagleBone Black - - - - - - BeagleBone Black - - - - - - - - - - - - - pcDuino3 - - - - - - pcDuino3 - - - - - - - - - - - Debian - - - - - - Debian - - - - - - - - - - - VirtualBox - - - - - - VirtualBox - - - - - - - - - - - - - Pine A64+ - - - - - - Pine A64+ - - - - - - - - - - - Banana Pro - - - - - - Banana Pro - - - - - - - - - - - Orange Pi Zero - - - - - - Orange Pi Zero - - - - - - - - - - - - - RockPro64 - - - - - - RockPro64 - - - - - - - - - - - Rock64 - - - - - - Rock64 - - - - - - - -
- Comparativa de Hardware - - - - - - - - - - - - - - - - Nombre - - - - - Velocidad CPU (GHz) - - - - - Arquitectura - - - - - RAM (GB) - - - - - disco (GB) - - - - - batería - - - - - SATA - - - - - Velocidad Ethernet - - - - - - OSHW - - - - - - - APU.1D - - - 1x2 - - - amd64 - - - 2 - - - - - - - - - - - (./) - - - 1000x3 - - - {X} - - - - - APU.1D4 - - - 1x2 - - - amd64 - - - 4 - - - - - - - - - - - (./) - - - 1000x3 - - - {X} - - - - - BeagleBone Black C - - - 1 - - - armhf/omap - - - ½ - - - 4 - - - - - - - - - - - 100 - - - (./) - - - - - Cubieboard2 - - - 1x2 - - - armhf/sunxi - - - 1 - - - 4 - - - (./) - - - (./) - - - 100 - - - {X} - - - - - Cubieboard2-Dual - - - 1x2 - - - armhf/sunxi - - - 1 - - - - - - - (./) - - - (./) - - - 100 - - - {X} - - - - - Cubieboard3/Cubietruck - - - 1x2 - - - armhf/sunxi - - - 2 - - - 8 - - - (./) - - - (./) - - - 1000 - - - {X} - - - - - OLinuXino A20 LIME - - - 1x2 - - - armhf/sunxi - - - ½ - - - - - - - (./) - - - (./) - - - 100 - - - (./) - - - - - OLinuXino A20 LIME2 - - - 1x2 - - - armhf/sunxi - - - 1 - - - - - - - (./) - - - (./) - - - 1000 - - - (./) - - - - - OLinuXino A20 MICRO - - - 1x2 - - - armhf/sunxi - - - 1 - - - - - - - (./) - - - (./) - - - 100 - - - (./) - - - - - pcDunino3 - - - 1x2 - - - armhf/sunxi - - - 1 - - - 4 - - - (./) - - - (./) - - - 100 - - - {X} - - - - - Pine A64+ - - - 1.2x4 - - - arm64/sunxi - - - ½,1,2 - - - - - - - - - - - - - - - 1000 - - - {X} - - - - - Banana Pro - - - 1.2x2 - - - armhf/sunxi - - - 1 - - - - - - - - - - - (./) - - - 1000 - - - {X} - - - - - Orange Pi Zero - - - ?x4 - - - armhf/sunxi - - - ¼,½ - - - - - - - - - - - - - - - 100 - - - {X} - - - - - RockPro64 - - - 1.4x4+1.8x2 - - - arm64 - - - 2,4 - - - 16,32,64,128 - - - - - - - (./) - - - 1000 - - - {X} - - - - - Rock64 - - - 1.5x4 - - - arm64 - - - 1,2,4 - - - 16,32,64,128 - - - - - - - (./) - - - 1000 - - - {X} - - - - - -
-
-
- Más Hardware -
- Más Hardware Operativo - Freedombox funciona en este hardware. Pero no se recomienda porque (el hardware) no funciona empleando únicamante software libre: - - - - - - - - - - - - - - - - Raspberry Pi 2 - - - - - - Raspberry Pi 2 - - - - - - - - - - - Raspberry Pi 3 Model B - - - - - - Raspberry Pi 3 Model B - - - - - - - - - - - Raspberry Pi 3 Model B+ - - - - - - Raspberry Pi 3 Model B+ - - - - - - - - - - - - - Raspberry Pi 4 B - - - - - - Raspberry Pi 4 B - - - - - - - - -
-
- Hardware Soportado mediante Imágenes Genéricas - Si ya tienes un hardware que quieres convertir en una FreedomBox, no dejes que la corta lista de hardware soportado te desanime. Si estás usando máquinas de arquitectura AMD o Intel puedes descargar las imágenes genéricas de tu arquitectura y funcionarán en cualquier máquina. Para arquitecturas ARM de 32 o 64 bits, tenemos una solución similar. - A partir de Agosto de 2020 comenzamos a compiler imágenes genéricas que funcionan para todas las computadoras monoplaca basadas en una solución que involucra a los estándares UEFI y al firmware u-boot. Con este enfoque un pequeño firmware específico de la placa residente en una flash SPI o en una tarjeta SD es responsable de cargar una imágen genérica de FreedomBox puesta en una tarjeta SD, un disco USB, SATA o NVMe. De este modo, busca y obtén un firmware basado en u-boot del fabricante de tu hardware y ponlo en una flash SPI o una tarjeta SD. A continuación, asegúrate de que el kernel de FreedomBox soporta tu placa y ponlo en cualquiera de los otros discos de almacenamiento. Este enfoque debería funcionar bien para montones de placas que no están listadas específicamente como soportadas. Mira la sección firmware para más detalles. - Nosotros continuamos compilando imágenes especificas para algún hardware como hacíamos antes. Éstas imágenes tienen la ligera ventaja de que son más fáciles de montar porque conllevan menos pasos. Sin embargo intentamos descontinuarlas porque no arrancan desde todos los dispositivos de almacenamiento y consumen nuestro tiempo, limitando así la cantidad de placas que soportamos. -
-
- Añadir Soporte a Hardware - Si tu hardware no esta en la lista anterior pero fuiste capaz de hacerlo funcionar usando el método descrito anteriormente de usar una imágen genérica, escríbenos y lo incluiremos en la lista. Es más, mira la lista de hardware objetivo con las placas que queremos soportar. -
-
-
- Hardware Obsoleto - Este hardware estuvo soportado anteriormente pero ya no. Si descargaste una imagen anterior y ejecutas FreedomBox sobre algún hardware de estos, seguirás obteniendo actualizaciones de software. Sin embargo, no se publicarán imagenes nuevas. Se recomienda que migres a hardware nuevo y soportado generando una copia de seguridad y restaurándola. - - - - - - - - - - - - - - - DreamPlug - - - - - - DreamPlug - - - - - - - - - - - Raspberry Pi - - - - - - Raspberry Pi - - - - - - - Nota: Hardware soportado significa que las imágenes de FreedomBox se construyen para este hardware y al menos un desarrollador ha informado que las funciones básicas funcionan. -
-
- Información común sobre Hardware - Las siguientes secciones documentan consejos comunes relativos al hardware y periféricos cuando se usan con FreedomBox. -
- Wi-Fi - FreedomBox puede usar hardware Wi-Fi para 2 propósitos distintos: proporcionar conectividad a internet o compartir conectividad a internet previamente disponible a FreedomBox (a través de Ethernet, 3G/4G u otro interfaz Wi-Fi) con otros dispositivos de la red. Ver instrucciones sobre cómo configurar FreedomBox para ambos casos en la página del manual Redes. - Desafortunadamente la mayoría de los adaptadores Wi-Fi requieren firmware que no es software libre, por lo que FreedomBox recomienda conectar dispositivos Wi-Fi USB que not requieran firmware privativo. Al configurar las redes, los dispositivos soportados se muestran automáticamente en la lista de intefaces de red. - Si tienes un dispositivo Wi-Fi que requiera firmware privativo y quieres instalarlo para hacerlo funcionar, consulta la página del wiki de Debian. Una vez el firmware está instalado y se muestra el dispositivo se puede configurar y usar en FreedomBox. -
-
- Alimentación eléctrica - En computadoras monoplaca uno puede toparse con facilidad con situaciones en las que la placa y sus periféricos no reciban suficiente potencia y fallen de modo impredecible. Para evitarlo, use un adaptador de corriente que suministre la corriente mínima recomendada por el fabricante del hardware. Cuando se conectan periféricos adicionales como dispositivos Wi-Fi, o discos USB, SATA o NVMe los requisitos de potencia aumentan. Sería preferible una fuente de alimentación que pueda proporcionar más corriente de la necesaria pero el voltaje debe coincidir con exactitud a la especificación del fabricante. Recuerda que algunas fuentes de alimentación baratas no proporcionan la corriente que prometen. -
-
- Firmware - Los ordenadores normales tienen un software que se ejecuta al arranque llamado UEFI/BIOS. Cuando este software, a veces llamado firmware, se encuentra en algúno de los dispositivos de almacenamiento puede cargar el sistema operativo (en nuestro caso FreedomBox) y pasarle el control. Con la mayoría de las computadoras monoplaca no es así. - Las computadoras monoplaca se suministran con muy poco software que típicamente se limita a cargar un sistema operativo desde tarjetas SD o eMMCs. Normalmente no pueden arrancar desde discos USB, SATA o NVMe. Para remediar esta situación, los fabricantes de hardware empezaron a añadir un dispositivo especial de almacenamiento de unos pocos MiB de tamaño llamado flash SPI con un software especial, típicamente basado en un cargador de arranque libre y de código abierto llamado u-boot, y que aquí llamaremos firmware. Cuando se enciende la computadora arranca el cargador de la flash SPI que a su vez cargará el sistema operativo. Como el firmware es mucho más potente, puede cargar el sistema operativo desde cualquier dispositivo de almacenamiento. Entre los ejemplos de computadoras monoplaca con flash SPI se incluyen la A20-OLinuXino-Lime2 y la RockPro64. - Este enfoque de firmware se puede usar incluso sin flash SPI. Pongamos que uno quiere arrancar desde un disco USB pero la placa no lo soporta. Se puede instalar el firmware en una tarjeta SD (basta una muy pequeña) e insertarla en la placa. El disco USB contendrá a FreedomBox. Al encender la placa arranca el firmware desde la tarjeta SD y este inicia el sistema operativo desde el disco USB o cualquier otra unidad de almacenamiento. - Este enfoque de firmware también nos permite usar imágenes genéricas que funcionan para una gran cantidad de placas. Aunque aumentan un poco el esfuerzo del usuario tiene la ventaja de permitirnos dar soporte a mucho más hardware y permiten poner el sistema operativo en cualquier unidad de almacenamiento. - Cuando se necesite un firmware especial para alguna computadora monoplaca el manual de FreedomBox para esa placa detallará cómo obtenerlo e instalarlo antes de proceder a la installación de FreedomBox. -
-
- Almacenamiento - FreedomBox puede ejecutarse desde varios medios de almacenamiento que soporte tu computadora. Elegir el medio consiste en equilibrar fiabilidad, capacidad y velocidad vs. coste. Para ejecutar FreedomBox se recomienda una capacidad mínima de almacenamiento de 8GB. -
- Tarjeta Digital Segura (SD) - Las tarjetas SD son habituales en las computadoras monoplaca. La mayoría de computadoras monoplaca pueden arrancar directamente desde una tarjeta SD sin necesidad de preparativos adicionales. - Las tarjetas SD suelen ser el medio de almacenamiento más lento de entre los disponibles. FreedomBox será más lento ejecutando ciertas operaciones en estos discos. No todas las tarjetas SD tienen rendimientos similares; las hay mucho más rápidas que otras. Al comprar una tarjeta SD elije una de clase 10 o mayor (suele figurar escrita sobre la tarjeta como un número inscrito en un círculo) o una de clase UHS 1 (escrita sobre la tarjeta como un 1 dentro de un cubo). Las clases UHS 3 (escrita sobre la tarjeta como un 3 dentro de un cubo) o application speed class 1 o superior (escrita como A1 o A2) irán mucho mejor. Finalmente los usuarios de FreedomBox han informado casos en los que algunas tarjetas SD han fallado, por lo que para mayor fiabilidad serían preferibles otros medios de almacenamiento. -
-
- Tarjeta MultiMedia Empotrada (eMMC) - Muchas computadoras monoplaca de nuevo cuño soportan tarjetas eMMC. La mayoría de computadoras monoplaca pueden arrancar directamente desde una tarjeta eMMC sin necesidad de preparativos adicionales. - A veces la eMMC viene soldada a la placa y tendrás que elegir su tamaño al comprar la placa; por ejemplo con la Olimex's A20-OLinuXino-Lime2. Otras veces el fabricante las proporcionará como periférico insertable y en tal caso puedes elegir la eMMC a posteriori o sustituir la que haya por otra de capacidad superior. No andes poniendo y quitandolas demasiado. Tienen un número muy limitado (< 100) de ciclos de reinicio. - Las eMMC son mucho más veloces que las SD o los HDDs de discos rotatorios pero son significativamente más lentas que los SSDs. Estas tiene velocidades de escritura aleatoria mucho mejores, lo que es necesario en muchas operaciones de FreedomBox. En general son preferibles a las SD. - La imágen de FreedomBox se puede montar en una eMMC de 2 maneras. Para eMMC insertables hay disponibles conversores de eMMC a USB. Suelta la eMMC de la placa, insertala en un conversor USB y este en tu máquina, y escribe FreedomBox en ella como harías con una SD. Si la eMMC viene integrada arranca la computadora desde otra unidad, como una SD o un disco USB. Da igual el sistema operativo. Tras arrancar la eMMC se mostrará como disco adicional. Descarga y escribe la imágen de FreedomBox en la eMMC como harías con una SD. -
-
- Unidad de disco USB - La mayoría de ordenadores y computadoras monoplaca tienen puertos USB que aceptan medios de almacenamiento como unidades flash USB, SSDs o HDDs. - Una unidad flash USB puede también servir para ejecutar FreedomBox. Las unidades flash USB 2.0 son mucho más lentas y de rendimiento comparable a las tarjetas SD. Las USB 3.0 rinden mucho mejor. Las unidades flash USB y las tarjetas SD usan una tecnología similar de modo que sus ciclos de lectoescritura y por tanto su fiabilidad adolecen de las mismas limitaciones. - Aparte de unidades flash USB, se pueden insertar discos de estado sólido (SSDs) y discos duros (HDDs) en los puertos USB, ya sea comprando unidades con interfaz USB o usando adaptadores como de USB a SATA o de USB a interfaz M.2. Tanto los SSDs como los HDDs tienen una fiabilidad mucho mayor que las tarjetas SD, eMMC o las unidades flash USB por lo que son preferibles cuando se pueda elegir. Además, las SSDs proporcionan un rendimiento excelente conectadas a través de interfaces USB 3.0. - Al conectar SSDs y HDDs a puertos USB de computadoras monoplaca hay que prestar atención al suministro eléctrico de la unidad de almacenamiento. Si la unidad viene con alimentador propio no hay problema pero si no es así asegúrate de que la monoplaca es capaz de alimentarla comprobando las especificaciones de alimentación de ambas. Usa siempre un adaptador de corriente para la placa que pueda suministrarle siempre la intensidad de corriente mínima recomendada por su fabricante. Son preferibles los adaptadores que puedan suministrar mayor intensidad pero el voltaje debe coincidir exáctamente con la especificación del fabricante. Recuerda que algunas fuentes de alimentación baratas no suministran la intensidad de corriente que prometen. - Montar la imágen de FreedomBox en una unidad USB (flash, SSD o HDD) puede resultar sencillo dado que la mayoría de los ordenadores tienen puertos USB. Inserta la unidad USB en tu ordenador, descarga y escribe la imágen de FreedomBox en la unidad USB. A diferencia de los ordenadores portátiles, los de sobremesa, y las máquinas virtuales, que pueden arrancar desde discos USB, muchas computadoras monoplaca no pueden. Para solucionarlo se necesita un firmware adicional. Consulta la sección firmware. -
-
- Unidad de disco SATA - Algunos ordenadores soportan el interfaz SATA para conectar unidades de estado sólido (SSD) o de disco duro (HDD). La Olimex's A20-OLinuXino-Lime2 es un ejemplo de computadora monoplaca con soporte SATA. El protocolo SATA se usa también para puertos mSATA o ranuras M.2 (con llaves B o M). Tanto las SSDs como los HDDs tienen una fiabilidad muy superior a la de las tarjetas SD, eMMC o unidades flash USB. El interfaz SATA proporciona ratios de transferencia de datos muy buenos (aunque no tanto como las unidaes NVMe basadas en PCIe), por lo que cuando se pueda elegir son preferibles a las tarjetas SD, eMMC o unidades flash USB. - Al conectar SSDs y HDDs a puertos SATA de computadoras monoplaca hay que prestar atención al suministro eléctrico de la unidad de almacenamiento. Si la unidad viene con alimentador propio no hay problema pero si no es así asegúrate de que la monoplaca es capaz de alimentarla comprobando las especificaciones de alimentación de ambas. Usa siempre un adaptador de corriente para la placa que pueda suministrarle siempre la intensidad de corriente mínima recomendada por su fabricante. Son preferibles los adaptadores que puedan suministrar mayor intensidad pero el voltaje debe coincidir exáctamente con la especificación del fabricante. Recuerda que algunas fuentes de alimentación baratas no suministran la intensidad de corriente que prometen. - Para montar la imágen de FreedomBox en una unidad SATA arranca la computadora con otro medio que no sea el disco SATA, como una tarjeta SD. Da igual el sistema operativo. Tras arrancar el disco SATA se mostrará como disco adicional. Descarga y escribe la imágen de FreedomBox en él como harías con una SD. A diferencia de los ordenadores portátiles, los de sobremesa, y las máquinas virtuales, que pueden arrancar directamente desde discos SATA, muchas computadoras monoplaca no pueden. Para solucionarlo se necesita un firmware adicional. Consulta la sección firmware. -
-
- Unidad de disco NVMe - La mayoría de ordenadores portátiles y de sobreesa, y algunas computadoras monoplaca soportan el interfaz NVMe para conectar una unidad de estado sólido (SSD)ya sea mediante una ranura M.2 (con llave B o M) o una PCIe. Si viene con ranura PCIe se puede emplear un adaptador PCIe a M.2 para acomodar una unidad NVMe. La placa Radxa's Rock Pi 4 es un ejemplo de computadora monoplaca con ranura M.2. Un ejemplo de computadora monoplaca con ranura PCIe es la RockPro64 de Pine64. Las SSD basadas en NVMe tienen una fiabilidad muy superior a las tarjetas SD, eMMC o unidades flash USB. Las unidades NVMe proporcionan los mejores ratios de transferencia de datos, por lo que cuando se pueda elegir son preferibles a cualquier otra alternativa. - Al conectar unidades NVMe a computadoras monoplaca hay que prestar atención al suministro eléctrico de la unidad de almacenamiento. Asegúrate de que la monoplaca es capaz de alimentarla comprobando las especificaciones de alimentación de ambas. Usa siempre un adaptador de corriente para la placa que pueda suministrarle siempre la intensidad de corriente mínima recomendada por su fabricante. Son preferibles los adaptadores que puedan suministrar mayor intensidad pero el voltaje debe coincidir exáctamente con la especificación del fabricante. Recuerda que algunas fuentes de alimentación baratas no suministran la intensidad de corriente que prometen. - Para montar la imágen de FreedomBox en una unidad NVMe arranca la computadora con otro medio que no sea el disco NVMe, como una tarjeta SD. Da igual el sistema operativo. Tras arrancar el disco NVMe se mostrará como disco adicional. Descarga y escribe la imágen de FreedomBox en él como harías con una SD. A diferencia de los ordenadores portátiles, los de sobremesa, y las máquinas virtuales, que pueden arrancar directamente desde unidades NVMe, muchas computadoras monoplaca no pueden. Para solucionarlo se necesita un firmware adicional. Consulta la sección firmware. -
-
-
-
- Compilar tus propias imágenes - Todas las imágenes de disco de FreedomBox para hardware diferente las compila el proyecto usando una herramienta conocida como Freedom Maker. Si por algún motivo quieres compilar tus propias imágenes en vez de descargar las disponibles emplea esta herramienta. El archivo README del proyecto proporciona información acerca de la lista de objetivos de compilación hardware disponibles y cómo compilar imágenes. -
- Estado del software empleado - - - Todo el software de las imágenes FreedomBox viene de los repositorios Debian. El script Freedom Maker realiza ajustes menores. - - - Todo el software de las imágenes es software libre que cumple la DFSG excepto en el caso de las imágenes para la Raspberry Pi en las que el paquete de firmware no es software libre. - - - Todas las imágenes usan el kernel Linux de Debian que a su vez se basa en el kernel Linux principal. - - -
-
-
- FreedomBox Pioneer Edition - Los servidores caseros FreedomBox Pioneer Edition los fabrica y vende Olimex, una compañía epecializada en hardware de fuentes abiertas. El Kit incluye hardware de servidor tamaño bolsillo, una tarjeta SD con el sistema operativo preinstalado, y una batería de respaldo que puede alimentar el hardware durante 4-5 horas en casos de indisponibilidad de la red eléctrica. Se vende por 82 €. Olimex ofrece una extensión opcional para almacenamiento de alta capacidad en disco duro o de estado sólido. Al comprar este producto contribuyes a los esfuerzos de la FreedomBox Foundation's para crear y promover su software de servidor libre. - - - - - - - Pioneer Edition FreedomBox Home Server Kit - - - -
-
- Características del Producto -
- HW Recomendado - Éste es el hardware recomendado para los usuarios que quieran simplemente una FreedomBox llave en mano, y no quieran construirse una. - (Construir tu propia FreedomBox implica algunos tecnicismos como elegir y comprar los componentes adecuados, descargar la imágen y preparar una tarjeta SD). -
-
- Este Kit - Este producto proporciona la combinación perfecta de hardware de fuentes abiertas y software libre y open source. Comprando este producto, soportas también los edfuerzos de la FreedomBox Foundation para crear y promover su software libre y open source de servidor. - El Kit de Servidor Casero FreedomBox Pioneer Edition incluye todo el hardware necesario para arrancar un servidor FreedomBox casero sobre una placa Olimex A20-OLinuXino-LIME2: - - - la A20-OlinuXino-LIME2, - - - su carcasa de metal con el logo de FreedomBox grabado mediante laser, - - - una tarjeta micro SD de alta velocidad y 32GB con el software FreedomBox preinstalado, - - - una batería de respaldo, - - - un transformador, - - - un cable Ethernet, y - - - una extensión para almacenamiento de alta capacidad en disco duro o de estado sólido. - - -
-
- Disponibilidad - El servidor casero FreedomBox Pioneer Edition es la primera versión comercial disponible de FreedomBox. - - - Precio: 82 EUR - - - - Tienda Olimex - - - -
-
- Especificaciones del Hardware - El servidor casero FreedomBox Pioneer Edition se basa en la A20-OLinuXino-LIME2 Rev.G - - - Hardware de fuentes abiertas (OSHW): Sí - - - CPU: Allwinner A20, ARM Cortex-A7 dual-core a 1GHz - - - RAM: 1 GiB DDR3 - - - Almacenamiento: tarjeta microSD de 32GB de clase 10+ precargada con FreedomBox - - - SATA: 1 puerto SATA compatible 2.6 a 3Gb/s - - - USB: 2 puertos host de alta velocidad USB 2.0 - - - Batería: Li-Po, 3.3V y 1400mAh (4-5 horas de respaldo si no hay dispositivos adicionales conectados al puerto USB) - - - Ethernet: 10/100/1000, RJ45 (cable de 1 m incluído) - - - Transformador: Entrada a 110-220V, salida a 5V, estilo UE (enchufes opcionales para el Reino Unido o EE.UU) - - - Consumo eléctrico: 1.5W o 5W dependiendo de la carga (corriente entre 0.3A 1 1A) - - - Carcasa: Metálica con la marca FreedomBox - - - Los kits ejecutan sólo Software Libre. Funcionan con núcleo (kernel) y u-boot de los repositorios Debian. Incluso el firmware de arranque de la ROM, llamado BROM es software libre (GPLV2+). - Más información: - - - - Guía de inicio rápido. - - - - - Ficheros fuente del hardware - - - - - Esquéma de la A20-OLinuXino-LIME2 rev.G - - - - - Especificaciones técnicas del SoC A20 - - - -
-
- Extensión para Almacenamiento - Junto con tu servidor casero FreedomBox Pioneer Edition puedes encargar una extensión para almacenamiento consistente en una carcasa para disco SATA, opcionalmente con un disco duro o de estado sólido de entre 128 y 2000 GB de capacidad. Si ya has comprado tu servidor casero sin la extensión puedes encargarla aparte. - - - - Tienda Olimex - - - - Precio: 9 EUR (carcasa suelta sin disco duro, para albergar un disco tuyo) - - - Precio: 42 EUR (con disco de estado sólido de 128 GB) - - - Precio: 69 EUR (con disco de estado sólido de 512 GB) - - - Precio: 42 EUR (con disco duro de 320 GB) - - - Precio: 53 EUR (con disco duro de 500 GB) - - - Precio: 64 EUR (con disco duro de 1000 GB) - - - Precio: 86 EUR (con disco duro de 2000 GB) - - -
-
- Descarga - Los kits vienen con una tarjeta SD precargada con FreedomBox. NO hace ninguna falta descargar imágenes. - No obstante, si deseas restablecer tus dispositivos a un estado virginal puedes hacerlo con la imágen provista. Sigue las instrucciones de la página de descargas para crear una tarjeta SD de FreedomBox y arrancar tu dispositivo. Asegúrate de descargar imágenes para la Pioneer Edition. Estas imágenes de tarjeta SD se usan en la ranura SD de la propia placa y no funcionarán si se insertan en un lector SD externo conectado por USB. - Una alternativa a descargar estas imágenes es instalar Debian en el dispositivo y luego instalar FreedomBox sobre él. -
-
- Construcción de una Imágen - Las imágenes de FreedomBox para este hardware se pueden construir usando Freedom Maker. -
-
- Reparos conocidos - - - La imágen distribuída con los kits usa un u-boot ligéramente modificado en vez de el de serie de Debian como el resto de FreedomBox. Así que si quieres obtener su código fuente usa por favor el repositorio de u-boot del equipo de FreedomBox. - - -
-
-
- Obtener el Código Fuente - FreedomBox es 100% software libre y puedes obtener el código fuente para estudiarlo, modificarlo y distribuir mejoras. -
- Desde (dentro de) FreedomBox - FreedomBox se compone de diferentes programas de software y puedes obtener el código fuente de cualquiera de ellos. Estas instrucciones son similares a obtener y construír código fuente de Debian ya que FreedomBox es una variante pura de Debian. Usando este procedimiento puedes obtener el código fuente de la misma versión del paquete que estás usando actualmene en FreedomBox. - - - Para ver la lista de paquetes software instalados en tu FreedomBox, ejecuta lo siguiente en un terminal: - - - - Para obtener el código fuente de cualquiera de esos programas ejecuta: - ]]> - Esto requiere que el archivo /etc/apt/sources.list contenga información acerca de los repositorios de código fuente. Esto es así por defecto en todas las imágenes FreedomBox. Pero si has instalado FreedomBox desde Debian necesitas asegurarte de que los repositorios de código fuente figuren en este archivo. - - - Para construir el paquete desde su código fuente, primero instala sus dependencias - ]]> - Cambia al directorio fuente creado con el comando apt source: - ]]> - Y construye el paquete - - - - Instala el paquete: - .deb]]> - - -
-
- Otras Maneras de Obtener el Código Fuente - - - El código fuente de cualquier paquete se puede ver y buscar usando el interfaz web de sources.debian.org. Por ejemplo, mira el paquete plinth. - - - El código fuente y el binario precompilado de cualquier version de un paquete, incluyendo versiones antigüas, se pueden obtener de snapshot.debian.org. Por ejemplo, mira el paquete plinth. - - - También puedes obtener los enlaces a la web del proyecto original, al control de versiones del proyecto original, al control de versiones de Debian, registro de cambios, etc. desde la página de control Debian para el proyecto en tracker.debian.org. Por ejemplo, mira la página de control para el paquete plinth. - - - Puedes compilar e instalar un paquete desde el control de versiones de Debian. Por ejemplo, - - - -
-
- Construyendo Imágenes de disco - También puedes construír imágenes de disco FreedomBox para varias platformas de hardware usando la herramienta freedom-maker. Esta también está disponible como paquete Debian y su código fuente se puede obtener empleando los métodos anteriores. Hay disponibles Instrucciones de Construcción para generar imágenes de disco incluídas en el código fuente del paquete freedom-maker. - Las imágenes de disco de FreedomBox se construyen y suben a los servidores oficiales empleando la infraestructura de integración contínua automatizada. Esta infraestructura está disponible también como código fuente y proporciona información precisa acerca de como se contruyen las imágenes de FreedomBox. -
- Imágenes U-boot sobre Pioneer Edition - Hay una excepción menor en el paquete u-boot que viene con el hardware que se vende como Kits de Servidor Casero FreedomBox Pioneer Edition. Contiene un parche pequeño pero importante que no está en el código fuente de Debian. Tanto el repositorio fuente de Debian u-boot como el parche de FreedomBox están disponibles como un repositorio aparte. Esperamos que en algún momento este parche esté integrado en u-boot de serie y este repositorio ya no sea necesario. Este paquete se puede compilar en una máquina Debian armhf como sigue (también se puede hacer compilación cruzada, simplemente sigue las instrucciones para compilación cruzada de paquetes Debian): - - El paquete u-boot Debian estará en u-boot-sunxi*.deb. Este paquete contendrá - -dd if=temp/usr/lib/u-boot/A20-OLinuXino-Lime2/u-boot-sunxi-with-spl.bin of= seek=8 bs=1k conv=notrunc]]> - La imagen resultante tendrá el u-boot modificado. -
-
-
-
- Cubietruck -
- FreedomBox Danube Edition - - - - - - - FreedomBox Danube Edition - - - - FreedomBox Danube Edition is a custom casing around Cubietruck and an SSD-hard drive. -
-
- Cubietruck / Cubieboard3 - Cubietruck (Cubieboard3) is a single board computer with very good performance compared to many other boards. FreedomBox images are built for this device. - Important: Read general advice about hardware before building a FreedomBox with this single board computer. -
-
- Download - FreedomBox SD card images are provided for this hardware. These SD card images are meant for use with the on-board SD card slot and do not work when used with a separate SD card reader connected via USB. - An alternative to downloading these images is to install Debian on the Cubietruck and then install FreedomBox on it. -
-
- Availability - Cubietruck / Cubieboard3 - - - Price: 89 USD - - - - List of suppliers - - - -
-
- Hardware - - - Open Hardware: No - - - CPU: Allwinner A20, ARM Cortex-A7 @ 1GHz dual-core - - - RAM: 2 GiB DDR3 @ 480 MHz - - - Storage: 8 GB NAND flash built-in, 1x microSD slot - - - Architecture: armhf - - - Ethernet: 10/100/1000, RJ45 - - - WiFi: Broadcom BCM4329/BCM40181 (no free WiFi drivers + firmware available) - - - SATA: 1x 2.0 port - - -
-
- Non-Free Status - - - Non-free blobs required: ? - - - WiFi: no free WiFi drivers + firmware available - - -
-
- Known Issues - - - The on-board WiFi does not work with free software. A separate USB WiFi device is recommended. - - -
-
-
- Beagle Bone Black - - - - - - - Beagle Bone Black - - - - Beagle Bone Black (Revision C.1) is an Open Source Hardware (OSHW) single board computer. This means that the designer is actively helping people using the platform for their own designs, and supports them in adding hardware functionality and production advice. This is a part of freedom that is often overlooked, but very much aligned with the FreedomBox goals. FreedomBox images are built and tested for this device. - Important: Read general advice about hardware before building a FreedomBox with this single board computer. -
- Download - FreedomBox SD card images are available for this device. Follow the instructions on the download page to create a FreedomBox SD card and boot the device. - Note: This image is for BeagleBone Black (Revision C.1) only. It will not work on the BeagleBone Green, and also not on the Revisions A&B. If you have such a device and would like to help getting FreedomBox to run on it, contact us! - An alternative to downloading these images is to install Debian on the BeagleBone and then install FreedomBox on it. -
-
- Availability - - - Price: ~ 59 USD (50 EUR) - - - - Mouser Electronics - - - - - Full list of suppliers - - - -
-
- Hardware - - - Open Source Hardware (OSHW): Yes - - - CPU: AM335x 1GHz ARM Cortex-A8 - - - RAM: 512MB DDR3L 800 Mhz - - - Storage: Onboard 4GB, 8bit Embedded MMC and microSD - - - Architecture: armhf - - - Ethernet: 10/100, RJ45 - - - WiFi: None, use a USB WiFi device - - - SATA: None - - -
-
- Non-Free Status - - - Non-free blobs required: No - - - WiFi: Not available - - -
-
-
- A20 OLinuXino Lime2 - - - - - - - A20 OLinuXino Lime2 - - - - Olimex's A20 OLinuXino Lime2 is a fully Open Source Hardware (OSHW) single board computer. This means that the designer is actively helping people using the platform for their own designs, and supports them in adding hardware functionality and production advice. This is a part of freedom that is often overlooked, but very much aligned with the FreedomBox goals. It uses the Allwinner A20 Dual Core ARM processor. - Important: Read general advice about hardware before building a FreedomBox with this single board computer. -
- Similar Hardware - The following similar hardware will also work well with FreedomBox. - - - Olimex's A20 OLinuXino Lime2 4GB. This hardware merely has extra 4GB NAND storage that is not used by FreedomBox. - - -
-
- Download - FreedomBox SD card images are available for this device. Follow the instructions on the download page to create a FreedomBox SD card and boot the device. These SD card images are meant for use with the on-board SD card slot and won't work when used with a separate SD card reader connected via USB. - An alternative to downloading these images is to install Debian on the device and then install FreedomBox on it. -
-
- Availability - - - Price: 45 EUR (A20 OLinuXino Lime2) - - - Price: 55 EUR (A20 OLinuXino Lime2 4GB) - - - - Olimex Store - - - -
-
- Hardware - - - Open Source Hardware (OSHW): Yes - - - CPU: Allwinner A20, ARM Cortex-A7 @ 1GHz dual-core - - - RAM: 1 GiB DDR3 - - - Storage: 4 GB NAND flash built-in (only on 4GB model), 1x microSD slot - - - Architecture: armhf - - - Ethernet: 10/100/1000, RJ45 - - - WiFi: None, use a USB WiFi device - - - SATA: 1x port - - -
-
- Non-Free Status - - - Non-free blobs required: No - - - WiFi: Not available - - - Boot Firmware: BROM (GPLV2+) - - -
-
- Known Issues - - - Revision C hardware has poor performance when receiving Ethernet data in Gigabit mode. To workaround the problem, you can switch to 100 Mbps mode instead of Gigabit mode. Login to your FreedomBox as root (or plugin the SD card into another computer) and create the file /etc/NetworkManager/dispatcher.d/20-fix-ethernet-problem with the following contents: - - - - Revision G2 hardware has poor performance when transmitting Ethernet data in Gigabit mode. Download and use the Pioneer Edition image to fix the issue. It contains a slightly modified u-boot. The above workaround to put the Ethernet into 100 Mbps mode also fixes this issue. - - - Revision K hardware is not working properly. - - -
-
-
- A20 OLinuXino MICRO - - - - - - - A20 OLinuXino MICRO - - - - Olimex's A20 OLinuXino MICRO is a fully Open Source Hardware (OSHW) single board computer. This means that the designer is actively helping people using the platform for their own designs, and supports them in adding hardware functionality and production advice. This is a part of freedom that is often overlooked, but very much aligned with the FreedomBox goals. It uses the Allwinner A20 Dual Core ARM processor. - Important: Read general advice about hardware before building a FreedomBox with this single board computer. -
- Similar Hardware - The following similar hardware will also work well with FreedomBox. - - - Olimex's A20 OLinuXino MICRO 4GB. This hardware merely has extra 4GB NAND storage that is not used by FreedomBox. - - -
-
- Download - FreedomBox MicroSD card images are available for this device. Follow the instructions on the download page to create a FreedomBox MicroSD card and boot the device. These MicroSD card images are meant for use with the on-board MicroSD card slot and won't work on the SD card slot or when using a separate MicroSD card reader connected via USB. - An alternative to downloading these images is to install Debian on the device and then install FreedomBox on it. -
-
- Availability - - - Price: 50 EUR (A20 OLinuXino MICRO) - - - Price: 63 EUR (A20 OLinuXino MICRO 4GB) - - - - Olimex Store - - - -
-
- Hardware - - - Open Source Hardware (OSHW): Yes - - - CPU: Allwinner A20, ARM Cortex-A7 @ 1GHz dual-core - - - RAM: 1 GiB DDR3 - - - Storage: 4 GB NAND flash built-in (only on 4GB model), 1x microSD slot - - - Architecture: armhf - - - Ethernet: 10/100, RJ45 - - - WiFi: None, use a USB WiFi device - - - SATA: 1x port - - -
-
- Non-Free Status - - - Non-free blobs required: No - - - WiFi: Not available - - - Boot Firmware: BROM (GPLV2+) - - -
-
- Known Issues - - - Not visible on local network - - - When booting the 'stable' image (made on 2017-06-18) the board does not automatically get an IP address from the router's DHCP server over ethernet. Booting the 'testing' image (2018-06) the board does get an IP address. Tested on MICRO hardware revision J. see also: - - -
-
-
- APU - - - - - - - PC Engines APU 1D - - - - PC Engines APU 1D is a single board computer with 3 Gigabit ethernet ports, a powerful AMD APU and Coreboot firmware. FreedomBox images built for AMD64 machines are tested to work well for it. - Important: Read general advice about hardware before building a FreedomBox with this single board computer. -
- Similar Hardware - Although untested, the following similar hardware is also likely to work well with FreedomBox. - - - Using amd64 image: - - - - apu1c - - - - - apu1c4 - - - - - apu1d4 - - - - - apu2b2 - - - - - apu2b4 - - - - - apu2c0 - - - - - apu2c2 - - - - - apu2c4 - - - - - apu3a2 - - - - - apu3a4 - - - - - apu3b2 - - - - - apu3b4 - - - - - - Using i386 image: - - - - alix1d - - - - - alix1e - - - - - alix2d2 - - - - - alix2d3 - - - - - alix2d13 - - - - - alix3d2 - - - - - alix3d3 - - - - - alix6f2 - - - - - -
-
- Download - FreedomBox disk images for this hardware are available. Follow the instructions on the download page to create a FreedomBox SD card, USB disk, SSD or hard drive and boot into FreedomBox. Pick the image meant for all amd64 machines. - An alternative to downloading these images is to install Debian on the APU and then install FreedomBox on it. -
-
- Networking - The first network port, the left most one in the above picture, is configured by FreedomBox to be an upstream Internet link and the remaining 2 ports are configured for local computers to connect to. -
-
- Availability - - - Price: 110 - 170 USD (depending on the board and supplier) - - - - PC Engines - - - - - Full list of suppliers - - - -
-
- Hardware - - - Open Hardware: No - - - CPU: AMD G series T40E - - - RAM: 2 GB DDR3-1066 DRAM - - - Storage: SD card, External USB - - - Architecture: amd64 - - - Ethernet: 3 Gigabit Ethernet ports - - - WiFi: None, use a USB WiFi device - - - SATA: 1 m-SATA and 1 SATA - - -
-
- Non-Free Status - - - Non-free blobs required: No - - - WiFi: Not available - - - Boot firmware: Coreboot - - -
-
-
- pcDuino3 - - - - - - - LinkSprite pcDuino3S - - - - LinkSprite pcDuino3S is a single board computer running on Allwinner A20 and sold with a good case. FreedomBox images are built and tested for this device. - Note: The FreedomBox logo is simply a sticker on top of device brought from store. - Important: Read general advice about hardware before building a FreedomBox with this single board computer. -
- Similar Hardware - Although untested, the following similar hardware is also likely to work well with FreedomBox. - - - also covers pcDuino3B - - -
-
- Download - FreedomBox disk images for this hardware are available. Follow the instructions on the download page to create a FreedomBox SD card, USB disk, SSD or hard drive and boot into FreedomBox. Pick the image meant for pcduino3. - An alternative to downloading these images is to install Debian on the APU and then install FreedomBox on it. -
-
- Availability - - - Price: 89 USD - - - - LinkSprite - - - - - Full list of suppliers - - - -
-
- Hardware - - - Open Hardware: No - - - CPU: AllWinner A20 SoC, 1GHz ARM Cortex A7 Dual Core - - - RAM: 1 GB - - - Storage: SD card, 4 GB onboard flash - - - Architecture: armhf - - - Ethernet: 10/100 Mbps - - - WiFi: Built-in WiFi requires non-free firmware, use a USB WiFi device instead - - - SATA: 1 SATA host socket - - -
-
- Non-Free Status - - - Non-free blobs required: No - - - WiFi: Requires non-free firmware - - - Boot Firmware: BROM (GPLV2+) - - -
-
-
- Pine A64+ - - - - - - - Pine 64+ - - - - Pine A64+ is an affordable single board computer with good performance. - Important: Read general advice about hardware before building a FreedomBox with this single board computer. -
- Similar Hardware - - - Both 1GB and 2GB versions of Pine A64+ are supported with the same FreedomBox image. - - - Pine A64-LTS is not supported yet. - - -
-
- Download - FreedomBox SD card images for this hardware are available. Follow the instructions on the download page to create a FreedomBox SD card and boot into FreedomBox. Pick the image meant for Pine A64+. - An alternative to downloading these images is to install Debian on the device and then install FreedomBox on it. -
-
- Availability - - - Price: 29 USD (for the 2 GB variant), 21 USD (for the 1 GB variant) - - - - Pine A64+ with 1 GB RAM at Pine64 Store - - - - - Pine A64+ with 2 GB RAM at Pine64 Store - - - -
-
- Hardware - - - Open Source Hardware (OSHW): No - - - CPU: Allwinner A64, Quad-core ARM Cortex A53 64-bit processor - - - RAM: 3 variants - 512 MB (not recommended), 1 GB and 2 GB (recommended) - - - Storage: SD card, eMMC (module sold separately but not tested with FreedomBox) - - - Architecture: arm64 - - - Ethernet: Gigabit Ethernet port - - - Battery: Supports battery backup using a Li-Po battery - - - WiFi: None, use a USB WiFi device - - - SATA: None - - -
-
- Non-Free Status - - - Non-free blobs required: No - - - WiFi: Not available - - -
-
-
- VirtualBox - - - - - - - VirtualBox - - - - This page will help you get started with using FreedomBox on a virtual machine using VirtualBox. While VirtualBox images are primarily used for testing and development, they can also be used for regular use if you have spare resources on one of your machines. This setup is useful if: - - - You don't own one of the supported hardware devices. - - - You don't use Debian GNU/Linux as your operating system. - - - You don't want to disturb your Debian installation to try out FreedomBox. - - - Prebuilt FreedomBox images for VirtualBox are routinely made available in VirtualBox's own VDI image file format. They contain a Debian GNU/Linux operating system and an installation of FreedomBox with all dependencies ready to run on any OS supported by VirtualBox (Windows, Linux, Macintosh, and Solaris). - A more adventurous alternative to downloading one of these images is to install Debian on VirtualBox and then install FreedomBox on it. - VirtualBox itself is available from (or your distribution's package manager). -
- Download - Follow the instructions on the download page to download and verify a VirtualBox image. The latest images are available on freedombox.org. -
-
- Creating a Virtual Machine - - - Decompress the downloaded VDI image (tool for Windows, Mac). - - - Create a new VM in the VirtualBox UI with OS type Linux and Version Debian (32/64-bit according to the downloaded image). - - - - - - - - - VirtualBox Name and OS dialog - - - - - - In the Hard disk dialog choose Use an existing virtual hard disk file and select the .vdi file you extracted in step 1. - - - - - - - - - VirtualBox Hard disk dialog - - - - - - When created, go to the virtual machine's Settings -> [Network] -> [Adapter 1]->[Attached to:] and choose the network type your want the machine to use according to the explanation in Network Configuration below. The recommended type is the Bridged adapter option, but be aware that this exposes the FreedomBox's services to your entire local network. - - - - - - - - - VirtualBox recommended network setting - - - - Note: It is important to make sure that you have provided the correct network interface in the above step. For example, if the virtual machine is running on a laptop connected to a Wi-Fi network, then the wireless interface (starts with wlp) must be chosen as shown in the screenshot. -
-
- First Boot - When satisfied with the VM settings click the start button in the VirtualBox UI and your new FreedomBox will boot. - The console of the VM will show the textual screen below when finished booting, from here most interaction with FreedomBox will be through the web interface in a browser. - - - - - - - FreedomBox console after booting successfully - - - - If everything went well so far, you should be able to access the web interface of FreedomBox by pointing a browser on the host machine to . - In case freedombox.local cannot be resolved, you need to find out your FreedomBox's IP address as described in Finding out the IP address of the virtual machine. Then access this IP from a web browser which is on the same network as the VM (for example, the host). If all is well, you are now presented with a welcome message and invited to complete the first boot process. - - - - - - - FreedomBox welcomes you to the first boot - - - - This mainly consist of creating an administrative user for the system. -
-
- Using - See the FreedomBox usage page for more details. - You can log in to the Debian GNU/Linux system as the user created during FreedomBox first boot on the VirtualBox console or remotely via ssh. - After logging in, you can become root with the command sudo su. -
-
- Build Image - If you wish to build your own images instead of downloading available images, it can be done using Freedom Maker. -
-
- Tips & Troubleshooting -
- Network Configuration - VirtualBox provides many types of networking options. Each has its advantages and disadvantages. For more information about how various networking types work in VirtualBox, see VirtualBox's networking documentation. - For a simple setup, it is recommended that you use a single network interface in your guest machine. This will make the first boot script automatically configure that interface as an internal network with automatic network configuration. Inside the guest machine, the networking is configured automatically and all the services are made available on this network interface. For more information on how networks are configured by default in FreedomBox, see Networks section. - What remains is to make those services available to the host machine or to other machines in the network. You must then choose one of the following types of networking for the network interface on your guest machine. To set a particular type of network for the guest's network adapter, go to the guest VM's settings then the network options and then select the adapter you wish to configure. There, set the network type from the available list of networks. - - - First and the recommended option is to use the Bridged type of network. This option exposes the guest machine to the same network that host network is connected to. The guest obtains network configuration information from a router or DHCP server on the network. The guest will appear as just another machine in the network. A major advantage of this of setup is that the host and all other machines in the network will be able to access the services provided by guest without requiring any further setup. The only drawback of this approach is that if the host is not connected to any network, the guest's network will remain unconfigured making it inaccessible even from the host. - - - Second method is Host only type of networking. With a guest's network interface configured in this manner, it will only be accessible from the host machine. The guest will not able access any other machine but the host, so you do not have internet access on the guest. All services on the guest are available to the host machine without any configuration such as port forwarding. - - - The third option is to use the NAT type of network. This the networking type that VirtualBox assigns to a freshly created virtual machine. This option works even when host is not connected to any network. The guest is automatically configured and is able to access the internet and local networks that host is able to connect to. However, the services provided by the guest require port forwarding configuration setup to be available outside. - To configure this go to VM settings -> [Network] -> [Adapter] -> [Port Forwarding]. Map a port such as 2222 from host to guest port 22 and you will be able to ssh into FreedomBox from host machine as follows: - - Map 4443 on host to 443 on the guest. This make FreedomBox HTTPS service available on host using the URL You will need to add a mapping for each such services from host to guest. - - - The final option is to create two network interfaces, one host only and one NAT type. This way you can access the guest without any additional configuration, and you have internet access on the guest. The guest will be invisible to any other machines on the network. - - - Summary of various network types: - - - - - - - - - - - - - - - - - Guest accessible from other machines - - - - - Guest accessible from host - - - - - Works without port forwarding - - - - - Works without host connected to network - - - - - Guest has internet access - - - - - - - Bridged - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - Host only - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - - - - - {X} - - - - - - - - - NAT - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - - NAT and Host - - - - - - - - - - {X} - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - - - - - (./) - - - - - - - - - - - -
-
- Finding out the IP address of the virtual machine - This depends on the network configuration you chose. With a bridged adapter, your virtual machine gets its IP address from the DHCP server of your network, most likely of your Router. You can try the first couple of IP addresses or check your router web interface for a list of connected devices. - If you chose host-only adapter, the IP address is assigned by the DHCP server of your VirtualBox network. In the VirtualBox Manager, go to File -> Preferences -> Network -> Host-only Networks. You can see and edit the DHCP address range there, typically you get assigned addresses close to the Lower Address Bound. - Another possibility of finding the IP address is to login via the VirtualBox Manager (or similar software). The FreedomBox images do not have any default user accounts, so you need to set an initial user and password using the passwd-in-image script. - See also QuickStart for instructions on how to scan your network to discover the IP of the VM. -
-
- Networking Problems with macchanger - The package macchanger can cause network problems with VirtualBox. If you have a valid IP address on your guest's host network adapter (like 192.168.56.101) but are not able to ping or access the host (like 192.168.56.1), try uninstalling macchanger: - - You might have to manually remove the script /etc/network/if-prep-up/macchanger. If Debian complains about unmet dependencies when you use a package manager (apt-get, aptitude, dpkg), try to remove 'macchanger' from the dependencies of 'freedombox-setup' in the file /var/lib/dpkg/status. -
-
- Mounting Images Locally - If you want to mount images locally, use the following to copy built images off the VirtualBox: - -
-
- Fixing the time after suspend and resume - The virtual machine loses the correct time/date after suspending and resuming. One way to fix this is to create a cron-job that restarts the time service ntp. You can add a crontab entry as root to restart ntp every 15 minutes by typing 'crontab -e' and adding this line: - - Do not restart this service too often as this increases the load of publicly and freely available NTP servers. -
-
- UUID collision in VB - Whenever this happens VirtualBox shows following error message: Cannot register the hard disk A with UUID ... because a hard disk B with UUID ... already exists in the media registry - Creating several VMs from the same image causes collisions due to ID's (hostname, IP, UUID, etc) that are expected to be universally unique. Most can be handeled operating the running VM. But VirtualBox complains before that (at the very creation of the VM) about the hard disk's UUID. This is usual stuff when you develop/test e.g. FreedomBox. - You can change a clone's UUID in the terminal as follows: - -
-
-
-
- Debian - FreedomBox is a pure blend of Debian. This means that all the work on FreedomBox is available in Debian as packages. It also means that any machine running Debian can be turned into a FreedomBox. - This page describes the process of installing FreedomBox on a Debian system. Currently, FreedomBox works in Debian Stable (Buster), Testing (Bullseye), and Unstable (Sid). - Important: Read general advice about hardware before building a FreedomBox with this approach. - - - Use a fresh Debian installation - - Installing FreedomBox changes your Debian system in many important ways. This includes installing a firewall and regenerating server certificates. It is hence recommended that you install FreedomBox on a fresh Debian installation instead of an existing setup. - - - - Console/GUI logins for non-admin users will be disabled - - After FreedomBox is fully setup, your system will no longer allow users not belonging to the admin group to log in to the system via console, secure shell (SSH) or graphical login. This behaviour can be disabled from the Security page. Use the administrator account created during FreedomBox first boot for console logins and add further user accounts to admin group, if necessary. - -
- Installing on Debian 10.0 (Buster) or newer - Check the Troubleshooting section below, for any tips or workarounds that might help during the install. - - - Install Debian 10.0 (Buster), or Unstable (Sid) on your hardware. - - - Update your package list. - - - - Install freedombox package. - - - - The "DEBIAN_FRONTEND=noninteractive" will avoid several configuration prompts that would otherwise appear during the install. - - - - - During the installation, you will be provided a secret key that needs to be entered during the initial configuration process. Note this down. The secret can also be read at a later time from the file /var/lib/plinth/firstboot-wizard-secret. - - - You can start using FreedomBox. During initial wizard, you will need to enter the secret noted above. - - -
-
- Installing on Debian 9 (Stretch) - Check the Troubleshooting section below, for any tips or workarounds that might help during the install. - - - Install Debian 9 (Stretch) on your hardware. - - - Update your package list. - - - - Install freedombox-setup package. - - - - The "DEBIAN_FRONTEND=noninteractive" will avoid several configuration prompts that would otherwise appear during the install. - - - - - Run FreedomBox setup program. This installs further packages and sets up basic configuration. - - You may have to clear your existing network configuration. See Troubleshooting note #2 below. - - - Reboot the system. This is necessary to trigger the first-run script. - - - - After the system boots up, wait for it to reboot again. The first-run scripts sets up a few things and initiates a reboot. - - - After the second reboot you can start using FreedomBox. - - -
-
- Tips and Troubleshooting - - - There is a bug in policykit-1 package that causes errors and hangs during installation of freedombox-setup package. This bug is only applicable to Debian 9 (Stretch) and older. A workaround is to first install policykit-1 package and then reboot. After that, follow the above setup procedure. - - - - FreedomBox uses NetworkManager to manage network configuration. If you have configured your network interfaces using Debian installer or by editing /etc/network/interfaces, FreedomBox will not manage those interfaces. (See bug #797614.) To let FreedomBox/NetworkManager manage your network interfaces, edit the /etc/network/interfaces manually and ensure that it contains only the following: - - If you have already completed the setup process without doing this step, you will need to clear out the /etc/network/interfaces file keeping only the above lines. Then perform a reboot. On Debian 9 (Stretch), after this network connections configured by the setup step above will configure your network. Network interfaces will then be in the internal or external firewall zone. This is essential for the FreedomBox's web interface to be reachable from other machines in the network. You can tweak network manager connections with the nmtui command if you wish. - - - FreedomBox will use an automatically configured IP address by default. You can assign a static IP address if necessary. Network configuration changes can be done using FreedomBox web interface or by using the nmtui or nmcli commands. nmcli can be used as follows: - - - - ..with the block capitals and somedomain.com replaced with your actual address, mask description, gateway and dns server details. - - -
-
-
- DreamPlug - - - - - - - DreamPlug - - - - - - Deprecated Hardware - - This hardware was supported earlier but is no longer supported. If you downloaded an earlier image and are running FreedomBox on this hardware, you will keep getting software updates. You can stay secure and up-to-date. However, no new images will be provided for this hardware. It is recommended that you migrate to newer, supported hardware using backup and restore. - - DreamPlug is the hardware for which FreedomBox has been originally targeted. FreedomBox images are built and tested for it. For using this device as FreedomBox, a USB WiFi device that does not require non-free firmware is recommended. - You can find more support and discussion for DreamPlug on the official forum. - Recommendation: If you are using a board that uses SD cards, when you flash the FreedomBox image onto your SD card, we recommend that you use an SD card with at least 8GB of storage space. -
- Download - FreedomBox SD card images for this hardware are available. Follow the instructions on the download page to create a FreedomBox SD card and boot into FreedomBox. See also instructions for using an internal micro-SD with DreamPlug. - An alternative to downloading these images is to install Debian on DreamPlug and then install FreedomBox on it. -
-
- Networking - The network port towards the middle of the box, is configured by FreedomBox to be an upstream Internet link. The remaining port is configured for a local computer to connect to. -
-
- Firmware - Note that the factory firmware configurations may vary between revisions of the hardware, and render some images incompatible. See the DreamPlug firmware page for information on what images are compatible and how to update your DreamPlug firmware. -
-
- Build Image - FreedomBox images for this hardware can be built using Freedom Maker. -
-
- Testing - Instructions on how to test this hardware are available. -
-
- Availability - - - Price: 159 USD - - - - DreamPlug manufacturer - - - - Reseller Spinifex in Australia - - -
-
- Hardware - - - Open Hardware: No - - - CPU: Marvell Kirkwood 88F6281 @ 1.2GHz - - - RAM: 512MB 16bit DDR2-800 MHz - - - Storage: 4 GB on board micro-SD - - - Architecture: armel - - - Ethernet: 2x 10/100/1000, RJ45 - - - WiFi: SD8787, 802.11 b/g/n - - - SATA: eSATA 2.0 port - - -
-
- Non-Free Status - - - Non-free blobs required: built-in WiFi - - - WiFi: no free WiFi drivers + firmware available - - - Works with stock Debian kernel: yes - - -
-
- Known Issues - - - WiFi does not work with free software. A separate USB WiFi device is recommended. - - -
-
-
- Raspberry Pi Model B+ - - - - - - - Raspberry Pi (Model B+) - - - - - - Deprecated Hardware - - This hardware was supported earlier but is no longer supported. If you downloaded an earlier image and are running FreedomBox on this hardware, you will keep getting software updates. You can stay secure and up-to-date. However, no new images will be provided for this hardware. It is recommended that you migrate to newer, supported hardware using backup and restore. - - Raspberry Pi (Model B+) is a popular single board computer developed with the intention of promoting teaching of basic computer science in schools. FreedomBox images are built and tested for it. For using this board as FreedomBox, a USB WiFi device that does not require non-free firmware is recommended. - Note: The Debian architecture used for this device is armel. This means floating point computations are done in software and most operations are slower than what Raspberry Pi is capable of. - Recommendation: When you flash the FreedomBox image onto your SD card, we recommend that you use an SD card with at least 8GB of storage space. -
- Download - FreedomBox SD card images for this hardware are available. Follow the instructions on the download page to create a FreedomBox SD card and boot into FreedomBox. -
-
- Build Image - FreedomBox images for this hardware can be built using Freedom Maker. -
-
- Availability - - - Price: 35 USD - - - - List of official distributors - - - -
-
- Hardware - - - Open Hardware: No - - - CPU: ARM1176JZF-S (ARMv6k) 700 MHz - - - RAM: 512 MB - - - Storage: MicroSD card slot - - - Architecture: armel - - - Ethernet: 10/100, RJ45 - - - WiFi: None, use a USB WiFi device - - - SATA: None - - -
-
- Non-Free Status - - - Non-free blobs required: boot firmware - - - WiFi: Not available - - - Works with stock Debian kernel: No - - -
-
- Known Issues - - - The Debian architecture used for this device is armel. This means floating point computations are done in software and generally most operations are slower than what Raspberry Pi is capable of. - - -
-
-
- Raspberry Pi 2 Model B - - - - - - - Raspberry Pi 2 - - - - Raspberry Pi 2 (Model B ) is a popular single board computer developed with the intention of promoting teaching of basic computer science in schools. It is a successor to Raspberry Pi Model B+ with much faster processor and more RAM. FreedomBox images are built and tested for it. - Please do not expect any output on a monitor connected via HDMI to this device as it does not display anything beyond the message 'Starting kernel...'. See the Quick Start page to access and control your FreedomBox from network. - Important: Read general advice about hardware before building a FreedomBox with this single board computer. -
- Download - FreedomBox SD card images for this hardware are available. Follow the instructions on the download page to create a FreedomBox SD card and boot into FreedomBox. -
-
- Availability - - - Price: 35 USD - - - - List of official distributors - - - -
-
- Hardware - - - Open Hardware: No - - - CPU: 900 MHz quad-core ARM Cortex-A7 - - - RAM: 1 GB - - - Storage: MicroSD card slot - - - Architecture: armhf - - - Ethernet: 10/100, RJ45 - - - WiFi: None, use a USB WiFi device - - - SATA: None - - -
-
- Non-Free Status - - - Non-free blobs required: boot firmware - - - WiFi: Not available - - -
-
-
- Raspberry Pi 3 Model B - - - - - - - Raspberry Pi 3 Model B - - - - Raspberry Pi 3 Model B is a popular single board computer developed with the intention of promoting teaching of basic computer science in schools. It is a successor to Raspberry Pi 2 Model B with a 64-bit processor and on-board Wi-Fi. A FreedomBox "testing" image is available for Raspberry Pi 3 Model B. - Please do not expect any output on a monitor connected via HDMI to this device as it does not display anything beyond the message 'Starting kernel...'. See the Quick Start page to access and control your FreedomBox from network. - Important: Read general advice about hardware before building a FreedomBox with this single board computer. -
- Download - FreedomBox SD card images for this hardware are available. Download the "testing" image for Raspberry Pi 3 Model B. Follow the instructions on the download page to create a FreedomBox SD card and boot into FreedomBox. -
-
- Availability - - - Price: 35 USD - - - - List of official distributors - - - -
-
- Hardware - - - Open Hardware: No - - - CPU: 1.2GHz 64-bit quad-core ARMv8 CPU - - - RAM: 1 GB - - - Storage: MicroSD card slot - - - Architecture: armhf - - - Ethernet: 10/100, RJ45 - - - WiFi: 802.11n but requires non-free firmware, instead use a USB WiFi device - - - SATA: None - - -
-
- Non-Free Status - - - Non-free blobs required: boot firmware - - - WiFi: Requires non-free firmware - - -
-
-
- Raspberry Pi 3 Model B+ - - - - - - - Raspberry Pi 3 Model B+ - - - - Raspberry Pi 3 Model B+ is a popular single board computer developed with the intention of promoting teaching of basic computer science in schools. It is a successor to Raspberry Pi 3 Model B with better Ethernet and a 5Ghz Wi-Fi. A FreedomBox "testing" image is available for Raspberry Pi 3 Model B+. - Please do not expect any output on a monitor connected via HDMI to this device as it does not display anything beyond the message 'Starting kernel...'. See the Quick Start page to access and control your FreedomBox from network. - Important: Read general advice about hardware before building a FreedomBox with this single board computer. -
- Download - FreedomBox SD card images for this hardware are available. Download the "testing" image for Raspberry Pi 3 Model B+. Follow the instructions on the download page to create a FreedomBox SD card and boot into FreedomBox. -
-
- Availability - - - Price: 35 USD - - - - List of official distributors - - - -
-
- Hardware - - - Open Hardware: No - - - CPU: 1.4GHz 64-bit quad-core ARMv8 CPU - - - RAM: 1 GB - - - Storage: MicroSD card slot - - - Architecture: armhf - - - Ethernet: 10/100/1000, RJ45 - - - WiFi: 802.11ac but requires non-free firmware, instead use a USB WiFi device - - - SATA: None - - -
-
- Non-Free Status - - - Non-free blobs required: boot firmware - - - WiFi: Requires non-free firmware - - -
-
-
- USB Wi-Fi - FreedomBox works on many single board computers. However, many of these boards do not have built-in Wi-Fi capabilities. Even when Wi-Fi capability is available, non-free proprietary firmware is required to make them work. - A solution to the problem is to plug-in a USB Wi-Fi device into one of the available USB ports. There are many such devices available which do not require non-free firmware to work. The following is a list of such devices that work with FreedomBox devices. Some devices based on these chips have tested to work well with FreedomBox including functions such as access point mode. - - - - Devices with Atheros AR7010 chip - - - - - Devices with Atheros AR9271 chip - - - -
- Firmware Installation - The free firmware for these devices is not packaged in Debian yet. You can manually download and install the firmware as follows: - -
-
- Resources - - - - Debian Wiki on WiFi drivers - - - - - Wikipedia: Comparison of open-source Linux wireless network drivers - - - - - WikiDevi: database of computer hardware - - - -
-
-
- Release Notes - The following are the release notes for each FreedomBox version. -
- FreedomBox 20.13 (2020-07-18) -
- Highlights - - - upgrades: Update apt cache before manual update - - - minidlna: Do not expose statistics over public web - - -
-
- Other Changes - - - backups: Allow remote repository usernames to start with numbers - - - locale: Update translations for Chinese (Simplified), Hungarian, Kannada, Norwegian Bokmål, Spanish, Swedish - - - security: Move backports notice to security page - - - upgrades: Add button to activate backports if needed for current release - - - debian: Rename source package from plinth to freedombox - - -
-
-
- FreedomBox 20.12.1 (2020-07-05) - - - cfg, frontpage: Ignore errors while reading config and shortcuts - - - locale: Update translations for French, German, and Norwegian Bokmål - - -
-
- FreedomBox 20.12 (2020-06-29) -
- Highlights - - - apt: Recover from errors before installing apps or updating system - - - apache: Add strict content security policy, sandbox and other security headers - - - storage: Allow ejecting SATA disks - - - configuration: Allow changes using .d drop-in files - - -
-
- Other Changes - - - configuration: Move default configuration into source code - - - configuration: Read from multiple locations in /etc/ and /usr/share/ - - - debian: Add ssl-cert and nscd as proper dependencies - - - frontpage: Allow adding shotcuts using .d drop-in files - - - frontpage: Read shortcuts from multiple locations in /etc/, /usr/share and /var/lib - - - locale: Update translations for Czech, Danish, French, German, Russian, Spanish, Swedish, Telugu, Turkish - - - storage: Automount system disks without partition table but ignore all loopback devices - - - storage: Allow ejecting SATA disks - - - storage: Show only physical disks and not all mount points - - - upgrades: Skip enabling backports on testing and unstable - - - upgrades: Show more logs - - - ui: Show a spinner and disable button on form submit - - -
-
-
- FreedomBox 20.11 (2020-06-15) -
- Top Highlight - - - locale: Add new translation for Arabic (Saudi Arabia) - - -
-
- Other Changes - - - javascript: Remove use of Turbolinks library - - - locale: Update translations for French, Norwegian Bokmål, German, Swedish, Polish, and Spanish - - - matrixsynapse: Handle upgrade to versions 1.15.x - - - upgrades: Avoid manual update interruption when upgrading freedombox package - - - upgrades: Don't enable backports on Debian derivatives - - -
-
-
- FreedomBox 20.10 (2020-06-01) -
- Top Highlights - - - pagekite: Fix expired certificates causing connection failures - - - tor: Fix problems with running a relay - - -
-
- Other Changes - - - backups: Add optional field - Name - - - cockpit: Promote for advanced storage/firewalld/networking ops - - - firewall: Don't show tun interface in internal zone warning - - - firewall: Mention that internal services are available over VPN - - - ikiwiki: Enable 'attachment' plugin by default - - - locale: Update translations for Spanish, French, Russian, Norwegian Bokmål, Czech, Hungarian, and Greek - - - minidlna: Add link to manual page - - - minidlna: Fix internationalization for name of the app - - - mldonkey: Add app to freedombox-share group - - - openvpn: Use app toggle button and common app view - - - radicale: Fix link in description to clients - - - samba: Add clients information - - - templates: Fix setup state check - - - users: Avoid error when user's groups cannot be parsed - - -
-
-
- FreedomBox 20.9 (2020-05-18) -
- Top Highlights - - - performance: Add app for system monitoring - - - upgrades: Restart services and system when needed after upgrades - - - System restart will happen at 02:00 local time - - - - -
-
- Other Changes - - - bind: Add service alias for bind9 -> named - - - firewall: Reload firewalld so it works with newly installed services - - - first_setup: Fix regression with logo not showing - - - locale: Update translations for Norwegian Bokmål, German, Swedish, Spanish, and Russian - - - mediawiki: Stop jobrunner during backup/restore - - - minidlna: Stop service during backup/restore - - - mumble: Stop service during backup/restore - - - package: Fix error log when checking if package manager is busy - - - performance: Launch the Cockpit graphs directly if possible - - - quassel: Fix stopping service during backup/restore - - - quassel: Use systemd sandboxing features - - - samba: Change description to Network File Storage - - - snapshot: Fix issues with restore and delete - - - snapshot: Set as essential module - - - storage: Auto-mount disks, notify of failing disks - - - tor: Fix stopping service during backup/restore - - -
-
-
- FreedomBox 20.8 (2020-05-04) - - - syncthing: Add service to freedombox-share group - - - users: When adding service to sharing group, only restart if already running - - - datetime: Ignore time synchronization service in containers and virtual machines - - - minidlna: Make app installable inside unprivileged container - - - web_server: Suppress warnings that static directories don't exist - - - debian: Remove unused timer - - - static: Use SVG logo during first wizard welcome step - - - static: Reduce the size of the background noise image - - - setup.py: Don't install/ship .po files - - - static: Don't ship visual design file and unused images - - - all: Update links to repository and project page - - - coturn: Add app to manage Coturn TURN/STUN server - - - mediawiki: Partial fix for installing on testing - - - datetime: Disable diagnostics when no tests are available - - - data: Print hostname and IP addresses before console login - - - snapshot: Fix message when not available - - - snapshot: Fix title - - - mumble: Add Mumla to the list of clients - - - locale: Update translations for Spanish, Telugu, Russian, German, French, and Swedish - - -
-
- FreedomBox 20.7 (2020-04-20) - - - matrixsynapse: Fix initial installation and upgrade from backports - - - gitweb: Improve error handling when creating repository - - - locale: Update translations for French, Serbian, and Telugu - - -
-
- FreedomBox 20.6.1 (2020-04-11) - - - users: Restore line of help text that was accidentally dropped - - - debian: Add firmware-ath9k-htc to Recommends - - - gitweb: Use proper ellipsis char when showing clone progress - - - locale: Update translations for Norwegian Bokmål, German, French, Portuguese, Italian, Russian, and Serbian - - -
-
- FreedomBox 20.6 (2020-04-06) - - - app: Ensure toggle buttons work independently of configuration form - - - networks, monkeysphere: Make styling more specific to avoid interference - - - syncthing: Update description to mention 'syncthing' group - - - radicale: Support upgrade up to any 2.x version - - - packages: Hold freedombox package during package installs - - - users: Add component for managing users and groups - - - app: Fix grammar in developer documentation string - - - ikiwiki: Disable public edits of blog pages - - - ikiwiki: Add moderation of blog comments - - - firewalld: Support upgrade up to any 0.8.x version - - - infinoted: Fix permissions of sync directory - - - locale: Added Serbian translation - - - locale: Update translations for Russian, French, German, Czech, Italian, Hindi, Telugu, and Spanish - - -
-
- FreedomBox 20.5.1 (2020-03-26) - - - networks: Update label wording in topology form - - - jsxc: Fix issue with serving static files - - - debian: Separate binary packages for each language manual - - - locale: Update translations for Norwegian Bokmål and German - - -
-
- FreedomBox 20.5 (2020-03-23) - - - app: Fix description block in app header - - - pagekite: Don't signal new domain on init if app is disabled - - - pagekite: Don't attempt to notify about domain if app is disabled - - - pagekite: Remove app enabled checking from getting configuration - - - pagekite: On enable/disable, add/remove domain from names module - - - pagekite: Fix an error message in custom services form - - - matrixsynapse: Handle release of matrix-synapse 1.11 - - - setup: Fix regression to force-upgrade caused by Info changes - - - pagekite: Don't allow non-unique custom services - - - index: Reintroduce clients button in front page - - - upgrades: Don't ship apt backport preferences file - - - upgrades: Use internal scheduler instead of systemd timer - - - shadowsocks: Change default configuration - - - shadowsocks: Fix incorrect setting of state directory - - - shadowsocks: When editing configuration, don't re-enable - - - mediawiki: Don't allow anonymous edits - - - names: Fix Local Network Domain is not shown - - - shadowshocks: Fix setting configuration on Buster - - - locale: Update translations for Swedish, Spanish, and French - - -
-
- FreedomBox 20.4 (2020-03-09) - - - apache: Handle transition to php 7.4 - - - app: Fix showing app name in port forwarding information - - - apps: Do not show status block if service is running - - - i2p: New style app page layout - - - locale: Update translations for French, Telugu, Spanish, and Swedish - - - networks: Add first boot step for network topology wizard - - - networks: Add form for network topology - - - networks: Don't show router wizard if not behind a router - - - networks, firewall: Support newer version of policykit - - - networks: Fixes for networks wizards access and user experience - - - networks: If topology wizard is skipped, skip router wizard too - - - networks: Show router wizard before Internet connection type wizard - - - plinth: Increase sqlite busy timeout from default 5s to 30s - - - quassel: Fix unable to disable application without choosing a domain name - - - shadowsocks: Move user settings to state directory - - - storage: Directory selection form improvements - - - transmission: Allow to submit download directory if it is creatable - - - upgrades: Clean apt cache every week - - - views: Improve template security - - -
-
- FreedomBox 20.3 (2020-02-24) - - - apps: Update style for toggle button - - - apps: Drop border shadow for app icon in mobile view - - - apps: Show short description as secondary title - - - apps: Remove css filters and glow from app icons - - - cards: Remove the transition delay on hover effect - - - system: Implement new style for cards - - - framework: Generate secret key (existing sessions will get logged out) - - - framework: Cleanup expired sessions every week - - - networks: Add setting for internet connection type - - - networks: Ask about internet connection type during setup - - - shadowsocks: Fix shadowsocks not able to start - - - jsxc: Bypass issue with stronghold to get the app working again - - - monkeysphere: Fix regression with reading Apache configuration - - - help: Fix attribute on download manual button - - - firewall: Improve speed of some operations using DBus API - - - css: Add missing license identifier on some CSS files - - - deluge: Use safer method for editing configuration - - - deluge: More reliable initial configuration setup - - - samba: Add link to manual page - - - searx: Update search engines for 0.16.0 - - - openvpn: Fix spelling for Tunnelblick - - - bind: Show served domains - - - Update translations for German, Swedish, Italian, Spanish, Norwegian Bokmål, Hungarian, Polish, and French - - -
-
- FreedomBox 20.2 (2020-02-10) - - - networks: Support virtual Ethernet (veth) devices - - - diagnostics: Show firewall service status - - - storage: Show disks if FreedomBox is running in an unprivileged container - - - service: Stop service not before but after disabling it - - - users: Use more precise username validation - - - sso, users: Turn off autocapitalization on the username field - - - help: Fix anchor hidden under navbar - - - searx: Fix installation issue for 0.16.0 - - - firewall: Show Run Diagnostics button in app - - - glib: Introduce method to schedule an operation at regular intervals - - - notification: Show a drop down from main navbar for notifications - - - storage: Show low disk space warning using notifications API - - - upgrades: Show notification when FreedomBox is updated - - - security: Add Sandbox Coverage to report page - - - matrixsynapse: Enable systemd sandboxing - - - locale: Update translations for Telugu, French, Norwegian Bokmål, German, Spanish, and Swedish - - -
-
- FreedomBox 20.1 (2020-01-27) - - - deluge: Allow to set a download directory - - - deluge: Fix installation failure on slow machine - - - storage: Make external disk mounts accessible to other users - - - gitweb: Add link to the manual page - - - style: Fix incorrect margins for containers in mobile view - - - style: Fix responsiveness for app header - - - network: Fix activating connections that don't have real devices - - - wireguard: Add WireGuard VPN app - - - networks: Add router configuration page - - - networks: Add first boot step for router config helper - - - bind: Enable sandboxing for bind service - - - locale: Updated translations for Dutch, Norwegian Bokmål, German, Spanish, Swedish, French, and Greek - - -
-
- FreedomBox 20.0 (2020-01-13) - - - samba: Improve speed of actions - - - deluge: Manage deluged service and connect automatically from web interface - - - openvpn: Enable support for communication among all clients - - - storage: Ignore errors resizing partition during initial setup - - - storage: Make partition resizing work with parted 3.3 - - - debian: Add powermgmt-base as recommended package - - - openvpn: Enable IPv6 for server and client outside the tunnel - - - networks: Fix crashing when accessing network manager D-Bus API - - - mediawiki: Use a mobile-friendly skin by default - - - mediawiki: Allow admin to set default skin - - - matrixsynapse: Allow upgrade to 1.8.* - - - security: Add explanation of sandboxing - - - Update translations for Greek, German, Swedish, Hungarian, Norwegian Bokmål, and French - - -
-
- FreedomBox 19.24 (2019-12-30) - - - app: Fix JavaScript doesn't run on first visit - - - samba: Add private shares - - - firewall: Support upgrading firewalld to 0.8 - - - deluge: Add systemd sandboxing features - - - infinoted: Add systemd sandboxing features - - - storage: Add systemd sandboxing features to udiskie service - - - upgrades: Add systemd sandboxing features to repository setup service - - - security: List whether each app is sandboxed - - - mediawiki: Avoid delay in update script - - - diagnostics: Use new component based API for all diagnostic tests - - - minidlna: Fix showing clients information - - - mediawiki: Fix problem with session cache failing logins - - - locale: Update translations for French, German, Swedish, Greek, Hungarian, Norwegian Bokmål, and Dutch - - -
-
- FreedomBox 19.23 (2019-12-16) - - - minidlna: New app for MiniDLNA (Simple Media Server) - - - apps: Show app icons in app pages - - - apps: Implement responsive layout for app pages - - - samba: Recursively set open share directory permissions - - - transmission: Add directory selection form - - - mumble: Add option to set SuperUser password - - - cockpit: Extend apps description with access info - - - cockpit: Add list of valid urls to access the app - - - Update translations for French, German, Spanish, Portuguese, and Swedish - - -
-
- FreedomBox 19.22 (2019-12-02) - - - samba: Add new app for Samba file sharing - - - pagekite: Remove tabs in the configuration page - - - openvpn: Fix text with manual link - - - pagekite: Show existing services only if there are any - - - pagekite: Move Custom Services under Configuration - - - pagekite: Use the new app toggle button - - - openvpn: Add client apps - - - backups: Fix title not appearing - - - diagnostics: Don't run on disabled modules - - - apps: Remove link to webapps in app descriptions - - - interface: Fix error with app toggle input - - - templates: Add toolbar for apps - - - toolbar: Move diagnostics button into dropdown menu - - - ssh: Fix Avahi SFTP service file - - - diagnostics: Fix IPv6 failures - - - matrix-synapse: Fix installation of 1.5 from buster-backports - - - app: Fix javascript constant redeclaration error - - - ikiwiki: Move the create button to manage section - - - gitweb: Move create button into manage section - - - networks: Move actions button into connection section - - - users: Move create button into users section - - - locale: Update translations for French, German, and Swedish - - -
-
- FreedomBox 19.21 (2019-11-18) - - - gitweb: Allow to import from a remote repository - - - interface: Disable turbolinks on links that don't point to /plinth/... - - - backups: Show proper error when SSH server is not reachable - - - tor: Rename "Hidden Service" to "Onion Service" - - - ejabberd: Handle case where domain name is not set - - - tahoe: Mark Tahoe-LAFS as an advanced app - - - searx: Set safe_search to Moderate by default - - - backups: Make verify ssh host page string translatable - - - backups: Simplify SSH fingerprint verification command - - - doc: Fix unavailability of manual images - - - tor: Fix port diagnostics by correcting port data type - - - tor: Expect obfs service to be also available on IPv6 - - - tor: Listen on IPv6 for OrPort - - - clients: implement launch button feature - - - apps: Implement toggle button in apps pages - - - Update translations for German, Hungarian, Swedish, Norwegian Bokmål, French, Polish - - -
-
- FreedomBox 19.20 (2019-11-04) - - - doc: Add Spanish manual - - - ssh: Add option to disable password authentication - - - sharing: Fix wrong links on Apache2 directory index page - - - gitweb: Set correct access rights after enabling application - - - gitweb: Fix links leading to blank page - - - gitweb: Set proper access after restoration of a backup - - - snapshot: Sort snapshot list from newest to oldest - - - infinoted: Add missing manual page link - - - backups: Fix typo - - - Update translations for German, Spanish, Swedish, Czech, French, Norwegian Bokmål, Hungarian - - -
-
- FreedomBox 19.19 (2019-10-21) - - - gitweb: New app for simple git hosting - - - ikiwiki: Allow full Unicode text in wiki/blog title names - - - users: reload Apache2 to flush LDAP cache after user operations - - - ssh: Show server fingerprints in SSH page - - - frontpage: Show public shortcuts to all users regardless of group - - - ikiwiki: Remove extra create button when no wiki/blog is present - - - quassel: Add Let's Encrypt component for certificates - - - Update translations for Czech, French, Bulgarian, Dutch, German, and Norwegian Bokmål - - -
-
- FreedomBox 19.18 (2019-10-07) - - - diagnostics: Ensure that exceptions are reported as failures - - - users: Rearrange UI to match with other apps - - - upgrades, ikiwiki, networks, backups: Replace page tabs with buttons - - - dynamicdns, i2p, pagekite, snapshot: Cleanup page templates - - - deluge: Support deluge 2 by starting it properly - - - minetest: Remove mod-torches no longer available in testing/unstable - - - security: Add past vulnerabilities count, move report to new page - - - Update translations for Spanish, Norwegian Bokmål, German - - -
-
- FreedomBox 19.17 (2019-09-23) - - - firstboot: Add new help menu to firstboot navbar - - - firstboot: Hide left menu during first boot as intended - - - Update translations for Chinese (Simplified) and Czech - - - Fix tests for letsencrypt and tor - - -
-
- FreedomBox 19.16 (2019-09-09) - - - backups: Allow adding backup repositories on multiple disks - - - help: Add buttons for contribute, support, and feedback - - - action_utils: Workaround problem with setting debconf answers - - - views: Fix failure in redirecting from language selection page - - - manual: Move PDF download link to HTML manual page - - - help: Convert help icon in the navbar to dropdown - - - ejabberd: Fix listen port configuration for ejabberd 19.x - - - cockpit, ejabberd: Prevent restart on freedombox startup - - - ejabberd: Perform host/domain name operations only when installed - - - logging: Improve formatting and reduce noise - - - translations: Update Hungarian, German, Italian, French, and Norwegian Bokmål - - -
-
- FreedomBox 19.15 (2019-08-26) - - - security: Hide vulnerability table by default - - - names: Perform better layout of domain names table on small screens - - - cockpit: Apply domain name changes immediately - - - ejabberd: Prevent processing empty domain name - - - config: Send hostname change signal only after fully processing it - - - letsencrypt: Don't try to obtain certificates for .local domains - - - avahi: Expose .local domain as a proper domain - - - cockpit: Make essential and install by default - - - tt-rss: Force upgrade to 18.12-1.1 and beyond - - - updates: Allow matrix-synapse 1.3 to be installed for buster users - - - javascript: Don't resubmit when refreshing the page - - - storage: Fix regression with restoring backups with storage - - - matrix-synapse: Use recommended reverse proxy configuration - - - Update translations for German, Hungarian, and Norwegian Bokmål - - -
-
- FreedomBox 19.14 (2019-08-12) - - - storage: Handle all device paths during eject - - - storage: Fix incorrect internationalization when throwing an error - - - upgrades: Use collapsible-button style for logs - - - firewall: Allow automatic upgrade to 0.7.x - - - upgrades: Handle release info change - - - frontpage: Fix regression with loading custom shortcuts - - - names: Add dynamic domain name - - - names: Add button to configure each type of name - - - names: Update page layout for clearer presentation - - - names: Introduce new API for domain name handling - - - api: Fix regression with listing only enabled apps in mobile app - - - Update translations for Czech, Hungarian, French, Chinese (Simplified), Turkish, Polish, and Norwegian Bokmål - - -
-
- FreedomBox 19.13 (2019-07-29) - - - backups: Make UI more consistent with other apps - - - backups: Make backup location tables collapsible - - - Updated translations for Chinese (Simplified), German, and Norwegian Bokmål - - - help: Show security notice when backports are in use - - - security: Show vulnerability counts - - -
-
- FreedomBox 19.12 (2019-07-22) - - - sharing: Allow directories to be publicly shared - - - backups: Add option to select/deselect all apps for backup or restore - - - dbus: Allow plinth user to own FreedomBox DBus service - - - letsencrypt: Simplify renewal hooks implementation - - - cockpit: Don't handle domains if app is not installed - - - dynamicdns: Send domain added signal properly during init - - - ejabberd: Backup and restore TLS certificates - - - Started new Galician translation on Weblate - - - Updated translations for Czech, Norwegian Bokmål, Hungarian, Spanish, Telugu, Chinese (Simplified), German, Turkish, and Russian - - -
-
- FreedomBox 19.2.2 (2019-07-17) - This release does not contain any functional changes, but fixes test failures when building the package. -
-
- FreedomBox 19.2.1 (2019-07-09) - This is a bugfix release for 19.2. - - - dbus: Allow plinth user to own FreedomBox DBus service - - -
-
- FreedomBox 19.11 (2019-07-08) - - - backups: Fixes to issues while adding SSH remotes: - - - Improve UX of adding ssh remote - - - Avoid creating duplicate SSH remotes - - - Fix issue with repository not being initialized - - - Verify SSH hostkey before mounting - - - Allow SSH directory paths with : in them - - - Require passphrase for encryption in add repository form - - - Don't send passphrase on the command line - - - Un-mount SSH repositories before deleting them - - - - - matrixsynapse: Fix missing translation mark - - - Started new Greek translation on Weblate - - - Updated translations for Chinese (Simplified), Hungarian, Spanish, and Russian - - -
-
- FreedomBox 19.10 (2019-06-24) - - - syncthing: Open firewall ports for listening and discovery - - - radicale: Workaround issue with creating log directory - - - Update translations for Turkish, German, Czech, Norwegian Bokmål, and Portuguese - - - Introduce components for firewall, webserver, uwsgi, and daemons - - -
-
- FreedomBox 19.9 (2019-06-10) - - - config: Add option to show advanced apps, which are hidden by default - - - monkeysphere: Hide by default - - - searx: Add option to allow public access to the application - - - Introduce component architecture for apps, with components for menus and shortcuts - - - Start new translation for Bulgarian - - - Update translations for Turkish and Norwegian Bokmål - - -
-
- FreedomBox 19.8 (2019-05-27) - - - Switch to using SVG icons for all apps. - - - Updated translations for Czech, Norwegian Bokmål, Hungarian, German, Turkish, and Spanish. - - -
-
- FreedomBox 19.7 (2019-05-13) - - - i2p: Include default favorites. - - - Separate enabled and disabled apps. - - - Display port forwarding info for apps. - - - Added Slovenian translation. - - - Updated translations for Dutch, German, Hungarian, Norwegian Bokmål, Polish, Portuguese, Telugu. - - -
-
- FreedomBox 19.6 (2019-04-29) - - - i2p: Enable new application for I2P Anonymity Network. - - - Updated translations for Czech, German, Norwegian Bokmål, and Turkish. - - - letsencrypt: Provide link to configure domain if not configured. - - - firewall: Show port numbers and types. - - -
-
- FreedomBox 19.5 (2019-04-15) - - - storage: Use more reliable method to list disks and disk space usage. - - - Updated translations for Russian and German. - - -
-
- FreedomBox 19.4 (2019-04-01) - - - clients: Open web app in a new browser tab - - - matrix-synapse: Change client diagnostics url - - - minetest: Fix duplicate domain names being displayed in UI - - - storage: Do not show an eject button on /boot partitions - - - letsencrypt: Call letsencrypt manage_hooks with correct arguments - - - dynamicdns: Install module by default - - - storage: Don't check type of the disk for / and /boot - - - storage: Don't log error when checking if partition is expandable - - - Updated translations for Norwegian Bokmål, Czech, German, Hungarian, Spanish, German, and Russian. - - -
-
- FreedomBox 19.3 (2019-03-18) - - - UI: Move tabs below descriptions. - - - firewall: Style heading - - - names: Add description - - - pagekite: Change heading text - - - ikiwiki: Consistent styling for delete warning page - - - main: Show service version in logs - - - setup: Organize data files into various apps - - - Updated translations for Czech, Hungarian, Norwegian Bokmål, Spanish, German, French, Italian, and Turkish. - - -
-
- FreedomBox 19.2 (2019-03-02) - - - config: Fix Ikiwiki entries not showing up as default apps - - - config: Migrate default app configuration to new conf file - - - config: Rename Default App to Webserver Home Page - - - config: Add option to use Apache's default home page as home page - - - config: Fix error when setting JSXC as the home page - - - Disable Coquelicot for Buster release - - - matrix-synapse: Fix LDAP login issue - - - config: Revert changes in freedombox.conf to avoid conffile prompt - - - openvpn: Migration from easy-rsa 2 to 3 for existing installations - - - tor: Use fixed 9001 port for relaying - - - package: Implement identifying packages that need conffile prompts - - - setup: Trigger force upgrade for app that implement it - - - bind: Handle conffile prompt during upgrade - - - apache: Pre-enable necessary apache modules - - - apache: Use cgid module instead of cgi - - - openvpn: Make frontpage shortcut appear after an upgrade - - - openvpn: Work around firewalld bug 919517 - - - firewalld: Implement upgrading from 0.4.x to 0.6.x - - - ttrss: Implement upgrade from 17.4 to 18.12 - - - radicale: Add description of web interface - - - ttrss: Add backup support - - - security: Migrate access config to new file - - - Updated translations for Czech, Hungarian, Norwegian Bokmål, Spanish, German, Telugu. - - -
-
- FreedomBox 19.1 (2019-02-14) - - - radicale: Increment module version to trigger upgrade handling - - - radicale: Remove obsolete diagnostics - - - radicale: Fix server URLs in client info - - - Updated translations for Czech, Norwegian Bokmål, and Spanish. - - - setup: Add option to handle configuration prompts during install - - - radicale: Simplify upgrading to newer packages - - - matrixsynapse: Use Let's Encrypt certificates - - -
-
- FreedomBox 19.0 (2019-02-09) - - - mldonkey: Add some more clients to the module page - - - mldonkey: Add to the description the three available front-ends - - - monkeysphere: Fix handling of multiple domains and keys - - - monkeysphere: Fix regression with reading new apache domain config - - - apache: Switch to mod_ssl from mod_gnutls - - - mldonkey: Enable app - - - upgrades: Fix priority for buster-backports version - - - upgrades: Fix premature adding of buster-backports sources - - - Updated translations for Czech, German, and Spanish - - - Switched to a new version number scheme: YY.N - - - YY is the year of release. - - - N is the release number within that year. - - - - -
-
- Version 0.49.1 (2019-02-07) - - - ui: Fix regression with configure button in home page. - - - backups: Rename 'Abort' buttons to 'Cancel'. - - - backups: Use icon for add repository button. - - - backups: Move subsubmenu below description. - - - backups: Add title and description to other pages. - - - backups: Add link to manual page. - - - backups: Fix styling for upload size warning. - - - backups: Increase timeout for SSH operations to 30 seconds. - - - letsencrypt: UI: Fix checkbox disabling. - - - datetime: Switch from chrony to systemd-timesyncd. - - - Updated translations for Czech, Norwegian Bokmål, and Spanish. - - -
-
- Version 0.49.0 (2019-02-05) - - - security: Update javascript for Content Security Policy. - - - help: Use correct package to determine available version. - - - repro: Disable app due to issues with Debian package. - - - ui: Fix regression with card icon style in front page. - - - js: Support full librejs compatibility. - - - js: Remove javascript license link from footer. - - - backups: Remove incorrectly set buffer size during download. - - - backups: Fix incomplete download archives. - - - backups: Improve performance of backup download. - - - radicale: Handle migration from 1.x to 2.x. - - - datetime: Switch from ntp to chrony. - - - backports: Add buster-backports to apt sources list. - - - Updated translations for Czech, Norwegian Bokmål, and Hungarian. - - -
-
- Version 0.48.0 (2019-01-28) - - - Updated translations for Czech, Hungarian, German, and Norwegian Bokmål. - - - UI improvements: - - - Fix top margin for content containers. - - - Fix setting width of card-list at various page sizes. - - - Show help nav item text when navbar is collapsed. - - - Hide restart/shutdown items when navbar is collapsed. - - - Compact pages on extra small screen sizes. - - - - - Backups improvements: - - - Add backup/restore support for syncthing and openvpn. - - - Upgrade apps before restoring them - - - Fix showing not-installed apps in create backup page - - - Automatically install required apps before restore. - - - Add a loader to the restore button to indicate progress. - - - - - Serve default favicon for apps that don't provide one. - - - radicale: Fix issue with configuration changes not applying. - - - storage: Fix false error message in log when visiting home page. - - - infinoted: Handle timeout issue when stopping daemon during setup. - - - matrix-synapse: Fix startup error caused by bind_address setting. - - - radicale: Avoid changes to conffile for radicale 2.x. - - - help: Fix showing status logs when an error occurs. - - - fail2ban: Enable bans for apache auth failures. - - - mldonkey: Initial work on new module for the eDonkey network. - - - Not available yet, due to bug in package. - - - - -
-
- Version 0.47.0 (2019-01-14) - - - Show Gujarati in the list of languages. - - - Replace glyphicons with forkawesome icons. - - - Snapshots: - - - Change configuration to avoid filling up disk. - - - Handle "Config in use" error. - - - Update descriptions and configuration options. - - - - - Firewall: Fix issue with transition from iptables. - - - Security: Switch to Argon2 password hash. - - - Cockpit: Add link to manual page and update description. - - - Radicale: Add initial support for radicale 2.x. - - - Setup: - - - Handle showing setup page after app completes installation. - - - Optimize installation in-progress checks and refresh time. - - - - -
-
- Version 0.46.0 (2018-12-31) - - - Updated translations for Czech, German, Spanish, Ukrainian, and Norwegian Bokmål. - - - Use systemd journal for logging. - - - Rename plinth binary package to "freedombox", and merge freedombox-setup package into it. - - -
-
- Version 0.45.0 (2018-12-17) - - - Storage: Merge list of removable media into existing table. - - - Backups: Allow remote backups to SSH servers using sshfs. - - - Backups: Removed asking for backup archive name. - - - Automatically handle future versions of PHP. - - - Updated translations for Hungarian, Czech, Spanish, Chinese (Simplified), Italian, Norwegian Bokmål, French, and German. - - -
-
- Version 0.44.0 (2018-12-03) - - - UI: Add card style and gray noise background to apps pages. - - - UI: Fix distortion of the client apps buttons. - - - ejabberd: Handle BOSH port change from TCP 5280 to 5443. - - - Minetest: Update mods list to available Debian packages. - - - Firewall: Use nftables instead of iptables. - - - Snapshots: Fix default snapshot listing. - - - Snapshots: Show description above either tab. - - - Snapshots: Allow snapshots to be selected for deletion. - - - Translations: Updated Czech, Norwegian Bokmål, Spanish, German, and Portuguese. - - -
-
- Version 0.43.0 (2018-11-19) - - - Backups improvements: - - - Allow backups to be downloaded directly, without export step. - - - Restore directly from uploaded backup. - - - Avoid error for apps with no data to backup. - - - Show free disk space on upload and restore page. - - - Do not limit maximum upload size. - - - - - openvpn: Migrate to easy-rsa 3 and fix setup issues. - - - Make single sign-on tickets valid for 12 hours. - - - Use consistent terminology for updates. - - - Updated translations for Czech and Portuguese. - - -
-
- Version 0.42.0 (2018-11-05) - - - Fix wrong color in mobile menu - - - snapshot: Fix broken snapshot management after snapper update - - - Enable backup/restore for tor, upgrades, monkeysphere, letsencrypt, tahoe - - - monkeysphere: Handle importing new OpenSSH format keys - - - udiskie: unmount drive as superuser - - - Updated translations for Telugu, Indonesian, and Italian - - -
-
- Version 0.41.0 (2018-10-22) - - - Enable backup/restore for datetime, deluge, avahi, backups, bind, security, snapshot, ssh, firewall, diagnostics, names, power, and storage. - - - snapshot: Fix issue with setting configuration. - - - backups: Fix backup archives ownership issue. - - - backups: Fix issue with showing exports from disks without labels. - - - backups: Don't rely on disk labels during export/restore. - - - backups: Fix downloading extracted archive files. - - - Updated translations for Norwegian Bokmål, French, Russian, and Spanish. - - -
-
- Version 0.40.0 (2018-10-08) - - - Backups - - - Enable backup/restore for mumble, privoxy, roundcube, searx, jsxc, coquelicot, transmission, quassel, shadowsocks, sharing, pagekite, and cockpit. - - - Allow backup archives to be downloaded/uploaded through browser. - - - mediawiki: Backup/restore settings as well as data. - - - - - User Interface - - - Change card text style and position. - - - Change maximum cards per row. - - - Add tint effect on card icons under "Apps". - - - - - mediawiki: Run update script for 1.31 upgrade. - - - customization: Show custom shortcuts on frontpage. - - - Updated translations for Norwegian Bokmål, Portuguese, Spanish, Czech, German, French, and Italian. - - -
-
- Version 0.39.0 (2018-09-24) - - - Updated translations for Hungarian and Norwegian Bokmål. - - - Merge Removable Media (udiskie) into Storage module. - - - Add Backups module for backing up apps data. - - -
-
- Version 0.38.0 (2018-09-10) - - - mediawiki: Enable SVG support for MediaWiki - - - upgrades: Clean up old kernel packages during automatic upgrades - - - Make the progress bar at the top of the page more visible. - - - Updated translations for Norwegian Bokmål, Czech, Russian, German, Hungarian, and Spanish. - - -
-
- Version 0.37.0 (2018-08-27) - - - Updated translations for Czech, Norwegian Bokmål, Russian, Spanish, Hungarian, and Dutch. - - - install: Use Post/Response/Get pattern for reloads. - - -
-
- Version 0.36.0 (2018-08-13) - - - Updated translations for Hindi, Spanish, Russian, Telugu, German, Hungarian, Czech, and French - - - ejabberd: Remove deprecated settings from already existing config files - - - mediawiki: Fix issue with re-installation - - - mediawiki: Enable Instant Commons - - - mediawiki: Fix images throwing 403s - - - turbolinks: Reload page using JavaScript - - - Add Lato woff2 fonts - - - Disable launch button for web client when not installed - - -
-
- Version 0.35.0 (2018-07-30) - - - configuration: Add an option to set a default app for FreedomBox. The root URL path (https://domainname/) will redirect to the selected app. - - - ejabberd: Remove deprecated iqdisc setting. To apply this fix, disable and then re-enable the Message Archive Management setting. - - - ejabberd: Replace logo with original version. - - - mediawiki: Enable short URLs, which look like https://domainname/mediawiki/ArticleName. - - - radicale: Clarify description for shared calendar/addressbook. - - - storage: Handle mount points with spaces. - - - udiskie: Add button to eject drives. - - - udiskie: Also show read-only filesystems. - - - udiskie: Remove internal networks warning. - - - udiskie: Show special message when no storage device available. - - - Add turbolinks library for smoother navigation. - - - Removed extra text from icons for mediawiki, radicale, and tahoe-lafs. - - - Updated translations for Russian, Spanish, Dutch, Hungarian, Hindi, Italian, Telugu, German, and Norwegian Bokmål. - - -
-
- Version 0.34.0 (2018-07-16) - - - Prompt for secret during firstboot welcome - - - (Does not apply to downloadable FreedomBox images, but only when installed using freedombox-setup package.) - - - - - Updated translations for Italian, Dutch, Hindi, Hungarian - - -
-
- Version 0.33.1 (2018-07-04) - - - Fix issue where editing a user would remove them from admin group - - - Updated translations for Hungarian, Czech, Spanish, Russian, Hindi - - -
-
- Version 0.33.0 (2018-07-02) - - - Updated translations for Hungarian, Norwegian Bokmål, Spanish, Russian, Czech, Hindi, Dutch, Italian - - - firewall: Display information that a service is internal only - - - users: Don't show Create User link to non-admin users - - - users: Redirect to users list on successful user creation - - - packages: Show button to refresh package lists when a package is not available for install - - - Only show front page shortcuts that a user is allowed to access - - - Restrict removal of last admin user - - - Use logos instead of icons in the apps page - - - udiskie: New module for automatic mounting of removable media - - -
-
- Version 0.32.0 (2018-06-18) - - - Apply new card based design - - - Fix client info table size and flickering - - - first-setup: Automatically expand root partition - - - mediawiki: Enable image uploads - - - mediawiki: Make private mode and public registrations mutually exclusive - - - mediawiki: Hide frontpage shortcut when private mode is enabled - - - Updated translations for Norwegian Bokmål, Czech, Spanish, Russian, Hindi, Telugu, Italian, Dutch, German, and Hungarian - - -
-
- Version 0.31.0 (2018-06-04) - - - Updated translations for Czech, Spanish, Russian, German, Italian, Hindi, Telugu, and Norwegian Bokmål - - - mediawiki: Added private mode option - - - users: Fix user permissions not being saved - - - users: internationalize a string - - - mediawiki: Run update script for 1.30 upgrade - - - shortcuts: Fix urls for ikiwiki shortcuts - - -
-
- Version 0.30.0 (2018-05-21) - - - Updated translations for Russian, Italian, Norwegian Bokmål, Hungarian, and Hindi - - - setup: Remove unavailable as a state in setup_helper - - -
-
- Version 0.29.1 (2018-05-08) - - - security: Fix issue with Plinth locked out from sudo - - - Updated translations for Czech and Spanish - - -
-
- Version 0.29.0 (2018-05-07) - - - security: Allow console login access to user plinth - - - Add an option to enable/disable public registrations in mediawiki - - - tt-rss: Skip the check for SELF_URL_PATH - - - searx: Fix issue with uwsgi crashing - - - Updated translations for Czech, Spanish, German, Norwegian Bokmål, and Italian - - -
-
- Version 0.28.0 (2018-04-23) - - - setup: disable install button for currently unavailable apps - - - Add locale for Lithuanian (lt) - - - Translation updates for Italian, Czech, Russian, Spanish, German, Norwegian Bokmål, Telugu, and Dutch - - -
-
- Version 0.27.0 (2018-04-09) - - - middleware: Skip 'installed' message for essential apps - - - users: Fix admin group appearing twice in permissions - - - apps: Fix app names and short descriptions not being translated - - - snapshots: Move manual page link to the index page - - - UI: Fix progress bar not appearing - - - snapshots: Fix for permissions issue when updating configuration - - - snapshots: Add option to enable/disable software installation snapshots - - - Translation updates for Italian, Czech, Russian, Spanish, Dutch, German, Norwegian Bokmål, and Ukrainian - - -
-
- Version 0.26.0 (2018-03-26) - - - snapshots: Update description - - - searx: Rewrite url from /searx to /searx/ - - - manual: Link to manual from each service - - - Workaround security issues in django-axes - - - apache: Only regenerate snake oil cert when needed - - - apache: Explicitly enable the latest version of PHP module - - - apache: Increase module version number to fix php7.2 - - - Update translations for Chinese (Simplified), Russian, Czech, German, Norwegian Bokmål, Hungarian, Spanish, and Italian - - -
-
- Version 0.25.0 (2018-03-12) - - - sharing: Add app for sharing disk folders. - - - ttrss: Update list of client apps. - - - infinoted: Allow setup to recover after timeout issue. - - - snapshots: Add configuration tab with settings for time-based snapshots. - - -
-
- Plinth v0.24.0 (2018-02-26) - - - Add file-sharing application Coquelicot. - - - Add metasearch engine application Searx. - - - Add locale for Hungarian (hu). - - - mediawiki: Allow shortcut to be publicly visible on front page. - - - clients: Add and correct Client Apps. - - - locale: Preferred language can be set in each user's profile. - - - locale: Anonymous users can select preferred language. - - - config: Remove language selection from config page. - - - matrixsynapse: Fix mail attribute for ldap login. - - -
-
- Plinth v0.23.0 (2018-02-12) - - - snapshots: Modify configurations to reduce disk usage. - - - snapshots: Skip currently active snapshot when deleting all snapshots. - - - jsxc: Use consistent url format. - - - sso: Increase timeout to 60 minutes. - - - theme: Change font from Helvetica to Lato. - - - Translation updates for Czech, German, Gujarati, and Telugu. - - -
-
- Plinth v0.22.0 (2018-01-30) - - - matrix-synapse: Make sure configuration file does not get corrupted. - - - tor: Show enabled status properly. - - - first_setup: Fix not showing admin user creation step. - - - Migrate from GitHub to Salsa - - - Migrate from CirceCI to GitLab CI on Salsa. - - - Translation updates for Czech, Dutch, Gujarati, Hindi, Russian and Telugu. - - - Started new translation for Ukrainian. - - -
-
- Plinth v0.21.0 (2018-01-15) - - - navigation bar: Change label from 'Configuration' to 'System'. - - - storage: Removed beta warning for expanding partition. - - - groups: Consistently show available user groups, even before applications are installed. - - - syncthing: Restrict administration to users in "syncthing" group. - - - help: Show menu on smaller screens also. - - - diagnostics: Enable the "Run Diagnostics" button when applications are enabled but not running. - - -
-
- Plinth v0.20.0 (2018-01-01) - - - bind: Don't use forwarders by default - - - ejabberd: Remove redundant button Client Apps - - - mediawiki: Add wiki application - - - users: Make sure first run actually works - - - bind: Add information about current utility - - -
-
- Plinth v0.19.0 (2017-12-18) - - - ejabberd: Use dynamic reload instead of restart when changing configuration. - - - manual: Make manual available as a PDF download. - - - minetest: Show domain information for users to connect to minetest. - - - snapshots: Add button to delete all snapshots. - - - snapshots: Add option to enable/disable automatic timeline snapshots. - - - users: Add groups for bit-torrent and feed-reader, available when these applications are installed. - - -
-
- Plinth v0.18.0 (2017-12-04) - - - Add Shadowsocks client with socks5 proxy. - - - Fix SSO regressions and conflict with captcha. - - - transmission: Fix sso not being enabled on upgrade. - - - avahi: Add service for FreedomBox discovery. - - - Add client information for modules. - - -
-
- Plinth v0.17.0 (2017-11-20) - - - transmission: Enable Single Sign On. - - - cockpit: Add short description to frontpage shortcut. - - - fail2ban: Fix spelling and sentence structure. - - -
-
- Plinth v0.16.0 (2017-11-06) -
- Added - - - Add mobile, web and desktop client info for modules. - - - Enable django SecurityMiddleware to improve security ratings. - - - cockpit: New module for server administration and web terminal. - - -
-
- Fixed - - - letsencrypt: Fix internal server error when obtaining a certificate. - - - ejabberd: Fix LDAP server entry in config file during setup. - - - jsxc: Fix outdated URLs for connecting to local ejabberd server. - - -
-
-
- Plinth v0.15.3 (2017-10-20) -
- Changed - - - Rename Disks to Storage. - - - Rename Snapshot to Storage Snapshots. - - - tt-rss: Enable API access by default. - - - Allow access to Plinth from outside the LAN. - - - matrix-synapse: Disable public registration by default. - - - power: Merge actions into the user dropdown. - - -
-
- Added - - - Add locales for Kannada (kn) and for Bengali (bn). - - - ejabberd: Use Let's Encrypt certificate, also across renewals. - - - matrix-synapse: Add enable/disable public registrations. - - - Add captcha validation on 3 failed attempts. - - - matrix-synapse: Enable LDAP integration. - - - letsencrypt: Automatically obtain and revoke SSL certificates. - - -
-
- Fixed - - - Fix front page label names. - - - Fix vertical alignment of shortcut icons. - - - storage: Fix issue with locales that use other decimal separators. - - - Make tt-rss api accessible using Apache basic auth. - - - letsencrypt: Handle case where current domain is empty. - - - Handle both admin and non-admin user names in update user template. - - -
-
-
- Plinth v0.15.2 (2017-09-24) -
- Added - - - letsencrypt: Show more info on cert validity status. - - - letsencrypt: Add option to delete certificates. - - - letsencrypt: Add option to let Plinth manage certbot's renewal hooks. - - - power: Warn if a package manager is running before shutdown/restart. - - - security: Install and manage fail2ban. - - - names: Include domain and services from dynamicdns. - - - disks: Add low disk space warning to system and disks page. - - - ssh: New application to manage SSH server. - - - Add api module to get enabled services and access info. - - - Add Django password validators. - - - ejabberd, ikiwiki, ttrss: Add user login descriptions. - - -
-
- Removed - - - diaspora: Disable for this release due to issues affecting package. - - - Remove help from navbar before firstboot complete. - - -
-
- Fixed - - - i18n: Don't use backslash-newline for wrapping long lines. - - - radicale: Update link to documentation. - - - sso: Upgrade crypto to 4096-bit RSA and SHA-512. - - - Users: Allow non-admin users to log out. - - -
-
- Changed - - - letsencrypt: Make Let's Encrypt an essential module. - - - UI: Make apps and configure pages responsive on small screens. - - - Make help accessible for logged-in non-admin users. - - -
-
-
- Plinth v0.15.0 (2017-07-01) - - - Added Tahoe-LAFS module for distributed file storage. - - - Added Diaspora* module for federated social networking. - - - Currently only available in "contrib" repository. - - - - - New Locales for Czech (cs) and Tamil (ta). - - - Added SSO using auth_pubtkt for Syncthing, TT-RSS, and the Repro admin panel. - - - If you are logged in to Plinth, you will be automatically logged in to these web apps. - - - - - ejabberd: Added option to enable/disable Message Archive Management. - - - help: Added Debian release name to about page. - - - firstboot: De-bloat first welcome screen. - - - Pinned footer to the bottom of the viewport. - - - disks: Restrict precision of reported available space on root partition. - - - diagnostics: Disable button if app/service is not running. - - - help: Only show help pages if user is logged in. - - - navbar: Moved logout to user drop-down and added a new power drop-down. - - - disks: Show disabled partition resize option if no space is available. - - - Added line break to titles to fix frontpage layout. - - - syncthing: Fixed typos and clarity in description. - - - firewall: Fix 500 error when firewalld is not running. - - - setup: Disable install/upgrade when dpkg/apt is running. - - - disks: Use information from lsblk for more accuracy. - - - datetime: Show timezone properly when it not in expected list. - - -
-
- Plinth v0.14.0 (2017-04) - - - tor: Added option to use upstream bridges. - - - openvpn: Added shortcut to front page, shown only when logged-in. - - - openvpn: Non-admin users can download their own profiles. - - - Added new locales for Hindi (hi) and Gujarati (gu). - - - Added Syncthing module for file synchronization. - - - Added Matrix Synapse as chat server with groups, audio and video. - - - Require admin access for all system configuration pages. - - - Changed appearance of topbar and footer. - - - openvpn: Regenerate user key or certificate if empty. - - - disks: Workaround issue in parted during resize. - - -
-
- Plinth v0.13.1 (2017-01-22) - - - Two new apps were added: - - - Gobby Server (infinoted) for collaborative editing of text documents - - - Domain Name Server (BIND), in system menu - - - - - Added JavaScript license web labels to provide partial support for LibreJS. - - - Added basic configuration form for Minetest server. - - - Added indicator to Help->About page if new Plinth version is available. - - - Show app logos on front page instead of generic icons. - - - Prevent anonymous users from accessing setup pages. - - - Split Chat Server (XMPP) app into Chat Server (ejabberd) and Chat Client (jsxc). - - -
-
- Plinth v0.12.0 (2016-12-08) - - - Open up RTP ports in the firewall for repro (SIP server). - - - Front page shortcuts for services show a Configure button in the details box for logged-in users. - - - Add mods packages to be installed with Minetest server. - - - Fix issue with reading Dynamic DNS status as non-root user. - - - After the hostname is changed, ensure the domain name is still set correctly. - - - Allow the domain name to be cleared, and properly set the configuration in this case. - - - On the Certificates (Let's Encrypt) page, show a more informative message when no domains are configured. - - - On the Chat Server (XMPP) page, show more clearly if domain is not set. - - - Apps that require login will not be shown on the front page, unless the user is logged in. - - - Show status block for News Feed Reader (Tiny Tiny RSS). - - - Change appearance of front page with larger icons and repositioned text. - - - Firewall page only lists services that have been setup. The port lists are collapsible under each service. - - - Support configuring IPv6 networks. - - - Make it less likely to accidentally delete the only Plinth user. - - - Updated to work with JSXC 3.0.0 (XMPP web client). - - -
-
- Plinth v0.11.0 (2016-09-29) - - - Added loading icon for additional busy operations. - - - Added basic front page with shortcuts to web apps, and information about enabled services. - - - networks: Add batctl as dependency, required for batman-adv mesh networking. - - - users: - - - Fixed checking restricted usernames. - - - Display error message if unable to set SSH keys. - - - Flush nscd cache after user operations to avoid some types of errors. - - - - - monkeysphere: - - - Adopted to using SHA256 fingerprints. - - - Sort items for consistent display. - - - Handle new uid format of gpg2. - - - Fixed handling of unavailable imported domains. - - - - - minetest: Fixed showing status block and diagnostics. - - - Fixed stretched favicon. - - - Switched base template from container-fluid to container. This will narrow the content area for larger displays. - - - Plinth is now able to run as "plinth" user instead of root user. - - - xmpp: Replaced jwchat with jsxc. - - - ikiwiki: Allow only alphanumerics in wiki/blog name to avoid invalid paths. - - -
-
- Plinth v0.10.0 (2016-08-21) - - - Updated Plinth to support Django 1.10. - - - Added a page to display recent status log from Plinth. It is accessible from the 500 error page. - - - Tor: Added options to toggle relay and bridge relay modes. - - - Radicale: Added access rights control. - - - Ikiwiki: Updated suggested packages. - - - Users and Groups: Fixed editing users without SSH keys. - - - Networks: Added basic support for configuring batman-adv mesh networking. - - - Networks: Fixed incorrect access for retrieving DNS entries. - - - New languages: - - - Persian (50% translated) - - - Indonesian (not started, contributions needed) - - - - - New modules added to Plinth: - - - Disks: Shows free space of mounted partitions, and allows expanding the root partition. - - - Security: Controls login restrictions. - - - Snapshots: Manages Btrfs snapshots. - - - - -
-
- Version 0.9.4 (2016-06-24) - - - Added Polish translation. - - - Fixed issue preventing access to Plinth on a non-standard port. - - - Dealt with ownCloud removal from Debian. The ownCloud page in Plinth will be hidden if it has not been setup. Otherwise, a warning is shown. - - - Fixed issue in Privoxy configuration. Two overlapping listen-addresses were configured, which prevented privoxy service from starting. - - - Fixed issue that could allow someone to start a module setup process without being logged in to Plinth. - - - Fixed issues with some diagnostic tests that would show false positive results. - - - Added check to Diagnostics to skip tests for modules that have not been setup. - - - Fixed some username checks that could cause errors when editing the user. - - - Added sorting of menu items per locale. - - - Moved Dynamic DNS and Pagekite from Applications to System Configuration. - - - Allowed setting IP for shared network connections. - - - Switched Dreamplug image from "non-free" to "free". This means that we no longer include the non-free firmware for the built-in wifi on Dreamplug. - - - Added the "userdir" module for the Apache web server. This allows users in the "admin" group to create a folder called "public_html" under their home folder, and to publicly share files placed in this folder. - - - New wiki and manual content licence: Creative Commons Attribution-ShareAlike 4.0 International (from June 13rd 2016). - - - Switched to using apt-get for module setup in Plinth. This fixes several issues that were seen during package installs. - - -
-
- Version 0.9 (2016-04-24) - - - Fixed Wi-Fi AP setup. - - - Prevent lockout of users in 'sudo' group after setup is complete. - - - Improved setup mechanism for Plinth modules. Allows users to see what a module is useful for, before doing the setup and package install. Also allows essential modules to be setup by default during FreedomBox install. - - - Added HTTPS certificates to Monkeysphere page. Reorganized so that multiple domains can be added to a key. - - - Added Radicale, a CalDAV and CardDAV server. - - - Added Minetest Server, a multiplayer infinite-world block sandbox. - - - Added Tiny Tiny RSS, a news feed reader. - - -
-
- Version 0.8 (2016-02-20) - - - Added Quassel, an IRC client that stays connected to IRC networks and can synchronize multiple frontends. - - - Improved first boot user interface. - - - Fixed Transmission RPC whitelist issue. - - - Added translations for Turkish, Chinese, and Russian. Fixed and updated translations in other languages. - - - Added Monkeysphere, which uses PGP web of trust for SSH host key verification. - - - Added Let's Encrypt, to obtain certificates for domains, so that browser certificate warnings can be avoided. - - - Added repro, a SIP server for audio and video calls. - - - Allow users to set their SSH public keys, so they can login over SSH without a password. - - -
-
- Version 0.7 (2015-12-13) - - - Translations! Full translations of the interface in Danish, Dutch, French, German and Norwegian Bokmål, and partial Telugu. - - - Support for OLinuXino A20 MICRO and LIME2 - - - New Plinth applications: OpenVPN, reStore - - - Improved first-boot experience - - - Many bugfixes and cleanups - - -
-
- Version 0.6 (2015-10-31) - - - New supported hardware target: Raspberry Pi 2 - - - New modules in Plinth: - - - Shaarli: Web application to manage and share bookmarks - - - Date & Time: Configure time zone and NTP service - - - Service Discovery: Configure Avahi service - - - - - Documentation revamp including new user manual and developer guide - - - Improved diagnostic tests, available in Plinth - - - Avoid unnecessary changes when installing on existing Debian system - - - Network configuration supports PPPoE connections - - - Debian packages can be download over Tor - - -
-
- Version 0.5 (2015-08-07) - - - New targets: CubieTruck, i386, amd64 - - - New apps in Plinth: Transmission, Dynamic DNS, Mumble, ikiwiki, Deluge, Roundcube, Privoxy - - - NetworkManager handles network configuration and can be manipulated through Plinth. - - - Software Upgrades (unattended-upgrades) module can upgrade the system, and enable automatic upgrades. - - - Plinth is now capable of installing ejabberd, jwchat, and privoxy, so they are not included in image but can be installed when needed. - - - User authentication through LDAP for SSH, XMPP (ejabberd), and ikiwiki. - - - Unit test suite is automatically run on Plinth upstream. This helps us catch at least some code errors before they are discovered by users! - - - New, simpler look for Plinth. - - - Performance improvements for Plinth. - - -
-
- Version 0.3 (2015-01-20) - - - Tor Bridges: All boxes now act as non-exit Tor bridges, routing traffic for the Tor network. - - - Firewall: firewall is on by default and is automatically managed. - - - Add BeagleBone support. We now have images for BeagleBone, RaspberryPi, VirtualBox i386/amd64, and DreamPlug. - - - Ability to enable and use Tor Hidden Services. Works with Ejabberd/JWChat and ownCloud services. - - - Enable Tor obfsproxy with scramblesuit. - - - Drop well-known root password (an account with sudo capabilities still exists for now but will be removed soon). - - - Switch to unstable as suite of choice for easier development. - - - Newer images are built with systemd by default (due to Debian change). - - - Install and operate firewall automatically (uses firewalld). - - - Major restructuring of Plinth UI using Python3, Django web development framework and Bootstrap3. Code quality is much better and UI is more polished. - - - Introduced packaging framework in Plinth UI for on-demand application installation. - - -
-
- Version 0.2 (2014-03-16) - - - Support for Raspberry Pi and VirtualBox (x86) in addition to the DreamPlug. - - - New Services: - - - Configuration Management UI. - - - Instant Messaging. - - - OwnCloud. - - - dnsmasq. - - - Low-Level Configuration Management. - - - Service Announcement. - - - LDAP Server. - - - LXC Support. - - - Source Packages. - - - - - The privoxy setup is now the default from Debian. - - -
-
- Version 0.1 (2013-02-26) - - - First FreedomBox software release (0.1 image, developer release). - - - Full hardware support in Debian - - - Support for DreamPlug. - - - Basic software tools selected as common working environment: - - - User interface system "plinth" - - - Cryptography tools: gpg or "monkeysphere" - - - Box-to-box communication design: Freedom-buddy (uses TOR network) - - - Web cleaning: "privoxy-freedombox". - - - - -
-
-
-
- Contribuir - Desde la codificación, el diseño y la traducción hasta la divulgación y las donaciones he aquí varias formas de contribuir a FreedomBox. -
- Enlaces Rápidos - - Manual del Desarrollador de FreedomBox - - - Reuniones de revisión de avance - - - Página de trabajos pendientes - - - Página de Donaciones - -
-
- Bienvenida a los recién llegados - Como nuevo contribuyente, eres más que bienvenido a presentarte a otros en el foro de debate, la lista de correo o el canal de IRC de FreedomBox. Además de hacer contactos útiles, puedes empezar a informar fallos y traducir (ver abajo) el wiki y el interfaz de FreedomBox. -
-
- Prioridades de Desarrollo - Las prioridades se discuten regularmente. Encontrarás el avance del Servicio FreedomBox con sus prioridades aquí: panel de tareas e hitos. - Por favor, asiste a las próximas reuniones de avance para mantenerte al día y tratar con los miembros del equipo de publicación (release). La Página de trabajos pendientes recopila la lista completa de los elementos en los que trabajar para FreedomBox. -
-
- Se necesitan Contribuciones -
- Añadir una Aplicación - Si eres desarrollador y quieres ver disponible en FreedomBox alguna aplicación, puedes contribuir añadiéndola a FreedomBox. Mira el Manual del Desarrollador de FreedomBox. -
-
- Defectos - Las listas de defectos, peticiones de funcionalidad y mejoras se controlan en el gestor de tiquets de FreedomBox. Mira también la lista de defectos para ayudar al paquete Debian del que dependemos y el cuadro de mando del equipo de paquetizado de FreedomBox para ver el estado los paquetes que usamos. -
-
- Codificar - Si eres desarrollador puedes contribuir código a algún sub-proyecto de FreedomBox. Éste es el procedimiento paso a paso para contribuir código. - - - Servicio FreedomBox: un interfaz web para administrar las funciones de FreedomBox. - - - Freedom Maker: un script para construir imágenes de disco de FreedomBox para usarlas en dispositivos de hardware variados o en máquinas virtuales. - - - Puedes tomar una tarea de la Página de trabajos pendientes. Las páginas de cada proyecto contienen información acerca de acceso al código, cómo construir y listas de trabajos pendientes. -
-
- Diseño -
- Diseño de Experiencia de Usuario (UX) - Si eres diseñador de UX, puedes ayudar a FreedomBox con esto: - - - Experiencia de interacción para el interfaz web del Servicio FreedomBox. - - - Diseño web para los sitios freedombox.org, freedomboxfoundation.org y el wiki. - - - Logo y marca (actualmente tenemos un manual de identidad y logos). - - - Propuestas de diseño para casos de uso de FreedomBox sobre SBCs personalizados. - - - - Diseño de UX - - - -
-
- Diseño Técnico - FreedomBox necesita tu conocimiento técnico para elaborar planes de implementación de nuevas funcionalidades. Puedes contribuir a los debates acerca de varios aspectos de diseño técnico e implementación de FreedomBox. Mira la sección de desarrollo de los foros de discusión. -
-
-
- Donar - La FreedomBox Foundation es una corporación federal 501(c)(3) reconocida por el IRS. El proyecto FreedomBox lo llevan voluntarios. Puedes ayudar a su financiación donando mediante PayPal, Bitcoin o enviando un cheque. Mira por favor la página de donación para más detalles acerca de cómo donar. -
-
- Documentar: Manual de Usuario, Sitio Web y Wiki - FreedomBox necesita mejor documentación para usuarios y contribuyentes. El manual de FreedomBox se prepara agregando diferentes páginas del wiki y exportando a various formatos. El manual se usa en el Servicio FreedomBox y en otros sitios. - Si quieres contribuir al wiki (y por extensión al manual) de FreedomBox, puedes crear una cuenta en el wiki y empezar a editar. - Para contribuir al sitio web por favor inicia un debate en la sección de desarrollo del foro de FreedomBox. -
-
- Asegurar la Calidad - - - FreedomBox ya funciona sobre muchas plataformas y a los desarrolladores les resulta imposible probar en todas. Si tienes algún hardware soportado puedes ayudar probando FreedomBox en tu platforma. - - - Cuando se integra una nueva aplicación en FreedomBox, el desarrollador que hace el trabajo no prueba toda la functionalidad en el mundo real. Desplegar la aplicación y probarla ayudará a tener aplicaciones de alta calidad en FreedomBox. - - - Mira en la página de aseguramiento de la calidad la lista de casos de prueba que hay que verificar y la información acerca de cómo informar defectos. -
-
- Localizar (l10n) - Todo texto visible por los usuarios de FreedomBox necesita ser localizado a varios idiomas. Este trabajo de traducción incluye: - - - El Interfaz web de FreedomBox - - - La documentación de FreedomBox - - - El wiki y los sitios web de FreedomBox y la Freedombox Foundation. - - - El framework Django que emplea FreedomBox. - - - Cada aplicación que FreedomBox expone a sus usuarios. - - - Puedes contribuir al esfuerzo de localización usando la herramienta web Weblate o directamente en el repositorio de código mediante Salsa. - Si quieres ver a FreedomBox disponible en alguno de tus idiomas, por favor abre un debate en la sección de desarrollo del foro de FreedomBox para trabajar con otros traduciendo para ese idioma. - Para más información, por favor visita la página de traductores. -
-
- Correr la Voz - Cuenta a tu familia, amistades, comunidad local o en conferencias globales la importancia de FreedomBox. Para ser un proyecto exitoso necesitamos muchos más participantes, ya sean usuarios o contribuyentes. Comenta tus esfuerzos de divulgación en la página de charlas y en el wiki. -
-
-
-
- Guía del Desarrollador - El Manual del Desarrollador de FreedomBox proporciona un tutorial paso a paso para escribir apps para FreedomBox y una referencia para la API. Está disponible en docs.freedombox.org. -
-
- Cacharreo - FreedomBox consiste de 2 sub-proyectos principales: - - - El Servicio FreedomBox (Plinth), el interfaz web - - - Freedom Maker, un script para generar imágenes de disco para hardware variado - - -
- Servicio FreedomBox (Plinth) - El servicio FreedomBox (Plinth) es un interfaz web para administrar las funciones de FreedomBox. - El servicio FreedomBox es Software Libre bajo la versión 3 o posterior (a tu elección) de la Licencia Pública General GNU Affero. -
- Uso - - - El servicio FreedomBox viene instalado en todas las imágenes de FreedomBox. Puedes descargar imágenes de FreedomBox y ejecutarlas en cualquier hardware soportado. El servicio FreedomBox (Plinth) estará accesible visitando la URL o . - - - Si estás en una máquina Debian puedes instalar el servicio FreedomBox desde el archivo de paquetes de Debian. Actualmente solo se soportan Buster (estable), Bullseye (en pruebas) y Sid (inestable). Para instalar el servicio FreedomBox ejecuta: - - - - - - También puedes obtener el servicio FreedomBox en su repositorio Git o instalarlo desde el código fuente. - - -
-
- Capturas de pantalla - - - - - - - - Página Principal - - - - - - - - - - Página de Apps - - - - - - - - - - Página del Sistema - - - - - - - - - - - - Habilitar Servicios or Onion - - - - - - - - - - Newsfeed desde cualquier lugar - - - - - - - - - - Cliente Email - - - - - - - - - - - - Páginas Man - - - - - - - - - - Página Acerca de - - - - -
-
- Soporte - Puedes solicitar soporte en - - - - El foro de debate - - - - - La lista de correo - - - - - El canal IRC #freedombox - - - - - El canal Matrix FreedomBox - - - -
-
- Contribuir - Buscamos ayuda para mejorar el servicio FreedomBox. Puedes contribuir al servicio FreedomBox no solo codificando sino también traduciendo, documentando, diseñando, empaquetando o dando soporte. - - - Hay disponibles instrucciones para contribuir código. - - - El repositorio Git principal se aloja en la página de FreedomBox en Salsa. - - - Hay disponibles instrucciones para instalar desde el código fuente y modificarlo. - - - Las listas de defectos, tareas pendientes y solicitudes de funcionalidad están en el gestor de incidencias. - - - Antes de contribuir al código fuente del servicio FreedomBox necesitas entender Python y Django porque se basa en ellos. - - - Puedes solicitar asistencia al desarrollo en el foro de debate, la lista de correo o el canal de IRC #freedombox. - - -
- Paquete Debian - - - El servicio FreedomBox está empaquetado para Debian como paquete nativo y el código fuente de empaquetado es parte del código fuente del paquete principal. - - - Las incidencias relacionadas con el empaquetado se listan en el BTS de Debian. - - -
-
-
-
- Freedom Maker - Freedom Maker es un script para generar imágenes de disco FreedomBox adaptadas a diferentes dispositivos hardware o máquinas virtuales. - Actualmente Freedom Maker puede generar imágenes de disco FreedomBox para el siguiente hardware: - - - - A20-OlinuXino-LIME - - - - - A20-OlinuXino-LIME2 - - - - - A20-OLinuXino-MICRO - - - - - Banana Pro - - - - - BeagleBone - - - - - Cubieboard2 - - - - - Cubietruck - - - - - pcDuino3 - - - - - Raspberry Pi 2 - - - - - Raspberry Pi 3 Modelo B - - - - - Raspberry Pi 3 Modelo B+ - - - - - VirtualBox - - - - - QEMU - - - - Máquinas AMD64 (x86-64), máquinas X86 y otras máquinas virtuales (usando imágenes de disco en crudo (raw)) - - - Si una platforma de hardware puede ejecutar Debian no debería llevar mucho esfuerzo adaptar Freedom Maker para que le genere imágenes FreedomBox. - Freedom Maker es Software Libre licenciado bajo la versión 3 o posterior (a tu elección) de la Licencia Pública General GNU. -
- Generar Imágenes FreedomBox - - - Puedes obtener Freedom Maker desde su repositorio Git y seguir las instrucciones del fichero README para generar una imágen FreedomBox. - - -
-
- Soporte - Puedes solicitar soporte en - - - - El foro de debate - - - - La lista de correo - - - El canal IRC #freedombox - - - El canal Matrix FreedomBox - - -
-
- Contribuir - Buscamos ayuda para mejorar Freedom Maker. - - - Hay instrucciones disponibles para contribuir código fuente. - - - Freedom Maker se aloja en el Proyecto Salsa de FreedomBox. El repositorio Git principal está alojado allí. - - - Puedes contribuir a FreedomBox añadiendo soporte para más platformas de hardware. Freedom Maker se puede adaptar fácilmente a más platformas si ya soportan ejecutar Debian. - - - Puedes crear y probar imágenes con Freedom Maker regularmente para probar las funcionalidades nuevas y comprobar que no hay regresiones. - - - Las listas de defectos, tareas pendientes y solicitudes de funcionalidad están en el gestor de incidencias. - - - Puedes solicitar asistencia al desarrollo en el foro de debate, la lista de correo o el canal IRC #freedombox. - - -
-
-
-
- Cuéntaselo a tu gente - - - - FreedomBox - - - - FreedomBox en la Prensa (en) - - - Conferencias (en) - - - Cahrlas y presentaciones (en) - - - Material Disponible. Presentaciones y otros materiales en bruto. - - - - Facebook - - - - - Twitter - - - - - Mastodon - - - - - Videos de la Debconf11 - - - -
-